حذف رسالة محادثة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.
حالات الاستخدام الشائعة
الطلب
طلب 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.