Method: spaces.members.create

Crée une appartenance pour l'application Chat appelant, un utilisateur ou un groupe Google. Il n'est pas possible de créer des souscriptions pour d'autres applications Chat. Lorsque vous créez un accès, si la règle d'acceptation automatique du membre spécifié est désactivée, il est invité et doit accepter l'invitation à l'espace avant de le rejoindre. Sinon, la création d'un accès ajoute le membre directement à l'espace spécifié.

Compatible avec les types d'authentification suivants:

  • Authentification de l'application avec approbation de l'administrateur dans la version Preview développeur et le champ d'application:

    • https://www.googleapis.com/auth/chat.app.memberships

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (pour ajouter l'application d'appel à l'espace)
    • https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement)
    • L'authentification utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, que useAdminAccess est true et que le champ d'application d'autorisation suivant est utilisé :
      • https://www.googleapis.com/auth/chat.admin.memberships

L'authentification des applications n'est pas compatible avec les cas d'utilisation suivants:

  • Inviter des utilisateurs externes à l'organisation Workspace propriétaire de l'espace
  • Ajouter un groupe Google à un espace
  • Ajout d'une application Chat à un espace

Pour voir un exemple d'utilisation, consultez les articles suivants:

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 la ressource de l'espace pour lequel créer l'abonnement.

Format: spaces/{space}

Paramètres de requête

Paramètres
useAdminAccess

boolean

Facultatif. Lorsque la valeur est true, la méthode s'exécute à l'aide des 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.

Requiert le champ d'application OAuth 2.0 chat.admin.memberships.

Il n'est pas possible de créer des adhésions à une application ou des adhésions pour des utilisateurs externes à l'organisation Google Workspace de l'administrateur à l'aide de l'accès 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.app.memberships
  • 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 d'autorisation.