Method: spaces.members.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un abonnement pour l'application Chat pour les appels, un utilisateur ou un groupe Google. Il n'est pas possible de créer des abonnements pour d'autres applications Chat. Lorsque vous créez un abonnement, si le membre spécifié a désactivé sa règle d'acceptation automatique, il est invité et doit accepter l'invitation à rejoindre l'espace avant de pouvoir le faire. Sinon, la création d'un abonnement ajoute directement le membre à l'espace spécifié.
Les types d'authentification suivants sont acceptés :
Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation :
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.membershipshttps://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 de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie,
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 obtenir un exemple d'utilisation, consultez :
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 : spaces/{space}
|
Paramètres de requête
| Paramètres |
useAdminAccess |
boolean
Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle 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. La création d'abonnements à des applications ou pour des utilisateurs en dehors de l'organisation Google Workspace de l'administrateur n'est pas possible avec 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.membershipshttps://www.googleapis.com/auth/chat.admin.membershipshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.app
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/29 (UTC).
[null,null,["Dernière mise à jour le 2025/07/29 (UTC)."],[[["\u003cp\u003eCreates memberships for the calling Chat app, a user, or a Google Group in a specified space.\u003c/p\u003e\n"],["\u003cp\u003eSupports app authentication (with admin approval in Developer Preview) and user authentication (with optional admin access).\u003c/p\u003e\n"],["\u003cp\u003eTo use administrator privileges, set the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter to \u003ccode\u003etrue\u003c/code\u003e and ensure the user has the required permissions and scope.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, such as \u003ccode\u003echat.app.memberships\u003c/code\u003e or \u003ccode\u003echat.admin.memberships\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf the member has auto-accept turned off, an invitation is sent; otherwise, they are directly added to the space.\u003c/p\u003e\n"]]],["This describes how to create a membership in Google Chat spaces using a `POST` request to `https://chat.googleapis.com/v1/{parent=spaces/*}/members`. Memberships can be created for a Chat app, user, or Google Group. Authentication supports app or user access, with optional administrator privileges via the `useAdminAccess` query parameter. The request includes path and query parameters and a `Membership` object in the body; the response returns the newly created `Membership`. Authorization requires specific OAuth scopes.\n"],null,["# Method: spaces.members.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a membership for the calling Chat app, a user, or a Google Group. Creating memberships for other Chat apps isn't supported. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space.\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and the authorization scope:\n\n - `https://www.googleapis.com/auth/chat.app.memberships`\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.memberships`\n - `https://www.googleapis.com/auth/chat.memberships.app` (to add the calling app to the space)\n - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)\n - User authentication grants administrator privileges when an administrator account authenticates, `useAdminAccess` is `true`, and the following authorization scope is used:\n - `https://www.googleapis.com/auth/chat.admin.memberships`\n\nApp authentication is not supported for the following use cases:\n\n- Inviting users external to the Workspace organization that owns the space.\n- Adding a Google Group to a space.\n- Adding a Chat app to a space.\n\nFor example usage, see:\n\n- [Invite or add a user to a space](https://developers.google.com/workspace/chat/create-members#create-user-membership).\n- [Invite or add a Google Group to a space](https://developers.google.com/workspace/chat/create-members#create-group-membership).\n- [Add the Chat app to a space](https://developers.google.com/workspace/chat/create-members#create-membership-calling-api).\n\n### HTTP request\n\n`POST https://chat.googleapis.com/v1/{parent=spaces/*}/members`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The resource name of the space for which to create the membership. Format: spaces/{space} |\n\n### Query parameters\n\n| Parameters ||\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `useAdminAccess` | `boolean` Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.memberships` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Creating app memberships or creating memberships for users outside the administrator's Google Workspace organization isn't supported using admin access. |\n\n### Request body\n\nThe request body contains an instance of [Membership](/workspace/chat/api/reference/rest/v1/spaces.members#Membership).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Membership](/workspace/chat/api/reference/rest/v1/spaces.members#Membership).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.app.memberships`\n- `https://www.googleapis.com/auth/chat.admin.memberships`\n- `https://www.googleapis.com/auth/chat.import`\n- `https://www.googleapis.com/auth/chat.memberships`\n- `https://www.googleapis.com/auth/chat.memberships.app`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
