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 é atribuído a você pelo Google, é possível visualizá-lo 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, além do ambiente em que é possível fazer chamadas.
Para fazer chamadas de API na sua conta de produção, você precisa solicitar o acesso básico ou o acesso padrão para o 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 é recomendável conferir como se inscrever para ter acesso básico depois de concluir este guia.
Você precisa de um novo token de desenvolvedor?
A necessidade de se inscrever para receber um novo token de desenvolvedor ou não 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 seus próprios apps | Inscreva-se para receber um novo token de desenvolvedor. Saiba mais |
| Sua empresa está usando ou já usou a API Google Ads no passado. | O Google geralmente concede um token de desenvolvedor por empresa. Portanto, se sua empresa já usa a API Google Ads, reutilize seu 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 que explique 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ê só 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 precisará receber um token de desenvolvedor para o app. Se você não tiver certeza sobre seu caso, entre em contato com a equipe de conformidade 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 da sua conta para facilitar o processo de análise do token 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 somente para contas de administrador do Google Ads, e 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 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 por esse endereço de e-mail durante o processo de análise para pedir esclarecimentos. Se não for possível entrar em contato com você, o Google pode não continuar com o aplicativo.
Você pode editar seu e-mail de contato da API na Central de API. Mantenha essas informações atualizadas, mesmo após o processo de inscrição, para que o Google possa enviar anúncios de serviço importantes.
Depois que você concluir o processo de solicitaçã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 de teste e você pode começar a fazer chamadas de API com base em contas de teste.
Depois de receber o token de desenvolvedor, anote o valor dele, porque ele será necessário ao fazer sua primeira chamada de API.
Onde encontrar seu token de desenvolvedor
Os tokens de desenvolvedor podem ser encontrados 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 aparece apenas para contas de administrador do Google Ads, e 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.
