Google Chat API

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

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

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

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

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

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

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

  • https://chat.googleapis.com

مورد REST: ‏ v1.customEmojis

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

مورد 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}
الحصول على إعدادات حالة إشعارات المساحة
patch PATCH /v1/{spaceNotificationSetting.name=users/*/spaces/*/spaceNotificationSetting}
تعديل إعدادات حالة إشعارات المساحة

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

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