Method: spaces.members.create

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 au id de la personne à partir de l'API People ou au id pour l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil Person 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 ajouter ou inviter un groupe Google dans un espace nommé, utilisez groups/{group}, où {group} est le id 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'ID 123456789 de l'adresse e-mail de groupe group@example.com, puis ajouter ou inviter le groupe à un espace nommé en définissant membership.group_member.name sur groups/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

string

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

boolean

Lorsque la valeur est 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 chat.admin.memberships.

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.