Google Chat API

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

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

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

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

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

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

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