REST Resource: accounts.admins

Ressource: Admin

Administrator eines Kontos oder 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 das folgende Format: accounts/{account_id}/admins/{admin_id}

Für Standortadministratoren hat sie das folgende 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 durch den Administrator festgelegt werden.

account

string

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

Wenn sowohl dieses Feld als auch admin in 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

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 in der Benutzeroberfläche als „Eigentümer“ angezeigt).
MANAGER Der Administrator hat Verwaltungszugriff.
SITE_MANAGER Der Administrator kann Seiten sozialer Netzwerke (Google+) verwalten. Auf der Benutzeroberfläche wird „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

Der angegebene Administrator wird aus dem angegebenen Konto entfernt.

list

Listet die Administratoren für das angegebene Konto auf.

patch

Aktualisiert den Administrator für den angegebenen Kontoadministrator.