REST Resource: spaces.members

Ressource: Mitgliedschaft

Stellt eine Mitgliedschaftsbeziehung in Google Chat dar, z. B. ob ein Nutzer oder eine Chat-App zu einem Gruppenbereich eingeladen wird, Teil eines Gruppenbereichs ist oder nicht in einem Gruppenbereich vorhanden 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

Kennung. Vom Server zugewiesener Ressourcenname der Mitgliedschaft.

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 seine zulässigen Aktionen im Bereich bestimmt.

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

createTime

string (Timestamp format)

Optional. Nicht veränderbar. Der Zeitpunkt, zu dem die Mitgliedschaft erstellt wurde, z. B. wann ein Mitglied einem Gruppenbereich beigetreten ist oder eingeladen wurde Dieses Feld wird nur ausgegeben, wenn es nicht zum Importieren von historischen Mitgliedschaften in Gruppenbereiche im Importmodus verwendet wird.

deleteTime

string (Timestamp format)

Optional. Nicht veränderbar. Der Zeitpunkt des Löschens der Mitgliedschaft, z. B. wann ein Mitglied das Unternehmen verlassen hat oder aus einem Gruppenbereich entfernt wurde. Dieses Feld dient nur der Ausgabe, es sei denn, es wird verwendet, um bisherige Mitgliedschaften in Gruppenbereichen im Importmodus zu importieren.

Union-Feld memberType. Mitglied, das mit dieser Mitgliedschaft verknüpft ist. Weitere Mitgliedertypen werden möglicherweise in Zukunft unterstützt. Für memberType ist nur einer der folgenden Werte zulässig:
member

object (User)

Optional. Der Google Chat-Nutzer oder die Google Chat-App, zu der die Mitgliedschaft gehört. Wenn Ihre Chat-App als Nutzer authentifiziert wird, werden in der Ausgabe die Nutzer name und type eingefügt.

groupMember

object (Group)

Optional. Die Google-Gruppe, zu der die Mitgliedschaft gehört.

Zum Lesen oder Ändern von Mitgliedschaften für Google Groups ist eine Nutzerauthentifizierung erforderlich.

MembershipState

Gibt die Beziehung des Mitglieds zu einem Gruppenbereich an. Weitere Mitgliedsstaaten werden möglicherweise in Zukunft unterstützt.

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

MembershipRole

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

Enums
MEMBERSHIP_ROLE_UNSPECIFIED Standardwert. users: Die Person ist kein Mitglied des Gruppenbereichs, kann aber eingeladen werden. Für Google Groups: Diese Rolle wird immer zugewiesen (in Zukunft können auch andere Aufzählungswerte verwendet werden).
ROLE_MEMBER Ein Mitglied des Gruppenbereichs. Der Nutzer hat grundlegende Berechtigungen, z. B. das Senden von Nachrichten an den Gruppenbereich. In Einzelunterhaltungen und unbenannten Gruppenunterhaltungen haben alle Nutzer diese Rolle.
ROLE_MANAGER Sie müssen Administrator des Gruppenbereichs sein. Der Nutzer hat alle grundlegenden Berechtigungen sowie Administratorberechtigungen, mit denen er den Gruppenbereich verwalten kann, z. B. Mitglieder hinzufügen oder entfernen. 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

Es wird eine Mitgliedschaft für die anrufende Chat-App, einen Nutzer oder eine Google-Gruppe erstellt.

delete

Löscht eine Mitgliedschaft.

get

Gibt Details zu einer Mitgliedschaft zurück.

list

Listet die Mitgliedschaften in einem Gruppenbereich auf.

patch

Aktualisiert eine Mitgliedschaft.