- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Crea una membresía humana o de apps para la app que realiza la llamada. No se pueden crear membresías para otras apps. Para ver un ejemplo, consulta Cómo crear una membresía. Cuando se crea una membresía, si se desactiva la política de aceptación automática del miembro especificado, se la invita y debe aceptarla antes de unirse. De lo contrario, la creación de una membresía agrega al miembro directamente al espacio especificado. Requiere la autenticación de usuarios y el alcance chat.memberships
(para membresías humanas) o chat.memberships.app
(para membresías de apps).
Para especificar el miembro que deseas agregar, configura membership.member.name
en CreateMembershipRequest
:
Para agregar la app que realiza la llamada a un espacio o a un mensaje directo entre dos usuarios humanos, usa
users/app
. No se pueden agregar otras apps al espacio.Para agregar un usuario humano, usa
users/{user}
, en el que{user}
es{person_id}
para la persona de la API de People, o bienid
para el usuario en la API de Directory. Por ejemplo, si la API dePerson
resourceName
espeople/123456789
, puedes agregar al usuario al espacio configurandomembership.member.name
enusers/123456789
.
Solicitud HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. El nombre del recurso del espacio para el que se creará la membresía. Formato: espacios/{espacio} |
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de Membership
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Membership
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
Para obtener más información, consulta la Guía de autorización.