REST Resource: locations.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.

Methoden

create

Lädt den angegebenen Nutzer ein, Administrator für den angegebenen Standort zu werden.

delete

Der angegebene Administrator wird als Administrator des angegebenen Standorts entfernt.

list

Listet alle Administratoren für den angegebenen Standort auf.

patch

Aktualisiert den Administrator für den angegebenen Standort.