Google Chat API

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

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

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

مستند الاستكشاف

مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات 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
تعرض هذه الطريقة الرسالة المباشرة الحالية مع المستخدم المحدّد.
findGroupChats GET /v1/spaces:findGroupChats
تعرض هذه الطريقة جميع المساحات التي تتضمّن spaceType == GROUP_CHAT، والتي تتضمّن عضوياتها من المستخدمين بالضبط المستخدم الذي يطلب البيانات والمستخدمين المحدّدين في FindGroupChatsRequest.memberships.
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}
تعرض هذه الطريقة تفاصيل حول حالة القراءة الخاصة بالمستخدم ضمن سلسلة محادثات، ويتم استخدامها لتحديد الرسائل المقروءة وغير المقروءة.