Nutzerzugriff verwalten

Als Administrator können Sie die Zugriffsebenen und Rollen von Nutzern für Ihre Google Ads-Konten verwalten. Über die Google Ads API können Sie Nutzerrollen abrufen und aktualisieren, Einladungen an Nutzer senden und den Zugriff von Nutzern auf ein Konto beenden. Weitere Informationen zu den Zugriffsebenen für Konten

Damit der Nutzerzugriff verwaltet werden kann, muss der aufrufende Nutzer oder das Dienstkonto ADMIN-Zugriff auf das Zielkonto haben.

Nutzer einladen

Wenn Sie einen neuen Nutzer einladen möchten, auf ein Konto zuzugreifen, verwenden Sie die CustomerUserAccessInvitationService, um eine Einladung zu erstellen und zu senden (siehe Einladungen für den Nutzerzugriff verwalten). Sobald der Nutzer die Einladung annimmt, wird er unter CustomerUserAccess als bestätigter Nutzer angezeigt.

Nutzerrollen abrufen

Sie können die Liste der Nutzer mit Zugriff auf ein Konto abrufen, indem Sie eine Google Ads Query Language-Anweisung erstellen, um alle CustomerUserAccess-Entitäten abzufragen, die mit einer Kundennummer verknüpft sind. Hier ist eine typische Abfrage:

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

Nutzerrollen ändern

Wenn Sie eine vorhandene Nutzerrolle aktualisieren möchten, rufen Sie CustomerUserAccessService.MutateCustomerUserAccess mit dem Vorgang UPDATE auf. Wenn Sie eine Nutzerrolle ändern, müssen Sie Folgendes angeben:

• Der Ressourcenname der zu ändernden CustomerUserAccess-Entität im Format customers/{customer_id}/customerUserAccesses/{user_id}.
• Die neue Nutzerrolle in access_role.
• Ein update_mask (FieldMask), der access_role angibt.

Nutzer entfernen

Wenn Sie den Zugriff eines Nutzers auf das Konto beenden möchten, rufen Sie CustomerUserAccessService.MutateCustomerUserAccess mit einem REMOVE-Vorgang auf und geben Sie den Ressourcennamen (customers/{customer_id}/customerUserAccesses/{user_id}) an.

Genehmigung durch mehrere Parteien für Zugriffsänderungen

Wenn beim Aufrufen von MutateCustomerUserAccess eine Genehmigungsanfrage durch mehrere Parteien ausgelöst wird:

• Das Objekt MutateCustomerUserAccessResult (im Feld result von MutateCustomerUserAccessResponse) füllt das Feld multi_party_auth_review mit dem Ressourcennamen der ausstehenden Überprüfung, die genehmigt werden muss.
• Das Feld resource_name in MutateCustomerUserAccessResult wird nicht ausgefüllt.
• Die ausstehende Überprüfungsanfrage kann von einem zweiten Administrator mit der Methode MultiPartyAuthReviewService.ResolveMultiPartyAuthReview genehmigt oder abgelehnt werden. Weitere Informationen finden Sie im Leitfaden zur Genehmigung durch mehrere Parteien.