Sviluppare con Google Chat
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina fornisce una panoramica dell'API Google Chat e delle app Google Chat.
Panoramica dell'API Google Chat
L'API Chat è costituita da
servizi gRPC o risorse e metodi REST
che concedono l'accesso a Chat, inclusi spazi, membri degli spazi,
messaggi, reazioni ai messaggi, allegati dei messaggi, eventi dello spazio e stati di lettura
degli utenti.
Concetti
La sezione seguente definisce i servizi, le risorse e i metodi per l'API Chat:
- Spazi
Gli spazi sono luoghi in cui persone e app possono conversare e condividere file. Esistono
diversi tipi di spazi. I messaggi diretti sono conversazioni 1:1
tra due utenti o tra un utente e un'app di chat. Le chat
di gruppo sono conversazioni tra tre o più utenti e
app di chat. Gli spazi con nome sono luoghi permanenti in cui le persone inviano
messaggi, condividono file e collaborano.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Membri
I membri sono utenti e app di chat che hanno partecipato o sono stati invitati a uno spazio.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Messaggi
I messaggi includono
testo
e
schede>
comunicazioni pubblicate negli spazi. I messaggi possono avere file allegati.
Le persone possono reagire ai messaggi aggiungendo emoji.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Reazioni
Le reazioni rappresentano le emoji che le persone usano per reagire a un messaggio, ad esempio
👍, 🚲 e 🌞.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Emoji personalizzate
Emoji personalizzate rappresentano le emoji personalizzate create e condivise all'interno dell'organizzazione in Google Chat. Le emoji personalizzate possono essere incluse nel contenuto di un messaggio o utilizzate per reagire a un messaggio.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Contenuti multimediali e allegati
Contenuti multimediali indica un file caricato su Google Chat, come immagini, video e documenti.
Riferimento alla risorsa multimediale (non disponibile in RPC):
Gli allegati sono istanze di contenuti multimediali (file) allegati ai messaggi.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Eventi dello spazio
Gli eventi dello spazio rappresentano le modifiche apportate a uno spazio o alle relative risorse secondarie, inclusi membri, messaggi e reazioni.
Riferimento alla risorsa:
Per un esempio di utilizzo, vedi:
- Stati di lettura dell'utente
Gli stati di lettura degli utenti sono risorse singleton che rappresentano i dettagli dell'ultimo messaggio letto da un utente specifico in uno spazio Google Chat o in un thread di messaggi.
Riferimento alla risorsa stato di lettura dello spazio:
Riferimento alla risorsa dello stato di lettura del thread:
Per un esempio di utilizzo, vedi:
- Impostazioni di notifica dello spazio utente
Le impostazioni di notifica dello spazio utente sono risorse singleton che rappresentano le impostazioni di notifica di un utente specifico in uno spazio Google Chat.
Riferimento alla risorsa:
Autenticazione
La chiamata all'API Chat richiede l'autenticazione. Ogni
metodo dell'API Chat richiede
l'autenticazione utente
(per eseguire azioni o accedere
ai dati per conto di un utente) o
l'autenticazione app
(per eseguire azioni o accedere ai dati come app di Chat). Alcuni
metodi supportano sia l'autenticazione utente sia l'autenticazione app.
Per saperne di più sull'autenticazione in Chat, consulta la Panoramica dell'autenticazione.
Librerie client
Il modo consigliato per la maggior parte degli sviluppatori di chiamare l'API Google Chat
è con le nostre librerie client di Cloud
supportate ufficialmente per il linguaggio che preferisci, come Python, Java o Node.js.
Se codifichi con Google Apps Script, utilizza il
servizio Chat avanzato
anziché installare una libreria client.
Creare app di chat
L'API Chat ti consente di creare app Google Chat che portano i tuoi
servizi e risorse direttamente in Google Chat. Puoi creare
app di chat per eseguire una delle seguenti operazioni:
- Recupera le informazioni in base alle query di testo strutturato o libero inserite dall'utente.
- Generare report sugli incidenti o altri artefatti utilizzando le informazioni fornite dall'utente.
- Migliora la collaborazione del team, ad esempio fornendo una "memoria del team" o pianificando le risorse.
Puoi progettare la tua app di chat utilizzando diversi stili di architettura, tra cui:
- App interattive: rispondono all'interazione degli utenti, ad esempio @menzioni o comandi
con slash, e presentano informazioni o guidano gli utenti in un flusso di lavoro con
schede e finestre di dialogo.
- App da riga di comando o webhook: invia messaggi proattivi, come sveglie
o notifiche, da un altro sistema a uno spazio. Gli utenti non possono interagire direttamente con questo tipo di app.
- App basate su eventi: iscriviti e reagisci all'attività in uno spazio Chat, ad esempio l'ingresso di un nuovo membro. In risposta a un
evento, l'app può inviare un messaggio o eseguire un'altra azione.
Per maggiori dettagli sulla progettazione dell'app Chat, vedi
Scegliere un'architettura per l'app Google Chat.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-04 UTC.
[null,null,["Ultimo aggiornamento 2025-08-04 UTC."],[[["\u003cp\u003eGoogle Chat apps integrate services directly into chats, enabling users to access information and take action without leaving the conversation.\u003c/p\u003e\n"],["\u003cp\u003eThese apps support various functionalities, including workflow management, data collection, and interactive elements like dialogs and slash commands.\u003c/p\u003e\n"],["\u003cp\u003eChoose from interactive, non-interactive, or event-driven architectures to build apps that cater to your specific needs and use cases.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Chat apps can be built using various platforms like AppSheet, Google Apps Script, and Dialogflow.\u003c/p\u003e\n"],["\u003cp\u003eAccess to user data beyond basic identity requires authentication and user consent, ensuring privacy and security.\u003c/p\u003e\n"]]],["Google Chat apps integrate services directly into conversations, allowing users to access information and perform actions without leaving the chat. These apps can send text or card messages within spaces or direct messages. They can be interactive, responding to mentions and commands, or non-interactive, sending messages without user interaction. Apps can retrieve information, file tickets, and coordinate team efforts. Developers can build these apps using diverse platforms, manage deployments, and publish them on the Google Workspace Marketplace.\n"],null,["# Develop with Google Chat\n\nThis page provides an overview of the Google Chat API and Google Chat apps.\n\nGoogle Chat API overview\n------------------------\n\nThe Chat API consists of\n[gRPC services or REST resources and methods](https://cloud.google.com/apis/docs/client-libraries-explained)\nthat grant access to Chat, including spaces, space members,\nmessages, message reactions, message attachments, space events, and user read\nstates.\n\n### Concepts\n\nThe following section defines the services, resources, and methods for the\nChat API:\n\n*Spaces*\n\n: *Spaces* are places where people and apps can converse and share files. There\n are several types of spaces. Direct messages (DMs) are 1:1 conversations\n between two users or a user and a Chat app. Group\n chats are conversations between three or more users and\n Chat apps. Named spaces are persistent places where people send\n messages, share files, and collaborate.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Space)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces)\n\n: For example usage, see:\n\n - [Create a space](/workspace/chat/create-spaces)\n - [Set up a space](/workspace/chat/set-up-spaces)\n - [Get a space](/workspace/chat/get-spaces)\n - [List spaces](/workspace/chat/list-spaces)\n - [Update a space](/workspace/chat/update-spaces)\n - [Delete a space](/workspace/chat/delete-spaces)\n - [Find a direct message (DM)](/workspace/chat/find-direct-message-in-spaces)\n\n*Members*\n\n: *Members* are users and Chat apps that have joined or are\n invited to a space.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Membership)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces.members)\n\n: For example usage, see:\n\n - [Create a membership](/workspace/chat/create-members)\n - [Get a membership](/workspace/chat/get-members)\n - [List memberships](/workspace/chat/list-members)\n - [Update a membership](/workspace/chat/update-members)\n - [Delete a membership](/workspace/chat/delete-members)\n\n*Messages*\n\n: *Messages* include\n [text](/workspace/chat/api/reference/rest/v1/spaces.messages)\n and\n [card](/workspace/chat/api/reference/rest/v1/cards)\n communications posted in spaces. Messages can have files attached to them.\n People can react to messages by appending emoji to them.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Message)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces.messages)\n\n: For example usage, see:\n\n - [Create a message](/workspace/chat/create-messages)\n - [Get a message](/workspace/chat/get-messages)\n - [List messages](/workspace/chat/list-messages)\n - [Update a message](/workspace/chat/update-messages)\n - [Delete a message](/workspace/chat/delete-messages)\n\n*Reactions*\n\n: *Reactions* represent the emoji people use to react to a message, such as\n 👍, 🚲, and 🌞.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Reaction)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces.messages.reactions)\n\n: For example usage, see:\n\n - [Create a reaction](/workspace/chat/create-reactions)\n - [List reactions](/workspace/chat/list-reactions)\n - [Delete a reaction](/workspace/chat/delete-reactions)\n\n*Custom emoji*\n\n: *Custom emoji* represent custom emoji created and shared within the\n organization in Google Chat. Custom emoji can be included in the content of\n a message or used to react to a message.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.CustomEmoji)\n - [REST reference](/workspace/chat/api/reference/rest/v1/customEmojis)\n\n: For example usage, see:\n\n - [Create a custom emoji](/workspace/chat/create-custom-emoji)\n - [Delete a custom emoji](/workspace/chat/delete-custom-emoji)\n - [Get details about a custom emoji](/workspace/chat/get-custom-emoji)\n - [List custom emojis in an organization](/workspace/chat/list-custom-emojis)\n\n*Media and attachments*\n\n: *Media* represents a file uploaded to Google Chat, like images, videos, and\n documents.\n\n: Media resource reference (Unavailable in RPC):\n\n - [REST reference](/workspace/chat/api/reference/rest/v1/media)\n\n: *Attachments* are instances of media (files) attached to messages.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Attachment)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments)\n\n: For example usage, see:\n\n - [Upload media as an attachment](/workspace/chat/upload-media-attachments)\n - [Download media as an attachment](/workspace/chat/download-media-attachments)\n - [Get an attachment](/workspace/chat/get-media-attachments)\n\n*Space events*\n\n: *Space events* represent changes to a space or its\n child resources, including its members, messages, and reactions.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceEvent)\n - [REST reference](/workspace/chat/api/reference/rest/v1/spaces.spaceEvents)\n\n: For example usage, see:\n\n - [Get space read state](/workspace/chat/get-space-read-state)\n - [Update space read state](/workspace/chat/update-space-read-state)\n - [Get thread read state](/workspace/chat/get-thread-read-state)\n\n*User read states*\n\n: *User read states* are singleton resources that represent details about a\n specified user's last read message in a Google Chat space or a message\n thread.\n\n: Space read state resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceReadState)\n - [REST reference](/workspace/chat/api/reference/rest/v1/users.spaces)\n\n: Thread read state resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.ThreadReadState)\n - [REST reference](/workspace/chat/api/reference/rest/v1/users.spaces.threads)\n\n: For example usage, see:\n\n - [Get space read state](/workspace/chat/get-space-read-state)\n - [Update space read state](/workspace/chat/update-space-read-state)\n - [Get thread read state](/workspace/chat/get-thread-read-state)\n\n*User space notification settings*\n\n: *User space notification settings* are singleton resources that represent a\n specified user notification settings in a Google Chat space.\n\n: Resource reference:\n\n - [RPC reference](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceNotificationSetting)\n - [REST reference](/workspace/chat/api/reference/rest/v1/users.spaces.spaceNotificationSetting)\n\n### Authentication\n\nCalling the Chat API requires authentication. Each\nChat API method requires either\n[user authentication](/workspace/chat/authenticate-authorize-chat-user)\n(to perform actions or access\ndata on behalf of a user) or\n[app authentication](/workspace/chat/authenticate-authorize-chat-app)\n(to perform actions or access data as a Chat app). Some\nmethods support both user authentication and app authentication.\n\nTo learn more about authentication in Chat, see\n[Authentication overview](/workspace/chat/authenticate-authorize).\n\n### Client libraries\n\nThe recommended way for most developers to call the Google Chat API\nis with our officially supported\n[Cloud Client Libraries](/workspace/chat/libraries)\nfor your preferred language, like Python, Java, or Node.js.\n\nIf you're coding with Google Apps Script, use the\n[Advanced Chat service](/apps-script/advanced/chat)\ninstead of installing a client library.\n\nBuild Chat apps\n---------------\n\nThe Chat API lets you build Google Chat apps that bring your\nservices and resources right into Google Chat. You can build\nChat apps to do any of the following:\n\n- Retrieve information based on structured or free text queries entered by the user.\n- Generate incident reports or other artifacts, using information provided by the user.\n- Enhance team collaboration, such as providing \"team memory\" or scheduling resources.\n\nYou can design your Chat app using several different\narchitecture styles, including the following:\n\n- **Interactive apps**: Respond to user interaction, such as @mentions or slash commands, and present information or guide users through a workflow with cards and dialogs.\n- **Command-line apps or webhooks**: Send proactive messages, such as alarms or notifications, from another system into a space. Users can't directly interact with this type of app.\n- **Event-driven apps**: Subscribe to and react to activity in a Chat space, such as a new member joining. In response to an event, the app can send a message or perform another action.\n\nFor details about designing your Chat app, see\n[Choose a Google Chat app architecture](/workspace/chat/structure).\n\nRelated topics\n--------------\n\n- [Explore Google Chat app samples](/workspace/chat/samples).\n- [Build interactive Google Chat apps](/workspace/chat/interact-users-overview).\n- [Choose a Google Chat app architecture](/workspace/chat/structure).\n\n|---|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Want to see the Google Chat API in action? The Google Workspace Developers channel offers videos about tips, tricks, and the latest features. [Subscribe now](https://www.youtube.com/channel/UCUcg6az6etU_gRtZVAhBXaw) |"]]
