Google Chat API

تتيح لك Google Chat API إنشاء تطبيقات Chat لدمج خدماتك مع Google Chat وإدارة موارد Chat، مثل المساحات والأعضاء والرسائل.

• مورد REST: ‏ v1.customEmojis
• مورد REST: ‏ v1.media
• مورد REST: ‏ v1.spaces
• مورد REST: ‏ v1.spaces.members
• مورد REST: ‏ v1.spaces.messages
• مورد REST: ‏ v1.spaces.messages.attachments
• مورد REST: ‏ v1.spaces.messages.reactions
• مورد REST: ‏ v1.spaces.spaceEvents
• مورد REST: ‏ v1.users.spaces
• مورد REST: ‏ v1.users.spaces.spaceNotificationSetting
• مورد REST: ‏ v1.users.spaces.threads

الخدمة: chat.googleapis.com

للاتّصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.

المستند المرتبط بميزة "اقتراحات"

مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

• https://chat.googleapis.com/$discovery/rest?version=v1

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

• https://chat.googleapis.com

مورد REST: ‏ v1.customEmojis

الطُرق
create	POST /v1/customEmojis الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تنشئ رمزًا تعبيريًا مخصّصًا.
delete	DELETE /v1/{name=customEmojis/*} الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. لحذف رمز تعبيري مخصّص
get	GET /v1/{name=customEmojis/*} الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. لعرض تفاصيل عن رمز إيموجي مخصّص
list	GET /v1/customEmojis الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تعرض هذه السمة رموز الإيموجي المخصّصة التي تظهر للمستخدم الذي تم مصادقة هويته.

مورد REST: ‏ v1.media

الطُرق
download	GET /v1/media/{resourceName=**} تنزيل الوسائط
upload	POST /upload/v1/{parent=spaces/*}/attachments:upload لتحميل مرفق.

مورد REST: ‏ v1.spaces

الطُرق
completeImport	POST /v1/{name=spaces/*}:completeImport تُكمِل هذه الخطوة عملية الاستيراد للمساحات المحدّدة وتجعلها مرئية للمستخدمين.
create	POST /v1/spaces لإنشاء مساحة
delete	DELETE /v1/{name=spaces/*} لحذف مساحة مُسمّاة.
findDirectMessage	GET /v1/spaces:findDirectMessage عرض الرسالة المباشرة الحالية مع المستخدم المحدّد
get	GET /v1/{name=spaces/*} عرض تفاصيل عن مساحة
list	GET /v1/spaces تعرض هذه السمة المساحات التي يكون المتصل عضوًا فيها.
patch	PATCH /v1/{space.name=spaces/*} لتعديل مساحة
search	GET /v1/spaces:search تعرِض هذه الدالة قائمة بالمساحات في مؤسسة Google Workspace استنادًا إلى بحث المشرف.
setup	POST /v1/spaces:setup يؤدي هذا الإجراء إلى إنشاء مساحة وإضافة مستخدمين محدّدين إليها.

مورد REST: ‏ v1.spaces.members

الطُرق
create	POST /v1/{parent=spaces/*}/members لإنشاء اشتراك لتطبيق Chat المخصّص للمكالمات أو مستخدم أو مجموعة على Google
delete	DELETE /v1/{name=spaces/*/members/*} لحذف اشتراك.
get	GET /v1/{name=spaces/*/members/*} تعرِض هذه الدالة تفاصيل حول اشتراك.
list	GET /v1/{parent=spaces/*}/members تعرض هذه البطاقة العضويات في مساحة.
patch	PATCH /v1/{membership.name=spaces/*/members/*} تعديل اشتراك

مورد REST: ‏ v1.spaces.messages

الطُرق
create	POST /v1/{parent=spaces/*}/messages لإنشاء رسالة في مساحة Google Chat.
delete	DELETE /v1/{name=spaces/*/messages/*} لحذف رسالة.
get	GET /v1/{name=spaces/*/messages/*} لعرض تفاصيل عن رسالة.
list	GET /v1/{parent=spaces/*}/messages تعرض هذه القائمة الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل الواردة من الأعضاء والمساحات المحظورة.
patch	PATCH /v1/{message.name=spaces/*/messages/*} لتعديل رسالة.
update	PUT /v1/{message.name=spaces/*/messages/*} لتعديل رسالة.

مورد REST: ‏ v1.spaces.messages.attachments

الطُرق
get	GET /v1/{name=spaces/*/messages/*/attachments/*} للحصول على البيانات الوصفية لمرفق رسالة

مورد REST: ‏ v1.spaces.messages.reactions

الطُرق
create	POST /v1/{parent=spaces/*/messages/*}/reactions لإنشاء تفاعل وإضافته إلى رسالة
delete	DELETE /v1/{name=spaces/*/messages/*/reactions/*} لحذف تفاعل مع رسالة
list	GET /v1/{parent=spaces/*/messages/*}/reactions يعرض هذا الخيار ردود الأفعال على رسالة معيّنة.

مورد REST: ‏ v1.spaces.spaceEvents

الطُرق
get	GET /v1/{name=spaces/*/spaceEvents/*} عرض حدث من مساحة في Google Chat
list	GET /v1/{parent=spaces/*}/spaceEvents يعرض هذا الإجراء الأحداث من مساحة على Google Chat.

مورد REST: ‏ v1.users.spaces

الطُرق
getSpaceReadState	GET /v1/{name=users/*/spaces/*/spaceReadState} عرض تفاصيل عن حالة قراءة المستخدم ضمن مساحة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة
updateSpaceReadState	PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState} تعديل حالة قراءة المستخدم ضمن مساحة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة

مورد REST: ‏ v1.users.spaces.spaceNotificationSetting

الطُرق
get	GET /v1/{name=users/*/spaces/*/spaceNotificationSetting} الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. الحصول على إعدادات حالة إشعارات المساحة
patch	PATCH /v1/{spaceNotificationSetting.name=users/*/spaces/*/spaceNotificationSetting} الإصدار التجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تعديل إعدادات حالة إشعارات المساحة

مورد REST: ‏ v1.users.spaces.threads

الطُرق
getThreadReadState	GET /v1/{name=users/*/spaces/*/threads/*/threadReadState} تعرِض هذه السمة تفاصيل عن حالة قراءة المستخدم ضمن سلسلة محادثات، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.