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, ele poderá ser visualizado ou criado na página API Center 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 você pode fazer por dia com o token, bem como o ambiente para o qual você pode fazer chamadas.
Para fazer chamadas de API na sua conta de produção, solicite o Acesso básico ou o Acesso padrão para seu token de desenvolvedor durante o processo de solicitação de 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 você confira como se inscrever para o acesso básico depois de concluir este guia.
Precisa de um novo token de desenvolvedor?
A necessidade de se inscrever para 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 | Solicite um novo token de desenvolvedor. Saiba mais |
| Sua empresa está usando 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, é necessário reutilizar 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 no aplicativo. No restante deste guia, você pode usar seu token de desenvolvedor atual. Saiba mais |
| Sua empresa usa um app de terceiros | Você só vai precisar 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 do seu caso, entre em contato com a equipe de compliance da API. |
Como solicitar um token de desenvolvedor
Há duas etapas para 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 outras, recomendamos colocá-la na raiz da hierarquia para facilitar o processo de análise do token e simplificar o gerenciamento de contas 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 do desenvolvedor pode levar algum tempo. Saiba mais.
Faça login na sua conta de administrador. É possível verificar se ela é uma conta de administrador.
Na barra de pesquisa na parte de cima da página, digite "api center" e selecione-a no preenchimento automático da pesquisa. A opção Central de API aparece apenas para contas de administrador do Google Ads, e não para contas de cliente ou contas de administrador de teste.
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 sua empresa está funcionando. Se o site não estiver ativo, talvez o Google não consiga processar e rejeitar sua inscrição.
Verifique se o e-mail de contato da API que você fornece leva a uma caixa de entrada monitorada regularmente. A equipe de compliance de APIs do Google pode entrar em contato com este 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 pode não continuar com sua inscrição.
Você pode editar seu e-mail de contato da API no API Center. Mantenha essas informações atualizadas, mesmo após o processo de inscrição, para que o Google possa enviar a você avisos importantes sobre o serviço.
Depois que você concluir o processo de inscrição, o token de desenvolvedor vai aparecer na Central de APIs com o status Aprovação pendente. Agora seu token de desenvolvedor tem o nível Acesso de teste, e você pode começar a fazer chamadas de API em contas de teste.
Depois de receber o token de desenvolvedor, anote o valor dele, porque você vai precisar dele ao fazer a primeira chamada de API.
Verifique 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:
Faça login em sua conta.
Selecione Administrador à esquerda. Se você encontrar a opção Configurações da conta de administrador no canto superior esquerdo, significa que você fez login na sua conta de administrador. Se você encontrar a mensagem Configurações da conta, significa que você fez login em uma conta de cliente.
Se a opção Test account aparecer em vermelho no canto superior direito, sua conta é um gerente de teste ou um anunciante de teste.
Onde encontrar seu token de desenvolvedor
Você pode encontrar o token de desenvolvedor, se houver um, na página API Center da sua conta de administrador do Google Ads.
Faça login na sua conta de administrador. É possível verificar se ela é uma conta de administrador.
Na barra de pesquisa na parte de cima da página, digite "api center" e selecione-a no preenchimento automático da pesquisa. A opção Central de API aparece apenas para contas de administrador do Google Ads, e não para contas de administrador de teste.
O token do desenvolvedor e o nível de acesso dele são os primeiros valores listados em Acesso à API.