REST Resource: spaces.members

Ressource : Membership

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

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 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 d'un utilisateur dans un espace Chat, qui détermine les actions qu'il est autorisé à effectuer dans l'espace.

Ce champ ne peut être utilisé comme entrée que dans members.patch.

createTime

string (Timestamp format)

Facultatif. Immuable. Date de création de l'abonnement, par exemple la date à laquelle un membre a rejoint un espace ou y a été invité. Ce champ est en sortie seule, sauf lorsqu'il est utilisé pour importer des membres historiques dans des espaces en mode importation.

deleteTime

string (Timestamp format)

Facultatif. Immuable. Heure de suppression de l'appartenance, par exemple lorsqu'un membre a quitté ou a été exclu d'un espace. Ce champ est en sortie seule, sauf lorsqu'il est utilisé pour importer des membres historiques dans des espaces en mode importation.

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

object (User)

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

groupMember

object (Group)

Facultatif. Le groupe Google auquel l'adhésion correspond.

La lecture ou la modification des appartenances à des groupes Google Groupes nécessitent une authentification de l'utilisateur.

MembershipState

Spécifie la relation du membre avec un espace. D'autres états de membre pourront être pris en charge à 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 a été invité à rejoindre l'espace, mais ne l'a pas encore fait.
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 peut ê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

Membre de l'espace. Dans l'interface utilisateur du chat, ce rôle est appelé "Membre".

L'utilisateur dispose d'autorisations de base, comme l'envoi de messages dans l'espace. Les gestionnaires et les propriétaires peuvent accorder des autorisations supplémentaires aux membres d'un espace, y compris :

  • Ajoutez ou supprimez des membres.
  • Modifier les détails de l'espace.
  • Activez ou désactivez l'historique.
  • Mentionnez tous les membres de l'espace avec @all.
  • Gérez les applications et les webhooks Chat installés dans l'espace.

Dans les messages privés et les conversations de groupe sans nom, tous les participants ont ce rôle.

ROLE_MANAGER

un propriétaire d'espace ; Dans l'UI de chat, ce rôle est appelé "Propriétaire".

L'utilisateur dispose de l'ensemble des autorisations pour gérer l'espace, y compris :

  • Attribuez le rôle de membre, d'administrateur ou de propriétaire aux autres membres de l'espace.
  • Supprimez l'espace.

Compatible uniquement avec SpaceType.SPACE (espaces nommés).

Pour en savoir plus, consultez En savoir plus sur votre rôle de propriétaire ou de gestionnaire d'espace.

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 un abonnement pour l'application Chat pour les appels, un utilisateur ou un groupe Google.

delete

Supprime un abonnement.

get

Renvoie des informations sur une appartenance.

list

Répertorie les membres d'un espace.

patch

Met à jour une appartenance.