Package google.chat.v1

El espacio del modo de importación.

ContextualAddOnMarkup

Este tipo no tiene campos.

Es el lenguaje de marcado para que los desarrolladores especifiquen los contenidos de un complemento contextual.

Tarjeta

Una tarjeta es un elemento de la IU que puede contener widgets de IU, como imágenes y texto.

Campos
`header`	`CardHeader` El encabezado de la tarjeta. Un encabezado suele contener un título y una imagen.
`sections[]`	`Section` Las secciones están separadas por un divisor de líneas.
`card_actions[]`	`CardAction` Las acciones de esta tarjeta.
`name`	`string` Es el nombre de la tarjeta.

CardAction

Una acción con tarjeta es la acción asociada con la tarjeta. En el caso de una tarjeta de factura, una acción típica sería borrar una factura, enviarla por correo electrónico o abrir la factura en el navegador.

No es compatible con las apps de Google Chat.

Campos

Campos
`action_label`	`string` La etiqueta que se solía mostrar en el elemento del menú de acciones.
`on_click`	`OnClick` La acción "onClick" de este elemento de acción.

action_label

string

La etiqueta que se solía mostrar en el elemento del menú de acciones.

on_click

OnClick

La acción "onClick" de este elemento de acción.

CardHeader

Campos
`title`	`string` Se debe especificar el título. El encabezado tiene una altura fija: si se especifican tanto un título como un subtítulo, cada uno ocupará una línea. Si solo se especifica el título, ocupa ambas líneas.
`subtitle`	`string` El subtítulo del encabezado de la tarjeta.
`image_style`	`ImageStyle` El tipo de imagen (por ejemplo, borde cuadrado o borde circular).
`image_url`	`string` Es la URL de la imagen en el encabezado de la tarjeta.

ImageStyle

Enumeraciones
`IMAGE_STYLE_UNSPECIFIED`
`IMAGE`	Borde cuadrado
`AVATAR`	Borde circular

Sección

Una sección contiene una colección de widgets renderizados (verticalmente) en el orden en que se especifican. En todas las plataformas, las tarjetas tienen un ancho fijo estrecho, por lo que actualmente no es necesario utilizar propiedades de diseño (por ejemplo, un número de punto flotante).

Campos

Campos
`header`	`string` Es el encabezado de la sección. Se admite texto con formato. Si quieres obtener más información para dar formato al texto, consulta Da formato al texto en apps de Google Chat y Da formato al texto en complementos de Google Workspace.
`widgets[]`	`WidgetMarkup` Una sección debe contener al menos un widget.

header

string

Es el encabezado de la sección. Se admite texto con formato. Si quieres obtener más información para dar formato al texto, consulta Da formato al texto en apps de Google Chat y Da formato al texto en complementos de Google Workspace.

widgets[]

WidgetMarkup

Una sección debe contener al menos un widget.

CreateMembershipRequest

Mensaje de solicitud para crear una membresía.

Campos

Campos
`parent`	`string` Obligatorio. El nombre del recurso del espacio para el que se creará la membresía. Formato: espacios/{space}
`membership`	`Membership` Obligatorio. La relación de membresía que se creará. El campo `memberType` debe incluir un usuario con los campos `user.name` y `user.type` propagados. El servidor asignará un nombre de recurso y reemplazará todo lo especificado. Cuando una app de Chat crea una relación de membresía para un usuario humano, debe usar el permiso `chat.memberships`, establecer `user.type` en `HUMAN` y establecer `user.name` con el formato `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` de 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`. Cuando una app de Chat crea una relación de membresía para sí misma, debe usar el permiso `chat.memberships.app`, establecer `user.type` en `BOT` y establecer `user.name` en `users/app`.
`use_admin_access`	`bool` Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. 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.

parent

string

Obligatorio. El nombre del recurso del espacio para el que se creará la membresía.

Formato: espacios/{space}

membership

Obligatorio. La relación de membresía que se creará. El campo memberType debe incluir un usuario con los campos user.name y user.type propagados. El servidor asignará un nombre de recurso y reemplazará todo lo especificado. Cuando una app de Chat crea una relación de membresía para un usuario humano, debe usar el permiso chat.memberships, establecer user.type en HUMAN y establecer user.name con el formato 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 de 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. Cuando una app de Chat crea una relación de membresía para sí misma, debe usar el permiso chat.memberships.app, establecer user.type en BOT y establecer user.name en users/app.

use_admin_access

bool

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.

CreateMessageRequest

Crea un mensaje.

Campos
`parent`	`string` Obligatorio. El nombre de recurso del espacio en el que se creará un mensaje. Formato: `spaces/{space}`
`message`	`Message` Obligatorio. Cuerpo del mensaje.
`thread_key (deprecated)`	`string` Este elemento es obsoleto. Opcional. Obsoleto: Usa `thread.thread_key` en su lugar. Es el ID del subproceso. Admite hasta 4,000 caracteres. Para iniciar o agregar una conversación, crea un mensaje y especifica una `threadKey` o la `thread.name`. Para ver un ejemplo de uso, consulta Cómo iniciar o responder una conversación de mensajes.
`request_id`	`string` Opcional. Un ID de solicitud único para este mensaje. Si especificas un ID de solicitud existente, se muestra el mensaje creado con ese ID en lugar de crear un mensaje nuevo.
`message_reply_option`	`MessageReplyOption` Opcional. Especifica si un mensaje inicia una conversación o responde a una. Solo es compatible en los espacios con nombre.
`message_id`	`string` Opcional. Es un ID personalizado para un mensaje. Permite que las apps de Chat obtengan, actualicen o borren un mensaje sin necesidad de almacenar el ID asignado por el sistema en el nombre del recurso del mensaje (representado en el campo del mensaje `name`). El valor de este campo debe cumplir con los siguientes requisitos: Comienza con `client-`. Por ejemplo, `client-custom-name` es un ID personalizado válido, pero `custom-name` no lo es. Contiene hasta 63 caracteres, y solo letras minúsculas, números y guiones. Es único dentro de un espacio. Una app de Chat no puede usar el mismo ID personalizado para mensajes diferentes. Para obtener más información, consulta Cómo asignar un nombre a un mensaje.

MessageReplyOption

Especifica cómo responder un mensaje. Es posible que se agreguen más estados en el futuro.

Enumeraciones
`MESSAGE_REPLY_OPTION_UNSPECIFIED`	Predeterminado. Inicia una conversación nueva. Si usas esta opción, se ignorará cualquier `thread ID` o `thread_key` que se incluya.
`REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD`	Crea el mensaje como respuesta a la conversación especificada por `thread ID` o `thread_key`. Si falla, el mensaje inicia una nueva conversación.
`REPLY_MESSAGE_OR_FAIL`	Crea el mensaje como respuesta a la conversación especificada por `thread ID` o `thread_key`. Si se usa un `thread_key` nuevo, se crea un subproceso nuevo. Si la creación del mensaje falla, se muestra un error `NOT_FOUND` en su lugar.

CreateReactionRequest

Crea una reacción a un mensaje.

Campos

parent

string

Obligatorio. Es el mensaje en el que se crea la reacción.

Formato: spaces/{space}/messages/{message}

reaction

Obligatorio. La reacción que se creará.

CreateSpaceRequest

Una solicitud para crear un espacio con nombre.

Campos

space

Obligatorio. Se deben completar los campos displayName y spaceType. Solo se admite SpaceType.SPACE.

Si recibes el mensaje de error ALREADY_EXISTS, prueba con otro displayName. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible.

El espacio name está asignado en el servidor, por lo que se ignorará todo lo que se especifique en este campo.

request_id

string

Opcional. Es un identificador único para esta solicitud. Se recomienda usar un UUID aleatorio. Si especificas un ID de solicitud existente, se muestra el espacio creado con ese ID en lugar de crear un espacio nuevo. Si especificas un ID de solicitud existente de la misma app de Chat con un usuario autenticado diferente, se mostrará un error.

CustomEmoji

Representa un emoji personalizado.

Campos

uid

string

Solo salida. Clave única para el recurso de emoji personalizado.

DeleteMembershipRequest

Solicitud para borrar una membresía de un espacio.

Campos

name

string

Obligatorio. Nombre del recurso de la membresía que se borrará. Las apps de Chat pueden borrar las contraseñas o sus propias membresías. Las apps de chat no pueden borrar los datos de otras apps membresías.

Cuando se borra una membresía humana, se requiere el permiso chat.memberships y el formato spaces/{space}/members/{member}. Puedes usar el correo electrónico como alias de {member}. Por ejemplo, spaces/{space}/members/example@gmail.com, en el que example@gmail.com es el correo electrónico del usuario de Google Chat.

Cuando se borra una membresía de app, se requiere el permiso chat.memberships.app y el formato spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app.

use_admin_access

bool

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 borrar membresías de apps de un espacio con el acceso de administrador.

DeleteMessageRequest

Solicitud para borrar un mensaje.

Campos

name

string

Obligatorio. Es el nombre del recurso del mensaje.

Formato: spaces/{space}/messages/{message}

Si estableciste un ID personalizado para tu mensaje, puedes usar el valor del campo clientAssignedMessageId para {message}. Para obtener más información, consulta Cómo asignar un nombre a un mensaje.

force

bool

Si es true, cuando se borra un mensaje, también se borran las respuestas en múltiples conversaciones. Cuando sea false, si un mensaje tiene respuestas en múltiples conversaciones, fallará la eliminación.

Solo se aplica cuando se autentica como usuario. No tiene ningún efecto cuando se autentica como una app de Chat.

DeleteReactionRequest

Borra una reacción a un mensaje.

Campos

name

string

Obligatorio. Nombre de la reacción que se borrará.

Formato: spaces/{space}/messages/{message}/reactions/{reaction}

DeleteSpaceRequest

Solicitud para borrar un espacio.

Campos

name

string

Obligatorio. Nombre de recurso del espacio que se borrará.

Formato: spaces/{space}

use_admin_access

bool

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.delete.

DeletionMetadata

Información sobre un mensaje borrado. Se borra un mensaje cuando se configura delete_time.

Campos

deletion_type

DeletionType

Indica quién borró el mensaje.

DeletionType

Quién borró el mensaje y cómo se borró

Enumeraciones
`DELETION_TYPE_UNSPECIFIED`	Este valor no se usa.
`CREATOR`	El usuario borró su propio mensaje.
`SPACE_OWNER`	El propietario del espacio borró el mensaje.
`ADMIN`	Un administrador de Google Workspace borró el mensaje.
`APP_MESSAGE_EXPIRY`	Una app de Chat borró su propio mensaje cuando venció.
`CREATOR_VIA_APP`	Una app de Chat borró el mensaje en nombre del usuario.
`SPACE_OWNER_VIA_APP`	Una app de Chat borró el mensaje en nombre del propietario del espacio.

Diálogo

Unión alrededor del cuerpo de la tarjeta del diálogo.

Campos

body

Card

Solo entrada. Cuerpo del diálogo, que se renderiza en una ventana modal. Las apps de Google Chat no admiten las siguientes entidades de tarjeta: DateTimePicker, OnChangeAction.

DialogAction

Contiene un diálogo y el código de estado de la solicitud.

Campos

action_status

ActionStatus

Solo entrada. Estado de una solicitud para invocar o enviar un diálogo. Muestra un estado y un mensaje a los usuarios, si es necesario. Por ejemplo, en caso de error o éxito.

Campo de unión action. Acción para realizar. Las direcciones (action) solo pueden ser una de las siguientes opciones:

dialog

Dialog

Solo entrada. Dialog para la solicitud.

DriveDataRef

Es una referencia a los datos de un adjunto de unidad.

Campos

drive_file_id

string

El ID del archivo de Drive. Úsalo con la API de Drive.

DriveLinkData

Datos de vínculos de Google Drive.

Campos

drive_data_ref

DriveDataRef

Una DriveDataRef que hace referencia a un archivo de Google Drive

mime_type

string

El tipo MIME del recurso de Google Drive vinculado.

Emoji

Un emoji que se usa como reacción a un mensaje.

Campos

Campo de unión content. El contenido del emoji. Las direcciones (content) solo pueden ser una de las siguientes opciones:

unicode

string

Un emoji básico representado por una cadena Unicode.

custom_emoji

CustomEmoji

Solo salida. Un emoji personalizado

EmojiReactionSummary

Indica la cantidad de personas que reaccionaron a un mensaje con un emoji específico.

Campos

emoji

Emoji

Emoji asociado con las reacciones.

reaction_count

int32

La cantidad total de reacciones con el emoji asociado.

FindDirectMessageRequest

Una solicitud para obtener espacio de mensaje directo según el recurso del usuario.

Campos

name

string

Obligatorio. Nombre del recurso del usuario con el que se va a encontrar el mensaje directo.

Formato: users/{user}, en el que {user} es el id para la persona de la API de People o el id para el usuario en la API de Directory. Por ejemplo, si el ID del perfil de la API de People es 123456789, puedes encontrar un mensaje directo con esa persona usando users/123456789 como name. Cuando se autentica como usuario, puedes usar el correo electrónico como un alias para {user}. Por ejemplo, users/example@gmail.com, en el que example@gmail.com es el correo electrónico del usuario de Google Chat.

GetAttachmentRequest

Solicitud para obtener un archivo adjunto.

Campos

name

string

Obligatorio. Es el nombre del recurso del adjunto, con el formato spaces/{space}/messages/{message}/attachments/{attachment}.

GetMembershipRequest

Es una solicitud para obtener una membresía de un espacio.

Campos

name

string

Obligatorio. Nombre del recurso de la membresía que se recuperará.

Para obtener la membresía de la app mediante la autenticación de usuario, puedes usar spaces/{space}/members/app de manera opcional.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app

Cuando se autentica como usuario, puedes usar el correo electrónico del usuario como un alias para {member}. Por ejemplo, spaces/{space}/members/example@gmail.com, en el que example@gmail.com es el correo electrónico del usuario de Google Chat.

use_admin_access

bool

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 los permisos de OAuth 2.0 chat.admin.memberships o chat.admin.memberships.readonly.

No se pueden obtener membresías de apps en un espacio cuando se usa el acceso de administrador.

GetMessageRequest

Solicitud para recibir un mensaje.

Campos

name

string

Obligatorio. Es el nombre del recurso del mensaje.

Formato: spaces/{space}/messages/{message}

GetSpaceEventRequest

Mensaje de solicitud para obtener un evento espacial.

Campos

name

string

Obligatorio. El nombre del recurso del evento de espacio.

Formato: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceReadStateRequest

Mensaje de solicitud para la API de GetSpaceReadState.

Campos

name

string

Obligatorio. Nombre del recurso del estado de lectura del espacio que se recuperará.

Solo admite la obtención del estado de lectura del usuario que realiza la llamada.

Para hacer referencia al usuario que realiza la llamada, configura una de las siguientes opciones:

El alias me. Por ejemplo, users/me/spaces/{space}/spaceReadState
Su dirección de correo electrónico de Workspace Por ejemplo, users/user@example.com/spaces/{space}/spaceReadState.
Su ID de usuario Por ejemplo, users/123456789/spaces/{space}/spaceReadState.

Formato: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

Es una solicitud para mostrar un solo espacio.

Campos

name

string

Obligatorio. Nombre de recurso del espacio, con el formato spaces/{space}.

Formato: spaces/{space}

use_admin_access

bool

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 los permisos de OAuth 2.0 chat.admin.spaces o chat.admin.spaces.readonly.

GetThreadReadStateRequest

Mensaje de solicitud para la API de GetThreadReadStateRequest.

Campos

name

string

Obligatorio. Nombre del recurso del estado de lectura del subproceso que se recuperará.

Solo admite la obtención del estado de lectura del usuario que realiza la llamada.

Para hacer referencia al usuario que realiza la llamada, configura una de las siguientes opciones:

El alias me. Por ejemplo, users/me/spaces/{space}/threads/{thread}/threadReadState
Su dirección de correo electrónico de Workspace Por ejemplo, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.
Su ID de usuario Por ejemplo, users/123456789/spaces/{space}/threads/{thread}/threadReadState.

Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Grupo

Un Grupo de Google en Google Chat

Campos

name

string

Nombre de recurso para un Grupo de Google.

Representa un grupo en la API de Groups de Cloud Identity.

Formato: groups/{group}

HistoryState

El estado del historial de los mensajes y espacios. Especifica cuánto tiempo se conservan los mensajes y las conversaciones después de su creación.

Enumeraciones
`HISTORY_STATE_UNSPECIFIED`	Valor predeterminado No lo utilices.
`HISTORY_OFF`	Historial desactivado. Los mensajes y las conversaciones se conservan por 24 horas.
`HISTORY_ON`	Historial activado. Las reglas de retención de Vault de la organización especifican por cuánto tiempo se conservan los mensajes y las conversaciones.

ListMembershipsRequest

Mensaje de solicitud para las membresías de la ficha.

Campos
`parent`	`string` Obligatorio. El nombre del recurso del espacio para el que se recuperará una lista de membresías. Formato: espacios/{space}
`page_size`	`int32` Opcional. La cantidad máxima de membresías que se mostrarán. Es posible que el servicio muestre menos valores que este. Si no se especifica, se muestran 100 membresías como máximo. El valor máximo es 1,000. Si usas un valor superior a 1,000, este se cambia automáticamente a 1,000. Los valores negativos muestran un error `INVALID_ARGUMENT`.
`page_token`	`string` Opcional. Un token de página, recibido de una llamada anterior para enumerar membresías. Proporciona este parámetro para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados.
`filter`	`string` Opcional. Un filtro de consulta Puedes filtrar las membresías por el rol (`role`) y el tipo (`member.type`) de un miembro. Para filtrar por función, establece `role` en `ROLE_MEMBER` o `ROLE_MANAGER`. Para filtrar por tipo, establece `member.type` en `HUMAN` o `BOT`. Versión preliminar para desarrolladores: También puedes filtrar por `member.type` con el operador `!=`. Para filtrar por función y tipo, usa el operador `AND`. Para filtrar por función o tipo, usa el operador `OR`. Se requiere `member.type = "HUMAN"` o `member.type != "BOT"` cuando `use_admin_access` se establece como verdadero. Se rechazarán los demás filtros de tipos de miembros. Por ejemplo, las siguientes consultas son válidas: `role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" member.type != "BOT"` Las siguientes consultas no son válidas: `member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"` El servidor rechaza las consultas no válidas con un error `INVALID_ARGUMENT`.
`show_groups`	`bool` Opcional. Cuando es `true`, también muestra membresías asociadas con un `Google Group`, además de otros tipos de membresías. Si se configura una `filter`, no se mostrarán las membresías de `Google Group` que no coincidan con los criterios de filtro.
`show_invited`	`bool` Opcional. Cuando `true`, también muestra membresías asociadas con los miembros de `invited`, además de otros tipos de membresías. Si se configura un filtro, no se mostrarán las membresías de `invited` que no coinciden con los criterios del filtro. Actualmente requiere la autenticación de usuarios.
`use_admin_access`	`bool` Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. 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.readonly` o `chat.admin.memberships`. No se admite enumerar las membresías de apps en un espacio cuando se usa el acceso de administrador.

ListMembershipsResponse

Es una respuesta para enumerar las membresías del espacio.

Campos

memberships[]

Lista sin ordenar. Lista de membresías en la página solicitada (o la primera).

next_page_token

string

Un token que puedes enviar como pageToken para recuperar la siguiente página de resultados. Si está vacío, no hay páginas posteriores.

ListMessagesRequest

Muestra una lista de los mensajes del espacio especificado a los que pertenece el usuario.

Campos
`parent`	`string` Obligatorio. El nombre del recurso del espacio del que se enumeran los mensajes. Formato: `spaces/{space}`
`page_size`	`int32` La cantidad máxima de mensajes que se muestran. Es posible que el servicio muestre menos mensajes que este valor. Si no se especifica, se muestran 25 como máximo. El valor máximo es 1,000. Si usas un valor superior a 1,000, este se cambia automáticamente a 1,000. Los valores negativos muestran un error `INVALID_ARGUMENT`.
`page_token`	`string` Opcional si se reanuda desde una consulta anterior. Un token de página recibido de una llamada anterior de mensajes de lista. Proporciona este parámetro para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados.
`filter`	`string` Un filtro de consulta Puedes filtrar los mensajes por fecha (`create_time`) y conversación (`thread.name`). Para filtrar los mensajes por la fecha en que se crearon, especifica `create_time` con una marca de tiempo en formato RFC-3339 y comillas dobles. Por ejemplo, `"2023-04-21T11:30:00-04:00"`. Puedes usar el operador mayor que `>` para enumerar los mensajes que se crearon después de una marca de tiempo o el operador menor que `<` para enumerar los mensajes que se crearon antes de una marca de tiempo. Para filtrar mensajes dentro de un intervalo de tiempo, usa el operador `AND` entre dos marcas de tiempo. Para filtrar por subproceso, especifica `thread.name`, con el formato `spaces/{space}/threads/{thread}`. Solo puedes especificar un `thread.name` por consulta. Para filtrar por subproceso y fecha, usa el operador `AND` en tu consulta. Por ejemplo, las siguientes consultas son válidas: `create_time > "2012-04-21T11:30:00-04:00" create_time > "2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > "2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123` El servidor rechaza las consultas no válidas con un error `INVALID_ARGUMENT`.
`order_by`	`string` Opcional si se reanuda desde una consulta anterior. Cómo se ordena la lista de mensajes. Especifica un valor para ordenar según una operación de ordenamiento. Los valores válidos de una operación de ordenamiento son los siguientes: `ASC` para el orden ascendente. `DESC` para el orden descendente. El orden predeterminado es `create_time ASC`.
`show_deleted`	`bool` Indica si se deben incluir los mensajes borrados. Los mensajes borrados incluyen la hora de eliminación y los metadatos sobre su eliminación, pero el contenido de los mensajes no está disponible.

ListMessagesResponse

Mensaje de respuesta para enumerar los mensajes.

Campos

messages[]

Lista de mensajes.

next_page_token

string

Puedes enviar un token como pageToken para recuperar la siguiente página de resultados. Si está vacío, no hay páginas posteriores.

ListReactionsRequest

Muestra una lista de las reacciones a un mensaje.

Campos
`parent`	`string` Obligatorio. El mensaje al que reaccionaron los usuarios Formato: `spaces/{space}/messages/{message}`
`page_size`	`int32` Opcional. La cantidad máxima de reacciones que se muestran. El servicio puede mostrar menos reacciones que este valor. Si no se especifica, el valor predeterminado es 25. El valor máximo es 200. los valores superiores a 200 se cambian a 200.
`page_token`	`string` Opcional. (si se reanuda desde una consulta anterior). Un token de página recibido de una llamada de reacciones de lista anterior. Proporciona esto para recuperar la página siguiente. Durante la paginación, el valor del filtro debe coincidir con la llamada que proporcionó el token de la página. Pasar un valor diferente puede generar resultados inesperados.
`filter`	`string` Opcional. Un filtro de consulta Puedes filtrar las reacciones por emoji (`emoji.unicode` o `emoji.custom_emoji.uid`) y usuario (`user.name`). Para filtrar las reacciones de varios emojis o usuarios, une campos similares con el operador `OR`, como `emoji.unicode = "🙂" OR emoji.unicode = "👍"` y `user.name = "users/AAAAAA" OR user.name = "users/BBBBBB"`. Para filtrar reacciones por emoji y usuario, usa el operador `AND`, como `emoji.unicode = "🙂" AND user.name = "users/AAAAAA"`. Si tu consulta usa `AND` y `OR`, agrúpalas entre paréntesis. Por ejemplo, las siguientes consultas son válidas: `user.name = "users/{user}" emoji.unicode = "🙂" emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR emoji.unicode = "👍" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" AND user.name = "users/{user}" (emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}") AND user.name = "users/{user}"` Las siguientes consultas no son válidas: `emoji.unicode = "🙂" AND emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" AND user.name = "users/{user}"` El servidor rechaza las consultas no válidas con un error `INVALID_ARGUMENT`.

ListReactionsResponse

Respuesta a una solicitud de reacciones de lista.

Campos

reactions[]

Lista de reacciones en la página solicitada (o la primera).

next_page_token

string

Token de continuación para recuperar la siguiente página de resultados. Está vacía en la última página de resultados.

ListSpaceEventsRequest

Mensaje de solicitud para enumerar los eventos del espacio.

Campos
`parent`	`string` Obligatorio. Nombre del recurso del espacio de Google Chat en el que ocurrieron los eventos. Formato: `spaces/{space}`.
`page_size`	`int32` Opcional. La cantidad máxima de eventos de espacio que se muestran. Es posible que el servicio muestre menos valores que este. Los valores negativos muestran un error `INVALID_ARGUMENT`.
`page_token`	`string` Un token de página, recibido de una llamada anterior de eventos de espacio de lista. Proporciona esto para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados para enumerar los eventos de espacio deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados.
`filter`	`string` Obligatorio. Un filtro de consulta Debes especificar, al menos, un tipo de evento (`event_type`) con el operador que tiene `:`. Para filtrar por varios tipos de eventos, usa el operador `OR`. Omite los tipos de eventos por lotes en el filtro. La solicitud muestra automáticamente cualquier evento por lotes relacionado. Por ejemplo, si filtras por reacciones nuevas (`google.workspace.chat.reaction.v1.created`), el servidor también mostrará eventos de reacciones nuevos por lotes (`google.workspace.chat.reaction.v1.batchCreated`). Para obtener una lista de los tipos de eventos admitidos, consulta la documentación de referencia de `SpaceEvents`. De manera opcional, también puedes filtrar por hora de inicio (`start_time`) y hora de finalización (`end_time`): `start_time`: Es una marca de tiempo exclusiva desde la que se deben comenzar a mostrar los eventos del espacio. Puedes enumerar los eventos que ocurrieron hace hasta 28 días. Si no se especifica, se muestran los eventos de espacio de los últimos 28 días. `end_time`: Es la marca de tiempo inclusiva hasta la que se enumeran los eventos de espacio. Si no se especifica, enumera los eventos hasta el momento de la solicitud. Para especificar una hora de inicio o finalización, usa el operador signo igual `=` y el formato en RFC-3339. Para filtrar por `start_time` y `end_time`, usa el operador `AND`. Por ejemplo, las siguientes consultas son válidas: `start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00"` `start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created")` Las siguientes consultas no son válidas: `start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00"` `event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created"` El servidor rechaza las consultas no válidas con un error `INVALID_ARGUMENT`.

ListSpaceEventsResponse

Mensaje de respuesta para enumerar los eventos del espacio.

Campos

space_events[]

SpaceEvent

Los resultados se muestran en orden cronológico (el evento más antiguo primero).

next_page_token

string

Token de continuación usado para recuperar más eventos. Si se omite este campo, no habrá páginas siguientes.

ListSpacesRequest

Una solicitud para enumerar los espacios de los que pertenece el emisor.

Campos

page_size

int32

Opcional. La cantidad máxima de espacios que se mostrarán. Es posible que el servicio muestre menos valores que este.

Si no se especifica, se muestran 100 espacios como máximo.

El valor máximo es 1,000. Si usas un valor superior a 1,000, este se cambia automáticamente a 1,000.

Los valores negativos muestran un error INVALID_ARGUMENT.

page_token

string

Opcional. Un token de página, recibido de una llamada anterior a la lista de espacios. Proporciona este parámetro para recuperar la página siguiente.

Durante la paginación, el valor del filtro debe coincidir con la llamada que proporcionó el token de la página. Pasar un valor diferente puede generar resultados inesperados.

filter

string

Opcional. Un filtro de consulta

Puedes filtrar los espacios por tipo de espacio (space_type).

Para filtrar por tipo de espacio, debes especificar un valor de enumeración válido, como SPACE o GROUP_CHAT (space_type no puede ser SPACE_TYPE_UNSPECIFIED). Para consultar sobre varios tipos de espacio, usa el operador OR.

Por ejemplo, las siguientes consultas son válidas:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

El servidor rechaza las consultas no válidas con un error INVALID_ARGUMENT.

ListSpacesResponse

La respuesta para una solicitud de lista de espacios.

Campos

spaces[]

MembershipCreatedEventData

Lista de espacios en la página solicitada (o la primera).

next_page_token

string

Puedes enviar un token como pageToken para recuperar la siguiente página de resultados. Si está vacío, no hay páginas posteriores.

MatchedUrl

Una URL coincidente en un mensaje de Chat. Las apps de chat pueden obtener una vista previa de las URLs coincidentes. Si deseas obtener más información, consulta Vista previa de vínculos.

Campos

url

string

Solo salida. La URL que coincidió.

Membresía

Representa una relación de membresía en Google Chat, por ejemplo, si se invita a un usuario o una app de Chat a un espacio, si forma parte de él o si está ausente.

Campos
`name`	`string` Nombre del recurso de la membresía que asigna el servidor. Formato: `spaces/{space}/members/{member}`
`state`	`MembershipState` Solo salida. Estado de la membresía.
`role`	`MembershipRole` Opcional. El rol del usuario dentro de un espacio de Chat, que determina las acciones permitidas en el espacio Este campo solo se puede usar como entrada en `UpdateMembership`.
`create_time`	`Timestamp` Opcional. Inmutable. La hora de creación de la membresía, como la fecha en que un miembro se unió a un espacio o recibió una invitación para hacerlo. Este campo es solo de salida, excepto cuando se usa para importar membresías históricas en espacios en modo de importación.
`delete_time`	`Timestamp` Opcional. Inmutable. La hora de eliminación de la membresía, como cuando un miembro abandonó el espacio o se lo quitó. Este campo es solo de salida, excepto cuando se usa para importar membresías históricas en espacios en modo de importación.
Campo de unión `memberType`. Miembro asociado con esta membresía Es posible que se admitan otros tipos de miembros en el futuro. Las direcciones (`memberType`) solo pueden ser una de las siguientes opciones:
`member`	`User` El usuario o la app de Google Chat al que corresponde la membresía. Si tu app de Chat se autentica como usuario, el resultado propaga los datos del usuario `name` y `type`.
`group_member`	`Group` El Grupo de Google al que corresponde la membresía.

MembershipRole

Representa las acciones permitidas de un usuario en un espacio de Chat. Es posible que se agreguen más valores de enumeración en el futuro.

Enumeraciones
`MEMBERSHIP_ROLE_UNSPECIFIED`	Valor predeterminado En el caso de `users`, no es miembro del espacio, pero se puede invitar. Para `Google Groups`: siempre se le asigna este rol (es posible que se usen otros valores de enumeración en el futuro).
`ROLE_MEMBER`	Un miembro del espacio. El usuario tiene permisos básicos, como enviar mensajes al espacio. En conversaciones grupales 1:1 y sin nombre, todos tienen este rol.
`ROLE_MANAGER`	Un administrador del espacio. El usuario tiene todos los permisos básicos y los permisos administrativos con los que puede administrar el espacio, como agregar o quitar miembros. Solo se admite en `SpaceType.SPACE`.

MembershipState

Especifica la relación del miembro con un espacio. Es posible que se admitan otros estados de membresía en el futuro.

Enumeraciones
`MEMBERSHIP_STATE_UNSPECIFIED`	Valor predeterminado No usar.
`JOINED`	Se agregará el usuario al espacio y podrá participar en él.
`INVITED`	Se invitó al usuario a unirse al espacio, pero este no se unió a él.
`NOT_A_MEMBER`	El usuario no pertenece al espacio y no tiene una invitación pendiente para unirse a él.

MembershipBatchCreatedEventData

Carga útil de eventos para varias membresías nuevas.

Tipo de evento: google.workspace.chat.membership.v1.batchCreated

Campos

memberships[]

Una lista de las membresías nuevas.

MembershipBatchDeletedEventData

Carga útil de eventos para varias membresías borradas.

Tipo de evento: google.workspace.chat.membership.v1.batchDeleted

Campos

memberships[]

MembershipDeletedEventData

Una lista de las membresías borradas.

MembershipBatchUpdatedEventData

Carga útil de eventos para varias membresías actualizadas.

Tipo de evento: google.workspace.chat.membership.v1.batchUpdated

Campos

memberships[]

MembershipUpdatedEventData

Una lista de las membresías actualizadas.

MembershipCreatedEventData

Carga útil de evento para una membresía nueva.

Tipo de evento: google.workspace.chat.membership.v1.created.

Campos

membership

La nueva membresía.

MembershipDeletedEventData

Carga útil de evento para una membresía borrada.

Tipo de evento: google.workspace.chat.membership.v1.deleted

Campos

membership

La membresía que se borró. Solo se propagan los campos name y state.

MembershipUpdatedEventData

Carga útil de evento para una membresía actualizada.

Tipo de evento: google.workspace.chat.membership.v1.updated

Campos

membership

MessageCreatedEventData

La membresía actualizada.

Mensaje

Un mensaje en un espacio de Google Chat

Campos
`name`	`string` Es el nombre del recurso del mensaje. Formato: `spaces/{space}/messages/{message}` Donde `{space}` es el ID del espacio en el que se publica el mensaje y `{message}` es el ID que asignó el sistema al mensaje. Por ejemplo, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. Si estableces un ID personalizado cuando creas un mensaje, puedes usar este ID para especificar el mensaje en una solicitud. Para ello, reemplaza `{message}` por el valor del campo `clientAssignedMessageId`. Por ejemplo, `spaces/AAAAAAAAAAA/messages/client-custom-name`. Para obtener más información, consulta Cómo asignar un nombre a un mensaje.
`sender`	`User` Solo salida. El usuario que creó el mensaje Si tu app de Chat se autentica como usuario, el resultado propaga los datos del usuario `name` y `type`.
`create_time`	`Timestamp` Opcional. Inmutable. En el caso de los espacios creados en Chat, es la hora a la que se creó el mensaje. Este campo es solo de salida, excepto cuando se usa en espacios en modo de importación. Para los espacios en modo de importación, establece este campo en la marca de tiempo histórica en la que se creó el mensaje en la fuente para conservar la hora de creación original.
`last_update_time`	`Timestamp` Solo salida. Indica la hora en que el usuario editó el mensaje por última vez. Si el mensaje nunca se editó, este campo estará vacío.
`delete_time`	`Timestamp` Solo salida. La hora a la que se borró el mensaje en Google Chat. Si nunca se borra el mensaje, este campo estará vacío.
`text`	`string` Cuerpo de texto sin formato del mensaje. El primer vínculo a una imagen, un video o una página web genera un chip de vista previa. También puedes @mencionar a un usuario de Google Chat o a todos los miembros del espacio. Para obtener información sobre cómo crear mensajes de texto, consulta Cómo enviar un mensaje de texto.
`formatted_text`	`string` Solo salida. Contiene el mensaje `text` con marcas agregadas para comunicar el formato. Es posible que este campo no capture todos los formatos visibles en la IU, pero incluye lo siguiente: Sintaxis de lenguaje de marcado para negrita, cursiva, tachado, monoespaciado, bloque monoespacial y lista con viñetas El usuario menciona con el formato `<users/{user}>`. Incluye hipervínculos personalizados con el formato `<{url}\|{rendered_text}>`, en el que la primera string es la URL y la segunda es el texto renderizado, por ejemplo, `<http://example.com\|custom text>`. Emojis personalizados con el formato `:{emoji_name}:`, por ejemplo, `:smile:`. No se aplica a los emojis Unicode, como `U+1F600` para un emoji de cara sonriente. Para obtener más información, consulta Cómo ver el formato de texto enviado en un mensaje.
`cards[] (deprecated)`	`Card` Este elemento es obsoleto. Obsoleto: Usa `cards_v2` en su lugar. Tarjetas interactivas, con formato y con formato que se pueden usar para mostrar elementos de la IU, como textos con formato, imágenes en las que se puede hacer clic y botones. Por lo general, las tarjetas se muestran debajo del cuerpo de texto sin formato del mensaje. `cards` y `cards_v2` pueden tener un tamaño máximo de 32 KB.
`cards_v2[]`	`CardWithId` Un array de tarjetas. Solo las apps de Chat pueden crear tarjetas. Si tu app de Chat se autentica como usuario, los mensajes no pueden contener tarjetas. Para obtener información sobre las tarjetas y cómo crearlas, consulta Cómo enviar mensajes de tarjeta. Diseña tarjetas y obtén una vista previa de ellas con Card Builder. Abre el Creador de tarjetas
`annotations[]`	`Annotation` Solo salida. Anotaciones asociadas con el `text` de este mensaje.
`thread`	`Thread` La conversación a la que pertenece el mensaje. Para ver un ejemplo de uso, consulta Cómo iniciar o responder una conversación de mensajes.
`space`	`Space` Si tu app de Chat se autentica como usuario, el resultado propaga el espacio `name`.
`fallback_text`	`string` Es una descripción en texto sin formato de las tarjetas del mensaje, que se usa cuando no se pueden mostrar las tarjetas reales; por ejemplo, notificaciones móviles.
`action_response`	`ActionResponse` Solo entrada. Parámetros que una app de Chat puede usar para configurar cómo se publica su respuesta.
`argument_text`	`string` Solo salida. Cuerpo de texto sin formato del mensaje sin todas las menciones de la app de Chat
`slash_command`	`SlashCommand` Solo salida. Información del comando de barra, si corresponde.
`attachment[]`	`Attachment` Archivo adjunto subido por el usuario.
`matched_url`	`MatchedUrl` Solo salida. Una URL en `spaces.messages.text` que coincide con un patrón de vista previa de vínculo. Si deseas obtener más información, consulta Vista previa de vínculos.
`thread_reply`	`bool` Solo salida. Cuando es `true`, el mensaje es una respuesta en un hilo de respuestas. Cuando `false`, el mensaje aparece en la conversación de nivel superior del espacio como el primer mensaje de una conversación o como un mensaje sin respuestas en múltiples conversaciones. Si el espacio no admite respuestas en conversaciones, este campo siempre será `false`.
`client_assigned_message_id`	`string` Opcional. Un ID personalizado para el mensaje. Puedes usar el campo para identificar un mensaje, o bien obtener, borrar o actualizar un mensaje. Para establecer un ID personalizado, especifica el campo `messageId` cuando crees el mensaje. Para obtener más información, consulta Cómo asignar un nombre a un mensaje.
`emoji_reaction_summaries[]`	`EmojiReactionSummary` Solo salida. Es la lista de resúmenes de reacciones con emojis del mensaje.
`private_message_viewer`	`User` Inmutable. Entrada para crear un mensaje; de lo contrario, solo salida. El usuario que puede ver el mensaje. Cuando se configura, el mensaje es privado y solo lo pueden ver el usuario especificado y la app de Chat. Las vistas previas de vínculos y los archivos adjuntos no son compatibles con los mensajes privados. Solo las apps de Chat pueden enviar mensajes privados. Si tu app de Chat se autentica como usuario para enviar un mensaje, este no puede ser privado y debe omitir este campo. Para averiguar detalles, consulta Envía mensajes privados a usuarios de Google Chat.
`deletion_metadata`	`DeletionMetadata` Solo salida. Información sobre un mensaje borrado. Se borra un mensaje cuando se configura `delete_time`.
`quoted_message_metadata`	`QuotedMessageMetadata` Solo salida. Información sobre un mensaje citado por un usuario de Google Chat en un espacio. Los usuarios de Google Chat pueden citar un mensaje para responderlo.
`attached_gifs[]`	`AttachedGif` Solo salida. Imágenes GIF adjuntas al mensaje
`accessory_widgets[]`	`AccessoryWidget` Uno o más widgets interactivos que aparecen en la parte inferior de un mensaje. Puedes agregar widgets de accesorios a los mensajes que contengan texto, tarjetas o tanto texto como tarjetas. No es compatible con mensajes que contienen diálogos. Para obtener más detalles, consulta Agrega widgets interactivos al final de un mensaje. La creación de un mensaje con widgets complementarios requiere la autenticación de la app.

MessageBatchCreatedEventData

Carga útil de eventos para varios mensajes nuevos.

Tipo de evento: google.workspace.chat.message.v1.batchCreated

Campos

messages[]

Una lista de mensajes nuevos.

MessageBatchDeletedEventData

Carga útil de eventos para varios mensajes borrados.

Tipo de evento: google.workspace.chat.message.v1.batchDeleted

Campos

messages[]

MessageDeletedEventData

Una lista de los mensajes borrados.

MessageBatchUpdatedEventData

Carga útil de eventos para varios mensajes actualizados.

Tipo de evento: google.workspace.chat.message.v1.batchUpdated

Campos

messages[]

MessageUpdatedEventData

Una lista de los mensajes actualizados.

MessageCreatedEventData

Carga útil de evento para un mensaje nuevo.

Tipo de evento: google.workspace.chat.message.v1.created

Campos

message

El mensaje nuevo.

MessageDeletedEventData

Carga útil de evento para un mensaje borrado.

Tipo de evento: google.workspace.chat.message.v1.deleted

Campos

message

El mensaje borrado. Solo se propagan los campos name, createTime, deleteTime y deletionMetadata.

MessageUpdatedEventData

Carga útil de evento para un mensaje actualizado.

Tipo de evento: google.workspace.chat.message.v1.updated

Campos

message

ReactionCreatedEventData

El mensaje actualizado.

QuotedMessageMetadata

Información sobre un mensaje citado.

Campos

name

string

Solo salida. Nombre del recurso del mensaje citado.

Formato: spaces/{space}/messages/{message}

last_update_time

Timestamp

Solo salida. La marca de tiempo de cuando se creó el mensaje citado o de cuando se actualizó por última vez.

Reacciones

Una reacción a un mensaje.

Campos

name

string

El nombre del recurso de la reacción.

Formato: spaces/{space}/messages/{message}/reactions/{reaction}

user

User

Solo salida. El usuario que creó la reacción

emoji

Emoji

El emoji que se usa en la reacción.

ReactionBatchCreatedEventData

Carga útil de eventos para varias reacciones nuevas.

Tipo de evento: google.workspace.chat.reaction.v1.batchCreated

Campos

reactions[]

Una lista de reacciones nuevas.

ReactionBatchDeletedEventData

Carga útil de eventos para varias reacciones borradas.

Tipo de evento: google.workspace.chat.reaction.v1.batchDeleted

Campos

reactions[]

ReactionDeletedEventData

Una lista de reacciones borradas.

ReactionCreatedEventData

Carga útil de evento para una reacción nueva.

Tipo de evento: google.workspace.chat.reaction.v1.created

Campos

reaction

La nueva reacción.

ReactionDeletedEventData

Carga útil de evento para una reacción borrada.

Tipo: google.workspace.chat.reaction.v1.deleted

Campos

reaction

La reacción que se borró.

RichLinkMetadata

Es un vínculo enriquecido a un recurso.

Campos
`uri`	`string` Es el URI de este vínculo.
`rich_link_type`	`RichLinkType` El tipo de vínculo enriquecido.
Campo de unión `data`. Datos del recurso vinculado. Las direcciones (`data`) solo pueden ser una de las siguientes opciones:
`drive_link_data`	`DriveLinkData` Datos para un vínculo de Drive.
`chat_space_link_data`	`ChatSpaceLinkData` Datos de un vínculo de un espacio de Chat. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

RichLinkType

El tipo de vínculo enriquecido. Es posible que se agreguen más tipos en el futuro.

Enumeraciones
`RICH_LINK_TYPE_UNSPECIFIED`	Valor predeterminado de la enumeración. No usar.
`DRIVE_FILE`	Un tipo de vínculo enriquecido de Google Drive.
`CHAT_SPACE`	Un tipo de vínculo enriquecido a un espacio de Chat. Por ejemplo, un chip inteligente espacial. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

SearchSpacesRequest

Solicitud para buscar una lista de espacios en función de una consulta.

Campos
`use_admin_access`	`bool` 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.spaces.readonly` o `chat.admin.spaces`. Actualmente, este método solo admite acceso de administrador, por lo que solo se acepta `true` para este campo.
`page_size`	`int32` La cantidad máxima de espacios que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran 100 espacios como máximo. El valor máximo es 1,000. Si usas un valor superior a 1,000, este se cambia automáticamente a 1,000.
`page_token`	`string` Un token, recibido de la llamada a los espacios de búsqueda anterior. Proporciona este parámetro para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token de la página. Pasar valores diferentes a los otros parámetros puede generar resultados inesperados.
`query`	`string` Obligatorio. Una búsqueda. Puedes buscar con los siguientes parámetros: `create_time` `customer` `display_name` `external_user_allowed` `last_active_time` `space_history_state` `space_type` `create_time` y `last_active_time` aceptan una marca de tiempo en formato RFC-3339 y los operadores de comparación admitidos son `=`, `<`, `>`, `<=` y `>=`. `customer` es obligatorio y se usa para indicar de qué cliente se deben recuperar los espacios. `customers/my_customer` es el único valor admitido. `display_name` solo acepta el operador `HAS` (`:`). Primero, se asigna un token al texto que debe coincidir en tokens, y a cada token se le asigna un prefijo que no distingue entre mayúsculas y minúsculas, y es independiente, como una subcadena en el `display_name` del espacio. Por ejemplo, `Fun Eve` coincide con `Fun event` o `The evening was fun`, pero no con `notFun event` ni `even`. `external_user_allowed` acepta `true` o `false`. `space_history_state` solo acepta valores del campo `historyState` de un recurso `space`. `space_type` es obligatorio y el único valor válido es `SPACE`. En diferentes campos, solo se admiten los operadores `AND`. Un ejemplo válido es `space_type = "SPACE" AND display_name:"Hello"` y un ejemplo no válido es `space_type = "SPACE" OR display_name:"Hello"`. Entre el mismo campo, `space_type` no admite los operadores `AND` ni `OR`. `display_name`, 'space_history_state' y 'external_user_allowed' solo admite operadores `OR`. `last_active_time` y `create_time` admiten los operadores `AND` y `OR`. `AND` solo se puede usar para representar un intervalo, como `last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00"`. Las siguientes consultas de ejemplo son válidas: customer = "customers/my_customer" AND space_type = "SPACE" customer = "customers/my_customer" AND space_type = "SPACE" AND display_name:"Hello World" customer = "customers/my_customer" AND space_type = "SPACE" AND (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time > "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (display_name:"Hello World" OR display_name:"Fun event") AND (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time < "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (create_time > "2019-01-01T00:00:00+00:00" AND create_time < "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
`order_by`	`string` Opcional. Cómo se ordena la lista de espacios. Los atributos admitidos para ordenar son los siguientes: `membership_count.joined_direct_human_user_count`: Indica la cantidad de usuarios humanos que se unieron directamente a un espacio. `last_active_time`: Indica el momento en que se agregó el último elemento apto a cualquier tema de este espacio. `create_time`: Indica la hora de la creación del espacio. Los valores válidos de la operación de ordenamiento son los siguientes: `ASC` para el orden ascendente. Valor predeterminado `DESC` para el orden descendente. Las sintaxis admitidas son las siguientes: `membership_count.joined_direct_human_user_count DESC` `membership_count.joined_direct_human_user_count ASC` `last_active_time DESC` `last_active_time ASC` `create_time DESC` `create_time ASC`

SearchSpacesResponse

Respuesta con una lista de los espacios correspondientes a la solicitud de espacios de búsqueda.

Campos

spaces[]

Una página de los espacios solicitados.

next_page_token

string

Un token que se puede usar para recuperar la página siguiente. Si este campo está vacío, no hay páginas posteriores.

total_size

int32

Es la cantidad total de espacios que coinciden con la búsqueda en todas las páginas. Si el resultado supera los 10,000 espacios, este valor es una estimación.

SetUpSpaceRequest

Solicita crear un espacio y agregarle usuarios específicos.

Campos

space

Obligatorio. El campo Space.spaceType es obligatorio.

Para crear un espacio, establece Space.spaceType en SPACE y Space.displayName. Si recibes el mensaje de error ALREADY_EXISTS cuando configuras un espacio, prueba con otro displayName. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible.

Para crear un chat en grupo, establece Space.spaceType en GROUP_CHAT. No configures Space.displayName.

Para crear una conversación 1:1 entre personas, establece Space.spaceType en DIRECT_MESSAGE y Space.singleUserBotDm en false. No configures Space.displayName ni Space.spaceDetails.

Para crear una conversación 1:1 entre una persona y la app de Chat que realiza la llamada, establece Space.spaceType en DIRECT_MESSAGE y Space.singleUserBotDm en true. No configures Space.displayName ni Space.spaceDetails.

Si ya existe un espacio DIRECT_MESSAGE, se muestra ese espacio en lugar de crear uno nuevo.

request_id

string

memberships[]

Opcional. Los usuarios o grupos de Google Chat a los que se invitará a unirse al espacio. Omite al usuario que llama, ya que se agrega automáticamente.

Actualmente, el conjunto permite hasta 20 membresías (además del llamador).

Para la membresía humana, el campo Membership.member debe contener un user con name propagado (formato: users/{user}) y type configurado como User.Type.HUMAN. Solo puedes agregar usuarios humanos cuando configuras un espacio (agregar apps de Chat solo se admite para la configuración de mensajes directos con la app de llamadas). También puedes agregar miembros con el correo electrónico del usuario como alias de {user}. Por ejemplo, user.name puede ser users/example@gmail.com. Para invitar a usuarios de Gmail o de dominios externos de Google Workspace, se debe usar el correo electrónico del usuario para {user}.

Para la membresía a un Grupo de Google, el campo Membership.group_member debe contener una group con name propagado (formato groups/{group}). Solo puedes agregar Grupos de Google si estableces Space.spaceType en SPACE.

Es opcional cuando se establece Space.spaceType en SPACE.

Es obligatorio cuando se configura Space.spaceType como GROUP_CHAT, junto con al menos dos membresías.

Es obligatorio cuando se configura Space.spaceType como DIRECT_MESSAGE con un usuario humano, junto con exactamente una membresía.

Debe estar vacío cuando se crea una conversación 1:1 entre una persona y la app de Chat que realiza la llamada (cuando configuras Space.spaceType en DIRECT_MESSAGE y Space.singleUserBotDm en true).

SlashCommand

Un comando de barra en Google Chat

Campos

command_id

int64

El ID del comando de barra invocado

SlashCommandMetadata

Metadatos de anotación para comandos de barra (/).

Campos
`bot`	`User` La app de Chat cuyo comando se invocó.
`type`	`Type` El tipo de comando de barra.
`command_name`	`string` El nombre del comando de barra invocado.
`command_id`	`int64` El ID del comando de barra invocado
`triggers_dialog`	`bool` Indica si el comando de barra es para un diálogo.

Tipo

Enumeraciones
`TYPE_UNSPECIFIED`	Valor predeterminado de la enumeración. No usar.
`ADD`	Agregar la app de Chat al espacio
`INVOKE`	Invoca el comando de barra en el espacio.

Espacio

Un espacio en Google Chat Los espacios son conversaciones entre dos o más usuarios, o mensajes 1:1 entre un usuario y una app de Chat.

Campos
`name`	`string` Nombre de recurso del espacio. Formato: `spaces/{space}`
`type (deprecated)`	`Type` Este elemento es obsoleto. Solo salida. Obsoleto: Usa `space_type` en su lugar. Indica el tipo de espacio.
`space_type`	`SpaceType` Indica el tipo de espacio. Es obligatorio cuando se crea un espacio o se actualiza su tipo. Salida solo para otros usos.
`single_user_bot_dm`	`bool` Opcional. Si el espacio es un MD entre una app de Chat y una sola persona
`threaded (deprecated)`	`bool` Este elemento es obsoleto. Solo salida. Obsoleto: Usa `spaceThreadingState` en su lugar. Si los mensajes se agrupan en conversaciones en este espacio
`display_name`	`string` El nombre visible del espacio. Es obligatorio cuando creas un espacio. Si recibes el mensaje de error `ALREADY_EXISTS` cuando creas un espacio o actualizas el `displayName`, prueba con otro `displayName`. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible. Para los mensajes directos, este campo puede estar vacío. Admite hasta 128 caracteres.
`external_user_allowed`	`bool` Inmutable. Si este espacio permite que cualquier usuario de Google Chat sea miembro. Entrada cuando se crea un espacio en una organización de Google Workspace. Omite este campo cuando crees espacios en las siguientes condiciones: El usuario autenticado utiliza una cuenta personal (cuenta de usuario no administrada). De forma predeterminada, un espacio creado por una cuenta personal permite cualquier usuario de Google Chat. Para los espacios existentes, este campo es de solo salida.
`space_threading_state`	`SpaceThreadingState` Solo salida. El estado de la conversación en el espacio de Chat
`space_details`	`SpaceDetails` Detalles sobre el espacio, incluida la descripción y las reglas
`space_history_state`	`HistoryState` Es el estado del historial de mensajes de los mensajes y las conversaciones de este espacio.
`import_mode`	`bool` Opcional. Si este espacio se crea en `Import Mode` como parte de una migración de datos a Google Workspace. Mientras se importan los espacios, los usuarios no podrán verlos hasta que se complete la importación.
`create_time`	`Timestamp` Opcional. Inmutable. En el caso de los espacios creados en Chat, la hora a la que se creó el espacio. Este campo es solo de salida, excepto cuando se usa en espacios en modo de importación. Para los espacios en modo de importación, establece este campo en la marca de tiempo histórica en la que se creó el espacio en la fuente para conservar la hora de creación original. Solo se propaga en el resultado cuando `spaceType` es `GROUP_CHAT` o `SPACE`.
`last_active_time`	`Timestamp` Solo salida. Marca de tiempo del último mensaje en el espacio. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.
`admin_installed`	`bool` Solo salida. En el caso de los espacios de mensajes directos (MD) con una app de Chat, indica si el espacio fue creado por un administrador de Google Workspace. Los administradores pueden instalar y configurar un mensaje directo con una app de Chat en nombre de los usuarios de su organización. Para admitir la instalación por parte de administradores, tu app de Chat debe incluir mensajes directos.
`membership_count`	`MembershipCount` Solo salida. La cantidad de membresías unidas agrupadas por tipo de miembro. Se propaga cuando `space_type` es `SPACE`, `DIRECT_MESSAGE` o `GROUP_CHAT`. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.
`access_settings`	`AccessSettings` Opcional. Especifica la configuración de acceso del espacio. Solo se completa cuando `space_type` es `SPACE`.
`space_uri`	`string` Solo salida. Es el URI para que un usuario acceda al espacio.
Campo de unión `space_permission_settings`. Representa la configuración de permisos de un espacio. Solo se completa cuando `space_type` es `SPACE`. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. `space_permission_settings` puede ser solo una de las siguientes opciones:
`predefined_permission_settings`	`PredefinedPermissionSettings` Opcional. Solo entrada. Configuración de permisos de espacios. Entrada para crear un espacio. Si no estableces este campo, se creará un espacio de colaboración. Una vez que crees el espacio, la configuración se completará en el campo `PermissionSettings`. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.
`permission_settings`	`PermissionSettings` Opcional. La configuración de permisos exacta, que se puede establecer para actualizar el espacio Entrada para actualizar un espacio. De lo contrario, solo muestra el resultado. Para crear espacios, usa `predefined_permission_settings`. Versión preliminar para desarrolladores: Está disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

AccessSettings

Representa la configuración de acceso del espacio.

Campos

access_state

AccessState

Solo salida. Indica el estado de acceso del espacio.

audience

string

Opcional. Es el nombre de recurso del público objetivo que puede descubrir el espacio, unirse a él y obtener una vista previa de los mensajes que contiene. Si no la estableces, solo podrán acceder a él los usuarios o Grupos de Google que se hayan invitado o agregado de forma individual al espacio. Para conocer más detalles, consulta Haz que un espacio sea detectable para el público objetivo.

Formato: audiences/{audience}

Para usar el usuario objetivo predeterminado de la organización de Google Workspace, establécelo en audiences/default.

AccessState

Representa el estado de acceso del espacio.

Enumeraciones
`ACCESS_STATE_UNSPECIFIED`	Se desconoce el estado del acceso o no se admite en esta API.
`PRIVATE`	Solo los usuarios o Grupos de Google que otros usuarios o administradores de Google Workspace hayan agregado o invitado de forma individual pueden descubrir el espacio y acceder a él.
`DISCOVERABLE`	Un administrador del espacio otorgó acceso al espacio a usuarios objetivo. Los usuarios o Grupos de Google que se hayan agregado o invitado de forma individual al espacio también podrán descubrirlo y acceder a él. Para obtener más información, consulta Haz que un espacio sea visible para usuarios específicos.

MembershipCount

Representa el recuento de membresías de un espacio, agrupadas en categorías.

Campos

joined_direct_human_user_count

int32

Recuento de usuarios humanos que se unieron directamente al espacio, sin contar los usuarios que se unieron a un grupo.

joined_group_count

int32

Recuento de todos los grupos que se unieron directamente al espacio.

PermissionSetting

Representa un parámetro de configuración de permisos de espacio.

Campos

managers_allowed

bool

Si los administradores de espacios tienen este permiso

members_allowed

bool

Indica si las personas que no son administradores tienen este permiso.

PermissionSettings

Configuración de permisos para un espacio con nombre Para establecer la configuración de permisos cuando creas un espacio, especifica el campo PredefinedPermissionSettings en la solicitud.

Campos
`manage_members_and_groups`	`PermissionSetting` Parámetro de configuración para administrar los miembros y grupos de un espacio.
`modify_space_details`	`PermissionSetting` Parámetro de configuración para actualizar el nombre, el avatar, la descripción y los lineamientos del espacio.
`toggle_history`	`PermissionSetting` Parámetro de configuración para activar y desactivar el historial de espacio.
`use_at_mention_all`	`PermissionSetting` Parámetro de configuración para usar @todos en un espacio.
`manage_apps`	`PermissionSetting` Parámetro de configuración para administrar apps en un espacio.
`manage_webhooks`	`PermissionSetting` Parámetro de configuración para administrar webhooks en un espacio.
`post_messages`	`PermissionSetting` Solo salida. Parámetro de configuración para publicar mensajes en un espacio.
`reply_messages`	`PermissionSetting` Parámetro de configuración para responder mensajes en un espacio.

PredefinedPermissionSettings

La configuración de permisos de espacio que puedes especificar cuando creas un espacio con nombre. Es posible que se agreguen más parámetros de configuración en el futuro. Para obtener detalles sobre la configuración de permisos para espacios con nombre, consulta Información sobre los espacios.

Enumeraciones
`PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED`	Sin especificar. No usar.
`COLLABORATION_SPACE`	Parámetro de configuración para que el espacio sea de colaboración en el que todos los miembros puedan publicar mensajes.
`ANNOUNCEMENT_SPACE`	Parámetro de configuración para convertir este espacio en un espacio de anuncios en el que solo los administradores del espacio puedan publicar mensajes.

SpaceDetails

Detalles sobre el espacio, incluida la descripción y las reglas

Campos

description

string

Opcional. Es una descripción del espacio. Por ejemplo, describe el tema de debate del espacio, el propósito funcional o los participantes.

Admite hasta 150 caracteres.

guidelines

string

Opcional. Las reglas, las expectativas y el protocolo del espacio.

Admite hasta 5,000 caracteres.

SpaceThreadingState

Especifica el tipo de estado de conversación en el espacio de Chat.

Enumeraciones
`SPACE_THREADING_STATE_UNSPECIFIED`	Reservado.
`THREADED_MESSAGES`	Espacios con nombre que admiten conversaciones de mensajes Cuando los usuarios responden un mensaje, pueden hacerlo dentro de la conversación, lo que mantiene su respuesta en el contexto del mensaje original.
`GROUPED_MESSAGES`	Son espacios con nombre en los que la conversación se organiza por tema. Los temas y sus respuestas se agrupan.
`UNTHREADED_MESSAGES`	Mensajes directos (MD) entre dos personas y conversaciones grupales entre 3 o más personas.

SpaceType

Indica el tipo de espacio. Es obligatorio cuando se crea o actualiza un espacio. Salida solo para otros usos.

Enumeraciones
`SPACE_TYPE_UNSPECIFIED`	Reservado.
`SPACE`	Un lugar donde las personas envían mensajes, comparten archivos y colaboran. Un `SPACE` puede incluir apps de Chat.
`GROUP_CHAT`	Conversaciones grupales entre 3 o más personas Un `GROUP_CHAT` puede incluir apps de Chat.
`DIRECT_MESSAGE`	Mensajes 1:1 entre dos personas o entre una persona y una app de Chat.

Tipo

Obsoleto: Usa SpaceType en su lugar.

Enumeraciones
`TYPE_UNSPECIFIED`	Reservado.
`ROOM`	Conversaciones entre dos o más personas.
`DM`	Mensaje directo 1:1 entre una persona y una app de Chat, en la que todos los mensajes son planos. Ten en cuenta que esto no incluye los mensajes directos entre dos personas.

SpaceBatchUpdatedEventData

Carga útil de eventos para varias actualizaciones de un espacio.

Tipo de evento: google.workspace.chat.space.v1.batchUpdated

Campos

spaces[]

SpaceUpdatedEventData

Una lista de los espacios actualizados.

SpaceEvent

Un evento que representa un cambio o una actividad en un espacio de Google Chat. Para obtener más información, consulta Trabaja con eventos desde Google Chat.

Campos
`name`	`string` Es el nombre del recurso del evento de espacio. Formato: `spaces/{space}/spaceEvents/{spaceEvent}`
`event_time`	`Timestamp` Hora en la que ocurrió el evento.
`event_type`	`string` Tipo de evento espacial. Cada tipo de evento tiene una versión por lotes, que representa varias instancias del tipo de evento que ocurren en un período corto. Para las solicitudes `spaceEvents.list()`, omite los tipos de eventos por lotes en el filtro de consulta. De forma predeterminada, el servidor muestra el tipo de evento y su versión por lotes. Tipos de eventos admitidos para mensajes: Mensaje nuevo: `google.workspace.chat.message.v1.created` Mensaje actualizado: `google.workspace.chat.message.v1.updated` Mensaje borrado: `google.workspace.chat.message.v1.deleted` Varios mensajes nuevos: `google.workspace.chat.message.v1.batchCreated` Hay varios mensajes actualizados: `google.workspace.chat.message.v1.batchUpdated` Varios mensajes borrados: `google.workspace.chat.message.v1.batchDeleted` Tipos de eventos admitidos para las membresías: Nueva membresía: `google.workspace.chat.membership.v1.created` Se actualizó la membresía: `google.workspace.chat.membership.v1.updated` Membresía borrada: `google.workspace.chat.membership.v1.deleted` Varias membresías nuevas: `google.workspace.chat.membership.v1.batchCreated` Se actualizaron varias membresías: `google.workspace.chat.membership.v1.batchUpdated` Se borraron varias membresías: `google.workspace.chat.membership.v1.batchDeleted` Tipos de eventos admitidos para las reacciones: Nueva reacción: `google.workspace.chat.reaction.v1.created` Se borró la reacción: `google.workspace.chat.reaction.v1.deleted` Varias reacciones nuevas: `google.workspace.chat.reaction.v1.batchCreated` Se borraron varias reacciones: `google.workspace.chat.reaction.v1.batchDeleted` Tipos de eventos admitidos sobre el espacio: Espacio actualizado: `google.workspace.chat.space.v1.updated` Varias actualizaciones del espacio: `google.workspace.chat.space.v1.batchUpdated`
Campo de unión `payload`. `payload` puede ser una de las siguientes opciones:
`message_created_event_data`	`MessageCreatedEventData` Carga útil de evento para un mensaje nuevo. Tipo de evento: `google.workspace.chat.message.v1.created`
`message_updated_event_data`	`MessageUpdatedEventData` Carga útil de evento para un mensaje actualizado. Tipo de evento: `google.workspace.chat.message.v1.updated`
`message_deleted_event_data`	`MessageDeletedEventData` Carga útil de evento para un mensaje borrado. Tipo de evento: `google.workspace.chat.message.v1.deleted`
`message_batch_created_event_data`	`MessageBatchCreatedEventData` Carga útil de eventos para varios mensajes nuevos. Tipo de evento: `google.workspace.chat.message.v1.batchCreated`
`message_batch_updated_event_data`	`MessageBatchUpdatedEventData` Carga útil de eventos para varios mensajes actualizados. Tipo de evento: `google.workspace.chat.message.v1.batchUpdated`
`message_batch_deleted_event_data`	`MessageBatchDeletedEventData` Carga útil de eventos para varios mensajes borrados. Tipo de evento: `google.workspace.chat.message.v1.batchDeleted`
`space_updated_event_data`	`SpaceUpdatedEventData` Carga útil de evento para una actualización del espacio. Tipo de evento: `google.workspace.chat.space.v1.updated`
`space_batch_updated_event_data`	`SpaceBatchUpdatedEventData` Carga útil de eventos para varias actualizaciones de un espacio. Tipo de evento: `google.workspace.chat.space.v1.batchUpdated`
`membership_created_event_data`	`MembershipCreatedEventData` Carga útil de evento para una membresía nueva. Tipo de evento: `google.workspace.chat.membership.v1.created`
`membership_updated_event_data`	`MembershipUpdatedEventData` Carga útil de evento para una membresía actualizada. Tipo de evento: `google.workspace.chat.membership.v1.updated`
`membership_deleted_event_data`	`MembershipDeletedEventData` Carga útil de evento para una membresía borrada. Tipo de evento: `google.workspace.chat.membership.v1.deleted`
`membership_batch_created_event_data`	`MembershipBatchCreatedEventData` Carga útil de eventos para varias membresías nuevas. Tipo de evento: `google.workspace.chat.membership.v1.batchCreated`
`membership_batch_updated_event_data`	`MembershipBatchUpdatedEventData` Carga útil de eventos para varias membresías actualizadas. Tipo de evento: `google.workspace.chat.membership.v1.batchUpdated`
`membership_batch_deleted_event_data`	`MembershipBatchDeletedEventData` Carga útil de eventos para varias membresías borradas. Tipo de evento: `google.workspace.chat.membership.v1.batchDeleted`
`reaction_created_event_data`	`ReactionCreatedEventData` Carga útil de evento para una reacción nueva. Tipo de evento: `google.workspace.chat.reaction.v1.created`
`reaction_deleted_event_data`	`ReactionDeletedEventData` Carga útil de evento para una reacción borrada. Tipo de evento: `google.workspace.chat.reaction.v1.deleted`
`reaction_batch_created_event_data`	`ReactionBatchCreatedEventData` Carga útil de eventos para varias reacciones nuevas. Tipo de evento: `google.workspace.chat.reaction.v1.batchCreated`
`reaction_batch_deleted_event_data`	`ReactionBatchDeletedEventData` Carga útil de eventos para varias reacciones borradas. Tipo de evento: `google.workspace.chat.reaction.v1.batchDeleted`

SpaceReadState

El estado de lectura de un usuario dentro de un espacio, que se usa para identificar mensajes leídos y no leídos.

Campos

name

string

Nombre de recurso del estado de lectura del espacio.

Formato: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

Opcional. La hora en la que se actualizó el estado de lectura del espacio del usuario. Por lo general, se corresponde con la marca de tiempo del último mensaje leído o con una marca de tiempo especificada por el usuario para marcar la última posición de lectura en un espacio.

SpaceUpdatedEventData

Carga útil de evento para un espacio actualizado.

Tipo de evento: google.workspace.chat.space.v1.updated

Campos

space

El espacio actualizado.

Conversación

Una conversación en un espacio de Google Chat Para ver un ejemplo de uso, consulta Cómo iniciar o responder una conversación de mensajes.

Si especificas una conversación cuando creas un mensaje, puedes configurar el campo messageReplyOption para determinar qué sucede si no se encuentra una conversación que coincida.

Campos

name

string

Nombre del recurso del subproceso.

Ejemplo: spaces/{space}/threads/{thread}

thread_key

string

Opcional. Entrada para crear o actualizar un subproceso. De lo contrario, solo muestra el resultado. Es el ID del subproceso. Admite hasta 4,000 caracteres.

Este ID es exclusivo de la app de Chat que lo establece. Por ejemplo, si varias apps de Chat crean un mensaje con la misma clave de conversación, estos se publicarán en diferentes conversaciones. Para responder en una conversación creada por una persona o por otra app de Chat, especifica el campo de la conversación name.

ThreadReadState

El estado de lectura de un usuario dentro de una conversación, que se usa para identificar mensajes leídos y no leídos.

Campos

name

string

Nombre del recurso del estado de lectura del subproceso.

Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

El momento en que se actualizó el estado de lectura del subproceso del usuario. Por lo general, se corresponde con la marca de tiempo del último mensaje leído de una conversación.

UpdateMembershipRequest

Mensaje de solicitud para actualizar una membresía.

Campos

membership

Obligatorio. La membresía que se actualizará. Solo se actualizan los campos especificados por update_mask.

update_mask

Obligatorio. Las rutas de campo que se actualizarán. Separa varios valores con comas o usa * para actualizar todas las rutas de campo.

Rutas de campo admitidas actualmente:

role

use_admin_access

bool

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.

UpdateMessageRequest

Solicitud para actualizar un mensaje.

Campos

message

Obligatorio. Se actualizó el mensaje con los campos.

update_mask

Obligatorio. Las rutas de campo que se actualizarán. Separa varios valores con comas o usa * para actualizar todas las rutas de campo.

Rutas de campo admitidas actualmente:

text
attachment
cards (Requiere autenticación de apps).
cards_v2 (Requiere autenticación de apps).
accessory_widgets (Requiere autenticación de apps).

allow_missing

bool

Opcional. Si true y no se encuentra el mensaje, se creará uno nuevo y se ignorará updateMask. El ID del mensaje especificado debe ser client-Assigned. De lo contrario, la solicitud fallará.

UpdateSpaceReadStateRequest

Mensaje de solicitud para la API de UpdateSpaceReadState.

Campos

space_read_state

SpaceReadState

Obligatorio. El estado de lectura del espacio y los campos que se actualizarán.

Solo es compatible con la actualización del estado de lectura del usuario que realiza la llamada.

Para hacer referencia al usuario que realiza la llamada, configura una de las siguientes opciones:

El alias me. Por ejemplo, users/me/spaces/{space}/spaceReadState
Su dirección de correo electrónico de Workspace Por ejemplo, users/user@example.com/spaces/{space}/spaceReadState.
Su ID de usuario Por ejemplo, users/123456789/spaces/{space}/spaceReadState.

Formato: users/{user}/spaces/{space}/spaceReadState

update_mask

Obligatorio. Las rutas de campo que se actualizarán. Rutas de campo admitidas actualmente:

last_read_time

Cuando last_read_time sea anterior a la hora de creación del mensaje más reciente, el espacio aparecerá como no leído en la IU.

Para marcar el espacio como leído, establece last_read_time en cualquier valor posterior (mayor) que la hora de creación del mensaje más reciente. Se fuerza last_read_time para que coincida con la hora de creación del mensaje más reciente. Ten en cuenta que el estado de lectura del espacio solo afecta la lectura de los mensajes que aparecen en la conversación de nivel superior del espacio. Las respuestas de los subprocesos no se ven afectadas por esta marca de tiempo y, en su lugar, dependen del estado de lectura del subproceso.

UpdateSpaceRequest

Una solicitud para actualizar un solo espacio.

Campos

space

Obligatorio. Espacio con campos que se actualizarán. Space.name debe completarse con el formato spaces/{space}. Solo se actualizan los campos especificados por update_mask.

update_mask