لإضافة اشتراك في قناة المستخدم الذي تمت المصادقة عليه.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
POST 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 |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تستخدم المعلمة part غرضين في هذه العملية. وتحدّد هذه السمة الخصائص التي سيتم ضبطها من خلال عملية الكتابة، بالإضافة إلى الخصائص التي ستتضمنها استجابة واجهة برمجة التطبيقات.تتضمّن القائمة التالية أسماء part التي يمكنك تضمينها في قيمة المعلّمة:
|
نص الطلب
قدِّم مورد اشتراك في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
snippet.resourceId
-
يمكنك تعيين قيم للخصائص التالية:
snippet.resourceId
الإجابة
إذا نجحت هذه الطريقة، فإنها تعرض مورد الاشتراك في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
الاشتراك الذي تحاول إنشاءه موجود من قبل. |
badRequest (400) |
subscriptionForbidden |
لقد بلغت الحد الأقصى لعدد الاشتراكات. |
badRequest (400) |
subscriptionForbidden |
الاشتراك في قناتك الخاصة غير معتمد. |
badRequest (400) |
subscriptionForbidden |
الاشتراكات الأخيرة كثيرة جدًا. يُرجى المحاولة مرة أخرى بعد بضع ساعات. |
forbidden (403) |
subscriptionForbidden |
لم تتم مصادقة الطلب بشكل صحيح أو أنه غير معتمد لهذه القناة. |
notFound (404) |
publisherNotFound |
لا يمكن العثور على المورد المحدّد من خلال سمة الطلب snippet.resourceId . |
notFound (404) |
subscriberNotFound |
تعذّر العثور على المشترك الذي تم تحديده في الطلب. |
required (400) |
publisherRequired |
يجب أن يستخدم مورد الاشتراك المحدّد في الطلب السمة snippet.resourceId لتحديد القناة التي يتم الاشتراك فيها. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.