En esta sección, se explica cómo una app de Google Chat puede llamar a la API de Chat, lo que permite que las apps de Chat realicen acciones como crear un espacio, agregar personas a él y publicar un mensaje.
Autenticación
Las llamadas a la API de Chat requieren autenticación. Cada método de la API de Chat requiere autenticación del usuario (para realizar acciones o acceder a datos en nombre de un usuario) o autenticación de la app (para realizar acciones o acceder a datos como una app de Chat). Algunos métodos 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 nuestras bibliotecas cliente de Cloud compatibles oficialmente para tu lenguaje preferido, como Python, Java o Node.js.
Si codificas con Google Apps Script, usa el servicio de Chat avanzado en lugar de instalar una biblioteca cliente.
Conceptos de la API de Google Chat
Los servicios de gRPC o los recursos y métodos de REST otorgan acceso a los espacios de Chat, a los miembros de los espacios, a los mensajes, a las reacciones a los mensajes, a los archivos adjuntos de los mensajes, a los eventos de los espacios y a los estados de lectura de los usuarios.
- 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 grupales son conversaciones entre tres o más usuarios y apps de Chat. Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Miembros
Los miembros son los usuarios y las apps de Chat que se unieron a un espacio o se les invitó a él.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Mensajes
Los mensajes incluyen comunicaciones de texto y tarjetas publicadas en los espacios. Los mensajes pueden tener archivos adjuntos. Las personas pueden reaccionar a los mensajes agregando emojis.
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 👍, 🚲 y 🌞.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Emojis personalizados (versión preliminar para desarrolladores)
Los emojis personalizados son emojis personalizados que se crean y comparten dentro de la organización en Google Chat. Los emojis personalizados se pueden incluir en el contenido de un mensaje o usarlos para reaccionar a un mensaje.
Referencia del recurso:
- Contenido multimedia y archivos adjuntos
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 los mensajes.
Referencia del recurso:
Para ver ejemplos de uso, consulta lo siguiente:
- Eventos de Spaces
Los eventos de espacio representan cambios 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 del usuario
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 en una conversación.
Referencia del recurso de estado de lectura del espacio:
Referencia del recurso de estado de lectura del subproceso:
Para ver ejemplos de uso, consulta lo siguiente:
- Configuración de notificaciones del espacio del usuario (versión preliminar para desarrolladores)
La configuración de notificaciones del espacio del usuario son recursos singleton que representan una configuración de notificaciones del usuario especificada en un espacio de Google Chat.
Referencia del recurso:
Temas relacionados
- Explora muestras de apps de Google Chat para comenzar a usar la API de Chat.
Además de llamar a la API de Chat, las apps de Chat también pueden hacer lo siguiente:
- Recibir y responder eventos de interacción de la app de Chat, como los mensajes enviados a la app de Google Chat, en tiempo real
- Suscribirte a eventos de Google Chat para realizar acciones o responder cuando ocurran ciertos cambios o actividades en Chat, como mensajes nuevos y cambios en la membresía