Escolher o tipo de inscrição
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Como as contas do Google Ads contêm dados do usuário, seu aplicativo precisa receber
autorização do usuário para acessar esses dados. Há duas abordagens gerais com base em como você recebe essa autorização.
Escolher o tipo de app
Como as contas do Google Ads contêm dados do usuário, seu app precisa receber autorização dele para acessar esses dados. Há duas abordagens gerais com base em como você recebe essa autorização.
| |
Conta de serviço |
Autenticação de usuário |
| Resumo |
Configure manualmente sua conta do Google Ads para dar acesso a uma conta de serviço. Depois disso, o app pode usar as credenciais da conta de serviço
para fazer chamadas de API à conta do Google Ads sem interação
do usuário. As chamadas de API funcionam desde que a conta de serviço tenha acesso à conta do Google Ads. |
Receba uma autorização única do OAuth 2.0 de um usuário para
permitir que seu app gerencie a conta do Google Ads dele. Depois disso, seu
app poderá usar o token de atualização do OAuth 2.0 (emitido como parte do processo de autorização do OAuth 2.0
) para fazer chamadas de API para a conta do Google Ads. As chamadas de API
funcionam enquanto o usuário não revogar a autorização ou até que
ela expire por inatividade ou outros motivos. |
| Facilidade de uso |
Configuração e aprovações mínimas necessárias devido à falta de autorização do usuário no app. |
Configuração e aprovações extensas necessárias porque a autenticação do usuário faz parte do app. |
| Recomendação |
Altamente recomendável como a abordagem preferida |
Abordagem legada. Use como uma opção alternativa quando não for possível conceder a uma conta de serviço as permissões necessárias para sua conta do Google Ads. |
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."],[],[],null,["# Choose your application type\n\nSince Google Ads accounts contain user data, your application must obtain\nauthorization from the user to access this data. There are two broad approaches\nbased on how you obtain this authorization.\n\nChoose your app type\n--------------------\n\nSince Google Ads accounts contain user data, your app needs to obtain\nauthorization from the user to access this data. There are two broad approaches\nbased on how you obtain this authorization.\n\n| | **Service Account** | **User Authentication** |\n| Summary | Manually configure your Google Ads account to give a service account access to that account. Afterwards, your app can use the service account credentials to make API calls to the Google Ads account without any user interaction. The API calls work as long as the service account has access to the Google Ads account. | Obtain a one-time OAuth 2.0 authorization from a user to allow your app to manage their Google Ads account. Afterwards, your app can use the OAuth 2.0 refresh token (issued as part of the OAuth 2.0 authorization process) to make API calls to the Google Ads account. The API calls work as long as the user doesn't revoke the authorization, or until the authorization expires due to inactivity or other reasons. |\n| Ease of use | Minimal configuration and approvals required due to lack of user authorization in the app. | Extensive configuration and approvals required due to user authentication being part of the app. |\n| Recommendation | **Strongly recommended** as the preferred approach | Legacy approach. Use as a fallback option when you cannot give a service account the required permissions to your Google Ads account. |\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
