Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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 API. Non richiede parametri e viene richiamato utilizzando una
richiesta HTTP GET.
Stato del servizio
Quando elenca i link, le risposte mostrano un status per ogni 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 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 metodo listlinks.
Esempio di richiesta
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 non ha ancora approvato la richiesta, pertanto i
singoli servizi hanno lo stato pending.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elistlinks\u003c/code\u003e method allows retrieval of all flagged links between accounts, providing insight into account relationships.\u003c/p\u003e\n"],["\u003cp\u003eEach service within a link has a status, starting as \u003ccode\u003epending\u003c/code\u003e, transitioning to \u003ccode\u003eactive\u003c/code\u003e upon approval, and ultimately becoming \u003ccode\u003einactive\u003c/code\u003e when removed.\u003c/p\u003e\n"],["\u003cp\u003eA simple HTTP GET request to the \u003ccode\u003elistlinks\u003c/code\u003e endpoint is sufficient to retrieve link information without requiring any parameters.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. The `listlinks` method retrieves all links between merchant accounts without parameters via a `GET` request. Each service within a link has a `status`: `pending` (awaiting merchant approval), `active` (approved), or `inactive` (removed, but other services remain). Once all services are removed, the link is no longer listed. A `GET` request example and the `listlinks` method's response format are provided.\n"],null,["# List links\n\nBoth Shopping partners and individual merchant accounts can have multiple\nflagged links between their accounts and others.\nThe [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method\nreturns a list of all these links for the merchant center account\nmaking the API call. It does not require any parameters and is invoked using an\nHTTP `GET` request.\n\nService status\n--------------\n\nWhen listing links, responses will show a `status` for each individual `service`\nwithin a link. Merchants have the option to either approve all listed services\nor only a subset of those proposed in the request.\n\nServices start out in a `pending` status until explicitly [approved by a\nmerchant](/shopping-content/guides/flagging/approve). After they are approved, services have an `active` status.\n\nRemoved services will show a status of `inactive` if there are other `pending`\nor `active` services also present. Once all services comprising a link are\nremoved, the link will no longer be returned by the\n[`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method.\n\nExample request\n---------------\n\nTo list the link request sent by partner `123456789`, send a `GET`\nrequest with no parameters using the [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks\n\nExample response\n----------------\n\nIn this example, the merchant `98765` has yet to approve the request, so the\nindividual services have a `pending` status. \n\n {\n \"linkedAccountId\": \"98765\",\n \"services\": [\n {\n \"service\": \"shoppingAdsProductManagement\",\n \"status\": \"pending\"\n },\n {\n \"service\": \"shoppingActionsOrderManagement\",\n \"status\": \"pending\"\n }\n ]\n }\n\nThe [next section](/shopping-content/guides/flagging/approve) describes how to approve a linking request."]]