API Reference

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

این راهنمای مرجع نحوه استفاده از API برای انجام همه این عملیات را توضیح می دهد. راهنما بر اساس نوع منبع سازماندهی شده است. منبع نوعی مورد را نشان می‌دهد که بخشی از تجربه YouTube را شامل می‌شود، مانند ویدیو، فهرست پخش یا اشتراک. برای هر نوع منبع، راهنما یک یا چند نمایش داده را فهرست می‌کند و منابع به صورت اشیاء 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 را به یکی از روش های زیر ارائه دهید:

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

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

انواع منابع

Activities

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

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

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

Captions

یک منبع caption یک تراک شرح YouTube را نشان می دهد. یک تراک شرح دقیقاً با یک ویدیوی YouTube مرتبط است.

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

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

  1. با روش channelBanners.insert تماس بگیرید تا داده های تصویر باینری را در YouTube آپلود کنید. تصویر باید دارای نسبت تصویر 16:9 و حداقل 2048x1152 پیکسل باشد. توصیه می کنیم یک تصویر 2560 در 1440 پیکسل را آپلود کنید.
  2. مقدار ویژگی url را از پاسخی که API برای مرحله 1 برمی‌گرداند استخراج کنید.
  3. برای به روز رسانی تنظیمات نام تجاری کانال، با روش channels.update تماس بگیرید. مقدار ویژگی brandingSettings.image.bannerExternalUrl را روی URL بدست آمده در مرحله 2 تنظیم کنید.

ChannelSections

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

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

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

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

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

Channels

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

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

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

CommentThreads

یک منبع commentThread حاوی اطلاعاتی در مورد یک موضوع نظر YouTube است که شامل یک نظر سطح بالا است و در صورت وجود، به آن نظر پاسخ می دهد. یک منبع 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 حاوی اطلاعاتی درباره یک نظر YouTube است. یک منبع comment می تواند یک نظر در مورد یک ویدیو یا یک کانال را نشان دهد. علاوه بر این، نظر می تواند یک نظر سطح بالا یا پاسخی به یک نظر سطح بالا باشد.

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

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

GuideCategories

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

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

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

I18nLanguages

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

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

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

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

I18nRegions

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

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

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

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

Members

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

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

روش درخواست 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 یک لیست پخش YouTube را نشان می دهد. لیست پخش مجموعه ای از ویدیوها است که می توان آنها را به صورت متوالی مشاهده کرد و با سایر کاربران به اشتراک گذاشت. یک لیست پخش می تواند حداکثر 200 ویدیو داشته باشد و YouTube تعداد لیست های پخشی را که هر کاربر ایجاد می کند محدود نمی کند. به طور پیش‌فرض، فهرست‌های پخش برای سایر کاربران به صورت عمومی قابل مشاهده هستند، اما فهرست‌های پخش می‌توانند عمومی یا خصوصی باشند.

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

  • ویدیوهای آپلود شده
  • ویدیوهای دارای امتیاز مثبت (پسندیده)
  • تاریخچه تماشا
  • بعدا تماشا کن
برای دقیق تر، این لیست ها با یک کانال مرتبط هستند که مجموعه ای از ویدیوها، لیست های پخش و سایر اطلاعات YouTube یک شخص، گروه یا شرکت است. می‌توانید شناسه‌های فهرست پخش هر یک از این فهرست‌ها را از 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 یک لیست پخش را اصلاح می کند. برای مثال، می‌توانید عنوان، توضیحات یا وضعیت حریم خصوصی فهرست پخش را تغییر دهید.

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

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

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

Subscriptions

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

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

روش درخواست 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 معمولاً 120 پیکسل در 90 پیکسل است و تصویر کوچک default برای یک منبع channel معمولاً 88 پیکسل در 88 پیکسل است.
  • بسته به وضوح تصویر اصلی یا محتوای آپلود شده در YouTube، منابعی از یک نوع ممکن است همچنان اندازه‌های تصویر کوچک متفاوتی برای تصاویر خاص داشته باشند. برای مثال، یک ویدیوی HD ممکن است از تصاویر کوچک با وضوح بالاتر نسبت به ویدیوهای غیر HD پشتیبانی کند.
  • هر شی که حاوی اطلاعات مربوط به اندازه تصویر بند انگشتی است دارای یک ویژگی 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 فهرستی از دسته‌هایی را که می‌توان با ویدیوهای YouTube مرتبط کرد، برمی‌گرداند.

Videos

یک منبع video نشان دهنده یک ویدیوی YouTube است.

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

روش درخواست HTTP شرح
URI های مربوط به https://www.googleapis.com/youtube/v3
insert POST /videos یک ویدیو را در YouTube آپلود می کند و به صورت اختیاری ابرداده ویدیو را تنظیم می کند.
list GET /videos فهرستی از ویدیوها را برمی‌گرداند که با پارامترهای درخواست API مطابقت دارند.
delete DELETE /videos یک ویدیوی YouTube را حذف می کند.
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 یک تصویر واترمارک را در YouTube آپلود می کند و آن را برای یک کانال تنظیم می کند.
unset POST /watermarks/unset تصویر واترمارک کانال را حذف می کند.