Method: spaces.members.create

Permet de créer un abonnement de type "humain" ou "Appli pour l'application appelante". Il n'est pas possible de créer des abonnements pour d'autres applications. Pour obtenir un exemple, consultez Créer un abonnement. Lors de la création d'un abonnement, si la règle d'acceptation automatique est désactivée pour le membre indiqué, celui-ci est invité et doit accepter l'invitation avant de rejoindre le groupe. Sinon, la création d'un abonnement permet d'ajouter directement le membre à l'espace spécifié. Nécessite l'authentification de l'utilisateur et le champ d'application chat.memberships (pour une adhésion humaine) ou chat.memberships.app (pour une adhésion par application).

Pour spécifier le membre à ajouter, définissez membership.member.name dans CreateMembershipRequest:

  • 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} est le {person_id} pour la personne de l'API People ou le id pour l'utilisateur dans l'API Directory. Par exemple, si l'API People Person resourceName correspond à people/123456789, vous pouvez ajouter l'utilisateur à l'espace en définissant membership.member.name sur 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 vous souhaitez créer l'appartenance.

Format: spaces/{space}

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.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Pour en savoir plus, consultez le guide sur les autorisations.