Recomendamos o uso das bibliotecas de cliente da API do Google para configurar a API Content for Shopping. Este guia usa as bibliotecas de cliente da API Content do Python como exemplo, mas está disponível para muitas linguagens de programação conhecidas e simplifica tarefas comuns de API, como autenticação, envio de solicitações e análise de respostas. Se precisar de ajuda para configurar bibliotecas de cliente para outras linguagens, consulte README.md da linguagem no repositório googleads/googleads-shopping-samples do 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 diretório principal, crie os seguintes diretórios:
~/shopping-samples/content/ (link em inglês)
Para fazer o download das credenciais da sua conta de serviço, siga estas etapas:
- No Merchant Center, no menu Configurações, selecione API Content.
- Clique em Autenticação.
- Clique em [+] CRIAR chave de API.
- Se solicitado, leia e aceite os Termos de Serviço.
A nova chave vai ser salva automaticamente.
Renomeie o arquivo de credenciais salvo como service-account.json.
Mova o arquivo service-account.json para home directory/shopping-samples/content/.
Em home directory/shopping-samples/content/, crie um arquivo merchant-info.json vazio.
Em 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) o repositório googleads/googleads-shopping-samples do GitHub em qualquer local no seu computador. Ele não precisa estar no seu diretório principal nem em ~/shopping-samples/content/.
Se você fez o download e descompactou o repositório, em vez de cloná-lo, renomeie o diretório descompactado para googleads-shopping-samples.
Para instalar as dependências de amostra necessárias, acesse googleads-shopping-samples/python/ em uma janela de terminal e execute:
pip install -r requirements.txt
A biblioteca de cliente da API do Google para Python está configurada e pronta para ser usada com a API Content. Na próxima seção, você vai criar e enviar uma solicitação para inserir um novo produto.