Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta etapa, você identifica uma conta do Google Ads para fazer chamadas de API. Ela pode ser uma conta de produção (ativa) ou de teste. Cada uma tem vantagens e desvantagens.
Contas de produção
Contas de teste
Vantagens
É mais fácil escrever e testar códigos que funcionam com conteúdos específicos da conta.
É mais fácil escrever e testar códigos que processam dados de relatórios em tempo real.
As contas de teste não veiculam anúncios. Portanto, bugs de programação
não afetam suas campanhas ativas.
Funciona com tokens de desenvolvedor que têm nível de acesso de teste.
Desvantagens
Um bug de programação na fase de desenvolvimento pode afetar a veiculação de campanhas ativas, causando problemas como desempenho ruim, veiculação incorreta ou perdas financeiras.
O token de desenvolvedor precisa ter pelo menos o nível de acesso básico para
fazer chamadas de API.
É necessário reconstruir campanhas em contas de teste para testar o código que funciona com conteúdos específicos da conta.
Como as contas de teste não veiculam anúncios, os recursos relacionados à veiculação em tempo real, como estatísticas de relatórios, erros de violação da política ou processamento de importações de conversão off-line, não são compatíveis, o que dificulta o teste desses recursos.
Recomendamos usar uma conta de teste ao desenvolver seu aplicativo, sempre que possível. Para instruções, consulte Criar contas e campanhas de teste.
Outra opção é configurar uma conta de produção com um orçamento baixo, como US $1/dia, explicitamente para testar recursos que não são compatíveis com uma conta de teste.
Escolha do conjunto de atributos
Ao escolher uma conta para fazer chamadas de API, considere também a lista de recursos que você quer usar com a API. Mesmo que você escolha usar uma conta de produção, alguns recursos são específicos da conta, por exemplo:
Para usar os recursos de faturamento, você precisa de uma conta com faturamento mensal.
Alguns novos recursos da conta podem ser restritos por listas de permissão.
Antes de finalizar a conta para fazer chamadas de API, consulte a documentação do recurso específico para verificar se ele não tem outras restrições.
Identificar o ID de cliente de login e o ID de cliente
Para fazer uma chamada de API a um cliente do Google Ads, você precisa conceder acesso e permissões adequadas à sua conta de serviço na conta do cliente, diretamente ou por uma conta de administrador vinculada. Para fazer isso, você precisa ter acesso de administrador à conta do cliente.
Comece fazendo login na sua conta do Google Ads como administrador. Em alguns casos, você pode ter mais de uma conta de cliente para escolher. A conta que você seleciona estabelece o ID de cliente de login, que é um cabeçalho obrigatório para algumas chamadas de API.
Depois de identificar o cliente do Google Ads para fazer chamadas de API, anote os seguintes detalhes:
O ID de cliente de 10 dígitos da conta de cliente em que você planeja fazer chamadas de API. Às vezes, ele é chamado de cliente operacional.
O ID de cliente de login com 10 dígitos da conta de cliente em que você fez login.
Se você fez login como o cliente operacional, o ID do cliente de login é o mesmo que o ID do cliente. Se você fez login em uma conta de administrador do cliente operacional, o ID de cliente de login é o ID de cliente da conta de administrador.
Conceder acesso à conta de serviço
Faça login na sua conta do Google Ads como administrador e acesse Administrador > Acesso e segurança.
Clique no botão + na guia Usuários.
Digite o endereço de e-mail da conta de serviço na caixa de entrada E-mail. Selecione o nível de acesso à conta adequado e clique no botão Adicionar conta. O nível de acesso "E-mail" não é compatível com contas de serviço.
A conta de serviço recebe acesso.
Por padrão, não é possível conceder acesso de administrador a uma conta de serviço. Se as suas
chamadas de API exigirem acesso de administrador, faça upgrade do acesso da seguinte maneira.
Clique na seta suspensa ao lado do nível de acesso da conta de serviço na coluna Nível de acesso.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[[["\u003cp\u003eChoose a Google Ads account (production or test) to make API calls, noting its email address for generating OAuth 2.0 refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eTest accounts are recommended for development to prevent affecting live campaigns; however, they don't support features related to live serving.\u003c/p\u003e\n"],["\u003cp\u003eProduction accounts, with a low budget, can be used to test features unsupported by test accounts, but a programming bug can affect live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eEnsure the selected account supports the desired features as some features have account-specific restrictions.\u003c/p\u003e\n"],["\u003cp\u003eTo make API calls, you need access to the customer account, the 10-digit customer ID, email address for OAuth 2.0 token generation, and the 10-digit login customer ID.\u003c/p\u003e\n"]]],[],null,["# Prepare the customer account\n\n**Note:** The current step of this tutorial depends on the [type of application](/google-ads/api/docs/get-started/choose-application-type) you are building. We strongly recommend using service account to make API calls. However, the user authentication option is also provided as an alternative. The rest of this tutorial will be customized based on your choice. \nService accounts User authentication\n\nIn this step, you identify a Google Ads account to make API calls to. The account\ncan either be a production (live) account or a test account. Each approach has\nits advantages and disadvantages.\n\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | ##### Production accounts | ##### Test accounts |\n| ##### Advantages | - Easier to write and test code that works against specific account contents. - Easier to write and test code that processes live reporting data. | - Test accounts *don't* serve ads, hence programming bugs won't affect your live campaigns. - Works with developer tokens that have Test Access level. |\n| ##### Disadvantages | - A programming bug in the development phase could affect live campaign serving, leading to issues such as poor campaign performance, incorrect serving, or financial losses. - The developer token should have at least the Basic Access level to in order to make API calls. | - You must reconstruct campaigns within test accounts to test code that works against specific account contents. - Since test accounts don't serve ads, features related to live serving such as reporting stats, policy violation errors, or processing offline conversion imports are not supported, making it difficult to test those features. |\n\nWe recommend using a test account while developing your application when\npossible. For instructions, see [Create test accounts and\ncampaigns](/google-ads/api/docs/best-practices/test-accounts#create).\n\nAn alternative is to set up a production account with a low account budget,\nsuch as $1/day, explicitly for testing features that are not supported by a\ntest account.\n\nChoice of feature set\n---------------------\n\nWhen choosing an account for making API call, an additional consideration is\nthe list of features you'd want to use with the API. Even if you choose to use\na production account, there are some features that are account-specific, for\nexample:\n\n- For billing features, you need an account that is on monthly invoicing.\n- Some new features in the account might be restricted by allowlists.\n\nBefore finalizing the account to make API calls against, check the\ndocumentation of the specific feature to make sure that the feature doesn't\nhave additional restrictions.\n\nIdentify the login customer ID and customer ID\n----------------------------------------------\n\nTo make an API call to a Google Ads customer, you must grant access and\nappropriate permissions to your service account to the customer account\neither directly or through a linked manager account. To do this, you need\nadministrator access to the customer account.\n\nStart by signing in to your Google Ads account as an administrator. In some cases,\nyou might have more than one customer account to choose from. The account you\nselect establishes the login customer ID, which is a required header for some\nAPI calls.\n\nAfter you've identified the Google Ads customer to make API calls to, note the\nfollowing details:\n\n- The 10-digit customer ID of the customer account to which you plan to make\n API calls against. This is sometimes referred to as the operating customer.\n\n- The 10-digit login customer ID of the customer account you're signed in to.\n If you're signed in to the operating customer, the login customer ID is the\n same as the customer ID. If you signed into a manager account of the\n operating customer, the login customer ID is the customer ID of the manager\n account.\n\nGrant access to the service account\n-----------------------------------\n\n1. While signed in to your Google Ads account as an administrator, navigate to\n **Admin \\\u003e Access and security**.\n\n2. Click the **+** button under the **Users** tab.\n\n3. Type the service account email address into the **Email** input box. Select\n the appropriate level of account access level and click the **Add account**\n button. Note that Email access level is not supported for service accounts.\n\n4. The service account is granted access.\n\nBy default, you cannot grant administrator access to a service account. If your\nAPI calls require administrator access, you can upgrade the access as follows.\n\n1. Click the drop-down arrow next to the access level of the service account\n in the **Access level** column.\n\n2. Select **Admin** from the drop-down list."]]
