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 podem ser feitas por dia com o token, além do ambiente em que as chamadas podem ser feitas.
Ao se inscrever para um token de desenvolvedor, você pode receber o nível de acesso de explorador por padrão. Isso permite fazer chamadas em contas de produção, mas com algumas restrições. Em alguns casos em que não é possível analisar automaticamente sua solicitação de token de desenvolvedor, podemos conceder a ele um nível de acesso à conta de teste. Isso permite que você faça chamadas de API apenas em contas de teste. Para remover as restrições dos níveis de acesso de conta de teste e de explorador, solicite o nível de Acesso básico ou Acesso padrão para seu token de desenvolvedor. Depois que sua solicitação de token de desenvolvedor for analisada e aprovada, 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. |
Quem pode solicitar um token de desenvolvedor?
Empresas e desenvolvedores individuais podem solicitar um token de desenvolvedor. A tabela a seguir resume os detalhes que você precisa fornecer ao se inscrever para o token de desenvolvedor.
| Se você é | Em seguida, forneça os seguintes detalhes do desenvolvedor | Outras observações |
|---|---|---|
| Um desenvolvedor que representa sua empresa ou uma equipe de produto | Nome e URL da sua empresa | O Google geralmente concede um token de desenvolvedor por empresa, mas aprova tokens separados para ferramentas diferentes caso a caso. |
| Um desenvolvedor individual que não representa uma empresa | Especifique o nome da empresa como Individual. Você pode
fornecer URLs alternativos, como o URL do seu perfil do GitHub ou do LinkedIn,
em vez de um URL da empresa. |
Você precisa ter alguma forma de presença on-line e fornecer ao Google um URL
que nos ajude a avaliar o que você planeja fazer com a API Google Ads. URLs genéricos, como test.com e example.com, não são aceitos. |
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 de desenvolvedor. 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.
Confira 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 sua inscrição e rejeitá-la.
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 um dos seguintes resultados:
- Seu token de desenvolvedor tem nível de acesso de explorador com status Aprovado. Isso significa que o Google conseguiu analisar e aprovar automaticamente seu pedido de token de desenvolvedor para o nível de acesso do Explorer. Você pode começar a fazer chamadas de API na sua conta de produção ou na conta de teste.
- Seu token de desenvolvedor tem o nível Acesso à conta de teste com o status Aprovação pendente. Isso significa que o Google não conseguiu analisar e aprovar automaticamente sua solicitação de token de desenvolvedor para o nível de acesso do Explorer. Você pode começar a fazer chamadas de API em contas de teste. Depois de concluir este guia, confira como se inscrever para o nível de acesso básico.
Verificar se você fez login em uma conta de administrador do Google Ads
Você precisa fazer login na sua conta de administrador do Google Ads para acessar o token de desenvolvedor, e ela não pode ser uma conta de administrador de teste do Google Ads.
Para verificar se você fez login na conta de administrador do Google Ads, 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 será de um gerente de teste ou de um 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.