Lista de verificação de migração

Biblioteca de vídeo: workshop de 2021

Veja uma lista de verificação para você dar os primeiros passos na migração:

  1. Revise os mapeamentos da API do Google AdWords para a API do Google Ads:

  2. Confira estas ferramentas:

  3. Aceite os Termos e Condições atualizados e atualize seus dados de contato na Central de API.

    • Faça login na Central de API da conta de administrador em que você tem o token de desenvolvedor: ads.google.com/aw/apicenter.
    • Role para baixo até E-mail de contato da API e atualize-o.
    • Role para baixo até Local da empresa principal, aceite as novas condições e clique em Salvar.
  4. Ative a API Google Ads no projeto do Google Cloud.

    • Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione o projeto ou crie um novo. A biblioteca de APIs lista todas as APIs disponíveis agrupadas por família de produtos e popularidade.
    • Use a pesquisa para encontrar a Google Ads API se ela não estiver visível na lista.
    • Selecione a API Google Ads e clique no botão Ativar.
  5. Se você já tiver usado a Google AdWords API, as credenciais usadas ainda serão válidas para a Google Ads API. Não solicite um novo token de desenvolvedor nem crie novos pares de clientId e clientSecret de OAuth2.

  6. Selecione uma biblioteca de cliente.

  7. Leia o guia de início rápido para fazer sua primeira chamada.

Usar uma biblioteca de cliente

Se você estava usando uma das bibliotecas de cliente da Google AdWords API, pode fazer o download de uma das suas bibliotecas de cliente da Google Ads API e começar a trabalhar imediatamente. Consulte o README da biblioteca cliente para instruções sobre como definir o arquivo de configuração.

Na maioria dos casos, a configuração existente pode ser reutilizada ao migrar das bibliotecas de cliente da Google AdWords API para as da Google Ads API. Uma diferença fundamental é o novo login-customer-id. Nosso guia tem informações sobre quando você precisa adicioná-lo à sua configuração.

Exemplo de configuração do Java

Para a biblioteca de cliente Java, basta copiar as linhas no arquivo ads.properties que especificam as credenciais e alterar o prefixo api.adwords em cada chave para api.googleads:

api.adwords.clientId       --> api.googleads.clientId
api.adwords.clientSecret   --> api.googleads.clientSecret
api.adwords.refreshToken   --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken

Depois de atualizar o arquivo de configuração, você pode fazer sua primeira chamada:

Java

  1. No seu IDE, abra e execute o GetCampaigns.java.
  2. O console deve imprimir uma lista das campanhas em sua conta.

C#

  1. No seu IDE, abra e execute o GetCampaigns.cs.
  2. O console deve imprimir uma lista das campanhas em sua conta.

PHP

  1. Execute GetCampaigns.php.
  2. O console deve imprimir uma lista das campanhas em sua conta.

Python

  1. No seu IDE, abra e execute o get_campaigns.py.
  2. O console deve imprimir uma lista das campanhas em sua conta.

Ruby

  1. Na linha de comando, execute get_campaigns.rb digitando:
    ruby get_campaigns.rb
  2. O console deve imprimir uma lista das campanhas em sua conta.

Perl

  1. Execute get_campaigns.pl.
  2. O console deve imprimir uma lista das campanhas em sua conta.

Exemplos de código

As bibliotecas cliente também fornecem exemplos de código passo a passo que mostram como migrar da Google AdWords API para a Google Ads API.

Alternativas ao uso de uma biblioteca de cliente

Se você usava a Google AdWords API sem uma biblioteca cliente e quer continuar usando a Google Ads API, ainda pode usar suas credenciais.

Acesse o guia REST para ver como usar credenciais para executar solicitações na Google Ads API usando REST sobre HTTP.