Method: spaces.members.create

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 el id para la persona de la API de People o el id del usuario en la API de Directory. Por ejemplo, si el ID del perfil de persona de la API de People para user@example.com es 123456789, puedes agregar al usuario al espacio configurando membership.member.name como users/user@example.com o users/123456789.

  • Para agregar o invitar a un Grupo de Google a un espacio con nombre, usa groups/{group}, en el que {group} es la id del grupo de la API de Groups de Cloud Identity. Por ejemplo, puedes usar la API de Cloud Identity Groups lookup para recuperar el ID 123456789 del correo electrónico de grupo group@example.com. Luego, puedes agregar o invitar al grupo a un espacio con nombre estableciendo membership.group_member.name en groups/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

string

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

boolean

Cuando es 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 chat.admin.memberships.

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.