Livelli di accesso gestiti dal cloud

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

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

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

• Mantieni progetti separati nella console API di Google per app diverse: Qualsiasi progetto collegato all'organizzazione Google Cloud eredita il livello di accesso 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 della quota: 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, poi vai ad Amministratore > Centro API. Nel Centro API, vai a 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 un cliente Google Workspace o Google Cloud Identity esistente	È probabile che tu abbia già una risorsa Organizzazione. Puoi controllare e crearne uno 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 è adatta al tuo caso	Spiega il tuo scenario quando ti registri per il progetto pilota e chiedi a Google di creare una risorsa dell'organizzazione per te. Google possiederà 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 abilitato l'API Google Ads si trovino in questa organizzazione. In caso contrario, esegui la migrazione nell'organizzazione. Se sei già cliente di Google Workspace o Google Cloud Identity, è probabile che i progetti della console API di Google siano già associati alla 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 dell'account amministratore API Google Ads sia del progetto della console API di Google. Hai bisogno di questa autorizzazione per eseguire passaggi aggiuntivi dopo l'approvazione della tua applicazione pilota.

• Un'email di contatto API aggiornata

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

Registrarsi al programma pilota

Registrati al programma pilota. Il team di conformità di Google esaminerà la tua richiesta e invierà un'email all'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 organizzazione Cloud di proprietà di Google. A tutti gli amministratori del tuo account amministratore API Google Ads verrà concesso il ruolo roles/resourcemanager.projectCreator nella nuova organizzazione.

2. Google invierà un'email all'indirizzo email di contatto 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 di 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 è un passaggio facoltativo, ma consigliato. Se partecipi al programma pilot, il server dell'API Google Ads ignora 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 Google Ads API .NET.

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/v20/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 disporre di 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 API. come posso farlo?"

Per il momento, continua a utilizzare API Center per richiedere modifiche ai livelli di accesso API.

L'attivazione di questo progetto pilota comporta tempi di inattività?

No, non esiste. Una volta approvati, l'API Google Ads inizierà a utilizzare automaticamente i livelli di accesso 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 alla propria app in meno di 30 minuti.

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

In generale, no, non ti verrà addebitato alcun importo se partecipi a questo progetto pilota. L'API Google Ads è offerta senza costi e Google non sta apportando modifiche al modello di prezzi dell'API Google Ads.

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

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

   Ti verrà addebitato l'utilizzo regolare di questi prodotti come di consueto. 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 Google Cloud Identity Free Edition:

   Non ti verrà addebitato alcun costo quando ti registri per un account Google Cloud Identity Free Edition o quando crei 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, quindi non ti verrà addebitato alcun costo.

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 operazione influisce su eventuali 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 per l'API e spiega la natura del problema. Se possibile, includi dettagli come l'ID organizzazione e i log di richieste e risposte.