O token de desenvolvedor é uma string alfanumérica de 22 caracteres que permite
que seu app se conecte à API Google Ads. Para isso, inscreva-se na página da Central de APIs da sua conta de administrador do Google Ads. Sempre que você faz uma chamada de API, envia o token de desenvolvedor como parte da solicitação definindo o cabeçalho developer-token HTTP ou gRPC.
Cada token de desenvolvedor recebe um nível de acesso que controla o número de chamadas de API que você pode fazer por dia com o token, bem como o ambiente em que é possível fazer chamadas. Quando você se inscreve para um token de desenvolvedor, ele tem o nível Acesso de teste por padrão. Isso permite que você faça chamadas de API somente em contas de teste. Para fazer chamadas de API na sua conta de produção, solicite o nível de acesso básico ou padrão para seu token de desenvolvedor. Depois que seu pedido de token de desenvolvedor for analisado e aprovado, ele vai receber o nível de acesso adequado.
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 talvez não consiga 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 da API do Google pode entrar em contato com esse endereço de e-mail durante o processo de análise para esclarecimentos. Se não for possível entrar em contato com você, o Google poderá não continuar com sua inscrição.
Você pode editar o e-mail de contato da API no 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.
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.