يشرح هذا الدليل كيفية استخدام طريقة
update
في المورد Message ضمن Google Chat API لتعديل رسالة نصية أو رسالة بطاقة
في مساحة. تعديل رسالة لتغيير سمات الرسالة، مثل محتواها أو محتوى البطاقة يمكنك أيضًا إضافة رسالة نصية قبل رسالة بطاقة أو إضافة بطاقة إلى رسالة نصية.
في Chat API، يتم تمثيل رسالة Chat من خلال المورد
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. ويكون ذلك مفيدًا لتعديل محتوى بطاقة بدون تفاعل المستخدم، مثل إعادة تحميل معاينة رابط أو تعديل حالة مهمة.
تعمل هذه الطريقة مع الرسائل التي أنشأها التطبيق، بما في ذلك الرسائل التي تم إنشاؤها نيابةً عن مستخدم.
لمزيد من التفاصيل، يُرجى الاطّلاع على إنشاء البطاقات وتعديلها.
مواضيع ذات صلة
- تنسيق رسالة
- حذف رسالة
- الحصول على تفاصيل حول رسالة
- عرض قائمة بالرسائل في مساحة
- إرسال رسالة.
- البحث عن الرسائل