In der My Business Account Management API werden die Verwalter von Unternehmenskonten und Standorten als Administratoren bezeichnet. Informationen dazu, wie Administratoren Konten und Standorte verwalten können, finden Sie unter Konten und unter Standorte in großem Umfang verwalten.
Administratoren für Konten und Standorte werden durch die folgenden Ressourcen repräsentiert:
Die Ressourcenpfade für Administratoren sind:
accounts/{accountId}/admins/{adminId} locations/{locationId}/admins/{adminId}Sie können folgende Vorgänge ausführen:
- Administratoren für ein Konto oder einen Standort abrufen
- Administratoren einem Konto oder Standort hinzufügen
- Administratoren aus einem Konto oder Standort entfernen
Administratoren für ein Konto oder einen Standort abrufen
Administratoren können für ein Konto oder einen Standort abgerufen werden.
So rufen Sie die Administratoren für ein Konto ab:
GET https://mybusiness.googleapis.com/v1/accounts/{accountId}/admins
So rufen Sie die Administratoren für einen Standort ab:
GET https://mybusinessaccountmanagement.googleapis.com/v1/locations/{locationId}/admins
Administratoren einem Konto oder Standort hinzufügen
Sie können einen Nutzer einladen, Administrator für ein Konto oder einen Standort zu werden. Seine E-Mail-Adresse muss einem Google-Konto zugewiesen werden. Wenn sich der eingeladene Nutzer mit seinem Google-Konto in Google Unternehmensprofil anmeldet, wird er aufgefordert, den Nutzungsbedingungen zuzustimmen, bevor er Änderungen vornehmen kann.
So laden Sie einen Nutzer als Administrator für ein Konto ein:
POST https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}/admins
So laden Sie einen Nutzer als Administrator für einen Standort ein:
POST https://mybusinessaccountmanagement.googleapis.com/v1/locations/{locationId}/admins { "role": "MANAGER", "adminName": "example@example.com" }
So laden Sie eine Standortgruppe als Administrator für einen Standort ein:
POST https://mybusinessaccountmanagement.googleapis.com/v1/locations/{locationId}/admins { "account": "LocationGroupID", "role": "MANAGER" }
Administratoren aus einem Konto oder Standort entfernen
Sie können Administratoren aus einem angegebenen Konto oder Standort entfernen.
So entfernen Sie einen Administrator aus einem Konto:
DELETE https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}/admins/{adminId}
So entfernen Sie einen Administrator aus einem Standort:
DELETE https://mybusinessaccountmanagement.googleapis.com/v1/accounts/locations/{locationId}/admins/{adminId}