Introdução
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Google Ads é usada para gerenciar contas e campanhas grandes ou complexas do Google Ads. É possível criar um software que gerencia contas desde o nível do cliente até o da palavra-chave. Veja alguns casos de uso comuns:
- gerenciamento de contas automático
- geração de relatórios personalizada
- gerenciamento de anúncios com base no inventário
- Gerenciar estratégias de Lances inteligentes
A API Google Ads é o produto certo para mim?
O Google oferece vários produtos para ajudar a automatizar contas do Google Ads. Confira alguns cenários comuns e a lista de produtos do Google que podem ser mais adequados às suas necessidades.
| Cenário |
Recomendação |
| Sou um desenvolvedor que quer criar meu próprio produto de software ou
fazer a integração com a API Google Ads. Tenho experiência em escrever código e gerenciar infraestrutura de software, incluindo servidores e bancos de dados. |
Use a API Google Ads. |
| Sou um desenvolvedor que se sente à vontade para escrever código, mas prefere não gerenciar minha própria infraestrutura de software. |
Use os scripts do Google Ads. |
| Não sou desenvolvedor, mas quero investir algum tempo aprendendo
programação para automatizar o Google Ads. |
Use os scripts do Google Ads. |
| Sou um analista de dados (ou função semelhante) e quero baixar relatórios do Google Ads para fazer uma análise mais detalhada. |
Use o
serviço de transferência de dados do BigQuery. O suporte está disponível para
transferências do Google Ads. |
| Quero gerenciar o Google Ads em massa, mas não quero escrever nenhum código. |
Use regras automatizadas,
uploads em massa ou o Google Ads Editor.
|
Pré-requisitos
Para fazer uma chamada da API Google Ads, você precisa ter os seguintes detalhes. O restante deste tutorial ensina como conseguir cada um desses itens.
- Conta de administrador do Google Ads: você precisa de uma conta de administrador do Google Ads para se inscrever na API Google Ads.
Token de desenvolvedor: permite que seu app se conecte à
API Google Ads. Cada token de desenvolvedor recebe um nível de acesso à API que controla o número de chamadas de API que você pode fazer por dia, bem como o ambiente em que é possível fazer chamadas.
Projeto do Console de APIs do Google: usado para gerar credenciais do OAuth 2.0 para seu app. Em seguida, o app usa essas credenciais para autenticar o usuário e receber autorização para gerenciar as contas do Google Ads dele. Essa autorização é usada posteriormente pelo app
para fazer chamadas de API à conta do Google Ads. O projeto também permite que a API aceite chamadas.
Conta de cliente do Google Ads: é a conta em que você está fazendo chamadas de API. Você precisa das permissões necessárias para operar nessa conta, como buscar relatórios ou fazer mudanças nas campanhas.
Você também precisa do número de conta de 10 dígitos da conta para a qual está fazendo chamadas de API. Isso é mostrado na interface da Web do Google Ads na forma 123-456-7890. Esse número de conta é transmitido como um parâmetro para a chamada da API Google Ads sem os hífens: 1234567890.
Ferramentas de suporte e bibliotecas de cliente: esse conjunto de ferramentas pode ajudar você a se integrar à API mais rapidamente.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Google Ads API is designed for managing large or complex Google Ads accounts programmatically, enabling tasks like automated account management, custom reporting, and inventory-based ad management.\u003c/p\u003e\n"],["\u003cp\u003eGoogle offers alternative solutions like Google Ads scripts, BigQuery Data Transfer service, automated rules, bulk uploads, and Google Ads Editor depending on user technical expertise and needs.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Google Ads API, you'll need a Google Ads manager account, a developer token, a Google API Console project, and access to a Google Ads client account with necessary permissions.\u003c/p\u003e\n"],["\u003cp\u003eBefore making API calls, ensure you have the required details, including the 10-digit Google Ads client account number (without hyphens) and support tools or client libraries.\u003c/p\u003e\n"]]],[],null,["# Introduction\n\nThe Google Ads API is used for managing large or complex Google Ads accounts and\ncampaigns. You can build software that manages accounts from the customer level\ndown to the keyword level. Some typical use cases include:\n\n- Automated account management\n- Custom reporting\n- Ad management based on inventory\n- Manage smart bidding strategies\n\nIs the Google Ads API the right product for me?\n-----------------------------------------------\n\nGoogle provides multiple products to help automate Google Ads accounts. Here are\nsome common scenarios and the list of Google products that might best\nfit your needs.\n\n| Scenario | Recommendation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| I am a developer who wishes to build my own software product, or integrate with Google Ads API. I am comfortable writing code, managing software infrastructure including servers and database. | Use the Google Ads API. |\n| I am a developer who is comfortable writing code, but prefer not to manage my own software infrastructure. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am not a developer, but am willing to invest some time learning programming to automate Google Ads. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am a data analyst (or similar role) who wants to download Google Ads reports for further analysis. | Use [BigQuery Data Transfer service](//cloud.google.com/bigquery/docs/dts-introduction). Support is available for [Google Ads transfers](//cloud.google.com/bigquery/docs/google-ads-transfer). |\n| I want to manage Google Ads in bulk, but don't want to write any code. | Use [automated rules](//support.google.com/google-ads/answer/2472779), [bulk uploads](//support.google.com/google-ads/answer/10702932), or [Google Ads Editor](//support.google.com/google-ads/editor/answer/2484521). |\n\nPrerequisites\n-------------\n\nTo make a Google Ads API call, you should have the following details. The rest of this\ntutorial teaches you how to obtain each of these items.\n\n- [**Google Ads manager account**](//support.google.com/google-ads/answer/7459399): You need a Google Ads manager account to apply for the Google Ads API.\n- [**Developer token**](/google-ads/api/docs/get-started/dev-token): This token lets your app connect to the\n Google Ads API. Each developer token is assigned an API access level which\n controls the number of API calls you can make per day with as well as the\n environment to which you can make calls.\n\n- [**Google API Console project**](/google-ads/api/docs/get-started/oauth-cloud-project): The Google API Console project is used\n for generating OAuth 2.0 credentials for your app. The app will then use\n these credentials to authenticate the user and obtain user authorization to\n manage their Google Ads accounts. This authorization is later used by your app\n to make API calls to the Google Ads account. The project also enables the API\n to accept calls.\n\n- [**Google Ads client account**](/google-ads/api/docs/get-started/select-account): This is the account you're making API\n calls against. You need necessary permissions to operate on this account,\n such as fetching reports or making changes to campaigns.\n\n You also need the 10-digit account number of the account you're making API\n calls to. This is displayed in the Google Ads web interface in the form\n `123-456-7890`. This account number is passed as a parameter to the Google Ads API\n call without the hyphens: `1234567890`.\n- [**Support tools and client libraries**](/google-ads/api/docs/get-started/download-tools-libraries): This set of tools can help\n you integrate with the API more quickly."]]
