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 در این عملیات دو هدف را دنبال می کند. ویژگی هایی را که عملیات نوشتن تنظیم می کند و همچنین ویژگی هایی را که پاسخ API شامل می شود شناسایی می کند.

لیست زیر شامل نام part است که می توانید در مقدار پارامتر بگنجانید:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

درخواست بدن

یک منبع اشتراک در بدنه درخواست ارائه دهید. برای آن منبع:

  • شما باید یک مقدار برای این ویژگی ها مشخص کنید:

    • snippet.resourceId

  • شما می توانید مقادیری را برای این ویژگی ها تنظیم کنید:

    • snippet.resourceId

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع اشتراک را در بدنه پاسخ باز می گرداند.

خطاها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
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 برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.