Per segnalare una relazione con un account commerciante, un partner Shopping deve prima
utilizzare il metodo accounts.link
per inviare una richiesta di collegamento.
La richiesta di collegamento contiene un elemento linkedAccountId
che identifica il commerciante che riceve la richiesta e ha un tipo action
request
. Ogni link deve anche specificare un insieme di services
che elenca le funzionalità che il partner fornisce al commerciante. Sono supportati i seguenti valori services
.
Servizio | Descrizione |
---|---|
shoppingAdsProductManagement |
Gestione dei dati di prodotto per gli annunci Shopping |
shoppingActionsProductManagement |
Gestione dei dati di prodotto per Acquista su Google (precedentemente nota come Shopping Actions) |
shoppingActionsOrderManagement |
Gestione degli ordini per Acquista su Google (precedentemente nota come Shopping Actions) |
Inoltre, una richiesta deve contenere anche un valore linkType
valido che descriva il tipo di partner di Shopping che effettua la richiesta. Ai partner di Shopping viene assegnata una delle seguenti etichette e devono utilizzare l'etichetta designata nel campo linkType
quando chiamano l'API.
LinkType validi |
---|
channelPartner |
eCommercePlatform |
Esempio
La seguente chiamata API invia una richiesta di collegamento dall'account di un partner
123456789
a un commerciante con linkedAccountId
di "98765"
.
L'elemento "eCommercePlatform"
linkType
identifica il partner come piattaforma
di e-commerce. L'elenco services
indica che il partner fornisce le funzionalità "shoppingAdsProductManagement"
(gestione dei dati di prodotto per gli annunci Shopping) e "shoppingActionsOrderManagement"
(gestione degli ordini per Acquista su Google, precedentemente nota come Shopping Actions).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
La sezione successiva descrive come ottenere un elenco dei link esistenti.