Crée un espace et y ajoute les utilisateurs spécifiés. L'utilisateur appelant est automatiquement ajouté à l'espace et ne doit pas être spécifié en tant que membre dans la requête. Pour obtenir un exemple, consultez Configurer un espace avec des membres initiaux.
Pour spécifier les membres humains à ajouter, ajoutez des appartenances avec le membership.member.name
approprié. Pour ajouter un utilisateur, utilisez users/{user}
, où {user}
peut être l'adresse e-mail de l'utilisateur. Pour les utilisateurs de la même organisation Workspace, {user}
peut également être l'id
de la personne de l'API People ou l'id
de l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil de personne de l'API People pour user@example.com
est 123456789
, vous pouvez ajouter l'utilisateur à l'espace en définissant membership.member.name
sur users/user@example.com
ou users/123456789
.
Pour spécifier les groupes Google à ajouter, ajoutez des appartenances avec l'membership.group_member.name
appropriée. Pour ajouter ou inviter un groupe Google, utilisez groups/{group}
, où {group}
est l'id
du groupe de l'API Cloud Identity Groups. Par exemple, vous pouvez utiliser l'API de recherche Cloud Identity Groups pour récupérer l'ID 123456789
de l'adresse e-mail de groupe group@example.com
, puis ajouter le groupe à l'espace en définissant membership.group_member.name
sur groups/123456789
. Les adresses e-mail de groupe ne sont pas acceptées, et les groupes Google ne peuvent être ajoutés en tant que membres que dans des espaces nommés.
Pour un espace ou une discussion de groupe nommés, si l'appelant bloque certains membres ou est bloqué par eux, ou s'il n'est pas autorisé à ajouter certains membres, ces membres ne sont pas ajoutés à l'espace créé.
Pour créer un message privé (MP) entre l'utilisateur appelant et un autre utilisateur humain, spécifiez exactement un seul abonnement pour représenter l'utilisateur humain. Si l'un des utilisateurs bloque l'autre, la requête échoue et la MP n'est pas créée.
Pour créer un MP entre l'utilisateur appelant et l'application appelante, définissez Space.singleUserBotDm
sur true
et ne spécifiez aucun abonnement. Vous ne pouvez utiliser cette méthode que pour configurer un MP avec l'application appelante. Pour ajouter l'application appelante en tant que membre d'un espace ou d'un MP existant entre deux utilisateurs humains, consultez Inviter ou ajouter un utilisateur ou une application à un espace.
Si un message privé existe déjà entre deux utilisateurs, même si l'un d'eux bloque l'autre au moment de la demande, le message privé existant est renvoyé.
Les espaces avec des réponses sous forme de fil de discussion ne sont pas acceptés. Si le message d'erreur ALREADY_EXISTS
s'affiche lorsque vous configurez un espace, essayez un autre displayName
. Il est possible qu'un espace existant de l'organisation Google Workspace utilise déjà ce nom à afficher.
Authentification des utilisateurs requise.
Requête HTTP
POST https://chat.googleapis.com/v1/spaces:setup
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "space": { object ( |
Champs | |
---|---|
space |
Obligatoire. Le champ Pour créer un espace, définissez Pour créer un chat de groupe, définissez Pour créer une conversation privée entre deux utilisateurs, définissez Pour créer une conversation privée entre un humain et l'application Chat appelante, définissez Si un espace |
request |
Facultatif. Identifiant unique de cette requête. Nous vous recommandons d'utiliser un UUID aléatoire. Si vous spécifiez un ID de requête existant, l'espace créé avec cet ID est renvoyé au lieu d'en créer un autre. Spécifier un ID de requête existant de la même application Chat avec un autre utilisateur authentifié génère une erreur. |
memberships[] |
Facultatif. Les utilisateurs ou groupes Google Chat à inviter à rejoindre l'espace. Omettre l'utilisateur appelant, car il est ajouté automatiquement. L'ensemble permet actuellement d'accueillir jusqu'à 49 membres (en plus de l'appelant). Pour l'appartenance à un groupe d'utilisateurs, le champ Pour l'appartenance à un groupe Google, le champ Facultatif lorsque vous définissez Obligatoire lorsque vous définissez Obligatoire lorsque vous définissez Doit être vide lorsque vous créez une conversation privée entre un humain et l'application Chat appelante (lorsque vous définissez |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Space
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
Pour en savoir plus, consultez le guide d'autorisation.