Subscriptions: insert

لإضافة اشتراك في قناة المستخدم الذي تمت المصادقة عليه.

التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 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 التي يمكنك تضمينها في قيمة المعلّمة:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

نص الطلب

قدِّم مورد اشتراك في نص الطلب. بالنسبة إلى هذا المورد:

  • يجب تحديد قيمة للخصائص التالية:

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