REST Resource: accounts.admins

Ressource: Admin

Ein Administrator eines Kontos oder eines Standorts.

JSON-Darstellung
{
  "name": string,
  "admin": string,
  "account": string,
  "role": enum (AdminRole),
  "pendingInvitation": boolean
}
Felder
name

string

Nicht veränderbar. Der Ressourcenname. Für Kontoadministratoren hat sie das Format accounts/{account_id}/admins/{admin_id}.

Für Standortadministratoren hat sie das Format locations/{locationId}/admins/{admin_id}.

Dieses Feld wird ignoriert, wenn es beim Erstellen des Administrators festgelegt wird.

admin

string

Optional. Der Name des Administrators. Bei der ersten Einladung ist dies die E-Mail-Adresse der eingeladenen Person. Bei GET-Aufrufen wird die E-Mail-Adresse des Nutzers zurückgegeben, wenn die Einladung noch aussteht. Andernfalls enthält er den Vor- und Nachnamen des Nutzers.

Dieses Feld muss nur beim Erstellen des Administrators festgelegt werden.

account

string

Nicht veränderbar. Der Name der Kontoressource, auf die sich dieser Administrator bezieht. Wird beim Aufrufen von „locations.admins.create“ verwendet, um eine Standortgruppe als Administrator einzuladen.

Wenn sowohl dieses Feld als auch admin für CREATE-Anfragen festgelegt sind, hat dieses Feld Vorrang und die E-Mail-Adresse in admin wird ignoriert.

Format: accounts/{account}.

role

enum (AdminRole)

Erforderlich. Gibt die Rolle an, die dieser Administrator mit dem angegebenen Konto oder Standort verwendet.

pendingInvitation

boolean

Nur Ausgabe. Gibt an, ob dieser Administrator eine ausstehende Einladung für die angegebene Ressource hat.

AdminRole

Gibt die Zugriffsebene eines Administrators an. Weitere Informationen finden Sie in diesem Hilfeartikel.

Enums
ADMIN_ROLE_UNSPECIFIED Nicht angegeben.
PRIMARY_OWNER Der Administrator hat Zugriff auf Inhaberebene und ist der primäre Inhaber. (Wird in der Benutzeroberfläche als „Primärer Inhaber“ angezeigt.)
OWNER Der Administrator hat Zugriff auf Inhaberebene. (Wird auf der Benutzeroberfläche als „Owner“ angezeigt).
MANAGER Der Administrator hat Verwaltungszugriff.
SITE_MANAGER Der Administrator kann Seiten sozialer Netzwerke (Google+) verwalten. (Wird auf der Benutzeroberfläche als „Site Manager“ angezeigt). Mit dieser API kann kein Kontoadministrator mit der Rolle SITE_MANAGER erstellt werden.

Methoden

create

Lädt den angegebenen Nutzer ein, Administrator für das angegebene Konto zu werden.

delete

Entfernt den angegebenen Administrator aus dem angegebenen Konto.

list

Listet die Administratoren für das angegebene Konto auf.

patch

Aktualisiert den Administrator für den angegebenen Kontoadministrator.