لحذف رسالة محادثة يجب أن يفوّض مالك القناة أو مشرف المحادثة المباشرة المرتبطة بالحظر طلب البيانات من واجهة برمجة التطبيقات.
تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 20 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/messages
التفويض
يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.
| المعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
id |
stringتحدّد المَعلمة id معرّف رسالة المحادثة في YouTube للمرجع الذي يتم حذفه. |
|
نص الطلب
لا تقدّم نص طلب عند استدعاء هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، ستعرض رمز استجابة HTTP 204 (No Content).
الأخطاء
يوضّح الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب بيانات من هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات رسالة الخطأ.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
forbidden |
ليس لديك الأذونات المطلوبة لحذف الرسالة المحدّدة. |
forbidden (403) |
modificationNotAllowed |
لا يمكن حذف مورد liveChatMessage المحدّد. قد تحدّد المَعلمة id رسالة أنشأها مشرف أو مستخدم آخر لا يمكن حذف رسائله. |
notFound (404) |
liveChatMessageNotFound |
تعذّر العثور على الرسالة التي تحاول حذفها. تحقَّق من قيمة المَعلمة id للتأكّد من صحتها. |
جرِّبها الآن.
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.