Configurar uma biblioteca de cliente

Recomendamos o uso das bibliotecas de cliente das APIs do Google para configurar a API Content for Shopping. Este guia usa as bibliotecas de cliente da API Content for Shopping 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 receber ajuda na configuração de bibliotecas de cliente para outras linguagens, consulte o arquivo README.md da linguagem no googleads/googleads-shopping-samples repositório no GitHub (em inglês).

Para configurar a biblioteca de cliente das APIs 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/

2. Para baixar as 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 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 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 depois do 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.
   7. Você será direcionado à página "Contas de serviço", onde poderá acessar sua nova conta de serviço.

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

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

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

6. No 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, peça ao seu cliente para fazer essa etapa.

   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 para o novo usuário.

   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 baixe e descompacte) o googleads/googleads-shopping-samples repositório do GitHub em qualquer local do seu computador. Ele não precisa estar no diretório principal ou em ~/shopping-samples/content/.

10. Se você baixou 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 exemplo 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 das APIs do Google para Python configurada e pronta para uso com a API Content for Shopping. Na próxima seção, você vai criar e enviar uma solicitação para inserir um novo produto.