Tworzenie aplikacji w Google Chat
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz omówienie interfejsu Google Chat API i aplikacji Google Chat.
Omówienie interfejsu Google Chat API
Chat API składa się z usług gRPC lub zasobów i metod REST, które zapewniają dostęp do Google Chat, w tym do pokoi, członków pokoi, wiadomości, reakcji na wiadomości, załączników do wiadomości, wydarzeń w pokoju i stanów odczytu użytkownika.
Pojęcia
W sekcji poniżej znajdziesz definicje usług, zasobów i metod interfejsu Chat API:
- Pokoje
Pokoje to miejsca, w których użytkownicy i aplikacje mogą rozmawiać i udostępniać pliki. Istnieje kilka rodzajów pokoi. Czaty to rozmowy indywidualne między 2 użytkownikami lub użytkownikiem a aplikacją Google Chat. Czaty grupowe to rozmowy między co najmniej 3 użytkownikami a aplikacjami Google Chat. Pokoje z nazwami to trwałe miejsca, w których użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Członkowie
Użytkownicy to użytkownicy i aplikacje Google Chat, którzy dołączyli do pokoju lub zostali do niego zaproszeni.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Wiadomości
Wiadomości obejmują tekst i karty publikowane w pokojach. Do wiadomości można dołączać pliki.
Użytkownicy mogą reagować na wiadomości, dodając do nich emotikony.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Reakcje
Reakcje to emotikony, których użytkownicy używają do reagowania na wiadomości, np. 👍, 🚲 i 🌞.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- niestandardowe emotikony,
Niestandardowe emotikony to emotikony utworzone i udostępnione w organizacji w Google Chat. Niestandardowe emotikony można umieszczać w treści wiadomości lub używać do reagowania na wiadomości.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Multimedia i załączniki
Media to plik przesłany do Google Chat, np. obraz, film lub dokument.
Odwołanie do zasobu multimedialnego (niedostępne w RPC):
Załączniki to instancje multimediów (plików) dołączonych do wiadomości.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Wydarzenia w Space
Zdarzenia w pokoju reprezentują zmiany w pokoju lub jego zasobach podrzędnych, w tym w członkach, wiadomościach i reakcjach.
Odwołanie do zasobu:
Przykłady użycia znajdziesz w tych artykułach:
- Stan odczytu użytkownika
Stany odczytu użytkownika to pojedyncze zasoby, które zawierają szczegółowe informacje o ostatniej przeczytanej wiadomości przez określonego użytkownika w pokoju Google Chat lub w wątku wiadomości.
Dokumentacja zasobu stanu odczytu przestrzeni:
Dokumentacja zasobu stanu odczytu wątku:
Przykłady użycia znajdziesz w tych artykułach:
- Ustawienia powiadomień w przestrzeni użytkownika
Ustawienia powiadomień dotyczące pokoju użytkownika to pojedyncze zasoby, które reprezentują ustawienia powiadomień określonego użytkownika w pokoju Google Chat.
Odwołanie do zasobu:
Uwierzytelnianie
Wywoływanie interfejsu Chat API wymaga uwierzytelnienia. Każda metoda interfejsu Chat API wymaga uwierzytelnienia użytkownika (aby wykonywać działania lub uzyskiwać dostęp do danych w imieniu użytkownika) albo uwierzytelnienia aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja do czatu). Niektóre metody obsługują zarówno uwierzytelnianie użytkownika, jak i uwierzytelnianie aplikacji.
Więcej informacji o uwierzytelnianiu w Google Chat znajdziesz w artykule Omówienie uwierzytelniania.
Biblioteki klienta
Zalecanym sposobem wywoływania interfejsu Google Chat API dla większości deweloperów jest korzystanie z naszych oficjalnie obsługiwanych bibliotek klienta Cloud w wybranym języku, np. Python, Java lub Node.js.
Jeśli piszesz kod w Google Apps Script, użyj zaawansowanej usługi Chat zamiast instalować bibliotekę klienta.
Tworzenie aplikacji Google Chat
Interfejs Chat API umożliwia tworzenie aplikacji Google Chat, które integrują Twoje usługi i zasoby z Google Chat. Aplikacje do czatowania możesz tworzyć w celu wykonywania tych czynności:
- Pobieranie informacji na podstawie zapytań w formie uporządkowanego lub swobodnego tekstu wprowadzonych przez użytkownika.
- generować raporty o incydentach lub inne artefakty na podstawie informacji podanych przez użytkownika;
- Usprawnianie współpracy w zespole, np. poprzez zapewnianie „pamięci zespołu” lub planowanie zasobów.
Aplikację do obsługi czatu możesz zaprojektować w kilku różnych stylach architektury, w tym:
- Aplikacje interaktywne: reagują na interakcje użytkowników, takie jak @wzmianki czy polecenia z ukośnikiem, i prezentują informacje lub prowadzą użytkowników przez przepływ pracy za pomocą kart i okien dialogowych.
- Aplikacje wiersza poleceń lub webhooki: wysyłanie do pokoju proaktywnych wiadomości, takich jak alarmy lub powiadomienia, z innego systemu. Użytkownicy nie mogą bezpośrednio wchodzić w interakcje z tego typu aplikacjami.
- Aplikacje oparte na zdarzeniach: subskrybuj aktywność w pokoju w Google Chat i reaguj na nią, np. na dołączenie nowego użytkownika. W odpowiedzi na zdarzenie aplikacja może wysłać wiadomość lub wykonać inne działanie.
Więcej informacji o projektowaniu aplikacji Google Chat znajdziesz w artykule Wybieranie architektury aplikacji Google Chat.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-04 UTC.
[null,null,["Ostatnia aktualizacja: 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) |"]]
