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 consulter un exemple, consultez Inviter un utilisateur ou une application Google Chat à un espace, ou en ajouter un. Lors de la création d'un abonnement, si le membre indiqué a désactivé la règle d'acceptation automatique, il est invité et doit accepter l'invitation à l'espace pour pouvoir rejoindre l'espace. Sinon, la création d'un abonnement ajoute le membre directement à l'espace spécifié. Nécessite une authentification utilisateur.

Pour spécifier le membre à ajouter, définissez le membership.member.name pour l'utilisateur ou le membre de l'application.

  • Pour ajouter l'application d'appel à 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 d'une même organisation Workspace, {user} peut également indiquer id de la personne dans l'API People ou 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.

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 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 "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 abonnements à des applications ou à des utilisateurs externes à l'organisation Google Workspace de l'administrateur avec l'accès administrateur.

Corps de la requête

Le corps de la requête contient une instance 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.