REST Resource: spaces.members

Ressource : Membership

Représente une relation d'appartenance dans Google Chat (par exemple, un utilisateur ou une application Chat est invité, fait partie ou absent d'un espace).

Représentation JSON
{
  "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.
}
Champs
name

string

Identifiant. Nom de la ressource de l'abonnement, attribué par le serveur.

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

state

enum (MembershipState)

Uniquement en sortie. État de l'abonnement.

role

enum (MembershipRole)

Facultatif. Rôle de l'utilisateur dans un espace Chat, qui détermine les actions autorisées dans l'espace.

Ce champ ne peut être utilisé qu'en entrée dans members.patch.

createTime

string (Timestamp format)

Facultatif. Immuable. Heure de création de l'abonnement, par exemple quand un membre a rejoint un espace ou y a été invité. Ce champ est à usage exclusif en sortie, sauf lorsqu'il est utilisé pour importer des adhésions historiques dans des espaces en mode importation.

deleteTime

string (Timestamp format)

Facultatif. Immuable. Heure de suppression de l'appartenance, par exemple lorsque le membre a quitté ou a été supprimé d'un espace. Ce champ ne sert que de sortie, sauf s'il est utilisé pour importer des adhésions historiques dans des espaces en mode importation.

Champ d'union memberType. Membre associé à cet abonnement. D'autres types de membres pourraient être acceptés à l'avenir. memberType ne peut être qu'un des éléments suivants :
member

object (User)

Facultatif. Utilisateur ou application Google Chat à laquelle l'appartenance correspond. Si votre application Chat s'authentifie en tant qu'utilisateur, la sortie renseigne les champs user name et type.

groupMember

object (Group)

Facultatif. Groupe Google auquel l'appartenance correspond.

La lecture ou la modification des adhésions à Google Groupes nécessite l'authentification des utilisateurs.

MembershipState

Spécifie la relation du membre avec un espace. D'autres états d'adhésion pourraient être acceptés à l'avenir.

Enums
MEMBERSHIP_STATE_UNSPECIFIED Valeur par défaut. Ne pas utiliser.
JOINED L'utilisateur est ajouté à l'espace et peut y participer.
INVITED L'utilisateur est invité à rejoindre l'espace, mais il ne l'a pas rejoint.
NOT_A_MEMBER L'utilisateur n'appartient pas à l'espace et n'a pas d'invitation en attente pour le rejoindre.

MembershipRole

Représente les actions autorisées d'un utilisateur dans un espace Chat. D'autres valeurs d'énumération pourront être ajoutées à l'avenir.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED Valeur par défaut. Pour users : il n'est pas membre de l'espace, mais il peut y être invité. Pour Google Groups: ce rôle leur est toujours attribué (d'autres valeurs d'énumération pourront être utilisées à l'avenir).
ROLE_MEMBER un membre de l'espace ; L'utilisateur dispose d'autorisations de base, comme envoyer des messages dans l'espace. Dans les conversations de groupe privées et sans nom, tout le monde a ce rôle.
ROLE_MANAGER un gestionnaire d'espace ; L'utilisateur dispose de toutes les autorisations de base, ainsi que des autorisations d'administration qui lui permettent de gérer l'espace (ajouter ou supprimer des membres, par exemple). Disponible uniquement en SpaceType.SPACE.

Groupe

Un groupe Google dans Google Chat

Représentation JSON
{
  "name": string
}
Champs
name

string

Nom de ressource d'un groupe Google.

Représente un groupe dans l'API Cloud Identity Groups.

Format : groups/{group}

Méthodes

create

Crée une appartenance pour l'application Chat appelant, un utilisateur ou un groupe Google.

delete

Supprime un abonnement.

get

Affiche les détails d'un abonnement.

list

Répertorie les appartenances à un espace.

patch

Met à jour un abonnement.