Genehmigungen durch mehrere Parteien in der Google Ads API

Donnerstag, 25. Juni 2026

Wir möchten die Sicherheit bei Google Ads-Konten verbessern, deshalb ist bei sensiblen Aktionen in der Google Ads API die Genehmigung durch mehrere Parteien erforderlich. Diese Änderung ist Teil einer umfassenderen Änderung in Google Ads, bei der für sensible Aktionen in Ihrem Google Ads-Konto die Genehmigung durch mehrere Parteien erforderlich ist. Diese wichtigen Sicherheitsupdates werden ab dem 27. Juli 2026 eingeführt und in den nächsten Wochen für alle Nutzerinnen und Nutzer aktiviert.

Was ändert sich?

Wenn diese Änderung wirksam wird, ändert sich das Verhalten der folgenden API-Aufrufe.

Nutzer einladen

Wenn Sie die Methode CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation verwenden, um einen neuen Nutzer zur Verwaltung eines Google Ads-Kontos einzuladen, wird in der Google Ads API jetzt geprüft, ob eine Genehmigung durch mehrere Parteien erforderlich ist. Wenn unsere Server feststellen, dass eine Überprüfung erforderlich ist, wird der Standardworkflow pausiert. Das System generiert dann nicht sofort eine CustomerUserAccessInvitation und sendet auch nicht die E‑Mail-Einladung. Stattdessen wird eine MultiPartyAuthReview-Ressource initiiert, deren Ressourcenname in der Antwort angegeben wird. Sobald die ausstehende Überprüfung von einem zweiten Kontoadministrator genehmigt wurde, wird die CustomerUserAccessInvitation erstellt und der eingeladene Nutzer erhält die E‑Mail. Für den Nutzer können keine neuen Einladungen erstellt werden, bis die ausstehende Überprüfung abgeschlossen ist.

Zugriff eines Nutzers aktualisieren oder beenden

Wenn Sie die Methode CustomerUserAccessService.MutateCustomerUserAccess verwenden, um die Berechtigungen eines Nutzers mit dem Update-Vorgang anzupassen oder den Zugriff mit dem Entfernungsvorgang zu widerrufen, wird in der Google Ads API jetzt geprüft, ob eine Genehmigung durch mehrere Parteien erforderlich ist. Wenn unsere Server feststellen, dass eine Überprüfung erforderlich ist, generiert die API eine MultiPartyAuthReview-Ressource im Status „Ausstehend“ und gibt ihren Ressourcennamen zurück. Ihre angeforderten Änderungen bleiben ausstehend und werden erst wirksam, wenn sie entsprechend durch mehrere Parteien genehmigt wurden. Die zu überprüfende CustomerUserAccess kann erst geändert werden, wenn die ausstehende Überprüfung abgeschlossen ist.

Wie genehmige ich eine Genehmigungsanfrage durch mehrere Parteien?

Sie können einen ausstehenden MultiPartyAuthReview mit der Methode GoogleAdsService.Search oder GoogleAdsService.SearchStream und der folgenden GAQL-Abfrage abrufen. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Eine ausstehende MultiPartyAuthReview-Anfrage kann mit einer MultiPartyAuthReviewService.ResolveMultiPartyAuthReview-API-Anfrage genehmigt oder abgelehnt werden. Die Überprüfung muss von einem zweiten Administrator durchgeführt werden, der die ursprüngliche Anfrage nicht erstellt hat. Dies kann entweder eine Person oder ein Dienstkonto mit Administratorberechtigungen sein. Die ausstehende Überprüfung kann vom ursprünglichen Antragsteller widerrufen werden.

Was muss ich tun?

Wenn Ihre Anwendung diese Methoden verwendet, müssen Sie sie vor dem 27. Juli 2026 aktualisieren, damit sie Workflows mit Genehmigung durch mehrere Parteien verarbeiten kann. Die Genehmigung durch mehrere Parteien wird bei allen Hauptversionen der API unterstützt (Version 24.2, 23.3, 22.2 und 21.2). Wenn Sie eine offizielle Clientbibliothek verwenden, laden Sie die aktuelle Version herunter. In den unten genannten Leitfäden finden Sie weitere Informationen zu den Änderungen:

Wenn Sie Fragen zu dieser Änderung haben oder sich darüber austauschen möchten, können Sie sich auf dem Discord-Server Google Advertising and Measurement Community an uns wenden. Bei technischen Supportproblemen wenden Sie sich bitte an https://support.google.com/google-ads/contact/google_ads_api.

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

Labels: authorization, google-ads-api