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