Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
In questo passaggio, identifichi un account Google Ads a cui effettuare chiamate API. L'account
può essere un account di produzione (live) o un account di test. Ciascun approccio presenta vantaggi e svantaggi.
Account di produzione
Account di prova
Vantaggi
È più facile scrivere e testare il codice che funziona con contenuti specifici dell'account.
È più facile scrivere e testare il codice che elabora i dati dei report in tempo reale.
Gli account di test non pubblicano annunci, pertanto i bug di programmazione
non influiranno sulle tue campagne pubblicate.
Funziona con i token sviluppatore con livello di accesso per il test.
Svantaggi
Un bug di programmazione nella fase di sviluppo potrebbe influire sulla pubblicazione delle campagne attive, causando problemi come scarso rendimento della campagna, pubblicazione errata o perdite finanziarie.
Il token sviluppatore deve avere almeno il livello di accesso di base per
per effettuare chiamate API.
Devi ricostruire le campagne all'interno degli account di test per testare il codice
che funziona in base a contenuti specifici dell'account.
Poiché gli account di test non pubblicano annunci, le funzionalità correlate alla pubblicazione live, come le statistiche dei report, gli errori di violazione delle norme o l'elaborazione
delle importazioni delle conversioni offline non sono supportate, il che rende difficile testare queste
funzionalità.
Ti consigliamo di utilizzare un account di test durante lo sviluppo dell'applicazione, se possibile. Per le istruzioni, vedi Creare account e campagne di test.
Un'alternativa è configurare un account di produzione con un budget dell'account basso, ad esempio 1 € al giorno, esplicitamente per testare le funzionalità non supportate da un account di test.
Scelta del set di funzionalità
Quando scegli un account per effettuare chiamate API, un'ulteriore considerazione è
l'elenco delle funzionalità che vuoi utilizzare con l'API. Anche se scegli di utilizzare
un account di produzione, alcune funzionalità sono specifiche dell'account, ad esempio:
Per le funzionalità di fatturazione, devi disporre di un account con fatturazione mensile.
Alcune nuove funzionalità dell'account potrebbero essere limitate dalle liste consentite.
Prima di finalizzare l'account per effettuare chiamate API, consulta la
documentazione della funzionalità specifica per assicurarti che non
siano presenti ulteriori limitazioni.
Identificare l'ID cliente di accesso e l'ID cliente
Per effettuare una chiamata API a un cliente Google Ads, devi concedere l'accesso e
le autorizzazioni appropriate al tuo service account per l'account cliente
direttamente o tramite un account amministratore collegato. Per farlo, devi disporre
dell'accesso amministrativo all'account cliente.
Per iniziare, accedi al tuo account Google Ads come amministratore. In alcuni casi,
potresti avere più di un account cliente tra cui scegliere. L'account che
selezioni stabilisce l'ID cliente di accesso, che è un'intestazione obbligatoria per alcune
chiamate API.
Dopo aver identificato il cliente Google Ads a cui effettuare chiamate API, prendi nota dei
seguenti dettagli:
L'ID cliente a 10 cifre dell'account cliente a cui prevedi di effettuare
chiamate API. A volte è chiamato cliente operativo.
L'ID cliente di accesso a 10 cifre dell'account cliente a cui hai eseguito l'accesso.
Se hai eseguito l'accesso al cliente operativo, l'ID cliente di accesso è lo stesso dell'ID cliente. Se hai eseguito l'accesso a un account amministratore del cliente operativo, l'ID cliente di accesso è l'ID cliente dell'account amministratore.
Concedi l'accesso al service account
Dopo aver eseguito l'accesso al tuo account Google Ads come amministratore, vai ad
Amministrazione > Accesso e sicurezza.
Fai clic sul pulsante + nella scheda Utenti.
Digita l'indirizzo email del service account nella casella di input Email. Seleziona
il livello di accesso all'account appropriato e fai clic sul pulsante Aggiungi account. Tieni presente che il livello di accesso Email non è supportato per i service account.
All'account di servizio viene concesso l'accesso.
Per impostazione predefinita, non puoi concedere l'accesso amministratore a un service account. Se le tue
chiamate API richiedono l'accesso amministrativo, puoi eseguire l'upgrade dell'accesso come segue.
Fai clic sulla freccia menu a discesa accanto al livello di accesso dell'account di servizio
nella colonna Livello di accesso.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
