En esta sección, se explica cómo una app de Google Chat puede llamar la API de Chat, que les permite a las apps de Chat crear un espacio, agregarle personas y publicar un mensaje sin que te lo solicite Evento de interacción con la app de Chat.
Autenticación
Se requiere autenticación para llamar a la API de Chat de forma asíncrona. Cada El método de la API de Chat requiere lo siguiente: autenticación de usuarios (para realizar acciones o acceder datos en nombre de un usuario) o autenticación de apps (para realizar acciones o acceder a datos como una app de Chat). Algunos admiten la autenticación de usuarios y la autenticación 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 Chat espacios, miembros del espacio, mensajes, reacciones a mensajes y archivos adjuntos de mensajes.
- Espacios
Los Espacios son lugares donde las personas y las apps pueden conversar y compartir archivos. Hay hay varios tipos de espacios. Los mensajes directos (MD) son conversaciones individuales entre dos usuarios o un usuario y una app de Chat. Grupo los chats son conversaciones entre tres o más usuarios y Apps de Chat Los espacios con nombre son lugares persistentes donde las personas envían compartir archivos y colaborar.
El Recurso
spaces
representa un espacio.Los espacios admiten los siguientes métodos:
- Crear un espacio un lugar donde las personas y las aplicaciones puedan conversar y compartir archivos.
- Configura un espacio para crear el espacio y agregarle personas y apps de Chat. espacio.
- Obtén un espacio para ver detalles de un espacio.
- Crea listas de espacios para ver una lista de espacios paginada y filtrable.
- Actualiza un espacio para cambiar los atributos de un espacio, como su nombre visible visible para el usuario descripción y lineamientos.
- Cómo borrar un espacio cuando ya no se necesita.
- Cómo encontrar un mensaje directo (MD) Para devolver un MD entre dos usuarios o entre un usuario y el Apps de Chat
- Miembros
Los miembros son usuarios y apps de Chat que se unieron o están a un espacio.
El Recurso
spaces.members
representa a un miembro.Los miembros admiten los siguientes métodos:
- Crea una membresía para agregar un usuario o una app a un espacio.
- Obtén una membresía para ver los detalles de la membresía.
- Lista de membresías para ver una lista paginada y filtrable de membresías de un espacio.
- Cómo actualizar una membresía para cambiar los atributos de una membresía, como cambiar un miembro del espacio a administrador del espacio o cambio de administrador del espacio a miembro del espacio.
- Cómo borrar una membresía para quitar a un usuario o una app de un espacio.
- Mensajes
Los mensajes incluyen texto y tarjeta comunicaciones publicadas en los espacios. Los mensajes pueden tener archivos adjuntos. Las personas pueden reaccionar a los mensajes agregando emojis a ellos.
El Recurso
spaces.messages
representa un mensaje.Mensajes admite los siguientes métodos:
- Crea un mensaje para publicar un texto o tarjeta. También puedes iniciar o responder una conversación.
- Recibir un mensaje para obtener detalles sobre un mensaje, como la fecha de envío o lo que dice.
- Cómo enumerar mensajes para ver una lista paginada de mensajes en un espacio que se puede filtrar.
- Actualiza un mensaje para cambiar los atributos del mensaje, como lo que dice. También puedes agregar texto a un mensaje de tarjeta, o una tarjeta a un mensaje de texto.
- Cómo borrar un mensaje cuando ya no se necesita.
- Reacciones
Las reacciones representan los emojis que las personas usan para reaccionar a un mensaje, como el 👍, 📊 y Kerberos.
El Recurso
spaces.messages.reactions
representa una reacción.Las reacciones admiten los siguientes métodos:
- Cómo crear una reacción para agregar un emoji a un mensaje.
- Cómo enumerar reacciones para ver una lista paginada de reacciones a un mensaje que se puede filtrar.
- Cómo borrar una reacción para quitar un emoji del mensaje.
- 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 archivos metadatos adjuntos a un mensaje.El contenido multimedia y los archivos adjuntos admiten los siguientes métodos:
- Cómo subir contenido multimedia como archivo adjunto para subir contenido multimedia a Google Chat y, luego, adjuntarlo a un mensaje.
- Cómo descargar contenido multimedia como archivo adjunto para descargar contenido multimedia de Google Chat como un archivo binario.
- Cómo obtener un archivo adjunto para recuperar metadatos sobre el archivo adjunto de un mensaje.
- Eventos espaciales
Los eventos de espacio representan cambios que se realizan en un espacio o sus recursos secundarios, incluidos sus miembros, mensajes y reacciones.
El recurso
spaces.spaceEvent
representa un evento espacial.Los eventos de espacio admiten los siguientes métodos:
- Organiza un evento espacial para mostrar detalles sobre un evento que ocurrió en un espacio.
- Crea una lista de los eventos del espacio para obtener una lista de los eventos que ocurrieron en un espacio.
- Estados de lectura de los usuarios
Los estados de lectura de los usuarios son recursos singleton que representan detalles sobre un el último mensaje leído de un usuario especificado en un espacio de Google Chat o un mensaje conversación.
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.Los estados de lectura de los usuarios admiten los siguientes métodos:
- Cómo obtener el estado de lectura del espacio para mostrar detalles sobre el estado de lectura de un usuario dentro de un espacio.
- Actualiza el estado de lectura del espacio para actualizar el estado de lectura de un usuario en un espacio.
- Obtén el estado de lectura de subprocesos para mostrar detalles sobre el estado de lectura de un usuario dentro de un subproceso.