- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Crea una membresía humana o de la app para la app que realiza la llamada. No se pueden crear membresías para otras apps. Para ver un ejemplo, consulta Cómo invitar o agregar a un usuario o una app de Google Chat a un espacio. Cuando creas una membresía, si el miembro especificado tiene desactivada su política de aceptación automática, se lo invitará y deberá aceptar la invitación al espacio antes de unirse. De lo contrario, si creas una membresía, se agregará al miembro directamente al espacio especificado. Se requiere la autenticación del usuario.
Para especificar el miembro que deseas agregar, configura la membership.member.name
para el miembro humano o de la app, o la membership.group_member.name
para el miembro del grupo.
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 pudieron agregar otras apps al espacio.Para agregar un usuario humano, usa
users/{user}
, en el que{user}
puede ser la dirección de correo electrónico del usuario. En el caso de los usuarios de la misma organización de Workspace,{user}
también puede ser elid
para la persona de la API de People o elid
del usuario en la API de Directory. Por ejemplo, si el ID del perfil de persona de la API de People parauser@example.com
es123456789
, puedes agregar al usuario al espacio configurandomembership.member.name
comousers/user@example.com
ousers/123456789
.Para agregar o invitar a un Grupo de Google a un espacio con nombre, usa
groups/{group}
, en el que{group}
es laid
del grupo de la API de Groups de Cloud Identity. Por ejemplo, puedes usar la API de Cloud Identity Groups lookup para recuperar el ID123456789
del correo electrónico de grupogroup@example.com
. Luego, puedes agregar o invitar al grupo a un espacio con nombre estableciendomembership.group_member.name
engroups/123456789
. No se admiten los correos electrónicos de grupo, y los Grupos de Google solo se pueden agregar como miembros en espacios con nombre.
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/{space} |
Parámetros de consulta
Parámetros | |
---|---|
useAdminAccess |
true , el método se ejecuta con los privilegios de administrador de Google Workspace del usuario.El usuario que realiza la llamada debe ser administrador de Google Workspace con el privilegio para administrar el chat y las conversaciones de los espacios. Requiere el permiso de OAuth 2.0 No se pueden crear membresías de aplicaciones ni de usuarios fuera de la organización de Google Workspace del administrador con el acceso de administrador. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene 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 permisos de OAuth:
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
Para obtener más información, consulta la Guía de autorización.