يشرح هذا الدليل كيفية استخدام
list()
على المورد Message
في Google Chat API للاطّلاع على جدول بيانات
قائمة قابلة للفلترة تضم رسائل في إحدى المساحات
في Chat API، يتم تمثيل رسالة Chat باستخدام موارد
Message
.
يمكن لمستخدمي Chat إرسال الرسائل التي تحتوي على نصوص فقط،
يمكن لتطبيقات Chat استخدام العديد من ميزات المراسلة الأخرى، بما في ذلك
تعرض واجهات مستخدم ثابتة أو تفاعلية، تجمع المعلومات من
والمستخدمين، وتسليم الرسائل بشكل خاص. لمزيد من المعلومات حول ميزات المراسلة
المتوفّرة لواجهة برمجة تطبيقات Chat، يُرجى الاطّلاع على مقالة
نظرة عامة على رسائل Google Chat.
المتطلبات الأساسية
Node.js
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud Client Library لنظام التشغيل Node.js.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق كمبيوتر مكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
- مساحة Google Chat لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
Python
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد بيئتك:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت بايثون Cloud Client Library.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق كمبيوتر مكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
- مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
Java
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد بيئتك:
- أنشِئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- ثبِّت مكتبة Cloud Client Library لـ Java.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
- مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
برمجة تطبيقات
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد بيئتك:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- إنشاء مشروع "برمجة تطبيقات Google" مستقل وفعِّل خدمة المحادثة المتقدّمة.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
- مساحة في Google Chat لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
إدراج الرسائل
لإدراج الرسائل باستخدام مصادقة المستخدم، قم بتمرير ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.messages.readonly
أوchat.messages
. - عليك استدعاء
ListMessages()
.
يعرض المثال التالي الرسائل في "مساحة Chat":
Node.js
Python
Java
برمجة تطبيقات
لتنفيذ هذا النموذج، استبدِل SPACE_NAME
برقم التعريف من
المساحة الإعلانية
name
. يمكنك الحصول على المعرّف من خلال استدعاء الأسلوب
ListSpaces()
أو من عنوان URL للمساحة.
تعرض واجهة برمجة تطبيقات Chat
قائمة الرسائل
إرسالها في المساحة المحددة. في حال عدم وجود رسائل من الطلب، سيتم
يعرض ردّ واجهة برمجة التطبيقات Chat عنصرًا فارغًا. عند استخدام REST/HTTP
تحتوي الاستجابة على كائن JSON فارغ، {}
.