يوضّح هذا الدليل كيفية استخدام الـ
update
طريقة في مورد الـMessage ضِمن Google Chat API لتعديل رسالة نصية أو رسالة بطاقة
في مساحة. يمكنك تعديل رسالة لتغيير سماتها، مثل محتواها أو محتوى البطاقة. يمكنك أيضًا إضافة رسالة نصية قبل رسالة بطاقة أو إضافة بطاقة إلى رسالة نصية.
في Chat API، يتم تمثيل رسالة Chat بمورد
Message.
لا يمكن لمستخدمي Chat إرسال سوى الرسائل التي تحتوي على نص، ولكن يمكن لتطبيقات Chat استخدام العديد من ميزات المراسلة الأخرى، بما في ذلك عرض واجهات مستخدم ثابتة أو تفاعلية، وجمع المعلومات من المستخدمين، وإرسال الرسائل بشكل خاص. لمزيد من المعلومات عن ميزات المراسلة
المتاحة في Chat API، يُرجى الاطّلاع على
نظرة عامة على رسائل Google Chat.
المتطلبات الأساسية
Node.js
- إعداد البيئة:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت مكتبة عميل Google Cloud لنظام Node.js
- إنشاء بيانات اعتماد للوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API
request:
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
credentials.jsonفي دليلك المحلي. - للمصادقة كتطبيق Chat،
أنشئ بيانات اعتماد لحساب خدمة واحفظها كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
- اختيار نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
Python
- إعداد البيئة:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت مكتبة عميل Google Cloud لنظام Python .
- إنشاء بيانات اعتماد للوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API
request:
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
credentials.jsonفي دليلك المحلي. - للمصادقة كتطبيق Chat،
أنشئ بيانات اعتماد لحساب خدمة واحفظها كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
- اختيار نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
جافا
- إعداد البيئة:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت مكتبة عميل Google Cloud لنظام Java .
- إنشاء بيانات اعتماد للوصول استنادًا إلى طريقة المصادقة في طلب Google Chat API
request:
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
credentials.jsonفي دليلك المحلي. - للمصادقة كتطبيق Chat،
أنشئ بيانات اعتماد لحساب خدمة واحفظها كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم Chat،
أنشئ بيانات اعتماد لرقم تعريف عميل OAuth واحفظها كملف JSON باسم
- اختيار نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
برمجة التطبيقات
- إعداد البيئة:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- إنشاء مشروع مستقل في "برمجة تطبيقات Google"، وتفعيل "خدمة المحادثات المتقدّمة".
- في هذا الدليل، يجب استخدام مصادقة المستخدم أو التطبيق. للمصادقة كتطبيق Chat، أنشئ بيانات اعتماد لحساب خدمة. للاطّلاع على الخطوات، يُرجى الانتقال إلى مقالة المصادقة والتفويض كتطبيق Google Chat.
- اختيار نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
تعديل رسالة نيابةً عن مستخدم
باستخدام مصادقة المستخدم، لا يمكن تعديل سوى نص الرسالة.
لتعديل رسالة باستخدام مصادقة المستخدم، مرِّر ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.messages. - استدعِ طريقة
UpdateMessage. - مرِّر
messageكمثيل منMessageمع ما يلي:- الحقل
nameالذي تم ضبطه على الرسالة المطلوب تعديلها، والذي يتضمّن رقم تعريف مساحة ورقم تعريف رسالة - الحقل
textالذي تم ضبطه على النص الجديد
- الحقل
- مرِّر
updateMaskبالقيمةtext.
إذا كانت الرسالة المعدَّلة هي رسالة بطاقة، تتم إضافة النص قبل البطاقات (التي تظل معروضة).
في ما يلي كيفية تعديل رسالة أو إضافة رسالة نصية قبل رسالة بطاقة باستخدام مصادقة المستخدم:
Node.js
Python
جافا
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
SPACE_NAME: رقم التعريف من المساحةname. يمكنك الحصول على رقم التعريف من خلال استدعاء الـListSpacesطريقة أو من عنوان URL للمساحة.MESSAGE_NAME: رقم التعريف منnameللرسالة. يمكنك الحصول على رقم التعريف من نص الاستجابة الذي يتم عرضه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API، أو باستخدام الاسم المخصّص الذي تم تعيينه للرسالة عند إنشائها.
يعرض Chat API مثيلاً من
Message
يوضّح الرسالة التي تم تعديلها.
تعديل رسالة كتطبيق Chat
باستخدام مصادقة التطبيق، يمكن تعديل نص الرسالة والبطاقات.
لتعديل رسالة باستخدام مصادقة التطبيق، مرِّر ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.bot. - استدعِ طريقة
UpdateMessage. - مرِّر
messageكمثيل منMessageمع ما يلي:- الحقل
nameالذي تم ضبطه على الرسالة المطلوب تعديلها، والذي يتضمّن رقم تعريف مساحة ورقم تعريف رسالة - الحقل
textالذي تم ضبطه على النص الجديد إذا كان بحاجة إلى التعديل - الحقل
cardsV2الذي تم ضبطه على البطاقات الجديدة إذا كانت بحاجة إلى التعديل
- الحقل
- مرِّر
updateMaskمع قائمة الحقول المطلوب تعديلها، مثلtextوcardsV2.
إذا كانت الرسالة المعدَّلة هي رسالة بطاقة وتم تعديل النص، تتم إضافة النص المعدَّل قبل البطاقات (التي تظل معروضة). إذا كانت الرسالة المعدَّلة هي رسالة نصية وتم تعديل البطاقات، تتم إضافة البطاقات المعدَّلة إلى النص (الذي يظل معروضًا).
في ما يلي كيفية تعديل نص الرسالة وبطاقاتها باستخدام مصادقة التطبيق:
Node.js
Python
جافا
برمجة التطبيقات
لتشغيل هذا النموذج، استبدِل ما يلي:
SPACE_NAME: رقم التعريف من المساحةname. يمكنك الحصول على رقم التعريف من خلال استدعاء الـListSpacesطريقة أو من عنوان URL للمساحة.MESSAGE_NAME: رقم التعريف منnameللرسالة. يمكنك الحصول على رقم التعريف من نص الاستجابة الذي يتم عرضه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API، أو باستخدام الاسم المخصّص الذي تم تعيينه للرسالة عند إنشائها.
يعرض Chat API مثيلاً من
Message
يوضّح الرسالة التي تم تعديلها.
تعديل البطاقات بشكل غير متزامن
في إصدار المعاينة للمطوّرين، يمكنك
تعديل البطاقات في رسالة بشكل غير متزامن باستخدام
replaceCards
طريقة. ويفيد ذلك في تعديل محتوى البطاقة بدون تفاعل المستخدم، مثل إعادة تحميل معاينة رابط أو تعديل حالة مهمة.
تعمل هذه الطريقة مع الرسائل التي أنشأها التطبيق، بما في ذلك الرسائل التي تم إنشاؤها نيابةً عن مستخدم.
لمعرفة التفاصيل، يُرجى الاطّلاع على إنشاء البطاقات وتعديلها.