Nutzerzugriff verwalten

Als Administrator können Sie die Zugriffsebenen und Rollen von Nutzern für Ihre Google Ads-Konten verwalten. Mit der Google Ads API können Sie Nutzerrollen abrufen und aktualisieren, Nutzereinladungen senden und den Nutzerzugriff auf ein Konto beenden. Weitere Informationen zu Zugriffsebenen für Konten.

Zum Verwalten des Nutzerzugriffs 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. Weitere Informationen finden Sie unter 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. Beim Ändern einer Nutzerrolle müssen Sie Folgendes angeben:

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

Nutzer entfernen

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

Genehmigung durch mehrere Parteien für Zugriffsänderungen

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

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