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.
Autenticación
Se requiere autenticación para llamar a la API de Chat. 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.
Bibliotecas cliente
La forma recomendada para que la mayoría de los desarrolladores llamen a la API de Google Chat es con nuestra asistencia oficial Bibliotecas cliente de Cloud para tu lenguaje preferido, como Python, Java o Node.js.
Si estás programando con Google Apps Script, usa la Servicio de chat avanzado en lugar de instalar una biblioteca cliente.
Conceptos de la API de Google Chat
Servicios de gRPC o recursos y métodos de REST otorgar acceso a espacios de Chat, miembros de espacios, mensajes, mensajes reacciones, archivos adjuntos de mensajes, eventos del espacio y estados de lectura de los usuarios.
- 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.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Miembros
Los miembros son usuarios y apps de Chat que se unieron o están a un espacio.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- 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.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Reacciones
Las reacciones representan los emojis que las personas usan para reaccionar a un mensaje, como el 👍, ꛭ y automatizados.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Contenido multimedia y archivos adjuntos
Contenido multimedia representa un archivo subido a Google Chat, como imágenes, videos y documentos.
Referencia de recursos multimedia (no disponible en RPC):
Los archivos adjuntos son instancias de contenido multimedia (archivos) adjuntos a mensajes.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Eventos espaciales
Los eventos de espacio representan cambios que se realizan en un espacio o sus recursos secundarios, incluidos sus miembros, mensajes y reacciones.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- 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.
Referencia de recursos del estado de lectura del espacio:
Referencia de recursos de estado de lectura de subprocesos:
Para ver ejemplos de uso, consulta lo siguiente:
Temas relacionados
- Explora los ejemplos de la app de Google Chat para comienza a usar la API de Chat.
Además de llamar a la API de Chat, las apps de Chat también pueden realizar las siguientes acciones:
- Recibir y responder eventos de interacción con la app de Chat como mensajes enviados a la app de Google Chat, en tiempo real.
- Suscríbete a eventos de Google Chat de tomar medidas o responder cuando ciertas actividades o cambios suceden en Chat, como mensajes nuevos y cambios en las membresías.