API Reference

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

این راهنمای مرجع نحوه استفاده از API برای انجام همه این عملیات را توضیح می‌دهد. این راهنما بر اساس نوع منبع سازماندهی شده است. یک منبع نشان دهنده نوعی از آیتم است که بخشی از تجربه یوتیوب را شامل می‌شود، مانند یک ویدیو، یک لیست پخش یا یک اشتراک. برای هر نوع منبع، این راهنما یک یا چند نمایش داده را فهرست می‌کند و منابع به صورت اشیاء JSON نمایش داده می‌شوند. این راهنما همچنین یک یا چند روش پشتیبانی شده ( LIST ، POST ، DELETE و غیره) را برای هر نوع منبع فهرست می‌کند و نحوه استفاده از آن روش‌ها را در برنامه شما توضیح می‌دهد.

فراخوانی API

الزامات زیر برای درخواست‌های YouTube Data API اعمال می‌شود:

  1. هر درخواست باید یا یک کلید API (با پارامتر key ) مشخص کند یا یک توکن OAuth 2.0 ارائه دهد. کلید API شما در پنل دسترسی API کنسول توسعه‌دهندگان برای پروژه‌تان موجود است.

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

    علاوه بر این، برخی از روش‌های API برای بازیابی منابع ممکن است از پارامترهایی پشتیبانی کنند که نیاز به مجوز دارند یا ممکن است هنگام مجوز درخواست‌ها، حاوی فراداده‌های اضافی باشند. به عنوان مثال، درخواستی برای بازیابی ویدیوهای آپلود شده یک کاربر، در صورتی که درخواست توسط آن کاربر خاص مجاز شده باشد، ممکن است شامل ویدیوهای خصوصی نیز باشد.

  3. این API از پروتکل احراز هویت OAuth 2.0 پشتیبانی می‌کند. شما می‌توانید یک توکن OAuth 2.0 را به یکی از روش‌های زیر ارائه دهید:

    • از پارامتر پرس‌وجوی access_token به این صورت استفاده کنید: ?access_token= oauth2-token
    • از هدر HTTP Authorization به این صورت استفاده کنید: Authorization: Bearer oauth2-token

    دستورالعمل‌های کامل برای پیاده‌سازی احراز هویت OAuth 2.0 در برنامه شما را می‌توانید در راهنمای احراز هویت بیابید.

انواع منابع

Activities

یک منبع activity شامل اطلاعاتی درباره عملی است که یک کانال یا کاربر خاص در یوتیوب انجام داده است. اقدامات گزارش شده در فیدهای فعالیت شامل رتبه‌بندی یک ویدیو، اشتراک‌گذاری ویدیو، علامت‌گذاری یک ویدیو به عنوان مورد علاقه، آپلود ویدیو و غیره است. هر منبع activity نوع عمل، کانال مرتبط با عمل و منبع(های) مرتبط با عمل، مانند ویدیویی که رتبه‌بندی یا آپلود شده است را مشخص می‌کند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /activities لیستی از رویدادهای فعالیت کانال را که با معیارهای درخواست مطابقت دارند، برمی‌گرداند. برای مثال، می‌توانید رویدادهای مرتبط با یک کانال خاص یا با کانال خود کاربر را بازیابی کنید.

Captions

یک منبع caption یک آهنگ زیرنویس یوتیوب را نشان می‌دهد. یک آهنگ زیرنویس دقیقاً با یک ویدیوی یوتیوب مرتبط است.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
delete DELETE /captions آهنگ زیرنویس مشخص شده را حذف می‌کند.
download GET /captions/ id یک آهنگ زیرنویس را دانلود می‌کند. آهنگ زیرنویس در قالب اصلی خود بازگردانده می‌شود، مگر اینکه درخواست مقداری برای پارامتر tfmt مشخص کند و به زبان اصلی خود بازگردانده می‌شود، مگر اینکه درخواست مقداری برای پارامتر tlang مشخص کند.
insert POST /captions یک آهنگ زیرنویس آپلود می‌کند.
list GET /captions فهرستی از آهنگ‌های زیرنویس مرتبط با یک ویدیوی مشخص را برمی‌گرداند. پاسخ API شامل زیرنویس‌های واقعی نیست و متد captions.download قابلیت بازیابی آهنگ زیرنویس را فراهم می‌کند.
update PUT /captions یک آهنگ زیرنویس را به‌روزرسانی می‌کند. هنگام به‌روزرسانی یک آهنگ زیرنویس، می‌توانید وضعیت پیش‌نویس آهنگ را تغییر دهید، یک فایل زیرنویس جدید برای آهنگ بارگذاری کنید یا هر دو را انجام دهید.

ChannelBanners

یک منبع channelBanner شامل URL ای است که شما برای تنظیم یک تصویر تازه آپلود شده به عنوان تصویر بنر برای یک کانال از آن استفاده خواهید کرد.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
insert POST /channelBanners/insert تصویر بنر کانال را در یوتیوب آپلود می‌کند. این روش دو مرحله اول از یک فرآیند سه مرحله‌ای برای به‌روزرسانی تصویر بنر برای یک کانال را نشان می‌دهد:
  1. برای آپلود داده‌های تصویر باینری در یوتیوب، متد channelBanners.insert را فراخوانی کنید. تصویر باید نسبت ابعاد ۱۶:۹ داشته باشد و حداقل ۲۰۴۸x۱۱۵۲ پیکسل باشد. توصیه می‌کنیم تصویری با ابعاد ۲۵۶۰ پیکسل در ۱۴۴۰ پیکسل آپلود کنید.
  2. مقدار ویژگی url را از پاسخی که API برای مرحله 1 برمی‌گرداند، استخراج کنید.
  3. برای به‌روزرسانی تنظیمات برندسازی کانال، متد channels.update را فراخوانی کنید. مقدار ویژگی brandingSettings.image.bannerExternalUrl را برابر با URL به‌دست‌آمده در مرحله ۲ قرار دهید.

ChannelSections

یک منبع channelSection حاوی اطلاعاتی درباره مجموعه‌ای از ویدیوهایی است که یک کانال برای نمایش انتخاب کرده است. برای مثال، یک بخش می‌تواند آخرین آپلودهای کانال، محبوب‌ترین آپلودها یا ویدیوهای یک یا چند لیست پخش را نمایش دهد.

بخش‌های یک کانال فقط در صورتی قابل مشاهده هستند که کانال، محتوا را در نمای مرور (به جای نمای فید) نمایش دهد. برای فعال کردن نمایش محتوا در نمای مرور، ویژگی brandingSettings.channel.showBrowseView را برای کانال مشخص شده روی true تنظیم کنید.

یک کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
delete DELETE /channelSections یک بخش کانال را حذف می‌کند.
insert POST /channelSections یک بخش کانال به کانال کاربر احراز هویت شده اضافه می‌کند. یک کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند.
list GET /channelSections لیستی از منابع channelSection را که با معیارهای درخواست API مطابقت دارند، برمی‌گرداند.
update PUT /channelSections به‌روزرسانی بخشی از کانال

Channels

یک منبع channel حاوی اطلاعاتی درباره یک کانال یوتیوب است.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /channels مجموعه‌ای از صفر یا چند منبع channel را که با معیارهای درخواست مطابقت دارند، برمی‌گرداند.
update PUT /channels متادیتای یک کانال را به‌روزرسانی می‌کند. این متد فقط از به‌روزرسانی‌های مربوط به اشیاء brandingSettings و invideoPromotion منبع channel و ویژگی‌های فرزند آنها پشتیبانی می‌کند.

CommentThreads

یک منبع commentThread حاوی اطلاعاتی درباره یک رشته نظرات یوتیوب است که شامل یک نظر سطح بالا و پاسخ‌هایی (در صورت وجود) به آن نظر می‌شود. یک منبع commentThread می‌تواند نظرات مربوط به یک ویدیو یا یک کانال را نشان دهد.

هم نظر سطح بالا و هم پاسخ‌ها در واقع منابع comment هستند که درون منبع commentThread قرار گرفته‌اند. منبع commentThread لزوماً شامل تمام پاسخ‌های یک نظر نیست و اگر می‌خواهید تمام پاسخ‌های یک نظر خاص را بازیابی کنید، باید از متد comments.list استفاده کنید. همچنین، برخی از نظرات پاسخی ندارند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /commentThreads لیستی از رشته‌های نظر که با پارامترهای درخواست API مطابقت دارند را برمی‌گرداند.
insert POST /commentThreads یک نظر سطح بالای جدید ایجاد می‌کند. برای افزودن پاسخ به یک نظر موجود، به جای آن از متد comments.insert استفاده کنید.

Comments

یک منبع comment شامل اطلاعاتی در مورد یک نظر یوتیوب است. یک منبع comment می‌تواند نشان‌دهنده نظری در مورد یک ویدیو یا یک کانال باشد. علاوه بر این، نظر می‌تواند یک نظر سطح بالا یا پاسخی به یک نظر سطح بالا باشد.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /comments لیستی از نظراتی را که با پارامترهای درخواست API مطابقت دارند، برمی‌گرداند.
setModerationStatus POST /comments/setModerationStatus وضعیت مدیریت یک یا چند نظر را تنظیم می‌کند. درخواست API باید توسط صاحب کانال یا ویدیوی مرتبط با نظرات تأیید شود.
insert POST /comments یک پاسخ به یک نظر موجود ایجاد می‌کند. نکته: برای ایجاد یک نظر سطح بالا، از متد commentThreads.insert استفاده کنید.
delete DELETE /comments یک نظر را حذف می‌کند.
update PUT /comments یک نظر را اصلاح می‌کند.

I18nLanguages

یک منبع i18nLanguage زبان برنامه‌ای را که وب‌سایت یوتیوب از آن پشتیبانی می‌کند، مشخص می‌کند. زبان برنامه همچنین می‌تواند به عنوان زبان رابط کاربری (UI) شناخته شود. برای وب‌سایت یوتیوب، زبان برنامه می‌تواند به طور خودکار بر اساس تنظیمات حساب گوگل، زبان مرورگر یا موقعیت IP انتخاب شود. کاربر همچنین می‌تواند به صورت دستی زبان رابط کاربری را از پاورقی سایت یوتیوب انتخاب کند.

هر منبع i18nLanguage یک کد زبان و یک نام را مشخص می‌کند. کد زبان می‌تواند به عنوان مقدار پارامتر hl هنگام فراخوانی متدهای API مانند videoCategories.list استفاده شود.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /i18nLanguages لیستی از زبان‌های برنامه‌ای که وب‌سایت YouTube از آنها پشتیبانی می‌کند را برمی‌گرداند.

I18nRegions

یک منبع i18nRegion یک منطقه جغرافیایی را مشخص می‌کند که یک کاربر YouTube می‌تواند آن را به عنوان منطقه محتوای ترجیحی انتخاب کند. منطقه محتوا همچنین می‌تواند به عنوان یک منطقه محتوا شناخته شود. برای وب‌سایت YouTube، یک منطقه محتوا می‌تواند به طور خودکار بر اساس اکتشافاتی مانند دامنه YouTube یا موقعیت IP کاربر انتخاب شود. کاربر همچنین می‌تواند به صورت دستی منطقه محتوا را از پاورقی سایت YouTube انتخاب کند.

هر منبع i18nRegion یک کد منطقه و یک نام را مشخص می‌کند. کد منطقه می‌تواند به عنوان مقدار پارامتر regionCode هنگام فراخوانی متدهای API مانند search.list ، videos.list ، activities.list و videoCategories.list استفاده شود.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /i18nRegions فهرستی از مناطق محتوایی که وب‌سایت یوتیوب پشتیبانی می‌کند را برمی‌گرداند.

Members

یک منبع member ، نماینده یک عضو کانال برای یک کانال یوتیوب است. یک عضو، حمایت مالی دوره‌ای را به یک سازنده ارائه می‌دهد و مزایای ویژه‌ای دریافت می‌کند. به عنوان مثال، اعضا می‌توانند زمانی که سازنده حالت فقط اعضا را برای چت فعال می‌کند، چت کنند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /members اعضای (که قبلاً به عنوان "حامیان مالی" شناخته می‌شدند) یک کانال را فهرست می‌کند. درخواست API باید توسط صاحب کانال تأیید شود.

MembershipsLevels

منبع membershipsLevel یک سطح قیمت‌گذاری برای سازنده‌ای که درخواست API را تأیید کرده است، مشخص می‌کند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /membershipsLevels مجموعه‌ای از منابع membershipsLevel صفر یا بیشتر را که متعلق به کانالی است که درخواست API را تأیید کرده است، برمی‌گرداند. سطوح به ترتیب نمایش ضمنی برگردانده می‌شوند.

PlaylistItems

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

یوتیوب همچنین از یک لیست پخش برای شناسایی فهرست ویدیوهای آپلود شده در یک کانال استفاده می‌کند، که هر playlistItem در آن لیست نشان دهنده یک ویدیوی آپلود شده است. می‌توانید شناسه لیست پخش آن لیست را از channel resource برای یک کانال مشخص بازیابی کنید. سپس می‌توانید از متد playlistItems.list برای بازیابی لیست استفاده کنید.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
delete DELETE /playlistItems یک مورد از لیست پخش را حذف می‌کند.
insert POST /playlistItems یک منبع را به لیست پخش اضافه می‌کند.
list GET /playlistItems مجموعه‌ای از آیتم‌های لیست پخش را که با پارامترهای درخواست API مطابقت دارند، برمی‌گرداند. می‌توانید تمام آیتم‌های لیست پخش را در یک لیست پخش مشخص شده بازیابی کنید یا یک یا چند آیتم لیست پخش را با استفاده از شناسه‌های منحصر به فرد آنها بازیابی کنید.
update PUT /playlistItems یک آیتم لیست پخش را تغییر می‌دهد. برای مثال، می‌توانید موقعیت آیتم را در لیست پخش به‌روزرسانی کنید.

Playlists

یک منبع playlist یک لیست پخش یوتیوب را نشان می‌دهد. لیست پخش مجموعه‌ای از ویدیوهاست که می‌توان آن‌ها را به ترتیب مشاهده کرد و با سایر کاربران به اشتراک گذاشت. به طور پیش‌فرض، لیست‌های پخش برای سایر کاربران به صورت عمومی قابل مشاهده هستند، اما لیست‌های پخش می‌توانند عمومی یا خصوصی باشند.

یوتیوب همچنین از لیست‌های پخش برای شناسایی مجموعه‌های ویژه ویدیوها برای یک کانال استفاده می‌کند، مانند:

  • ویدیوهای آپلود شده
  • ویدیوهای دارای امتیاز مثبت (لایک شده)
  • تاریخچه تماشا
  • بعداً تماشا کنید

به طور خاص‌تر، این لیست‌ها با یک کانال مرتبط هستند که مجموعه‌ای از ویدیوها، لیست‌های پخش و سایر اطلاعات یوتیوب یک شخص، گروه یا شرکت است. می‌توانید شناسه‌های لیست پخش را برای هر یک از این لیست‌ها از channel resource برای یک کانال مشخص بازیابی کنید.

سپس می‌توانید از متد playlistItems.list برای بازیابی هر یک از آن لیست‌ها استفاده کنید. همچنین می‌توانید با فراخوانی متدهای playlistItems.insert و playlistItems.delete ، آیتم‌هایی را به آن لیست‌ها اضافه یا حذف کنید.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
delete DELETE /playlists یک لیست پخش را حذف می‌کند.
list GET /playlists مجموعه‌ای از لیست‌های پخش را که با پارامترهای درخواست API مطابقت دارند، برمی‌گرداند. برای مثال، می‌توانید تمام لیست‌های پخشی را که کاربر احراز هویت شده در اختیار دارد، بازیابی کنید، یا می‌توانید یک یا چند لیست پخش را با استفاده از شناسه‌های منحصر به فرد آنها بازیابی کنید.
insert POST /playlists یک لیست پخش ایجاد می‌کند.
update PUT /playlists یک لیست پخش را تغییر می‌دهد. برای مثال، می‌توانید عنوان، توضیحات یا وضعیت حریم خصوصی یک لیست پخش را تغییر دهید.

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

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /search مجموعه‌ای از نتایج جستجو را که با پارامترهای پرس‌وجو مشخص‌شده در درخواست API مطابقت دارند، برمی‌گرداند. به‌طور پیش‌فرض، یک مجموعه نتیجه جستجو، منابع video ، channel و playlist منطبق را شناسایی می‌کند، اما می‌توانید پرس‌وجوها را طوری پیکربندی کنید که فقط نوع خاصی از منبع را بازیابی کنند.

Subscriptions

یک منبع subscription شامل اطلاعاتی درباره اشتراک کاربر یوتیوب است. اشتراک، کاربر را از اضافه شدن ویدیوهای جدید به کانال یا انجام یکی از چندین اقدام در یوتیوب، مانند آپلود ویدیو، امتیازدهی به ویدیو یا نظر دادن در مورد ویدیو، مطلع می‌کند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
delete DELETE /subscriptions اشتراک را حذف می‌کند.
insert POST /subscriptions یک اشتراک برای کانال کاربر احراز هویت شده اضافه می‌کند.
list GET /subscriptions منابع اشتراکی که با معیارهای درخواست API مطابقت دارند را برمی‌گرداند.

Thumbnails

یک منبع تصویر thumbnail اندازه‌های مختلف تصویر بندانگشتی مرتبط با یک منبع را مشخص می‌کند. تصاویر بندانگشتی دارای ویژگی‌های زیر هستند:

  • ویژگی snippet.thumbnails یک منبع، شیء‌ای است که تصاویر کوچک موجود برای آن منبع را شناسایی می‌کند.
  • یک منبع thumbnail شامل مجموعه‌ای از اشیاء است. نام هر شیء ( default ، medium ، high و غیره) به اندازه تصویر بندانگشتی اشاره دارد.
  • انواع مختلف منابع ممکن است از اندازه‌های مختلف تصویر بندانگشتی پشتیبانی کنند.
  • انواع مختلف منابع ممکن است اندازه‌های متفاوتی برای تصاویر کوچک با نام یکسان تعریف کنند. برای مثال، تصویر کوچک default برای یک منبع video معمولاً ۱۲۰ پیکسل در ۹۰ پیکسل است و تصویر کوچک default برای یک منبع channel معمولاً ۸۸ پیکسل در ۸۸ پیکسل است.
  • منابع از یک نوع ممکن است بسته به وضوح تصویر اصلی یا محتوای آپلود شده در YouTube، اندازه تصاویر کوچک متفاوتی برای تصاویر خاص داشته باشند. به عنوان مثال، یک ویدیوی HD ممکن است از تصاویر کوچک با وضوح بالاتر نسبت به ویدیوهای غیر HD پشتیبانی کند.
  • هر شیء که حاوی اطلاعاتی در مورد اندازه تصویر بندانگشتی است، دارای یک ویژگی width و یک ویژگی height است. با این حال، ممکن است ویژگی‌های width و height برای آن تصویر برگردانده نشوند.
  • اگر تصویر کوچک آپلود شده با ابعاد مورد نیاز مطابقت نداشته باشد، تصویر بدون تغییر نسبت ابعاد، تغییر اندازه داده می‌شود تا با اندازه صحیح مطابقت داشته باشد. تصویر برش داده نمی‌شود، اما ممکن است شامل نوارهای سیاه باشد تا اندازه صحیح باشد.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
set POST /thumbnails/set یک تصویر کوچک ویدیوی سفارشی را در YouTube بارگذاری می‌کند و آن را برای یک ویدیو تنظیم می‌کند.

VideoAbuseReportReasons

یک منبع videoAbuseReportReason حاوی اطلاعاتی در مورد دلیلی است که یک ویدیو به دلیل محتوای توهین‌آمیز علامت‌گذاری می‌شود. هنگامی که برنامه شما متد videos.reportAbuse را برای گزارش یک ویدیوی توهین‌آمیز فراخوانی می‌کند، درخواست از اطلاعات منبع videoAbuseReportReason برای شناسایی دلیل گزارش ویدیو استفاده می‌کند.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /videoAbuseReportReasons فهرستی از دلایلی که می‌توان برای گزارش ویدیوهای توهین‌آمیز استفاده کرد، تهیه کنید.

VideoCategories

یک منبع videoCategory دسته‌بندی‌ای را شناسایی می‌کند که با ویدیوهای آپلود شده مرتبط بوده یا می‌تواند مرتبط باشد.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
list GET /videoCategories فهرستی از دسته‌هایی را که می‌توانند با ویدیوهای یوتیوب مرتبط باشند، برمی‌گرداند.

Videos

یک منبع video ، یک ویدیوی یوتیوب را نشان می‌دهد.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
insert POST /videos یک ویدیو را در یوتیوب آپلود می‌کند و به صورت اختیاری، متادیتای ویدیو را تنظیم می‌کند.
list GET /videos لیستی از ویدیوهایی را که با پارامترهای درخواست API مطابقت دارند، برمی‌گرداند.
delete DELETE /videos یک ویدیوی یوتیوب را حذف می‌کند.
update PUT /videos متادیتای یک ویدیو را به‌روزرسانی می‌کند.
rate POST /videos/rate به یک ویدیو امتیاز لایک یا دیسلایک اضافه کنید یا امتیازی را از یک ویدیو حذف کنید.
getRating GET /videos/getRating امتیازهایی را که کاربر مجاز به لیستی از ویدیوهای مشخص شده داده است، بازیابی می‌کند.
reportAbuse POST /videos/reportAbuse گزارش ویدیو به دلیل محتوای توهین‌آمیز.

Watermarks

یک منبع watermark تصویری را مشخص می‌کند که در طول پخش ویدیوهای یک کانال مشخص نمایش داده می‌شود. همچنین می‌توانید کانال هدفی را که تصویر به آن پیوند داده می‌شود، و همچنین جزئیات زمان‌بندی که تعیین می‌کند واترمارک در طول پخش ویدیو چه زمانی ظاهر می‌شود و مدت زمان قابل مشاهده بودن آن را مشخص کنید، مشخص کنید.

برای اطلاعات بیشتر در مورد این منبع، به نمایش منبع و فهرست ویژگی‌های آن مراجعه کنید.

روش درخواست HTTP توضیحات
آدرس‌های اینترنتی (URI) مربوط به https://www.googleapis.com/youtube/v3
set POST /watermarks/set یک تصویر واترمارک را در یوتیوب آپلود می‌کند و آن را برای یک کانال تنظیم می‌کند.
unset POST /watermarks/unset تصویر واترمارک کانال را حذف می‌کند.