Configurar uma biblioteca de cliente

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:

  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/ (link em inglês)

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

    1. No Merchant Center, no menu Configurações, selecione API Content.
    2. Clique em Autenticação.
    3. Clique em [+] CRIAR chave de API.
    4. Se solicitado, leia e aceite os Termos de Serviço.

    A nova chave vai ser salva automaticamente.

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

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

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

  6. Em 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) 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/.

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

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