Configurar uma biblioteca de cliente

Recomendamos o uso do Bibliotecas de cliente das APIs do Google para definir a API Content for Shopping. Este guia usa o cliente Python da API Content como exemplo, mas elas estão disponíveis para muitas bibliotecas de programação linguagens de programação e simplifique tarefas comuns de APIs, como autenticação, envio de solicitações, e análise de respostas. Para obter ajuda com a configuração de bibliotecas de cliente para outras linguagens, consulte o arquivo README.md para a linguagem na googleads/googleads-shopping-samples no GitHub.

Para configurar a biblioteca de cliente da API do Google para Python, siga estas etapas:

1. Crie um diretório para a configuração e autenticação da biblioteca de cliente . No seu diretório principal, crie os seguintes diretórios:

   ~/shopping-samples/content/

2. Para fazer o download das 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 superior da página. Se você não tiver uma Clique em Novo projeto para criar um.
   3. Se você ainda não ativou a API Content for Shopping para projeto e, em seguida, procure-o na lista de APIs do Google e ative-o.
   4. Na barra lateral à esquerda, selecione Credenciais. Talvez seja necessário clicar a seta apontando para a esquerda no canto superior esquerdo para conferir isso.
   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. Ele também serve como o nome de usuário padrão para o ID da conta de serviço. Anote o ID da conta de serviço, incluindo a parte após a "@" para uso posterior. Clique em Criar e analise as etapas opcionais para conceder acesso ao projeto e aos usuários, e clique em Concluído.
   7. Você será direcionado para a página "Contas de serviço" onde o novo serviço pode ser acessada.

3. Para conseguir uma chave privada JSON, clique na conta de serviço e em Chaves . Clique em Adicionar chave > Criar nova chave e selecionar JSON como o tipo de chave. Clique em Criar para fazer o download da chave privada no seu computador. A nova chave é salva automaticamente.

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

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

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

7. No 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 para seu cliente concluir essa etapa para você.

   1. Acesse sua conta do Merchant Center.
   2. Nas configurações da sua conta do Merchant Center, selecione Pessoas e .

   3. Clique em + Adicionar pessoa e use o ID da conta de serviço como 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 retornar à lista de usuários. O ID da conta de serviço é listado com o papel do usuário escolhido.

   6. Repita o processo para todas as outras contas de serviço que você quer adicionar.

9. Clonar (ou fazer download e descompactar) o googleads/googleads-shopping-samples repositório do GitHub para qualquer local no seu computador. não precisa estar em seu diretório principal ou em ~/shopping-samples/content/.

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

11. Para instalar as dependências de amostra necessárias, em uma janela de terminal, acesse 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.