Sia i partner di Shopping sia i singoli account commerciante possono avere più collegamenti segnalati tra i propri account e altri.
Il metodo listlinks
restituisce un elenco di tutti questi collegamenti per l'account Merchant Center
che effettua la chiamata all'API. Non richiede parametri e viene invocato utilizzando una richiesta GET
HTTP.
Stato del servizio
Quando vengono elencati i link, le risposte mostreranno un status
per ogni singolo service
all'interno di un link. I commercianti hanno la possibilità di approvare tutti i servizi elencati o solo un sottoinsieme di quelli proposti nella richiesta.
I servizi iniziano con lo stato pending
finché non vengono approvati esplicitamente da un commerciante. Una volta approvati, i servizi hanno uno stato active
.
I servizi rimossi mostreranno lo stato inactive
se sono presenti anche altri servizi pending
o active
. Una volta rimossi tutti i servizi che compongono un link, il link non verrà più restituito dal metodo listlinks
.
Richiesta di esempio
Per elencare la richiesta di collegamento inviata dal partner 123456789
, invia una richiesta GET
senza parametri utilizzando il metodo listlinks
.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
Esempio di risposta
In questo esempio, il commerciante 98765
deve ancora approvare la richiesta, pertanto i singoli servizi hanno lo stato pending
.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
La sezione successiva descrive come approvare una richiesta di collegamento.