Google Chat ile geliştirme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada Google Chat API ve Google Chat uygulamalarına genel bir bakış sunulmaktadır.
Google Chat API'ye genel bakış
Chat API, alanlar, alan üyeleri, mesajlar, mesaj tepkileri, mesaj ekleri, alan etkinlikleri ve kullanıcı okuma durumları dahil olmak üzere Chat'e erişim izni veren gRPC hizmetleri veya REST kaynakları ve yöntemlerinden oluşur.
Kavramlar
Aşağıdaki bölümde, Chat API'nin hizmetleri, kaynakları ve yöntemleri tanımlanmaktadır:
- Alanlar
Alanlar, kullanıcıların ve uygulamaların sohbet edebileceği ve dosya paylaşabileceği yerlerdir. Birkaç tür alan vardır. Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki bire bir görüşmelerdir. Grup sohbetleri ise üç veya daha fazla kullanıcı ile Chat uygulamaları arasındaki görüşmelerdir. Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Üyeler
Üyeler, bir alana katılan veya davet edilen kullanıcılar ve Chat uygulamalarıdır.
Kaynak referansı:
Örnek kullanım için bkz.:
- Mesajlar
Mesajlar, alanlarda yayınlanan metin ve kart iletişimlerini içerir. İletilere dosya eklenebilir.
Kullanıcılar, iletilere emoji ekleyerek tepki verebilir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Tepkiler
Tepkiler, kullanıcıların mesajlara tepki vermek için kullandığı emojileri (ör. 👍, 🚲 ve 🌞) ifade eder.
Kaynak referansı:
Örnek kullanım için bkz.:
- Özel emoji
Özel emoji, Google Chat'te kuruluş içinde oluşturulan ve paylaşılan özel emojileri ifade eder. Özel emojiler, mesaj içeriğine eklenebilir veya mesajlara tepki vermek için kullanılabilir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Medya ve ekler
Medya, Google Chat'e yüklenen resim, video ve doküman gibi dosyaları ifade eder.
Medya kaynağı referansı (RPC'de kullanılamaz):
Ekler, iletilere eklenen medya (dosya) örnekleridir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Alan etkinlikleri
Alan etkinlikleri, alan veya alt kaynaklarında (üyeleri, mesajları ve tepkileri dahil) yapılan değişiklikleri gösterir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Kullanıcı okuma durumları
Kullanıcı okuma durumları, bir Google Chat alanında veya ileti dizisinde belirtilen kullanıcının okuduğu son iletiyle ilgili ayrıntıları temsil eden tekil kaynaklardır.
Alan okuma durumu kaynak referansı:
İş parçacığı okuma durumu kaynak referansı:
Örnek kullanım için bkz.:
- Kullanıcı alanı bildirim ayarları
Kullanıcı alanı bildirim ayarları, Google Chat alanındaki belirli bir kullanıcı bildirim ayarlarını temsil eden tekil kaynaklardır.
Kaynak referansı:
Kimlik doğrulama
Chat API'yi çağırmak için kimlik doğrulama gerekir. Her Chat API yöntemi, kullanıcı kimlik doğrulaması (bir kullanıcı adına işlem yapmak veya verilere erişmek için) ya da uygulama kimlik doğrulaması (Chat uygulaması olarak işlem yapmak veya verilere erişmek için) gerektirir. Bazı yöntemler hem kullanıcı kimlik doğrulamasını hem de uygulama kimlik doğrulamasını destekler.
Chat'te kimlik doğrulama hakkında daha fazla bilgi edinmek için Kimlik doğrulamaya genel bakış başlıklı makaleyi inceleyin.
İstemci kitaplıkları
Çoğu geliştiricinin Google Chat API'yi çağırmak için önerilen yolu, Python, Java veya Node.js gibi tercih ettiğiniz dildeki resmi olarak desteklenen Cloud İstemci Kitaplıklarımızı kullanmaktır.
Google Apps Komut Dosyası ile kod yazıyorsanız istemci kitaplığı yüklemek yerine Advanced Chat hizmetini kullanın.
Chat uygulamaları oluşturma
Chat API, hizmetlerinizi ve kaynaklarınızı doğrudan Google Chat'e getiren Google Chat uygulamaları oluşturmanıza olanak tanır. Aşağıdakilerden herhangi birini yapmak için sohbet uygulamaları oluşturabilirsiniz:
- Kullanıcı tarafından girilen yapılandırılmış veya serbest metin sorgularına göre bilgi alın.
- Kullanıcı tarafından sağlanan bilgileri kullanarak olay raporları veya başka yapay içerikler oluşturma.
- "Ekip hafızası" sağlama veya kaynak planlama gibi ekip iş birliğini geliştirebilirsiniz.
Chat uygulamanızı aşağıdaki gibi çeşitli mimari stiller kullanarak tasarlayabilirsiniz:
- Etkileşimli uygulamalar: @bahsetmeler veya eğik çizgi komutları gibi kullanıcı etkileşimlerine yanıt verin ve kartlar ile iletişim kutularıyla bilgi sunun veya kullanıcıları bir iş akışında yönlendirin.
- Komut satırı uygulamaları veya webhook'lar: Başka bir sistemden bir alana proaktif mesajlar (ör. alarmlar veya bildirimler) gönderin. Kullanıcılar bu tür uygulamalarla doğrudan etkileşimde bulunamaz.
- Etkinliğe dayalı uygulamalar: Bir Chat alanındaki etkinliklere (ör. yeni bir üyenin katılması) abone olun ve bu etkinliklere tepki verin. Uygulama, bir etkinliğe yanıt olarak mesaj gönderebilir veya başka bir işlem gerçekleştirebilir.
Chat uygulamanızı tasarlama hakkında ayrıntılı bilgi için Google Chat uygulama mimarisi seçme başlıklı makaleyi inceleyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-04 UTC.
[null,null,["Son güncelleme tarihi: 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) |"]]
