يشرح هذا الدليل كيفية استخدام طريقة
update
في المورد Message من Google Chat API لتعديل رسالة نصية أو رسالة بطاقة
في مساحة. يمكنك تعديل رسالة لتغيير سماتها، مثل محتواها أو محتوى بطاقة. يمكنك أيضًا إضافة رسالة نصية قبل
رسالة البطاقة، أو إلحاق بطاقة برسالة نصية.
في Chat API، يتم تمثيل رسالة محادثة من خلال
مورد Message.
في حين أنّ مستخدمي Chat يمكنهم فقط إرسال رسائل تحتوي على نص،
يمكن لتطبيقات Chat استخدام العديد من ميزات المراسلة الأخرى، بما في ذلك
عرض واجهات مستخدم ثابتة أو تفاعلية، وجمع المعلومات من
المستخدمين، وإرسال الرسائل بشكل خاص. لمزيد من المعلومات عن ميزات المراسلة المتاحة في Chat API، يُرجى الاطّلاع على نظرة عامة على رسائل Google Chat.
المتطلبات الأساسية
Node.js
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- فعِّل واجهة برمجة تطبيقات Google Chat واضبط إعداداتها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud لنظام Node.js.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد بها المصادقة في طلب Google Chat API:
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي. - للمصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد حساب الخدمة واحفظ بيانات الاعتماد كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق في Chat.
Python
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- فعِّل واجهة برمجة تطبيقات Google Chat واضبط إعداداتها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud للغة Python.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد بها المصادقة في طلب Google Chat API:
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي. - للمصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد حساب الخدمة واحفظ بيانات الاعتماد كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق في Chat.
جافا
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- فعِّل واجهة برمجة تطبيقات Google Chat واضبط إعداداتها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud بلغة Java.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد بها المصادقة في طلب Google Chat API:
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي. - للمصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد حساب الخدمة واحفظ بيانات الاعتماد كملف JSON باسم
credentials.json.
- للمصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرِّف عميل OAuth واحفظ بيانات الاعتماد كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق في Chat.
برمجة التطبيقات
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- فعِّل واجهة برمجة تطبيقات Google Chat واضبط إعداداتها باستخدام اسم ورمز ووصف لتطبيق Chat.
- أنشئ مشروعًا مستقلاً في "برمجة تطبيقات Google"، وفعِّل خدمة Chat المتقدّمة.
- في هذا الدليل، يجب استخدام مصادقة المستخدم أو التطبيق. للمصادقة بصفتك تطبيق 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. ويُعدّ ذلك مفيدًا لتعديل محتوى بطاقة بدون تفاعل المستخدم، مثل إعادة تحميل معاينة رابط أو تعديل حالة مهمة.
تعمل هذه الطريقة مع الرسائل التي أنشأها التطبيق، بما في ذلك الرسائل التي تم إنشاؤها
نيابةً عن مستخدم.
لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إنشاء البطاقات التفاعلية وتعديلها.