Subscriptions: insert

اشتراکی برای کانال کاربر اصالت‌سنجی‌شده اضافه می‌کند.

تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.

موارد استفاده رایج

درخواست

درخواست 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

پاسخ

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

خطاها

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

امتحان کنید!

برای فراخوانی این API و دیدن درخواست و پاسخ API، از APIs Explorer استفاده کنید.