Contas de serviço

As contas de serviço são Contas do Google especiais 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, ele usa um arquivo de chave que somente seu aplicativo pode acessar. Neste guia, discutimos como acessar a API Content for Shopping usando 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 programando um aplicativo de terceiros que precise de acesso às contas do Merchant Center dos seus clientes, consulte o guia Autorização de solicitações.

Pré-requisitos

• Uma conta do Merchant Center.

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. Você vai precisar criar um ID do cliente OAuth 2.0 e obter um arquivo de chave privada *.json:
   1. Vá para o Console de APIs do Google.
   2. Selecione um projeto no menu suspenso na parte superior da página. Se você ainda não tiver um, crie um clicando em NOVO PROJETO.
   3. Se você ainda não ativou a API Content for Shopping para esse projeto, procure-a na lista de APIs do Google e ative-a.
   4. Na barra lateral à esquerda, selecione Credenciais. Talvez seja necessário clicar na seta apontando para a esquerda no canto superior esquerdo para conferir essa opção.
   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. Ele também serve como o nome de usuário padrão do 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 e siga as etapas opcionais para conceder acesso ao projeto e aos usuários. Em seguida, clique em CONCLUÍDO.

      A escolha da função para a conta de serviço não vai afetar as chamadas que podem ser feitas para a API Content, já que o acesso aos métodos da API Content é determinado pela função associada ao ID da conta de serviço no Merchant Center. Se você não tiver certeza do que escolher, selecione Project > Viewer.

   7. Você será direcionado para a página "Contas de serviço" em que sua nova conta de serviço pode ser acessada.
   8. Para conseguir uma chave privada JSON, clique na conta de serviço e, em seguida, 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 de terceiros, será necessário que seu cliente faça essa etapa para você.
   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, acesse a página de administração 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 estar 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 com o fluxo de credenciais padrão do aplicativo do Google ou com o fluxo da conta de serviço diretamente. As Amostras da API Content for Shopping mostram como usar os dois fluxos para credenciais da 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 serão necessárias para usar contas de serviço no seu 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 expirar, o aplicativo precisará usar a biblioteca de cliente para buscar outro token de acesso.