Subscriptions: delete

يحذف هذا الطلب اشتراكًا.

تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 50 وحدة.

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

طلب

طلب HTTP

DELETE https://www.googleapis.com/youtube/v3/subscriptions

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المعلمات التي يتيحها طلب البحث هذا. وجميع المعلمات المدرَجة هي معلمات طلب بحث.

المعلمات
المعلمات المطلوبة
id string
تحدّد المَعلمة id معرّف الاشتراك على YouTube للمورد الذي يتم حذفه. في مورد subscription، تحدّد السمة id معرّف الاشتراك على YouTube.

نص الطلب

يُرجى عدم تقديم نص طلب عند طلب هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، تعرض رمز استجابة HTTP 204 (No Content).

الأخطاء

يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسالة الخطأ لمزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) subscriptionForbidden لم تتم مصادقة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة.
notFound (404) subscriptionNotFound تعذّر العثور على الاشتراك الذي تحاول حذفه. يُرجى التحقّق من قيمة المَعلمة id للطلب للتأكّد من أنّها صحيحة.

جرِّبها الآن.

استخدِم APIs Explorer لطلب واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والاستجابة.