Livelli di accesso gestiti nel cloud

Nota: Google accetta candidati per questo programma. Registrati.

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

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

• Gestisci progetti della console API di Google separati per app diverse: Qualsiasi progetto collegato all'organizzazione Google Cloud eredita l'API livello di accesso dell'organizzazione. In questo modo è possibile creare più Progetti della console API di Google in questa organizzazione, ad esempio una gestione dei progetti granulare, progetti separati per diverse app più progetti nella console API di Google per i membri del tuo team.

• Monitoraggio e gestione delle quote più efficaci: puoi monitorare l'API. dei singoli progetti o il limite di utilizzo dell'API.

Prerequisiti

• Un token sviluppatore approvato

  Dovresti avere già un token sviluppatore approvato per utilizzare questa opzione. Tu trovare un token sviluppatore esistente nella pagina Centro API del tuo Account amministratore Google Ads. Accedi, quindi vai a STRUMENTI E IMPOSTAZIONI > IMPOSTAZIONE > Centro API.

• Un'organizzazione Google Cloud

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

  Scenario	Passaggi
  Sei un account Google Workspace o Google Cloud Identità del cliente	È probabile che tu possieda già una risorsa dell'organizzazione. Puoi Controlla e crea uno, se necessario.
  Non usi Google Workspace oppure Google Cloud Identity	Registrati per la versione senza costi di Google Cloud Identity. Quindi per creare la risorsa dell'organizzazione.
  Nessuna delle opzioni precedenti è adatta a te	Spiega il tuo scenario quando firma per il progetto pilota e chiedere a Google di creare una risorsa dell'organizzazione per te. Google possiederà e gestirà questa risorsa dell'organizzazione senza ricarica.

• Preparare 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:

  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 abilitato L'API Google Ads è gestita da questa organizzazione. In caso contrario, esegui la migrazione nell'organizzazione. Se sei un account Google Workspace o Google Cloud Identity, è probabile che i progetti della Console API di Google fanno già parte della tua organizzazione, quindi puoi saltare questo passaggio.
  Non possiedi un'organizzazione Google Cloud e non puoi crearne una in il passaggio precedente	Assicurati di essere entrambi un utente amministratore nel gestore dell'API Google Ads e il progetto della console API di Google. Devi disporre di questa autorizzazione per eseguire passaggi aggiuntivi dopo l'approvazione della richiesta di partecipazione al progetto pilota.

• Un'email di contatto aggiornata per l'API

  Assicurati che l'email di contatto dell'API Google Ads sia aggiornata. Il tuo contatto API sono disponibili nella pagina Centro API del tuo account amministratore API Google Ads. Accedi, quindi vai a STRUMENTI e IMPOSTAZIONI > IMPOSTAZIONE > Centro API.

Registrati al programma pilota

Registrati al programma pilota. Il team di conformità di Google Quindi, esamina la tua richiesta e invia tramite email il tuo indirizzo email di contatto API con stato di approvazione e ulteriori dettagli.

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

1. Google creerà per te una risorsa organizzazione Cloud di proprietà di Google. Tutti agli amministratori del tuo account amministratore dell'API Google Ads verrà concesso il ruolo roles/resourcemanager.projectCreator nel nuovo account creato dell'organizzazione.

2. Google invierà un'email all'indirizzo email di contatto dell'API con i dettagli del 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 in la nuova organizzazione.

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

5. Il team di conformità di Google esaminerà la tua richiesta e invierà l'API via email l'indirizzo email di contatto con lo stato di approvazione e ulteriori dettagli.

Modificare le richieste API

Puoi modificare l'app per interrompere l'invio dell'intestazione developer-token quando di effettuare chiamate API. Questo passaggio è facoltativo, ma consigliato. Se sei nella programma pilota, 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 una versione successiva di Google Ads API .NET libreria di Google.

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/v17/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. Hai bisogno di un'organizzazione Google Cloud, che può essere ottenuta in molte diverse. Questo requisito è simile a quello che ti serve Progetto della console API di Google per utilizzare l'API Google Ads oggi stesso.

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

Per il momento devi continuare a utilizzare il Centro API per richiedere eventuali modifiche al Livelli di accesso API.

Ci sono tempi di inattività per l'iscrizione a questo progetto pilota?

No, non esiste. L'API Google Ads inizierà automaticamente a utilizzare a livello di organizzazione dopo l'approvazione.

Quanto impegno richiede la partecipazione a questo progetto pilota?

Sono previste minime modifiche 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 accedo a questo progetto pilota?

In generale, no, non ti verrà addebitato alcun costo se accetti di partecipare a questo progetto pilota. L'API Google Ads è offerto senza costi aggiuntivi e Google non apporta alcuna modifica all'API Google Ads un modello di determinazione del prezzo.

Gli scenari possibili per ottenere un'organizzazione Google Cloud sono i seguenti: che segue:

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

   Come di consueto, ti verrà addebitato il costo dell'utilizzo regolare di questi prodotti. Tu non ti verrà addebitato alcun costo per la creazione di un'organizzazione Google Cloud ai fini che partecipano a questo progetto pilota.

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

   Non ti verrà addebitato alcun costo quando ti registri alla versione senza costi di Google Cloud Identity o per creare un'organizzazione Google Cloud allo scopo di che partecipano a questo progetto pilota.

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

   Questa è una risorsa dell'organizzazione Cloud interna gestita da Google, per cui di conseguenza non ti verrà addebitato alcun costo.

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

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

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

No, questa modifica non influisce sulle autorizzazioni API esistenti in Google Ads che gestisci con l'API Google Ads.

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

Contatta il team per l'API Google Ads utilizzando l'assistenza tecnica per l'API pagina e spiegare la natura del problema. Includi come l'ID organizzazione e i log di richieste e risposte, possibile.