Configurar uma biblioteca de cliente

Gostaríamos de apresentar a versão Beta da API Merchant. Esta é a nova versão da API Content e o futuro.

Recomendamos o uso das bibliotecas de cliente das APIs do Google para configurar a API Content for Shopping. Neste guia, usamos as bibliotecas de cliente da API Content para 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 README.md da linguagem no repositório googleads/googleads-shopping-samples (em inglês) no GitHub.

Observação: é necessário instalar várias bibliotecas necessárias para usar o código de amostra no Python. Por esse motivo, recomendamos criar um ambiente virtual do Python antes de continuar. Para mais informações, consulte Como instalar pacotes usando 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 seu 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 transferido por download na etapa 7.

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

   1. No menu Configurações do Merchant Center, selecione API Content.
   2. Clique em Autenticação.
   3. Clique em [+] CRIAR CHAVE DE API.
   4. Se solicitado, leia e aceite os termos dos contratos de serviço.

   A nova chave é salva automaticamente.

3. Renomeie o arquivo de credenciais salvo como service-account.json.

   Observação: esse nome de arquivo é definido no arquivo _constants.py, localizado em python/shopping/content/ no diretório de amostras da API Content, que foi salvo na etapa 7.

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

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

6. No merchant-info.json, adicione o seguinte texto:

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

7. 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/.

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

9. 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 da API 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.