googleads shopping samples

API de amostras para a API de conteúdo para compras e fabricante

Essas amostras de código são organizadas por plataforma ou idioma. Cada diretório de idiomas contém um README com mais informações sobre como executar as amostras para esse idioma em particular. Aqui, cobrimos a configuração da autenticação e o arquivo de configuração comum usado por todas as amostras.

Para obter mais informações sobre as APIs, consulte a documentação da API de conteúdo para compras e da API do Centro de Fabricantes.

Escolha o seu método de autenticação

Antes de começar, verifique a seção de início da API de conteúdo para documentação de compras. Você pode usar contas de serviço para simplificar o fluxo de autenticação. Essas amostras também suportam o uso de credenciais padrão do aplicativo do Google.

A configuração da autenticação para a API do Centro de Fabricante é semelhante à API de conteúdo. Apenas certifique -se de selecionar a API do Centro de Fabricante no console da API. Ambas as APIs podem ser selecionadas se você deseja experimentar amostras para ambas as APIs.

Configurando autenticação e configuração de amostra

1. Crie o diretório $(HOME)/shopping-samples para armazenar a configuração.

   Se você não tiver certeza de onde isso estará localizado em sua configuração específica, execute as amostras (seguindo a README específica do idioma). Os erros das amostras relacionadas a este diretório ou arquivos necessários não existentes fornecerão o caminho completo para o diretório/arquivos esperados.

   Dentro deste diretório, também crie os seguintes subdiretórios, dependendo da API que você gostaria de tentar:

   • content da API de conteúdo para fazer compras
   • manufacturers para a API do Centro de Fabricantes

   Coloque os arquivos descritos abaixo no subdiretório apropriado para a API que você deseja experimentar.

2. Configure o método de autenticação desejado.

   Se você estiver usando credenciais padrão do aplicativo do Google:

   • Siga as instruções na página Credenciais padrão do aplicativo do Google.

   Se você estiver usando uma conta de serviço:

   • Coloque o arquivo JSON que você baixou ao criar a conta de serviço para o arquivo de service-account.json nos subdiretórios de configuração da API apropriados.

   Se você estiver usando um ID do cliente OAuth2:

   • Faça o download de suas credenciais do cliente OAuth2 para o arquivo client-secrets.json nos subdiretórios de configuração da API apropriados.

     Nota: As amostras assumem que você está usando um ID do cliente OAuth2 que pode usar um endereço IP de loopback para recuperar tokens. Se você não tiver ou não tiver certeza de que é, visite o [OAuth2.0 para aplicativos para celular e desktop] (https://developers.google.com/identity/protocols/oauth2installeedapp) e siga as instruções para criar um Novo ID do cliente OAuth2 para usar com as amostras.

   Você pode configurar vários métodos de autenticação para experimentar diferentes fluxos, mas observe que as amostras sempre usarão as primeiras credenciais que podem ser carregadas, na ordem:

   1. Credenciais padrão do aplicativo do Google
   2. Credenciais de contas de serviço
   3. OAuth2 Credenciais do cliente

3. Cada conjunto de amostras usa um arquivo de configuração diferente. Para a API de conteúdo para fazer compras, pegue o exemplo merchant-info.json da raiz do repositório e copie-a em $(HOME)/shopping-samples/content . Em seguida, mude seu conteúdo adequadamente. Ele contém um objeto JSON com os seguintes campos:

   Campo	Tipo	Descrição
   merchantId	número	O ID do Merchant Center para executar amostras contra.
   accountSampleUser	corda	Se não estiver vazio, o endereço de email para o usuário adicionar/remover em amostras para o serviço Accounts .
   accountSampleAdWordsCID	número	Se diferente de zero, o ID do cliente do Google AdWords para vincular/desvincular em amostras para o Serviço Accounts .

   Para a API do Centro de Fabricante, pegue o exemplo manufacturer-info.json da raiz do repositório e copie-a em $(HOME)/shopping-samples/manufacturers . Em seguida, mude seu conteúdo adequadamente. Ele contém um objeto JSON com os seguintes campos:

   Campo	Tipo	Descrição
   manufacturerId	número	O ID do Centro de Fabricante para executar amostras contra.
   websiteUrl	corda	O URL (sem barra de direita) associado à conta do Centro de Fabricante.

   Se estiver usando as credenciais do cliente OAuth2, depois de ter acesso autorizado, os detalhes do seu token serão armazenados no arquivo stored-token.json no diretório de configuração de amostras. Se você tiver algum problema em autenticação, remova este arquivo e você será solicitado a autorizar novamente o acesso.

Experimente as amostras

Agora que você configurou o arquivo de configuração de amostra comum e configurou suas credenciais de autenticação, é hora de criar e executar qualquer uma das amostras incluídas. Como mencionado anteriormente, existem instruções específicas do idioma nos README localizados em cada subdiretório de idiomas. Divirta-se!

Questões possíveis

• Ao usar a API de conteúdo para fazer compras, se você não configurar as configurações de impostos em sua conta, poderá obter um erro ao executar determinadas amostras. Se você receber um erro "Configurações tributárias ausentes", defina suas configurações de impostos no Centro de Mercantes antes de experimentar essas amostras. Selecionar a configuração "Não cobrar impostos nos Estados Unidos" é suficiente.