Descripción general de la API de Google Chat

En esta sección, se explica cómo una app de Google Chat puede llamar a la API de Chat, lo que permite que esas apps realicen acciones como crear un espacio, agregar personas a él y publicar un mensaje sin que un evento de interacción con la app de Chat lo solicite.

Autenticación

Llamar a la API de Chat de forma asíncrona requiere autenticación. Cada método de la API de Chat requiere la autenticación del usuario (para realizar acciones o acceder a los datos en nombre de un usuario) o la autenticación de la app (para realizar acciones o acceder a los datos como una app de Chat). Algunos métodos admiten la autenticación de usuarios y de apps.

Para obtener más información sobre la autenticación en Chat, consulta Descripción general de la autenticación.

Recursos y métodos de la API

Los recursos y métodos de REST otorgan acceso asíncrono a los espacios de Chat y los miembros de espacios, los mensajes, las reacciones a mensajes y los archivos adjuntos de mensajes.

Espacios

Los espacios son lugares donde las personas y las apps pueden conversar y compartir archivos. Existen varios tipos de espacios. Los mensajes directos (MD) son conversaciones 1:1 entre dos usuarios o un usuario y una app de Chat. Los chats en grupo son conversaciones entre tres o más usuarios y las apps de chat. Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.

El recurso spaces representa un espacio.

Los espacios admiten los siguientes métodos:

Miembros

Los miembros son los usuarios y las apps de Chat que se unieron a un espacio o que recibieron invitaciones.

El recurso spaces.members representa a un miembro.

Los miembros admiten los siguientes métodos:

Mensajes

Los mensajes incluyen las comunicaciones de texto y tarjetas publicadas en espacios. Los mensajes pueden tener archivos adjuntos. Las personas pueden reaccionar a los mensajes agregándoles emojis.

El recurso spaces.messages representa un mensaje.

Los mensajes admiten los siguientes métodos:

Reacciones

Las reacciones representan los emojis que las personas usan para reaccionar a un mensaje, como 👍, Ъ y pe.

El recurso spaces.messages.reactions representa una reacción.

Las reacciones admiten los siguientes métodos:

Contenido multimedia y archivos adjuntos

Contenido multimedia representa un archivo subido a Google Chat, como imágenes, videos y documentos.

El recurso media representa el contenido multimedia adjunto a los mensajes.

Los archivos adjuntos son instancias de contenido multimedia (archivos) adjuntos a mensajes.

El recurso spaces.messages.attachments representa un adjunto. Un archivo adjunto incluye el contenido multimedia y los metadatos asociados adjuntos a un mensaje.

El contenido multimedia y los archivos adjuntos admiten los siguientes métodos:

Estados de lectura del usuario (versión preliminar para desarrolladores)

Los estados de lectura del usuario son recursos singleton que representan detalles sobre el último mensaje leído de un usuario específico en un espacio de Google Chat o una conversación de mensajes.

El recurso users.spaces representa el estado de lectura de un usuario en un espacio.

El recurso users.spaces.threads representa el estado de lectura de un usuario en una conversación de mensajes.

Los estados de lectura del usuario admiten los siguientes métodos: