Para sinalizar uma relação com uma conta de comerciante, um parceiro do Shopping precisa primeiro
usar o método accounts.link
para enviar uma solicitação de vinculação.
A solicitação de vinculação contém um linkedAccountId
que identifica o comerciante que recebe a solicitação e tem um tipo action
de request. Cada link também precisa especificar um conjunto de services
que enumera quais recursos o parceiro oferece ao comerciante. Os seguintes valores de
services são compatíveis.
| Serviço | Descrição |
|---|---|
shoppingAdsProductManagement |
Gerenciamento de dados de produtos para anúncios do Shopping |
shoppingActionsProductManagement |
Gerenciamento de dados do produto para o Comprar com o Google (antigo Ações do Shopping) |
shoppingActionsOrderManagement |
Gerenciamento de pedidos do Comprar com o Google (antes conhecido como Ações do Shopping) |
Além disso, uma solicitação também precisa conter um linkType válido
que descreva o tipo de parceiro do Shopping que está fazendo a solicitação. Os parceiros do Shopping recebem um dos seguintes rótulos 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 uma solicitação de vinculação da conta de um parceiro
123456789 para um comerciante com linkedAccountId de "98765".
O "eCommercePlatform" linkType identifica o parceiro como uma plataforma de e-commerce. A lista services indica que o parceiro oferece recursos de "shoppingAdsProductManagement" (gerenciamento de dados de produtos para anúncios do Shopping) e "shoppingActionsOrderManagement" (gerenciamento de pedidos para o Comprar com o Google, antes conhecido como Ações do Shopping).
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.