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 linkedAccountId
che identifica il commerciante che riceve la richiesta e ha un tipo action
di request. Ogni link deve anche specificare un insieme di services
che elenca le funzionalità fornite dal partner al commerciante. Sono supportati i seguenti valori
di services.
| Servizio | Descrizione |
|---|---|
shoppingAdsProductManagement |
Gestione dei dati di prodotto per gli annunci Shopping |
shoppingActionsProductManagement |
Gestione dei dati di prodotto per Acquista su Google (in precedenza noto come Shopping Actions) |
shoppingActionsOrderManagement |
Gestione degli ordini per Acquista su Google (precedentemente noto come Shopping Actions) |
Inoltre, una richiesta deve contenere anche un linkType valido
che descriva il tipo di partner Shopping che effettua la richiesta. Ai partner
Shopping viene assegnata una delle seguenti etichette e devono utilizzare l'etichetta designata
nel campo linkType quando chiamano l'API.
| Valid linkTypes |
|---|
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".
"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
note 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.