REST Resource: spaces.members

Ressource: Mitgliedschaft

Stellt eine Mitgliedschaftsbeziehung in Google Chat dar, z. B. ob ein Nutzer oder eine Chat-App in einen Gruppenbereich eingeladen, Teil davon ist oder dort nicht anwesend ist.

JSON-Darstellung
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
Felder
name

string

Ressourcenname der Mitgliedschaft, der vom Server zugewiesen wurde.

Format: spaces/{space}/members/{member}

state

enum (MembershipState)

Nur Ausgabe. Status der Mitgliedschaft.

role

enum (MembershipRole)

Optional. Die Rolle des Nutzers in einem Chatbereich, die die zulässigen Aktionen im Gruppenbereich bestimmt.

Dieses Feld kann nur als Eingabe in members.patch verwendet werden.

createTime

string (Timestamp format)

Optional. Nicht veränderbar. Der Erstellungszeitpunkt der Mitgliedschaft, z. B. der Zeitpunkt, an dem ein Mitglied einem Gruppenbereich beigetreten ist oder dazu eingeladen wurde. Dieses Feld wird nur ausgegeben, es sei denn, es wird zum Importieren von bisherigen Mitgliedschaften in Gruppenbereiche im Importmodus verwendet.

deleteTime

string (Timestamp format)

Optional. Nicht veränderbar. Der Löschzeitpunkt der Mitgliedschaft, z. B. wann ein Mitglied einen Gruppenbereich verlassen hat oder daraus entfernt wurde. Dieses Feld wird nur ausgegeben, es sei denn, es wird zum Importieren von bisherigen Mitgliedschaften in Gruppenbereiche im Importmodus verwendet.

Union-Feld memberType. Das mit dieser Mitgliedschaft verknüpfte Mitglied. Möglicherweise werden in Zukunft weitere Mitgliedstypen unterstützt. Für memberType ist nur einer der folgenden Werte zulässig:
member

object (User)

Der Google Chat-Nutzer oder die Google Chat-App, zu der die Mitgliedschaft gehört. Wenn sich Ihre Chat-App als Nutzer authentifiziert, werden in der Ausgabe die Felder Nutzer name und type ausgegeben.

groupMember

object (Group)

Die Google-Gruppe, der die Mitgliedschaft entspricht. Unterstützt nur Lesevorgänge. Andere Vorgänge wie das Erstellen oder Aktualisieren einer Mitgliedschaft werden derzeit nicht unterstützt.

MembershipState

Gibt die Beziehung des Mitglieds zu einem Gruppenbereich an. Möglicherweise werden in Zukunft weitere Mitgliedschaftsstatus unterstützt.

Enums
MEMBERSHIP_STATE_UNSPECIFIED Standardwert. Nicht verwenden.
JOINED Der Nutzer wird dem Gruppenbereich hinzugefügt und kann ihm beitreten.
INVITED Der Nutzer wurde in den Gruppenbereich eingeladen, ist ihm aber nicht beigetreten.
NOT_A_MEMBER Der Nutzer gehört nicht zum Gruppenbereich und hat keine ausstehende Einladung, dem Gruppenbereich beizutreten.

MembershipRole

Stellt die zulässigen Aktionen eines Nutzers in einem Chatbereich dar. In Zukunft werden möglicherweise weitere Aufzählungswerte hinzugefügt.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED Standardwert. Für users: Diese Person ist kein Mitglied des Gruppenbereichs, kann aber eingeladen werden. Für Google Groups wird ihnen immer diese Rolle zugewiesen (in Zukunft werden möglicherweise andere enum-Werte verwendet).
ROLE_MEMBER Ein Mitglied des Gruppenbereichs. Der Nutzer hat grundlegende Berechtigungen, z. B. das Senden von Nachrichten an den Gruppenbereich. In 1:1- und unbenannten Gruppenunterhaltungen hat jeder diese Rolle.
ROLE_MANAGER Ein Administrator des Gruppenbereichs. Der Nutzer hat alle grundlegenden Berechtigungen sowie Administratorberechtigungen, mit denen er den Gruppenbereich verwalten kann, z. B. Mitglieder hinzufügen oder entfernen. Wird nur in SpaceType.SPACE unterstützt.

Gruppe

Eine Google-Gruppe in Google Chat.

JSON-Darstellung
{
  "name": string
}
Felder
name

string

Ressourcenname für eine Google-Gruppe.

Stellt eine Gruppe in der Cloud Identity Groups API dar.

Format: groups/{group}

Methoden

create

Erstellt eine Mitgliedschaft durch einen Mitarbeiter oder eine App-Mitgliedschaft für die Anruf-App.

delete

Löscht eine Mitgliedschaft.

get

Gibt Details zu einer Mitgliedschaft zurück.

list

Listet Mitgliedschaften in einem Gruppenbereich auf.

patch

Aktualisiert eine Mitgliedschaft.