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