Contas de serviço

As contas de serviço são contas especiais do Google que podem ser usadas por aplicativos para acessar as APIs do Google de maneira programática via OAuth 2.0. Uma conta de serviço usa um fluxo do OAuth 2.0 que não requer autorização humana. Em vez disso, ela usa um arquivo de chave que só o aplicativo pode acessar. Este guia discute como acessar a API Content for Shopping com contas de serviço.

Observação:os aplicativos que usam contas de serviço para autenticação só podem acessar sua própria conta do Merchant Center. Se você estiver escrevendo um aplicativo de terceiros que precisa de acesso às contas do Merchant Center dos seus clientes, consulte o guia Autorizar solicitações.

Pré-requisitos

Etapas para usar uma conta de serviço para acessar a API Content para Shopping

  1. Gere credenciais de conta de serviço ou acesse as credenciais públicas que você já gerou. Será necessário criar um ID do cliente OAuth 2.0 e receber um arquivo de chave privada *.json:
    1. Vá para o Console de APIs do Google.
    2. Selecione um projeto no menu suspenso na parte de cima da página. Se você ainda não tiver um, crie um clicando em NOVO PROJETO.
    3. Se você ainda não tiver ativado a API Content for Shopping para esse projeto, pesquise na lista de APIs do Google e ative-a.
    4. Clique no menu de navegação (☰) no canto superior esquerdo, selecione APIs e serviços e, em seguida, Credenciais.
    5. Para configurar uma conta de serviço, selecione CRIAR CREDENCIAIS e em seguida Conta de serviço.
    6. Nomeie a nova conta de serviço. Esse nome também serve como o nome de usuário padrão para o ID da conta de serviço. Registre o ID da conta de serviço, incluindo a parte após o caractere "@", para uso posterior. Clique em CRIAR, siga as etapas opcionais de concessão de acesso ao projeto e aos usuários e clique em CONCLUÍDO.

      A escolha do papel para a conta de serviço não terá efeito nas chamadas que podem ser feitas para a API Content, já que o acesso aos métodos da API Content é determinado pelo papel associado ao ID da conta de serviço no Merchant Center. Se você não tiver certeza do que escolher, selecione Projeto > Visualizador.

    7. Você será direcionado à página "Contas de serviço", onde poderá acessar sua nova conta de serviço.
    8. Para receber uma chave privada JSON, clique na conta de serviço e na guia CHAVES. Clique em ADICIONAR CHAVE > Criar nova chave e selecione JSON como o tipo de chave. Clique em CRIAR para fazer o download da chave privada no seu computador.
  2. Adicione a nova conta de serviço como um usuário à sua conta do Merchant Center. Se você for um desenvolvedor terceirizado, peça ao seu cliente para fazer essa etapa.
    1. Acesse sua conta do Merchant Center.
    2. Acesse Acesso à conta nas configurações da sua conta do Merchant Center.
    3. Clique em + Adicionar usuário e use o ID da conta de serviço como o endereço de e-mail do novo usuário.

      Se você não anotou o ID da conta de serviço antes, acesse a página de administração de Contas de Serviço e selecione o projeto criado.

    4. Especifique as preferências de Acesso do usuário e Notificações por e-mail para a conta de serviço. O uso do serviço Accounts requer acesso de administrador.
    5. Clique em Adicionar usuário para salvar as preferências e retornar à lista de usuários. O ID da conta de serviço precisa ser listado com o papel de usuário escolhido.
    6. Repita o processo para todas as outras contas de serviço que você quer adicionar.
  3. Agora você pode acessar sua conta do Merchant Center usando a conta de serviço usando o fluxo de credenciais padrão do aplicativo Google ou o fluxo da conta de serviço diretamente. Os exemplos da API Content para Shopping mostram como usar os dois fluxos para credenciais de conta de serviço em cada linguagem de programação compatível. Confira os exemplos de código para testar sua nova conta de serviço e saber quais mudanças você precisará usar contas de serviço no seu próprio código.

Perguntas frequentes

Posso fazer login na interface do Merchant Center com minha conta de serviço?
Não, as contas de serviço não são contas normais do Google e não podem acessar a interface do Merchant Center.
Com que frequência preciso atualizar os tokens de acesso da conta de serviço?
Os tokens de acesso expiram uma hora após serem emitidos pelo servidor de autorização do Google OAuth 2.0. Quando um token de acesso expira, o aplicativo precisa usar a biblioteca de cliente para buscar outro token de acesso.