Entbündelung der Einwilligung in Google Ads APIs

Donnerstag, 20. Februar 2025

Was ändert sich?
Ab der Woche vom 1. Mai 2025 führen wir die Entbündelung der Einwilligung für die OAuth-Nutzerauthentifizierung für alle Google Cloud-Projekte ein, die vor 2019 erstellt wurden. Wenn Sie eine Anwendung besitzen, die eine werbebezogene API über ein Google Cloud-Projekt verwendet, das vor 2019 erstellt wurde, müssen Sie Ihre Anwendung möglicherweise vor dem 1. Mai 2025 aktualisieren, um die ungebündelte Nutzereinwilligung zu verarbeiten.

Hintergrund
Durch die Entbündelung der Einwilligung für den OAuth-Nutzerauthentifizierungsablauf können Nutzer anstelle eines Alles-oder-Nichts-Ansatzes individuell festlegen, für welche OAuth-Bereiche sie Ihre Anwendung autorisieren möchten. Bei allen Google Cloud Console-Projekten, die seit 2019 erstellt wurden, ist diese Funktion aktiviert. Bei allen Projekten, die vor 2019 erstellt wurden, ist sie deaktiviert.

Wer ist von dieser Änderung betroffen?
Sie sind von dieser Änderung betroffen, wenn ALLE folgenden Bedingungen erfüllt sind:

  1. Ihre API-Anwendung verwendet ein Google Cloud Console-Projekt, das vor 2019 erstellt wurde.
  2. Ihre Anwendung implementiert den OAuth 2.0-Ablauf für die Nutzereinwilligung – einen Authentifizierungs-Workflow, bei dem sich der Nutzer mit seinem Google-Konto anmeldet und eine oder mehrere Berechtigungen erteilt, die Ihre Anwendung anfordert.
  3. Ihre Anwendung verwendet mehr als eine Google API und eine der APIs ist eine der unten aufgeführten werbebezogenen APIs.

Wer ist von dieser Änderung nicht betroffen?

  • Vorhandene Aktualisierungstokens: Diese Änderung hat keine Auswirkungen auf bereits vorhandene Nutzerauthentifizierungen. Ihre vorhandenen Aktualisierungstokens funktionieren weiterhin ohne Änderungen oder erneute Authentifizierung.
  • Anwendungen mit einem einzigen Bereich: Wenn Ihre Anwendung nur einen Google API-Bereich verwendet, ist sie von dieser Änderung nicht betroffen, da es keine mehreren OAuth-Bereiche gibt, die entbündelt werden müssen.
  • Anwendungen für einzelne Nutzer / manuell authentifizierte Anwendungen: In Ihrer Anwendung ist kein expliziter OAuth-Nutzerauthentifizierungsablauf implementiert. Stattdessen verwenden Sie ein manuelles Authentifizierungsskript wie GenerateUserCredentials, die gcloud CLI oder OAuth Playground, um den Nutzer zu authentifizieren, und verwenden diese Anmeldedaten dann über einen längeren Zeitraum. Da Sie bei der Authentifizierung alle Bereiche auswählen, die Ihre Anwendung benötigt, ist Ihre Anwendung von dieser Änderung nicht betroffen.
  • Dienstkonten: Wenn Ihre Anwendung ein Dienstkonto zur Authentifizierung Ihrer API-Aufrufe verwendet, sind Sie von dieser Änderung nicht betroffen.

Was muss ich tun?
Sie müssen dafür sorgen, dass Ihre Anwendung mit einer teilweisen Nutzereinwilligung umgehen kann. Hierzu klicken Sie einfach

  1. Fordern Sie die Liste der OAuth-Bereiche an, denen der Nutzer zugestimmt hat, indem Sie den Parameter include_granted_scopes in Ihren OAuth-Ablauf einfügen.
  2. Prüfen Sie die tatsächliche Liste der OAuth-Bereiche, denen der Nutzer in der OAuth-Antwort zugestimmt hat.
  3. Implementieren Sie die inkrementelle Autorisierung in Ihrer Anwendung.

In unserem Leitfaden zur detaillierten Einwilligung finden Sie Informationen zu den Anforderungen und Best Practices für den Umgang mit der detaillierten Einwilligung.

Wie kann ich diese Funktion testen?
Es gibt zwei Möglichkeiten, diese Funktion zu testen:

  1. Neues Google Cloud-Projekt erstellen: Bei neuen Google Cloud-Projekten ist die Entbündelung der OAuth-Zustimmung aktiviert. Sie können also ein neues Google Cloud-Projekt erstellen und es zum Testen Ihrer Anwendung verwenden.
  2. Entbündelung der Einwilligung in Ihrem bestehenden Projekt aktivieren: Sie können den Parameter enable_granular_consent in Ihrer OAuth-Autorisierungsanfrage auf „true“ setzen.

Welche API-Bereiche sind betroffen?
Die folgenden APIs im Zusammenhang mit Anzeigen sind von dieser Änderung betroffen.

API OAuth-Bereich
Google Ads API https://adwords.google.com/api/adwords
Google Ad Manager API (SOAP API, Beta) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
Bid Manager API https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
Display & Video 360 API https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
AdMob API https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
Google Analytics API 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
Campaign Manager 360 API https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API 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
Real-time Bidding API https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

Hilfe erhalten
Wenn Sie Fragen haben oder Hilfe benötigen, wenden Sie sich an das Supportteam der jeweiligen API.

Porträt des Autors – , Google Ads API-Team

Labels: authentication, oauth