Gerenciar relacionamentos de conta

Você pode usar a API Accounts para gerenciar as relações entre sua conta do Merchant Center e outros provedores de serviços. Uma relação é 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 os recursos concedidos ao provedor, como gerenciamento de produtos ou de campanhas. Por exemplo, ao vincular sua conta do Merchant Center a uma conta do Google Ads, a conta do 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

Alias

Os provedores de serviços podem associar um alias às contas que atendem. Esse é o equivalente ao seller_id campo que estava presente no recurso da conta na 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. O alias precisa ter de 1 a 50 caracteres escolhidos entre letras ASCII, dígitos decimais, hífens, sublinhados, pontos ou tils ([A-Za-z0-9_~.-]{1,50}).

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. É possível adicionar muitos desses serviços durante a criação da conta.

• Agregação de contas: esse serviço vincula uma conta avançada a outra conta, concedendo acesso total e irrestrito à conta avançada. Ele é usado normalmente por marketplaces, varejistas de várias marcas ou varejistas internacionais que precisam de controle centralizado sobre contas aninhadas. Se você é uma plataforma de e-commerce ou um parceiro de canal, recomendamos usar accountManagement. Ao criar uma conta usando a agregação de contas, o externalAccountId precisa ser omitido.

• Gerenciamento de campanhas: esse serviço modela o vínculo entre uma conta do Merchant Center e uma conta do Google Ads, à conta de anúncios acesso aos dados de produtos e dados da conta necessários para veicular campanhas publicitárias. O provedor de serviços nesse caso é GOOGLE_ADS, e o externalAccountId é o ID da conta do Google Ads. Esse serviço também pode ser proposto a uma conta atual.

Observação: para varejistas/ marketplaces que usam a rede de commerce media em contas do Google Ads:

• Esse serviço permite a criação de filtros de produtos específicos do parceiro ao veicular campanhas da rede de commerce media.
• No momento, é necessário usar a versão Alfa da sub-API Accounts.
• O uso desse recurso exige uma lista de permissões específica do GMC.

Entre em contato com a equipe de gerenciamento de contas do Google Ads para mais detalhes.

• 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 fichas da empresa em pesquisa local: representa a relação com um gerente de loja para gerenciar o inventário local e as fichas da empresa em pesquisa local usando um Perfil da Empresa no Google.

• Gerenciamento de contas: esse serviço permite que o provedor realize ações administrativas na conta do Merchant Center, como configurar as definições da conta, gerenciar usuários ou atualizar informações comerciais. A empresa também pode restringir o acesso concedido. Quando usado durante a criação da conta, esse serviço cria uma conta vinculada ao provedor, que é a abordagem recomendada para plataformas de e-commerce e parceiros de canal. Ele também pode ser proposto a uma conta atual.

• Gerenciamento de produtos: esse serviço permite que os provedores gerenciem produtos e recursos relacionados, como fontes de dados e regras. Quando adicionado durante a criação da conta, ele geralmente é combinado com accountManagement ou accountAggregation. Esse serviço também pode ser proposto a uma conta atual.

Aperto de mão

Para estabelecer um serviço, a conta que o fornece e a conta que o recebe precisam autorizar a conexão. Esse processo de autorização é chamado de "aperto de mão".

O aperto de mão é 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 conferido ao provedor de serviços agora é concedido a usuários qualificados (consulte os direitos de acesso abaixo).

Observe que o usuário que cria, rejeita ou aprova uma proposta precisa ter ADMIN direitos de acesso na conta que inicia o processo. Portanto, se o provedor de serviços propuser 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 receptora.

Comportamento de aperto de mão específico do serviço

A seguir, descrevemos os requisitos específicos de aperto de mão para cada serviço:

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

• Comparação de preços: esse serviço é aprovado automaticamente quando adicionado durante a criação da conta usando createAndConfigure.

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

• Gerenciamento de fichas da empresa em pesquisa local: para esse serviço, o handshake é proposto em um método dedicado, e as aprovações são feitas no outro sistema (por exemplo, no 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 aperto de mão é aplicado ao usar propose. Se o serviço for adicionado durante a criação da conta usando createAndConfigure, ele será aprovado automaticamente.

• Gerenciamento de produtos: para esse serviço, o processo normal de aperto de mão é aplicado (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 usuários do provedor de serviços na conta atendida:

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

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

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

• Gerenciamento de fichas da empresa em pesquisa local: esse serviço não oferece direito de acesso direto. Em vez disso, ele permite que as informações do produto sincronizem os produtos com a conta do Merchant Center.

Importante: os direitos de acesso descritos para os tipos de serviço a seguir se aplicam apenas 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 para gerenciamento de produtos na API Content for Shopping, poderá usar esse serviço na API Merchant sem outras aprovações.

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

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

Como as relações se aplicam a plataformas de terceiros

Se você é uma plataforma de terceiros que gerencia contas em nome de outras empresas, a seguir mostramos como os diferentes conceitos são mapeados para 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:
   • accountManagement: esse é o serviço recomendado para plataformas de e-commerce e parceiros de canal que criam novas contas em nome de comerciantes. Ele cria uma conta de propriedade do comerciante, vinculada a você para gerenciamento. Isso está alinhado à estrutura preferencial do Merchant Center para esse caso de uso.
   • accountAggregation: esse serviço vincula sua conta avançada a outra conta. Embora seja compatível, não é recomendado para plataformas de e-commerce e parceiros de canal.

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