Migrar a vinculação de contas

O gerenciamento de relações de contas evoluiu de um único método link na API Content for Shopping para um sistema mais granular e explícito na API Merchant. A nova API usa recursos dedicados, como AccountRelationship e AccountService, para definir os serviços específicos que uma conta oferece a outra. Para mais detalhes, consulte Relações entre contas.

principais diferenças

  • Recursos dedicados para relacionamentos e serviços: na API Merchant, o recurso AccountRelationship define a conexão entre um provedor de serviços e um comerciante, enquanto o recurso AccountService especifica o serviço exato que está sendo fornecido (por exemplo, accountAggregation). Isso substitui os campos genéricos linkType e services da API Content for Shopping.
  • Métodos de ação explícita: em vez de um único método link com um parâmetro action, a API Merchant usa métodos distintos para gerenciar serviços, como propose, approve e reject.
  • Vinculação dedicada do Perfil da Empresa no Google: a vinculação a um Perfil da Empresa no Google, antes processada pela definição do campo googleMyBusinessLink, agora tem um método dedicado, gbpAccounts.linkGbpAccount.
  • Criação de conta de cliente como um serviço: agora, criar uma conta de cliente em uma conta avançada é tratado como propor um serviço de accountAggregation usando o método accounts.createAndConfigure. Para mais informações sobre contas, acesse a página da API Merchant Accounts. Não é necessário um handshake, já que o usuário tem acesso à conta avançada e à conta de cliente.

Solicitações

A API Merchant oferece endpoints específicos para gerenciar diferentes tipos de links de contas e serviços:

URLs de solicitação da API Merchant

  • Sugerir um novo serviço: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Aprovar um serviço: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Rejeitar um serviço: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Vincular a um Perfil da Empresa no Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Criar uma conta de cliente (link de agregação de contas): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Comparação de URLs de solicitação

Descrição da solicitação API Content for Shopping API Merchant
Vincular contas (por exemplo, plataformas de terceiros) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Vincular ao Perfil da Empresa no Google PUT .../v2.1/{merchantId}/accounts/{accountId} (com o campo googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Criar uma conta de cliente POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Métodos

Método da API Content for Shopping Método da API Merchant Disponibilidade e observações
accounts.link accountServices.propose Use esse método para iniciar um novo serviço com outra conta.
accounts.link (com action: "approve") accountServices.approve Use esse método para aprovar uma proposta de serviço pendente.
accounts.link (com action: "remove") accountServices.reject Use esse método para rejeitar um serviço pendente ou estabelecido.
accounts.insert (para contas de cliente) accounts.createAndConfigure Use esse método com um serviço accountAggregation para criar uma conta de cliente em uma conta avançada.
accounts.update (com googleMyBusinessLink) gbpAccounts.linkGbpAccount Use esse método dedicado para vincular uma conta do Merchant Center a um Perfil da Empresa no Google.
accounts.update (com adsLinks) AccountRelationship recurso A vinculação ao Google Ads é gerenciada na interface do Google Ads. O link resultante é representado como um AccountRelationship na API Merchant, que pode ser visualizado, mas não criado diretamente.

Mudanças detalhadas nos campos

API Content for Shopping API Merchant Descrição
AccountsLinkRequest.action Métodos propose, approve e reject O campo único action é substituído por métodos de API dedicados para cada mudança de estado no ciclo de vida do serviço.
AccountsLinkRequest.linkType AccountService.service_type A string genérica linkType é substituída por um campo service_type oneof estruturado no recurso AccountService, como productsManagement ou accountAggregation.
AccountsLinkRequest.services AccountService.service_type A lista de serviços baseados em strings agora é representada pelo service_type específico escolhido no recurso AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider O ID da conta que fornece o serviço agora é especificado no campo provider da solicitação propose.
Account.googleMyBusinessLink LinkGbpAccountRequest O objeto que contém os detalhes do link do GBP é substituído por uma mensagem de solicitação dedicada para o método linkGbpAccount.
Account.adsLinks AccountRelationship Os links do Google Ads são representados como um recurso AccountRelationship em que o provider é providers/GOOGLE_ADS. Normalmente, esse relacionamento é gerenciado na interface do Google Ads.