Configurar uma biblioteca de cliente

Conheça a API Merchant (Beta), a sucessora oficial da API Content for Shopping.

Receba as informações mais recentes sobre novos recursos, correções de bugs e atualizações da API Merchant (Beta).

Aprenda a gerenciar sua empresa e seus produtos no Google e a ter acesso programático a dados, insights e recursos exclusivos em grande escala. Começar agora

Recomendamos usar as bibliotecas de cliente das APIs do Google para configurar a API Content for Shopping. Este guia usa as bibliotecas de cliente da API Content Python como exemplo, mas elas estão disponíveis para muitas linguagens de programação conhecidas e simplificam tarefas comuns de API, como autenticação, envio de solicitações e análise de respostas. Para receber ajuda na configuração de bibliotecas de cliente para outros idiomas, consulte o README.md do idioma no repositório googleads/googleads-shopping-samples no GitHub.

Observação: é necessário instalar várias bibliotecas obrigatórias para usar o código de exemplo em Python. Por isso, recomendamos criar um ambiente virtual Python antes de continuar. Para mais informações, consulte Como instalar pacotes usando o pip e ambientes virtuais.

Para configurar a biblioteca de cliente da API do Google para Python, siga estas etapas:

1. Crie um diretório para os arquivos de configuração e autenticação da biblioteca de cliente. No diretório principal, crie os seguintes diretórios:

   ~/shopping-samples/content/

   Observação: esse caminho e o nome do arquivo merchant-info.json criado na etapa 5 são definidos no arquivo python/shopping/content/common.py no diretório de amostras da API Content baixado na etapa 7.

2. Para fazer o download das credenciais da conta de serviço, siga estas etapas:

   1. Acesse a Biblioteca de APIs do Google.
   2. Selecione um projeto no menu na parte de cima da página. Se você ainda não tiver um, clique em Novo projeto para criar um.
   3. Se você ainda não ativou a API Content for Shopping para este projeto, pesquise-a na lista de APIs do Google e ative-a.
   4. Na barra lateral à esquerda, selecione Credenciais. Talvez seja necessário clicar na seta para a esquerda no canto superior esquerdo para ver isso.
   5. Para configurar uma conta de serviço, selecione Criar credenciais e Conta de serviço.
   6. Nomeie a nova conta de serviço. Ele 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 para conceder acesso ao projeto e aos usuários e clique em Concluído.
   7. Você será direcionado para a página "Contas de serviço", onde sua nova conta de serviço poderá ser acessada.

3. 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. O download da nova chave é feito automaticamente.

4. Renomeie o arquivo de credenciais baixado para service-account.json.

   Observação: o nome do arquivo é definido no arquivo _constants.py, localizado em python/shopping/content/ no diretório de exemplos da API Content baixado na etapa 7.

5. Mova o arquivo service-account.json para home directory/shopping-samples/content/.

6. Em home directory/shopping-samples/content/, crie um arquivo merchant-info.json vazio.

7. Em merchant-info.json, adicione o seguinte texto:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Adicione a nova conta de serviço como um usuário à sua conta do Merchant Center. Se você for um desenvolvedor terceirizado, seu cliente precisará realizar esta etapa para você.

   1. Acesse sua conta do Merchant Center.
   2. Nas configurações da sua conta do Merchant Center, selecione Pessoas e acesso.

   3. Clique em + Adicionar pessoa e use o ID da conta de serviço como o endereço de e-mail do novo usuário.

      Observação: se você não anotou o ID da conta de serviço, acesse a página de administração das contas de serviço e selecione o projeto que você criou.

   4. O uso do serviço Accounts requer acesso de administrador. Portanto, selecione Administrador.

   5. Clique em Adicionar usuário para salvar as preferências e voltar à lista de usuários. O ID da conta de serviço é listado com o papel de usuário escolhido.

   6. Repita o processo para todas as outras contas de serviço que você quer adicionar.

9. Clone (ou faça o download e descompacte) o repositório do GitHub googleads/googleads-shopping-samples para qualquer local no seu computador. Ele não precisa estar no diretório principal ou em ~/shopping-samples/content/.

10. Se você fez o download e descompactou o repositório, em vez de cloná-lo, renomeie o diretório descompactado para googleads-shopping-samples.

11. Para instalar as dependências de amostra necessárias, em uma janela do terminal, acesse googleads-shopping-samples/python/ e execute:

    pip install -r requirements.txt
    

Agora você tem a biblioteca de cliente da API Google para Python configurada e pronta para uso com a API Content. Na próxima seção, você vai criar e enviar uma solicitação para inserir um novo produto.