LiveStreams: update

یک جریان ویدیویی را به روز می کند. اگر ویژگی هایی که می خواهید تغییر دهید نمی توانند به روز شوند، باید یک جریان جدید با تنظیمات مناسب ایجاد کنید.

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

درخواست کنید

درخواست HTTP 

PUT https://www.googleapis.com/youtube/v3/liveStreams

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد. برای مطالعه بیشتر درباره احراز هویت و مجوز، به اجرای مجوز OAuth 2.0 مراجعه کنید.

دامنه
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

پارامترها

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

پارامترها
پارامترهای مورد نیاز
part string
پارامتر part در این عملیات دو هدف را دنبال می کند. ویژگی هایی را که عملیات نوشتن تنظیم می کند و همچنین ویژگی هایی را که پاسخ API شامل می شود شناسایی می کند.

ویژگی های part که می توانید در مقدار پارامتر قرار دهید عبارتند از id , snippet , cdn و status .

توجه داشته باشید که این روش مقادیر موجود را برای همه ویژگی‌های قابل تغییر که در هر قسمتی که مقدار پارامتر مشخص می‌کند وجود دارد لغو می‌کند. اگر بدنه درخواست مقداری را برای یک ویژگی قابل تغییر مشخص نکند، مقدار موجود برای آن ویژگی حذف خواهد شد.
پارامترهای اختیاری
onBehalfOfContentOwner string
این پارامتر فقط در یک درخواست مجاز به درستی قابل استفاده است.

توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است.
پارامتر onBehalfOfContentOwner نشان می دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می کند که از طرف مالک محتوا مشخص شده در مقدار پارامتر عمل می کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا امکان می‌دهد یک بار احراز هویت کنند و به تمام داده‌های ویدیویی و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت می‌کند باید به مالک محتوای YouTube مشخص شده مرتبط باشد.
onBehalfOfContentOwnerChannel string
این پارامتر فقط در یک درخواست مجاز به درستی قابل استفاده است.

توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است.
پارامتر onBehalfOfContentOwnerChannel شناسه کانال YouTube کانالی را که ویدیویی به آن اضافه می شود مشخص می کند. این پارامتر زمانی مورد نیاز است که یک درخواست مقداری را برای پارامتر onBehalfOfContentOwner مشخص می کند و فقط می تواند در ارتباط با آن پارامتر استفاده شود. علاوه بر این، درخواست باید با استفاده از یک حساب CMS که به مالک محتوایی که پارامتر onBehalfOfContentOwner مشخص می‌کند مرتبط است، مجاز باشد. در نهایت، کانالی که مقدار پارامتر onBehalfOfContentOwnerChannel مشخص می کند باید به مالک محتوایی که پارامتر onBehalfOfContentOwner مشخص می کند پیوند داده شود.

این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا اجازه می‌دهد تا یک بار احراز هویت کنند و اقداماتی را از طرف کانال مشخص‌شده در مقدار پارامتر انجام دهند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه باشد.

درخواست بدن

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

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

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

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

    • snippet.title
    • snippet.description

    اگر درخواست به‌روزرسانی ارسال می‌کنید و درخواست شما مقداری را برای خاصیتی که قبلاً دارای مقدار است مشخص نمی‌کند، مقدار موجود ویژگی حذف می‌شود.

پاسخ

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

خطاها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. برای جزئیات بیشتر، YouTube Live Streaming API - Errors را ببینید.

نوع خطا جزئیات خطا توضیحات
forbidden (403) liveStreamModificationNotAllowed پخش زنده مشخص شده را نمی توان در وضعیت فعلی تغییر داد. برای اطلاعات بیشتر، Life of a Broadcast را ببینید.
forbidden (403) liveStreamModificationNotAllowed API به شما اجازه نمی دهد پس از ایجاد جریان، مقدار فیلدهای cdn.format ، cdn.frameRate ، cdn.ingestionType ، یا cdn.resolution را تغییر دهید.
forbidden (403) liveStreamModificationNotAllowed API به شما اجازه نمی دهد یک جریان قابل استفاده مجدد را به غیرقابل استفاده مجدد تغییر دهید یا برعکس. برای اطلاعات بیشتر، به درک پخش‌ها و جریان‌ها مراجعه کنید.
insufficientPermissions insufficientLivePermissions درخواست مجاز به به روز رسانی جریان مستقیم مشخص شده نیست. برای اطلاعات بیشتر، به اجرای احراز هویت OAuth2 مراجعه کنید.
insufficientPermissions liveStreamingNotEnabled کاربری که درخواست را مجاز کرده است، قادر به پخش جریانی ویدیوی زنده در YouTube نیست. کاربر می تواند اطلاعات بیشتری را در واجد شرایط بودن ویژگی بیابد.
invalidValue (400) invalidDescription مقدار ویژگی snippet.description در منبع liveStream می تواند حداکثر 10000 کاراکتر داشته باشد.
invalidValue (400) invalidTitle مقدار ویژگی snippet.title در منبع liveStream باید بین 1 تا 128 نویسه باشد.
notFound (404) liveStreamNotFound پخش جریانی مستقیم مشخص شده وجود ندارد.
required (400) idRequired منبع liveStream باید مقداری را برای ویژگی id مشخص کند.
required (400) ingestionTypeRequired منبع liveStream باید مقداری را برای ویژگی cdn.ingestionType مشخص کند.
required (400) titleRequired منبع liveStream باید مقداری را برای ویژگی snippet.title مشخص کند.

آن را امتحان کنید!

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