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