O token de desenvolvedor é uma string alfanumérica de 22 caracteres que permite que seu app se conecte à API Google Ads. Depois que o token for atribuído a você pelo Google, será possível conferir ou criar um novo na página Central de API da sua conta de administrador do Google Ads.
Cada token de desenvolvedor recebe um nível de acesso que controla o número de chamadas de API que podem ser feitas por dia com o token, bem como o ambiente em que as chamadas podem ser feitas.
Para fazer chamadas de API na sua conta de produção, solicite o nível de acesso básico ou acesso padrão para seu token de desenvolvedor durante o processo de solicitação do token. Como esses níveis de acesso não são necessários para fazer chamadas em contas de teste, você pode continuar com os exercícios, mas recomendamos que confira como solicitar o nível de acesso básico depois de concluir este guia.
Você precisa de um novo token de desenvolvedor?
Se você precisa se inscrever para receber um novo token de desenvolvedor depende de alguns fatores. Veja algumas situações comuns:
Cenário |
Próximas etapas |
| Sua empresa nunca usou a API Google Ads e você quer desenvolver seus próprios apps | Inscreva-se para receber um novo token de desenvolvedor. Saiba mais |
| Sua empresa usa ou já usou a API Google Ads. | O Google geralmente concede um token de desenvolvedor por empresa. Portanto, se a sua empresa já usa a API Google Ads, reutilize o token de desenvolvedor atual. Saiba mais |
| Sua empresa já usa a API Google Ads, mas também está desenvolvendo um novo produto ou ferramenta. | Se você tiver certeza de que não pode usar seu token de desenvolvedor atual, solicite um novo explicando seu caso de uso na inscrição. Para o restante deste guia, use seu token de desenvolvedor atual. Saiba mais |
| Sua empresa usa um app de terceiros | Você só precisa de um token de desenvolvedor se estiver desenvolvendo seu próprio app. Se você usar um app ou serviço de terceiros, o desenvolvedor desse app precisará receber um token de desenvolvedor para ele. Se você não tiver certeza sobre seu caso, entre em contato com a equipe de compliance da API. |
Como solicitar um token de desenvolvedor
Há duas etapas ao solicitar um token de desenvolvedor.
Etapa 1: selecionar ou criar uma conta de administrador do Google Ads
Se você já tiver uma conta de administrador do Google Ads, selecione-a ao solicitar o token. Se essa conta de administrador ainda não estiver vinculada às suas outras contas, recomendamos colocá-la na raiz da hierarquia para facilitar o processo de revisão de token e simplificar o gerenciamento da conta mais tarde.
Se você não tiver uma conta de administrador, siga as instruções da Central de Ajuda para criar uma.
Etapa 2: inscrever-se para acessar a Google Ads API
O processo de análise do token de desenvolvedor pode levar algum tempo para ser concluído. Saiba mais.
Acesse https://ads.google.com/aw/apicenter no navegador da Web. Faça login na sua conta de administrador do Google Ads, se solicitado.
Preencha o formulário de acesso à API e aceite os Termos e Condições.
Verifique se as informações estão corretas e se o URL do site da empresa está funcionando. Se o site não estiver ativo, o Google poderá não conseguir processar e recusar sua inscrição.
Verifique se o e-mail de contato da API que você forneceu leva a uma caixa de entrada monitorada regularmente. A equipe de compliance de API do Google pode entrar em contato com esse endereço de e-mail durante o processo de revisão para esclarecimentos. Se não for possível entrar em contato com você, o Google poderá não continuar com sua inscrição.
É possível editar o e-mail de contato da API na Central de APIs. Mantenha essas informações atualizadas, mesmo após o processo de inscrição, para que o Google possa enviar avisos importantes sobre o serviço.
Depois de concluir o processo de inscrição, o token de desenvolvedor vai aparecer na Central de API com o status Aprovação pendente. Seu token de desenvolvedor agora tem o nível de acesso Conta de teste, e você pode começar a fazer chamadas de API em contas de teste.
Depois de receber seu token de desenvolvedor, anote o valor dele, já que você vai precisar ao fazer sua primeira chamada de API.
Verificar se você fez login em uma conta de administrador
Você precisa fazer login na sua conta de administrador para acessar o token de desenvolvedor, e ela não pode ser uma conta de administrador de teste.
Para verificar se você fez login na conta de administrador, siga estas etapas:
Acesse https://ads.google.com/aw/apicenter no navegador da Web.
Se você tiver feito login em uma conta de cliente, a página vai mostrar A Central de API está disponível apenas para contas de administrador..
Se Conta de teste aparecer em vermelho no canto superior direito, sua conta é de um gerente ou anunciante de teste.
Onde encontrar seu token de desenvolvedor
Se ele existir, você vai encontrar o token de desenvolvedor na página Central de API da sua conta de administrador do Google Ads.