Disaggregazione del consenso nelle API Google Ads

Giovedì 20 febbraio 2025

Cosa cambierà?
A partire dalla settimana del 1° maggio 2025, implementeremo la separazione del consenso per l'autenticazione utente OAuth per tutti i progetti Google Cloud creati prima del 2019. Se possiedi un'applicazione che utilizza un'API correlata a Google Ads tramite un progetto Google Cloud creato prima del 2019, potresti dover aggiornare l'applicazione per gestire il consenso dell'utente disaggregato prima del 1° maggio 2025.

Contesto
La separazione del consenso per il flusso di autenticazione utente OAuth consente agli utenti di personalizzare gli ambiti OAuth specifici per cui vogliono autorizzare la tua applicazione, anziché un approccio tutto o niente. Questa funzionalità è attiva in tutti i progetti della console Google Cloud creati a partire dal 2019, mentre è disattivata in tutti i progetti creati prima del 2019.

Chi è interessato da questa modifica?
Questa modifica ti riguarderà se sono soddisfatte TUTTE le seguenti condizioni:

1. La tua applicazione API utilizza un progetto della console Google Cloud creato prima del 2019.
2. La tua applicazione implementa il flusso di consenso dell'utente OAuth 2.0, un workflow di autenticazione in cui l'utente accede con il proprio Account Google e concede una o più autorizzazioni richieste dalla tua applicazione.
3. La tua applicazione utilizza più di un'API di Google e una delle API è un'API correlata a Google Ads elencata di seguito.

Chi non è interessato da questa modifica?

• Token di aggiornamento esistenti: questa modifica non influisce sulle autenticazioni utente già in atto. I token di aggiornamento esistenti continueranno a funzionare senza modifiche o nuova autenticazione.
• Applicazioni con un solo ambito: se la tua applicazione utilizza un solo ambito delle API di Google, non è interessata da questa modifica, poiché non esistono più ambiti OAuth da separare.
• Applicazioni per un singolo utente/Applicazioni autenticate manualmente: la tua applicazione non ha un flusso di autenticazione utente OAuth esplicito implementato. Invece, utilizzi uno script di autenticazione manuale come GenerateUserCredentials, gcloud CLI o OAuth Playground per autenticare l'utente e poi utilizzi queste credenziali per un lungo periodo di tempo. Poiché selezioni tutti gli ambiti richiesti dalla tua applicazione durante l'autenticazione, la tua applicazione non è interessata da questa modifica.
• Service account: se la tua applicazione utilizza un service account per autenticare le chiamate API, questa modifica non ti riguarderà.

Cosa devo fare?
Devi assicurarti che la tua applicazione possa gestire il consenso parziale dell'utente. Per farlo:

1. Richiedi l'elenco degli ambiti OAuth per i quali l'utente ha dato il consenso includendo il parametro include_granted_scopes nel tuo flusso OAuth.
2. Esamina l'elenco effettivo degli ambiti OAuth per cui l'utente ha dato il consenso nella risposta OAuth.
3. Implementa l'autorizzazione incrementale nella tua applicazione.

Consulta la nostra guida al consenso granulare di OAuth per scoprire i requisiti e le best practice per la gestione del consenso granulare.

Come faccio a testare questa funzionalità?
Esistono due modi per testare questa funzionalità:

1. Crea un nuovo progetto Google Cloud: i nuovi progetti Google Cloud hanno abilitato la separazione del consenso OAuth. Puoi quindi creare un nuovo progetto Google Cloud e utilizzarlo per testare la tua applicazione.
2. Attiva la separazione del consenso nel tuo progetto esistente: puoi impostare il parametro enable_granular_consent su true nella richiesta di autorizzazione OAuth.

Quali ambiti API sono interessati?
Le seguenti API relative ad Ads sono interessate da questa modifica.

API	Ambito OAuth
API Google Ads	https://adwords.google.com/api/adwords
API Google Ad Manager (API SOAP, beta)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
API Bid Manager	https://www.googleapis.com/auth/doubleclickbidmanager
API Content for Shopping	https://www.googleapis.com/auth/content
API di Display & Video 360	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
API AdMob	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
API AdSense per le piattaforme	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
API Google Analytics	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
API Campaign Manager 360	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
API Search Ads 360	https://www.googleapis.com/auth/doubleclicksearch
API Google Tag Manager	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
API Real-time Bidding	https://www.googleapis.com/auth/realtime-bidding
API Marketplace di Authorized Buyers	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

Come ricevere assistenza
Se hai domande o hai bisogno di aiuto, contatta il team di assistenza dell'API corrispondente.

 - Anash P. Oommen, team API Google Ads

Etichette: authentication, oauth