Google Chat API

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

• مورد REST: ‏ v1.customEmojis
• مورد REST: ‏ v1.media
• مصدر RST: v1.spaces
• مورد RST: 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 واستخدامها. يُستخدم في إنشاء مكتبات للعملاء، ومكونات IDE الإضافية، وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

• 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} تعرِض هذه السمة تفاصيل عن حالة قراءة المستخدم ضمن سلسلة محادثات، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.