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.
Para configurar a biblioteca de cliente da API do Google para Python, siga estas etapas:
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/
Para fazer o download das credenciais da conta de serviço, siga estas etapas:
- No menu Configurações do Merchant Center, selecione API Content.
- Clique em Autenticação.
- Clique em [+] CRIAR CHAVE DE API.
- Se solicitado, leia e aceite os termos dos contratos de serviço.
A nova chave é salva automaticamente.
Renomeie o arquivo de credenciais salvo como service-account.json.
Mova o arquivo service-account.json para home directory/shopping-samples/content/.
No home directory/shopping-samples/content/, crie um arquivo merchant-info.json vazio.
No merchant-info.json, adicione o seguinte texto:
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }
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/.
Se você fez o download e descompactou o repositório, em vez de cloná-lo, renomeie o diretório descompactado como googleads-shopping-samples.
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.