يؤدي هذا الإجراء إلى حذف اشتراك.
تأثير الحصة: تحتوي إحدى المكالمات إلى هذه الطريقة على تكلفة حصة تبلغ 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.