Links de solicitação

Para sinalizar um relacionamento com uma conta do comerciante, um parceiro do Shopping precisa usar o método accounts.link para enviar uma solicitação de vinculação.

O pedido de vinculação contém um linkedAccountId que identifica o comerciante que recebe a solicitação e tem um action do tipo request. Cada link também precisa especificar um conjunto de services que enumera os recursos que o parceiro fornece ao comerciante. Os valores de services a seguir são aceitos.

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 (antigo Ações do Shopping)
shoppingActionsOrderManagement Gerenciamento de pedidos do Comprar com o Google (antigo Ações do Shopping)

Além disso, uma solicitação 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 123456789 de um parceiro a um comerciante com linkedAccountId no valor de "98765".

O "eCommercePlatform" linkType identifica o parceiro como uma plataforma de e-commerce. A lista services indica que o parceiro fornece recursos de "shoppingAdsProductManagement" (gerenciamento de dados de produtos para anúncios do Shopping) e "shoppingActionsOrderManagement" (gerenciamento de pedidos do Comprar com o Google, anteriormente 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 conseguir uma lista de links existentes.