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