Configurar uma biblioteca de cliente

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 do Python como exemplo, mas elas estão disponíveis para muitas linguagens de programação conhecidas e simplificam tarefas comuns da API, como autenticação, envio de solicitações e análise de respostas. Para ajuda na configuração de bibliotecas de cliente para outras linguagens, consulte o README.md da linguagem no repositório googleads/googleads-shopping-samples no GitHub.

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 seu diretório principal, crie os seguintes diretórios:

   ~/shopping-samples/content/

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, crie um clicando em Novo projeto.
   3. Se você ainda não ativou a API Content for Shopping para este projeto, pesquise na lista de APIs do Google e ative.
   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 depois 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 poderá acessar sua nova conta.

3. Para conseguir 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 baixar a chave privada no seu computador. A nova chave é baixada automaticamente.

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

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 usuário à sua conta do Merchant Center. Se você for um desenvolvedor terceirizado, peça ao cliente para fazer isso.

   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.

   4. O uso do serviço Accounts exige 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 em qualquer local do seu computador. Não precisa ser no diretório inicial ou em ~/shopping-samples/content/.

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

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

    pip install -r requirements.txt
    

Agora você tem a biblioteca de cliente de APIs do 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.