- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Crée un abonnement humain ou d'application pour l'application appelante. Il n'est pas possible de créer des abonnements pour d'autres applications. Pour obtenir un exemple, consultez Inviter ou ajouter un utilisateur ou une application Google Chat à un espace. Lors de la création d'un abonnement, si le membre spécifié a désactivé la règle d'acceptation automatique, il est invité et doit accepter l'invitation à l'espace avant de rejoindre l'espace. Sinon, créer un abonnement ajoute le membre directement à l'espace spécifié. Nécessite une authentification de l'utilisateur.
Pour spécifier le membre à ajouter, définissez membership.member.name
pour l'humain ou le membre de l'application, ou définissez membership.group_member.name
pour le membre du groupe.
Pour ajouter l'application appelante à un espace ou à un message privé entre deux utilisateurs humains, utilisez
users/app
. Impossible d'ajouter d'autres applications à l'espace.Pour ajouter un utilisateur humain, 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 correspondre auid
de la personne à partir de l'API People ou auid
pour l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil Person de l'API People pouruser@example.com
est123456789
, vous pouvez ajouter l'utilisateur à l'espace en définissantmembership.member.name
surusers/user@example.com
ouusers/123456789
.Pour ajouter ou inviter un groupe Google dans un espace nommé, utilisez
groups/{group}
, où{group}
est leid
du groupe issu de l'API Cloud Identity Groups. Par exemple, vous pouvez utiliser l'API Cloud Identity Groups lookup pour récupérer l'ID123456789
de l'adresse e-mail de groupegroup@example.com
, puis ajouter ou inviter le groupe à un espace nommé en définissantmembership.group_member.name
surgroups/123456789
. L'adresse e-mail de groupe n'est pas acceptée, et les groupes Google ne peuvent être ajoutés qu'en tant que membres d'espaces nommés.
Requête HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Nom de ressource de l'espace pour lequel vous souhaitez créer l'abonnement. Format: espaces/{espace} |
Paramètres de requête
Paramètres | |
---|---|
useAdminAccess |
true , la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur.L'utilisateur appelant doit être un administrateur Google Workspace disposant du droit de gérer les conversations Chat et Espaces. Nécessite le champ d'application OAuth 2.0 Il n'est pas possible de créer des adhésions à des applications ni pour des utilisateurs externes à l'organisation Google Workspace de l'administrateur. |
Corps de la requête
Le corps de la requête contient une instance de Membership
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Membership
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
Pour en savoir plus, consultez le Guide relatif aux autorisations.