Para sinalizar um relacionamento com uma conta de comerciante, primeiro um parceiro do Shopping precisa
usar o método accounts.link
para enviar um pedido de vinculação.
O pedido de vinculação contém um linkedAccountId que identifica o comerciante que está recebendo a solicitação e tem um tipo action request. Cada link também precisa especificar um conjunto de services que enumera quais recursos o parceiro fornece ao comerciante. Há suporte para os valores
services a seguir.
| Serviço | Descrição |
|---|---|
shoppingAdsProductManagement |
Gerenciamento de dados do produto para anúncios do Shopping |
shoppingActionsProductManagement |
Gerenciamento de dados do produto para o Comprar com o Google (antes conhecido como Ações de Shopping) |
shoppingActionsOrderManagement |
Gerenciamento de pedidos do Comprar com o Google (antigo Ações de Shopping) |
Além disso, uma solicitação também precisa conter um linkType válido que descreva o tipo de parceiro do Shopping que fez a solicitação. Os parceiros de compras recebem um dos rótulos a seguir e precisam usar o rótulo designado no campo linkType ao chamar a API.
| linkTypes válidos |
|---|
channelPartner |
eCommercePlatform |
Exemplo
A chamada de API a seguir envia um pedido de vinculação da conta de um parceiro 123456789 para um comerciante com linkedAccountId de "98765".
O linkType do "eCommercePlatform" identifica o parceiro como uma plataforma de
e-commerce. A lista services indica que o parceiro oferece os recursos
"shoppingAdsProductManagement" (gerenciamento de dados do produto para anúncios do Shopping) e
"shoppingActionsOrderManagement" (gerenciamento de pedidos do Comprar com o Google, antes
conhecido como Shopping Actions).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
A próxima seção descreve como acessar uma lista de links existentes.