Sia i partner di Shopping sia i singoli account commerciante possono avere più link contrassegnati tra i propri account e quelli di altri.
Il metodo listlinks restituisce un elenco di tutti questi link per l'account Merchant Center che effettua la chiamata API. Non richiede parametri e viene richiamato utilizzando una richiesta HTTP GET.
Stato del servizio
Quando vengono elencati i link, le risposte mostrano uno 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 esplicitamente approvati da un
commerciante. Una volta approvati, i servizi hanno lo 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, quest'ultimo non verrà più restituito dal
listlinks metodo.
Esempio di richiesta
Per elencare la richiesta di link inviata dal partner 123456789, invia una GET
richiesta senza parametri utilizzando il listlinks metodo.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
Esempio di risposta
In questo esempio, il commerciante 98765 non ha ancora approvato la richiesta, quindi i singoli servizi hanno lo stato pending.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
Nella sezione successiva viene descritto come approvare una richiesta di collegamento.