Livelli di accesso gestiti dal cloud

Nota: Google sta accettando richieste di adesione a questo programma. Registrati.

Questa funzionalità consente di gestire i livelli di accesso alle API da 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, ma devi comunque inviare un token di accesso.

• Gestisci progetti della Console API di Google separati per app diverse: qualunque progetto collegato all'organizzazione Google Cloud eredita il livello di accesso all'API dell'organizzazione. In questo modo puoi creare più progetti della console API di Google in questa organizzazione per scopi quali gestione granulare dei progetti, progetti separati per app diverse e più progetti della console API di Google per i membri del team.

• Monitoraggio e gestione più granulari delle quote: puoi monitorare l'utilizzo dell'API dei singoli progetti o limitare l'utilizzo dell'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, poi vai ad Amministrazione > Centro API. Nel Centro API, vai ad Accesso API > Token sviluppatore.

• Un'organizzazione Google Cloud

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

  Scenario	Passaggi
  Sei già cliente di Google Workspace o Cloud Identity di Google	È probabile che tu possieda già una risorsa organizzazione. Se necessario, puoi controllare e crearne uno.
  Non utilizzi Google Workspace o Google Cloud Identity	Registrati alla versione senza costi di Google Cloud Identity. Quindi, crea la risorsa dell'organizzazione.
  Nessuna delle opzioni precedenti funziona	Spiega il tuo scenario quando ti registri al progetto pilota e richiedi a Google di creare una risorsa dell'organizzazione per te. Google sarà proprietaria e gestirà questa risorsa dell'organizzazione senza costi.

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

  Per il programma pilota, devi preparare i progetti della console API di Google che utilizzi con l'API Google Ads come segue:

  Scenario	Passaggi
  Possiedi 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 rientrino in questa organizzazione. In caso contrario, esegui la migrazione all'interno dell'organizzazione. Se sei già cliente Google Workspace o Cloud Identity di Google, è probabile che i progetti della console API di Google siano già nella tua organizzazione, quindi puoi saltare questo passaggio.
  Non possiedi un'organizzazione Google Cloud e non hai potuto crearne una nel passaggio precedente	Assicurati di essere un utente amministratore sia nell'account amministratore dell'API Google Ads sia nel progetto della Console API di Google. Ti serve questa autorizzazione per eseguire passaggi aggiuntivi dopo l'approvazione della tua richiesta di progetto pilota.

• Un'email di contatto dell'API aggiornata

  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, poi vai a STRUMENTI & Impostazioni > CONFIGURAZIONE > Centro API.

Registrarsi al programma pilota

Registrati al programma pilota. Il team di conformità di Google esaminerà quindi la tua richiesta e invierà un'email all'indirizzo email di contatto dell'API con lo stato dell'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 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 nell'organizzazione appena creata.

2. Google invierà un'email all'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 nella 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 richiesta e invierà un'email all'indirizzo email di contatto dell'API con lo stato dell'approvazione e ulteriori dettagli.

Modificare le richieste API

Puoi modificare la tua 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 valore developer-token se inviato come parte delle richieste API.

Java

Disponibile a breve.

.NET

Scarica e installa la versione 17.1.0 o successiva 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/v18/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

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

No. Devi disporre di un'organizzazione Google Cloud, che puoi ottenere in diversi modi. Questo requisito è simile al fatto che per utilizzare l'API Google Ads oggi è necessario un progetto della console API di Google.

Devo modificare i miei livelli di accesso API. come posso farlo?"

Per il momento, continua a utilizzare il Centro API per richiedere eventuali modifiche ai livelli di accesso all'API.

È previsto un tempo di riposo 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 all'API a livello di organizzazione.

Quanto è impegnativo partecipare a questo progetto pilota?

Dovresti notare modifiche minime al codice. La maggior parte degli sviluppatori dovrebbe essere in grado di completare le modifiche alla propria app in meno di 30 minuti.

Mi verrà addebitato un importo se partecipo a questo progetto pilota?

In genere, no, non ti verrà addebitato alcun importo se attivi questo programma pilota. L'API Google Ads viene offerta senza costi e Google non apporterà modifiche al suo modello di prezzi.

I possibili scenari per ottenere un'organizzazione Google Cloud sono i seguenti:

1. Sei già un cliente Google Workspace o Google Cloud Identity:

   Ti verrà addebitato l'importo regolare per l'utilizzo regolare di questi prodotti. Non ti verrà addebitato alcun costo per la creazione di un'organizzazione Google Cloud ai fini della partecipazione a questo progetto pilota.

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

   Non ti verrà addebitato alcun importo per la registrazione all'account Google Cloud Identity Free Edition o per la creazione di un'organizzazione Google Cloud allo scopo di partecipare a questo progetto pilota.

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

   Si tratta di una risorsa dell'organizzazione Cloud interna gestita da Google, pertanto non ti verrà addebitato alcun costo.

Ho più token sviluppatore per strumenti diversi. Che cosa comporta questo progetto pilota per me?

Questo caso d'uso non è supportato, pertanto non potrai partecipare al progetto pilota.

Questo 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 di assistenza tecnica dell'API e spiega la natura del problema. Se possibile, includi dettagli come l'ID della tua organizzazione e i log di richiesta e risposta.