يوضّح هذا الدليل كيفية استخدام الأسلوب
delete()
في مورد Message
من Google Chat API لحذف رسالة ملف شخصي أو بطاقة.
في Chat API، يتم تمثيل رسالة Chat باستخدام موارد
Message
.
في حين أنّ مستخدمي Chat يمكنهم إرسال رسائل تتضمّن نصًا فقط،
يمكن لتطبيقات Chat استخدام العديد من ميزات المراسلة الأخرى، بما في ذلك
عرض واجهات مستخدم ثابتة أو تفاعلية، وجمع المعلومات من
المستخدمين، وتسليم الرسائل بشكل خاص. لمزيد من المعلومات حول ميزات المراسلة
المتوفّرة لواجهة برمجة تطبيقات Chat، يُرجى الاطّلاع على مقالة
نظرة عامة على رسائل Google Chat.
باستخدام مصادقة التطبيق، يمكنك استخدام هذه الطريقة لحذف رسالة أرسلها تطبيق 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.
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.
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 Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- أنشئ مشروعًا مستقلاً في Apps Script، وفعِّل خدمة Chat المتقدّمة.
- في هذا الدليل، يجب استخدام مصادقة المستخدم أو مصادقة التطبيق. للمصادقة بصفتك تطبيق Chat، أنشئ بيانات اعتماد حساب الخدمة. لمعرفة الخطوات، يُرجى الاطّلاع على مقالة المصادقة والتفويض بصفتك تطبيق Google Chat.
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة بصفتك مستخدمًا أو تطبيق Chat.
حذف رسالة من خلال مصادقة المستخدم
لحذف رسالة باستخدام مصادقة المستخدم، يجب إدخال ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.messages
. - استخدِم الطريقة
DeleteMessage()
. - اضبط
name
على اسم المورد للرسالة المطلوب حذفها.
يحذف المثال التالي رسالة باستخدام مصادقة المستخدم:
Node.js
Python
Java
برمجة تطبيقات
لتشغيل هذا العيّنة، استبدِل ما يلي:
SPACE_NAME
: رقم التعريف منname
المساحة يمكنك الحصول على رقم التعريف من خلال استدعاء الأسلوبListSpaces()
أو من عنوان URL للمساحة.MESSAGE_NAME
: المعرّف منname
الرسالة يمكنك الحصول على رقم التعريف من نص الاستجابة الذي يتم إرجاعه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API، أو باستخدام الاسم المخصّص الذي تمّ تعيينه للرسالة عند إنشائها.
في حال نجاح العملية، يكون نص الاستجابة فارغًا، ما يشير إلى أنّه تمت حذف الرسالة.
حذف رسالة باستخدام مصادقة التطبيق
لحذف رسالة باستخدام مصادقة التطبيق، يجب إدخال المعلومات التالية في طلبك:
- حدِّد نطاق تفويض
chat.bot
. - استخدِم الطريقة
DeleteMessage()
. - اضبط
name
على اسم المورد للرسالة المطلوب حذفها.
يحذف المثال التالي رسالة باستخدام مصادقة التطبيق:
Node.js
Python
Java
برمجة تطبيقات
لتشغيل هذا العيّنة، استبدِل ما يلي:
SPACE_NAME
: رقم التعريف منname
المساحة يمكنك الحصول على رقم التعريف من خلال استدعاء الأسلوبListSpaces()
أو من عنوان URL للمساحة.MESSAGE_NAME
: المعرّف منname
الرسالة يمكنك الحصول على رقم التعريف من نص الاستجابة الذي يتم إرجاعه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API، أو باستخدام الاسم المخصّص الذي تمّ تعيينه للرسالة عند إنشائها.
في حال نجاح العملية، يكون نص الاستجابة فارغًا، ما يشير إلى أنّه تمت حذف الرسالة.