Gerenciar relacionamentos de conta

Use a API Accounts para gerenciar as relações entre sua conta do Merchant Center e outros provedores de serviços. Um relacionamento é uma conexão formal que permite que um provedor ofereça serviços específicos à sua empresa. Um serviço define as permissões e capacidades concedidas ao provedor, como gerenciamento de produtos ou campanhas. Por exemplo, ao vincular sua conta do Merchant Center a uma conta do Google Ads, a conta do Google Ads pode usar seus dados de produtos para veicular campanhas publicitárias.

Uma relação é composta pelos seguintes atributos:

  • A conta do Merchant Center que recebe o serviço
  • O provedor de serviços
  • O serviço ou conjunto de serviços fornecidos à conta do Merchant Center

Os provedores de serviços podem associar um alias às contas que atendem. Esse é o equivalente ao campo seller_id presente no recurso account da API Content for Shopping. O alias pode ser atribuído usando o campo opcional account_id_alias no recurso AccountRelationship e serve como um identificador personalizado.

A estrutura do URL para acessar uma conta usando o alias é GET /accounts/v1/accounts/{provider}~{account_id_alias}.

Serviços

Na API Accounts, as contas podem receber os seguintes serviços:

  • Agregação de contas: modela a relação entre uma conta avançada e as contas a que ela fornece serviços. O provedor de serviços (a conta avançada) recebe acesso completo e irrestrito às subcontas vinculadas. O externalAccountId é, neste caso, o identificador da conta do Merchant Center. Ao criar uma subconta, o externalAccountId precisa ser omitido, já que será atribuído ao ID da conta na criação.

  • Gerenciamento de campanhas: esse serviço modela a vinculação entre uma conta do Merchant Center e uma conta do Google Ads, à conta do Google Ads acesso aos dados de produtos e da conta necessários para veicular campanhas publicitárias. Nesse caso, o provedor de serviços é GOOGLE_ADS e externalAccountId é o ID da conta do Google Ads.

  • Comparação de preços: representa a relação com um serviço de comparação de preços (CSS) que opera a conta do Merchant Center.

  • Gerenciamento de informações comerciais locais: representa a relação com um gerente de loja para gerenciar o inventário e as informações comerciais locais usando um Perfil da Empresa no Google.

  • Gerenciamento de conta: esse serviço permite que o provedor realize ações administrativas na conta do Merchant Center, como configurar as configurações da conta, gerenciar usuários ou atualizar informações comerciais. A empresa também pode restringir o acesso concedido.

  • Gerenciamento de produtos: esse serviço permite que os provedores gerenciem produtos e recursos relacionados, como fontes de dados e regras.

Aperto de mão

Para estabelecer um serviço, tanto a conta que fornece quanto a que recebe precisam autorizar a conexão. Esse processo de autorização é chamado de handshake.

O handshake é um processo de duas etapas:

  1. Uma das partes propõe um link de serviço.
  2. A outra parte aprova ou rejeita a proposta.

Depois que uma proposta é aceita, o serviço é aprovado e considerado totalmente estabelecido. Qualquer direito de acesso concedido ao provedor de serviços agora é concedido a usuários qualificados (consulte direitos de acesso abaixo).

O usuário que cria, rejeita ou aprova uma proposta precisa ter direitos de ADMIN acesso na conta que inicia o processo. Portanto, se o provedor de serviços propor um serviço, o usuário que fizer a proposta precisa ser um ADMIN na conta do provedor de serviços, e o usuário que aceitar ou rejeitar a proposta precisa ser um ADMIN na conta de recebimento.

Comportamento de handshake específico do serviço

A seguir, descrevemos os requisitos específicos de handshake para cada serviço individual:

  • Agregação de contas: esse serviço só pode ser estabelecido como parte da criação de contas. Espera-se que o provedor de serviços seja uma conta avançada, e o serviço é aprovado automaticamente porque os usuários da conta avançada têm acesso total de ADMIN à conta que está sendo criada.

  • Gerenciamento de campanhas: embora siga o processo normal de handshake, as propostas são feitas em um sistema (por exemplo, o Google Ads) e as aprovações são feitas no outro (por exemplo, no Merchant Center ou pela API Merchant).

  • Gerenciamento de fichas de empresas locais: para esse serviço, o handshake é proposto em um método dedicado, e as aprovações são feitas no outro sistema (por exemplo, Perfil da Empresa no Google). As etapas detalhadas estão no Guia para vincular um Perfil da Empresa no Google.

  • Gerenciamento de contas: para esse serviço, o processo normal de handshake se aplica (proposto pelo provedor de serviços ou empresa, seguido de aceitação da outra parte).

  • Gerenciamento de produtos: para esse serviço, o processo regular de handshake se aplica (proposto por uma parte, seguido da aceitação da outra).

Direitos de acesso

Cada tipo de serviço oferece um determinado nível de acesso para os usuários do provedor de serviços na conta atendida:

  • Agregação de contas: esse serviço oferece direitos completos de ADMIN.

  • Gerenciamento de campanhas: esse serviço oferece um direito de acesso restrito, permitindo que a conta do Google Ads associada acesse produtos e informações básicas da conta.

  • Comparação de preços: esse serviço oferece, por padrão, direitos completos de ADMIN. No entanto, a empresa pode restringir o acesso concedido no Merchant Center.

  • Gerenciamento de fichas de empresas locais: esse serviço não oferece direito de acesso direto. Em vez disso, ele permite que a ficha sincronize os produtos com a conta do Merchant Center.

Importante: os direitos de acesso descritos para os seguintes tipos de serviço se aplicam somente a provedores de serviços aprovados. Entre em contato com nossa equipe de suporte se você for um provedor de serviços e quiser usar esse recurso. Se você já tiver sido aprovado para o método accounts.link de gerenciamento de produtos na API Content for Shopping, poderá usar esse serviço na API Merchant sem precisar de outras aprovações.

  • Gerenciamento de contas: por padrão, esse serviço oferece direitos completos de ADMIN.

  • Gerenciamento de produtos: esse serviço oferece direitos completos de ADMIN. No futuro, isso será limitado apenas a direitos de acesso relacionados a produtos.

Como os relacionamentos se aplicam a plataformas de terceiros

Se você for uma plataforma terceirizada que gerencia contas em nome de outras empresas, confira abaixo como os diferentes conceitos se relacionam com a estrutura da sua conta:

  1. Provedor de serviços: sua conta avançada.
  2. Conta que recebe o serviço: uma conta do Merchant Center que representa a empresa que você gerencia.
  3. Serviço:
    • accountAggregation, se você estiver criando essas contas como subcontas da sua conta avançada. No entanto, isso não é recomendado, e o serviço preferencial é o accountManagement.
    • accountManagement, se você estiver estabelecendo esse serviço após a criação da conta para contas que não são secundárias da sua conta avançada.

Para detalhes sobre como configurar uma conta avançada e vincular a novas contas do Merchant Center, consulte Criar e gerenciar subcontas.