LiveChatMessages: delete

حذف رسالة محادثة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.

حالات الاستخدام الشائعة

الطلب

طلب 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.