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/*}
لتعديل مساحة
setup POST /v1/spaces:setup
ينشئ مساحة ويضيف مستخدمين محدَّدين إليها.

مورد REST: v1.spaces.members

الطُرق
create POST /v1/{parent=spaces/*}/members
ينشئ هذا الخيار عضوية بشرية أو عضوية في تطبيق لتطبيق الاتصال.
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}
عرض تفاصيل حول حالة القراءة للمستخدم داخل سلسلة محادثات، وتُستخدم لتحديد الرسائل المقروءة وغير المقروءة.