O token de desenvolvedor é uma string alfanumérica com 22 caracteres que permite que seu aplicativo se conecte à API Google Ads. Depois que o token é atribuído a você pelo Google, ele pode ser visualizado ou criado 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 você pode fazer por dia com o token, bem como o ambiente para o qual é possível fazer chamadas.
Para fazer chamadas de API na sua conta de produção, é preciso solicitar o acesso básico ou o acesso padrão do token de desenvolvedor durante o processo de solicitação. 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 conferir como se inscrever para ter acesso básico depois de concluir este guia.
Você precisa de um novo token de desenvolvedor?
A inscrição 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 antes e você quer desenvolver os próprios apps | Inscreva-se para receber um novo token de desenvolvedor. Saiba mais |
| Sua empresa usa ou já usou a API Google Ads no passado | Geralmente, o Google concede um token de desenvolvedor por empresa. Sendo assim, se sua empresa já usa a API Google Ads, você precisa 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ê não tiver certeza de que não é possível usar seu token de desenvolvedor atual, solicite um novo explicando seu caso de uso no aplicativo. Para o restante deste guia, você pode usar seu token de desenvolvedor atual. Saiba mais |
| Sua empresa usa um app de terceiros | Você precisará de um token de desenvolvedor apenas se estiver desenvolvendo seu próprio app. Nesse caso, o desenvolvedor do app precisa receber um token de desenvolvedor para o app. Se você não tiver certeza sobre o caso, entre em contato com a equipe de conformidade 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á tem 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 análise de tokens e simplificar o gerenciamento da conta posteriormente.
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.
Faça login na sua conta de administrador e clique no botão Pesquisar.
Digite "API center" e selecione essa opção no preenchimento automático da pesquisa. A opção Central de API aparece apenas para contas de administrador do Google Ads, não para contas de anunciantes ou contas de administrador de teste.
Preencha o formulário de acesso à API e aceite os Termos e Condições.
Verifique se suas 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 seu aplicativo e rejeitá-lo.
Verifique se o e-mail de contato da API fornecido leva a uma caixa de entrada monitorada regularmente. A equipe de conformidade da API do Google pode entrar em contato com esse endereço de e-mail durante o processo de análise para pedir esclarecimentos. Se você não puder ser contatado, o Google poderá não prosseguir com a inscrição.
É possível editar seu e-mail de contato da API na Central de API. Mantenha essas informações atualizadas, mesmo após o processo de solicitação, para que o Google possa enviar avisos de serviço importantes.
Depois que você concluir o processo de inscrição, o token de desenvolvedor será exibido na Central de APIs com o status Pending Approval. Seu token de desenvolvedor agora tem o nível de 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 sua primeira chamada de API.
Onde encontrar seu token de desenvolvedor
Um token de desenvolvedor atual pode ser encontrado na página Central de API da sua conta de administrador do Google Ads.
Faça login na sua conta de administrador e clique no botão Pesquisar.
Digite "API center" e selecione essa opção no preenchimento automático da pesquisa. A opção Central de API é exibida apenas para contas de administrador do Google Ads, não para contas de administrador de teste.
O token de desenvolvedor e o nível de acesso dele são os primeiros valores em Acesso à API.
