Livelli di accesso gestiti dal cloud

Nota: Google sta accettando le candidature per questo programma. Registrati.

Questa funzionalità consente di gestire i livelli di accesso alle API tramite un'organizzazione Google Cloud, offrendo i seguenti vantaggi:

• Non è più necessario proteggere i token sviluppatore: l'accesso alle API viene gestito tramite l'organizzazione Google Cloud, quindi non devi più preoccuparti di proteggere i token sviluppatore o di divulgarli. Puoi saltare l'invio del token sviluppatore nelle chiamate API, anche se devi comunque inviare un token di accesso.

• Mantieni progetti separati della console API di Google per app diverse: qualsiasi progetto collegato all'organizzazione Google Cloud eredita il livello di accesso alle API dell'organizzazione. In questo modo, puoi creare più progetti della console API di Google nell'ambito di questa organizzazione per scopi quali la gestione granulare dei progetti, progetti separati per app diverse e più progetti della console API di Google per i membri del tuo team.

• Monitoraggio e gestione più precisi delle quote: puoi monitorare l'utilizzo delle API di singoli progetti o limitare l'utilizzo delle API.

Prerequisiti

• Un token sviluppatore approvato

  Per utilizzare questa opzione, devi già disporre di un token sviluppatore approvato. Puoi trovare un token sviluppatore esistente nel Centro API del tuo account amministratore Google Ads. Accedi, quindi vai ad Amministratore > Centro API. Nel Centro API, vai ad Accesso API > Token sviluppatore.

• Un'organizzazione Google Cloud

  L'API Google Ads associa il token sviluppatore a un'organizzazione Google Cloud e lo utilizza per determinare i livelli di accesso alle API. Esistono diversi modi per creare un'organizzazione Google Cloud.

  Scenario	Passaggi
  Sei un cliente Google Workspace o Google Cloud Identity esistente	È probabile che tu abbia già una risorsa dell'organizzazione. Puoi controllarla e crearne una, se necessario.
  Non utilizzi Google Workspace o Google Cloud Identity	Registrati alla versione senza costi di Google Cloud Identity. Poi crea la risorsa dell'organizzazione.
  Nessuna delle opzioni precedenti funziona per te	Spiega il tuo scenario quando ti registri al progetto pilota e chiedi a Google di creare una risorsa dell'organizzazione per te. Google sarà proprietaria e gestirà questa risorsa dell'organizzazione senza costi.

• Prepara i progetti della console API di Google per il programma pilota

  Devi preparare i progetti della console API di Google che utilizzi con l'API Google Ads per il programma pilota nel seguente modo:

  Scenario	Passaggi
  Hai già un'organizzazione Google Cloud o ne hai creata una nel passaggio precedente	Assicurati che tutti i progetti della console API di Google in cui hai attivato l' API Google Ads siano inclusi in questa organizzazione. In caso contrario, esegui la migrazione nell'organizzazione. Se sei un cliente Google Workspace o Google Cloud Identity esistente, è probabile che i progetti della console API di Google siano già inclusi nella tua organizzazione, quindi puoi saltare questo passaggio.
  Non hai un'organizzazione Google Cloud e non hai potuto crearne una in nel passaggio precedente	Assicurati di essere un utente amministratore sia nel tuo account amministratore dell'API Google Ads sia nel tuo progetto della console API di Google. Hai bisogno di questa autorizzazione per eseguire passaggi aggiuntivi dopo l'approvazione della tua domanda di partecipazione al programma pilota.

• Un indirizzo email di contatto API aggiornato

  Assicurati che l'indirizzo email di contatto dell'API Google Ads sia aggiornato. I dettagli di contatto dell'API sono elencati nella pagina Centro API del tuo account amministratore dell'API Google Ads. Accedi e vai a STRUMENTI E IMPOSTAZIONI > CONFIGURAZIONE > Centro API.

Registrati al programma pilota

Registrati al programma pilota. Il team di conformità di Google esaminerà la tua candidatura e invierà un'email al tuo indirizzo email di contatto dell'API con lo stato di approvazione e ulteriori dettagli.

Se hai chiesto a Google di creare un'organizzazione Google Cloud per te, sono previsti alcuni passaggi aggiuntivi:

1. Google creerà una risorsa dell'organizzazione Cloud di proprietà di Google per te. A tutti gli amministratori del tuo account amministratore dell'API Google Ads verrà concesso il ruolo roles/resourcemanager.projectCreator nella nuova organizzazione.

2. Google invierà un'email al tuo indirizzo email di contatto dell'API con i dettagli della risorsa dell'organizzazione appena creata.

3. Devi accedere al tuo account della console API di Google e seguire le istruzioni per spostare il progetto della console API di Google sotto la nuova organizzazione.

4. Rispondi all'email per comunicare a Google che i tuoi progetti sono stati spostati nella nuova organizzazione.

5. Il team di conformità di Google esaminerà la tua candidatura e invierà un'email al tuo indirizzo email di contatto dell'API con lo stato di approvazione e ulteriori dettagli.

Modifica le richieste API

Puoi modificare l'app per interrompere l'invio dell'intestazione developer-token quando effettui chiamate API. Questo passaggio è facoltativo, ma consigliato. Se partecipi al programma pilota, il server dell'API Google Ads ignora il developer-token se inviato come parte delle richieste API.

Java

Disponibile a breve.

.NET

Scarica e installa la versione 17.1.0 o successive della libreria .NET dell'API Google Ads.

Poi, modifica il codice come segue:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Disponibile a breve.

Python

Disponibile a breve.

Ruby

Disponibile a breve.

Perl

Disponibile a breve.

Client HTTP (REST)

Ometti l'intestazione developer-token nelle richieste HTTP:

curl -i -X POST https://googleads.googleapis.com/v24/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Domande frequenti

Ecco alcune domande frequenti sui livelli di accesso gestiti dal cloud.

Questa modifica significa che devo essere un cliente Google Workspace o Google Cloud per utilizzare l'API Google Ads?

No. Devi avere un' organizzazione Google Cloud, che può essere ottenuta in diversi modi. Questo requisito è simile a quello per cui oggi è necessario un progetto della console API di Google per utilizzare l'API Google Ads.

Devo modificare i miei livelli di accesso alle API. How can I do this?

Per il momento, devi continuare a utilizzare il Centro API per richiedere modifiche ai livelli di accesso alle API.

È previsto un periodo di inattività per l'attivazione di questo progetto pilota?

No, non esiste. Una volta approvata, l'API Google Ads inizierà automaticamente a utilizzare i livelli di accesso alle API a livello di organizzazione.

Quanto impegno richiede la partecipazione a questo progetto pilota?

Sono previste modifiche minime al codice. La maggior parte degli sviluppatori dovrebbe essere in grado di completare le modifiche all'app in meno di 30 minuti.

Mi verranno addebitati costi se attivo questo progetto pilota?

In generale, no, non ti verranno addebitati costi se attivi questo progetto pilota. L'API Google Ads viene offerta senza costi e Google non sta apportando modifiche al modello di prezzi dell'API Google Ads.

Di seguito sono riportati i possibili scenari per ottenere un'organizzazione Google Cloud:

1. Sei un cliente Google Workspace o Google Cloud Identity esistente:

   Ti verranno addebitati i costi come di consueto per l'utilizzo regolare di questi prodotti. Non ti verranno addebitati costi per la creazione di un'organizzazione Google Cloud allo scopo di partecipare a questo progetto pilota.

2. Hai creato un account della versione senza costi di Google Cloud Identity:

   Non ti verranno addebitati costi per la registrazione a un account della versione senza costi di Google Cloud Identity o per la creazione di un'organizzazione Google Cloud allo scopo di partecipare a questo progetto pilota.

3. Google ha creato una risorsa dell'organizzazione Cloud per te:

   Si tratta di una risorsa dell'organizzazione Cloud interna gestita da Google, quindi non ti verranno addebitati costi.

Ho più token sviluppatore per strumenti diversi. In che modo questo progetto pilota mi riguarda?

Questo caso d'uso non è supportato, quindi non potrai partecipare a questo progetto pilota.

Questa modifica influisce sulle autorizzazioni API esistenti per gli account che gestisco utilizzando l'API Google Ads?

No, questa modifica non influisce sulle autorizzazioni API esistenti per gli account Google Ads che gestisci utilizzando l'API Google Ads.

Ho attivato questo progetto pilota e ho un problema o un feedback. Come faccio a contattare l'assistenza?

Contatta il team dell'API Google Ads utilizzando la pagina dell'assistenza tecnica dell'API e spiega la natura del problema. Se possibile, includi dettagli come l'ID dell'organizzazione e i log di richieste e risposte.