Google Chat API

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

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

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

مستند Discovery

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

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

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

  • https://chat.googleapis.com

مورد REST: v1.media

الطُرق
download GET /v1/media/{resourceName=**}
يتم تنزيل الوسائط.
upload POST /v1/{parent=spaces/*}/attachments: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
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.threads

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