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
di request. Ogni link deve specificare anche un insieme di services
che enumera le caratteristiche che il partner fornisce 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 (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 elemento linkType valido che descriva il tipo di partner Shopping che la effettua. Ai partner Shopping viene assegnata una delle seguenti etichette e devono utilizzare l'etichetta designata nel campo linkType quando chiami 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".
Il "eCommercePlatform" linkType identifica il partner come una 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"
}
Nella sezione successiva viene descritto come ottenere un elenco dei link esistenti.