Configurar a autenticação para a API Merchant

Para garantir a segurança de dados, aplicar o controle de acesso e manter a integridade do sistema, é necessário autenticar todas as solicitações da API Merchant. A API usa a identidade autenticada para determinar as ações que o autor da chamada tem permissão para realizar. Por exemplo, alguns autores de chamadas podem ter acesso somente leitura aos dados do produto, enquanto outros podem modificar as configurações da conta no Merchant Center.

Este documento faz parte de uma série sobre como começar a usar a API Merchant. Se você já configurou a autenticação com a API Merchant, você pode pular para a próxima seção: Registrar-se como desenvolvedor

Autorizar solicitações para a API Merchant

Todas as solicitações enviadas à API Merchant precisam incluir um token de autorização para identificar seu aplicativo para o Google. Para configurar a autenticação e a autorização, decida o caso de uso que melhor descreve a maneira como você planeja trabalhar com a API Merchant:

Você está criando um aplicativo para outras empresas usarem?

Se sim, use a autorização OAuth 2.0. Escolha a autorização OAuth 2.0 se:

• Você é um provedor ou agência terceirizada: você está criando um aplicativo, como uma plataforma SaaS, que será usado por outras empresas para gerenciar os dados do Merchant Center.
• Você precisa gerenciar muitas contas externas: você quer um único aplicativo para trabalhar em várias contas independentes do Merchant Center pertencentes a clientes diferentes. Seus clientes concedem permissões fazendo login nas próprias Contas do Google e clicando em "Permitir" em uma tela de permissão.

Você está criando um app para sua própria empresa?

Se sim, use uma autorização de conta de serviço para ter acesso à API Merchant. Escolha uma autorização de conta de serviço se:

• Você está criando seu próprio aplicativo interno: você está desenvolvendo uma ferramenta especificamente para sua empresa gerenciar os dados do Merchant Center ou quer que as credenciais pertençam ao próprio aplicativo, em vez de um usuário específico.
• Você precisa de automação sem login humano: seu aplicativo executa tarefas em segundo plano , como atualizações automatizadas de inventário ou jobs "cron".

Autorização do OAuth 2.0

Se você é um provedor ou agência terceirizada que gerencia várias contas de clientes, seu aplicativo precisa usar o OAuth 2.0 para autorizar solicitações. Siga estas etapas para configurar o OAuth 2.0 para a API Merchant:

1. Crie credenciais do OAuth 2.0 em APIs e serviços em seu console do Google Cloud.
2. Faça o download das credenciais do cliente OAuth2 para o arquivo, como client-secrets.json.
3. Adicione a conta de e-mail como um usuário ao Merchant Center: verifique se a Conta do Google usada para autorizar solicitações existe como usuário no Merchant Center. Consulte Como adicionar ou remover um usuário do Merchant Center para mais detalhes.
4. Atribua o papel Admin para realizar o registro. Para mais informações sobre papéis, consulte Gerenciar pessoas e níveis de acesso no Merchant Center
5. Configure a autenticação com exemplos de código: siga as orientações da seção Configuração da autenticação e configuração de amostra da documentação de exemplos de código oficial.

Para mais informações sobre a autorização OAuth 2.0, consulte Autorizar o acesso de apps de terceiros à conta do Merchant Center e Como usar o OAuth 2.0 para acessar as APIs do Google.

Autorização da conta de serviço

Você usa uma conta de serviço para autorizar o acesso da API Merchant a sua conta do Merchant Center. Siga estas etapas para configurar a autorização da conta de serviço para a API Merchant:

1. Crie credenciais de conta de serviço em APIs e serviços no console do Google Cloud
2. Faça o download da chave privada: crie e faça o download da chave privada no formato JSON para a conta de serviço. Renomeie o arquivo para service-account.json.
3. Adicione a conta de serviço ao Merchant Center: copie o endereço de e-mail exclusivo da conta de serviço, como [e-mail], e adicione-o como um novo usuário no Merchant Center. Consulte Como adicionar ou remover um usuário do Merchant Center para mais detalhes.
4. Atribua acesso Admin. Para mais informações sobre níveis de acesso, consulte Gerenciar pessoas e níveis de acesso no Merchant Center
5. Configure a autenticação com exemplos de código: siga as orientações da seção Configuração da autenticação e configuração de amostra da documentação de exemplos de código oficial.

Para mais informações sobre a autorização da conta de serviço, consulte Autorizar o acesso à sua conta do Merchant Center e Visão geral das contas de serviço.