التطوير باستخدام Google Chat
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم هذه الصفحة نظرة عامة على Google Chat API وتطبيقات Google Chat.
نظرة عامة على Google Chat API
يتألف Chat API من
خدمات gRPC أو موارد وأساليب REST
التي تمنح إذن الوصول إلى Chat، بما في ذلك المساحات وأعضاء المساحات
والرسائل والتفاعلات مع الرسائل ومرفقات الرسائل وأحداث المساحات وحالات القراءة لدى المستخدمين.
المفاهيم
يحدّد القسم التالي الخدمات والموارد والطرق الخاصة بواجهة برمجة التطبيقات Chat API:
- المساحات
المساحات هي أماكن يمكن للأشخاص والتطبيقات فيها إجراء محادثات ومشاركة الملفات. هناك عدة أنواع من المساحات. الرسائل المباشرة هي محادثات بين شخصين أو بين مستخدم وتطبيق Chat. أما المحادثات الجماعية، فهي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat. المساحات المسماة هي مساحات دائمة يمكن للمستخدمين فيها إرسال الرسائل ومشاركة الملفات والتعاون.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- الأعضاء
الأعضاء هم المستخدمون وتطبيقات Chat التي انضمّت إلى مساحة أو تمت دعوتها إليها.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- الرسائل
تتضمّن الرسائل
النصوص
والبطاقات
التي يتم نشرها في المساحات. يمكن أن تتضمّن الرسائل ملفات مرفقة.
يمكن للمستخدمين التفاعل مع الرسائل من خلال إضافة رموز إيموجي إليها.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- التفاعلات
التفاعلات هي رموز الإيموجي التي يستخدمها الأشخاص للتفاعل مع رسالة، مثل 👍 و🚲 و🌞.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- رموز إيموجي مخصصة
تمثّل رموز الإيموجي المخصّصة رموز الإيموجي التي تم إنشاؤها ومشاركتها داخل المؤسسة في Google Chat. يمكن تضمين رموز الإيموجي المخصّصة في محتوى الرسالة أو استخدامها للتفاعل مع الرسالة.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- الوسائط والمرفقات
تمثّل الوسائط ملفًا تم تحميله إلى Google Chat، مثل الصور والفيديوهات والمستندات.
مرجع مورد الوسائط (غير متوفّر في استدعاء الإجراء عن بُعد):
المرفقات هي مثيلات للوسائط (الملفات) المرفقة بالرسائل.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- أحداث المساحة
تمثّل أحداث المساحة التغييرات التي تطرأ على مساحة أو مواردها الفرعية، بما في ذلك الأعضاء والرسائل والتفاعلات.
مرجع المورد:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- حالات قراءة المستخدمين
حالات القراءة لدى المستخدم هي موارد فردية تمثّل تفاصيل حول آخر رسالة قرأها مستخدم محدّد في مساحة Google Chat أو سلسلة رسائل.
مرجع مورد حالة القراءة في المساحة:
مرجع مورد حالة قراءة سلسلة المحادثات:
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
- إعدادات الإشعارات في مساحة المستخدم
إعدادات إشعارات مساحة المستخدم هي موارد فردية تمثّل إعدادات إشعارات مستخدم محدّد في مساحة Google Chat.
مرجع المورد:
المصادقة
يتطلّب استخدام Chat API المصادقة. يتطلّب كلّ طريقة في Chat API إما
مصادقة المستخدم
(لتنفيذ إجراءات أو الوصول إلى
البيانات نيابةً عن المستخدم) أو
مصادقة التطبيق
(لتنفيذ إجراءات أو الوصول إلى البيانات كتطبيق Chat). تتيح بعض الطرق مصادقة المستخدم والتطبيق معًا.
لمزيد من المعلومات حول المصادقة في Chat، يُرجى الاطّلاع على
نظرة عامة على المصادقة.
مكتبات العملاء
الطريقة المقترَحة لمعظم المطوّرين لاستدعاء Google Chat API هي استخدام مكتبات Cloud Client Libraries المتوافقة رسميًا مع لغتك المفضّلة، مثل Python أو Java أو Node.js.
إذا كنت تكتب الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِم
خدمة Chat المتقدّمة
بدلاً من تثبيت مكتبة برامج العميل.
إنشاء تطبيقات Chat
تتيح لك واجهة برمجة تطبيقات Chat إنشاء تطبيقات Google Chat التي تنقل خدماتك ومواردك مباشرةً إلى Google Chat. يمكنك إنشاء تطبيقات Chat لتنفيذ أيّ من الإجراءات التالية:
- استرداد المعلومات استنادًا إلى طلبات البحث المنظَّمة أو النصية الحرة التي أدخلها المستخدم
- إنشاء تقارير حوادث أو عناصر أخرى باستخدام المعلومات التي يقدّمها المستخدم
- تحسين التعاون بين أعضاء الفريق، مثل توفير "ذاكرة الفريق" أو جدولة الموارد
يمكنك تصميم تطبيق Chat باستخدام عدة أنماط مختلفة للبنية، بما في ذلك ما يلي:
- التطبيقات التفاعلية: تستجيب هذه التطبيقات لتفاعل المستخدمين، مثل الإشارات إلى مستخدمين آخرين أو استخدام الأوامر التي تبدأ بشرطة مائلة، كما تعرض المعلومات أو ترشد المستخدمين خلال سير عمل باستخدام البطاقات ومربّعات الحوار.
- تطبيقات سطر الأوامر أو خطافات الويب: إرسال رسائل استباقية، مثل المنبّهات أو الإشعارات، من نظام آخر إلى مساحة لا يمكن للمستخدمين التفاعل مباشرةً مع هذا النوع من التطبيقات.
- التطبيقات المستندة إلى الأحداث: يمكنك الاشتراك في الأنشطة في مساحة Chat والتفاعل معها، مثل انضمام عضو جديد. واستجابةً لحدث معيّن، يمكن للتطبيق إرسال رسالة أو تنفيذ إجراء آخر.
لمعرفة تفاصيل حول تصميم تطبيق Chat، يُرجى الاطّلاع على المقالة
اختيار بنية تطبيق Google Chat.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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) |"]]
