YouTube Data API به شما امکان می‌دهد عملکردهایی را که معمولاً در وب‌سایت YouTube اجرا می‌شوند در وب‌سایت یا برنامه خودتان بگنجانید. بخش‌های زیر انواع مختلف منابعی را که می‌توانید بااستفاده از API بازیابی کنید شناسایی می‌کند. این میانای برنامه‌سازی کاربردی همچنین از روش‌هایی برای درج، به‌روزرسانی، یا حذف بسیاری از این منابع پشتیبانی می‌کند.
این راهنمای مرجع نحوه استفاده از API را برای انجام همه این عملیات توضیح می‌دهد. این راهنما براساس نوع منبع سازمان‌دهی شده است. منبع نشان‌دهنده نوعی از مورد است که بخشی از تجربه YouTube را تشکیل می‌دهد، مانند ویدیو، فهرست پخش، یا اشتراک. برای هر نوع منبع، راهنما یک یا چند نمایش داده را فهرست می‌کند و منابع به‌عنوان اشیاء JSON نمایش داده می‌شوند. این راهنما همچنین یک یا چند روش پشتیبانی‌شده (LIST، POST، DELETE، و غیره) را برای هر نوع منبع فهرست می‌کند و نحوه استفاده از این روش‌ها را در برنامه‌تان توضیح می‌دهد.
فراخوانی میانای برنامه‌سازی کاربردی
الزامات زیر برای درخواست‌های YouTube Data API اعمال می‌شود:
-
هر درخواست باید کلید میانای برنامه‌سازی کاربردی (با پارامتر
key) را مشخص کند یا کد OAuth 2.0 ارائه دهد. کلید API شما در قاب دسترسی API در کنسول توسعه‌دهندگان برای پروژه شما دردسترس است. -
برای هر درخواست درج، به‌روزرسانی، و حذف، باید یک کد تأیید ارسال کنید. همچنین باید برای هر درخواستی که داده‌های خصوصی کاربر اصالت‌سنجی‌شده را بازیابی می‌کند، یک کد مجازسازی ارسال کنید.
علاوه‌براین، برخی‌از روش‌های API برای بازیابی منابع ممکن است از پارامترهایی که نیاز به مجوز دارند پشتیبانی کنند یا ممکن است هنگام مجاز شدن درخواست‌ها حاوی فراداده اضافی باشند. برای مثال، درخواست بازیابی ویدیوهای بارگذاری‌شده کاربر ممکن است شامل ویدیوهای خصوصی نیز باشد، اگر این درخواست توسط آن کاربر خاص مجاز شده باشد.
-
این میانای برنامه‌سازی کاربردی از پروتکل اصالت‌سنجی OAuth 2.0 پشتیبانی می‌کند. می‌توانید کد OAuth 2.0 را به یکی از روش‌های زیر ارائه دهید:
- از پارامتر پُرسمان
access_tokenبه این صورت استفاده کنید:?access_token=oauth2-token - از سرصفحه HTTP
Authorizationبه این صورت استفاده کنید:Authorization: Beareroauth2-token
دستورالعمل‌های کامل برای پیاده‌سازی اصالت‌سنجی OAuth 2.0 در برنامه شما را می‌توانید در راهنمای اصالت‌سنجی پیدا کنید.
- از پارامتر پُرسمان
انواع منبع
فعالیت‌ها
منبع activity حاوی اطلاعاتی درباره کنشی است که کانال یا کاربر خاصی در YouTube انجام داده است. کنش‌های گزارش‌شده در فیدهای فعالیت شامل رتبه‌بندی ویدیو، هم‌رسانی ویدیو، علامت‌گذاری ویدیو به‌عنوان موردعلاقه، بارگذاری ویدیو، و غیره است. هر منبع activity نوع کنش، کانال مرتبط با کنش، و منبع(های) مرتبط با کنش را شناسایی می‌کند، مانند ویدیویی که رتبه‌بندی یا بارگذاری شده است.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها آن را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /activities |
فهرستی از رویدادهای فعالیت کانال را که با معیارهای درخواست مطابقت دارند برمی‌گرداند. برای مثال، می‌توانید رویدادهای مرتبط با یک کانال خاص یا کانال خود کاربر را بازیابی کنید. |
زیرنویس ناشنوایان
منبع caption نشان‌دهنده قطعه زیرنویس ناشنوایان YouTube است. یک قطعه زیرنویس ناشنوایان دقیقاً با یک ویدیو YouTube مرتبط است.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /captions |
قطعه زیرنویس ناشنوایان مشخص‌شده را حذف می‌کند. |
download |
GET /captions/id |
قطعه زیرنویس ناشنوایان را بارگیری می‌کند. قطعه زیرنویس ناشنوایان در قالب اصلی خود برگردانده می‌شود، مگراینکه درخواست مقدار مشخصی برای پارامتر tfmt تعیین کند، و به زبان اصلی خود برگردانده می‌شود، مگراینکه درخواست مقدار مشخصی برای پارامتر tlang تعیین کند. |
insert |
POST /captions |
قطعه زیرنویس ناشنوایان بارگذاری می‌کند. |
list |
GET /captions |
فهرستی از قطعه‌های زیرنویس ناشنوایان را که با ویدیو مشخصی مرتبط هستند برمی‌گرداند. پاسخ میانای برنامه‌سازی کاربردی حاوی زیرنویس‌های واقعی نیست و روش captions.download امکان بازیابی قطعه زیرنویس ناشنوایان را فراهم می‌کند. |
update |
PUT /captions |
قطعه زیرنویس ناشنوایان را به‌روز می‌کند. هنگام به‌روزرسانی قطعه زیرنویس ناشنوایان، می‌توانید وضعیت پیش‌نویس قطعه را تغییر دهید، فایل زیرنویس ناشنوایان جدیدی برای قطعه بارگذاری کنید، یا هر دو کار را انجام دهید. |
ChannelBanners
منبع channelBanner حاوی نشانی وبی است که برای تنظیم تصویر بارگذاری‌شده جدید به‌عنوان تصویر برنمای کانال استفاده می‌کنید.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
insert |
POST /channelBanners/insert |
تصویر برنمای کانال را در YouTube بارگذاری می‌کند. این روش نشان‌دهنده دو مرحله اول در یک فرایند سه مرحله‌ای برای به‌روزرسانی تصویر برنما برای یک کانال است:
|
ChannelSections
منبع channelSection حاوی اطلاعاتی درباره مجموعه‌ای از ویدیوها است که کانال برای نمایش انتخاب کرده است. برای مثال، یک بخش می‌تواند شامل جدیدترین بارگذاری‌های کانال، محبوب‌ترین بارگذاری‌ها، یا ویدیوهایی از یک یا چند فهرست پخش باشد.
بخش‌های یک کانال فقط درصورتی قابل‌مشاهده هستند که کانال محتوا را در نمای مرور (به‌جای نمای فید) نمایش دهد. برای فعال کردن کانال برای نمایش محتوا در نمای مرور، دارایی brandingSettings.channel.showBrowseView را برای کانال مشخص‌شده روی true تنظیم کنید.
هر کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها آن را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /channelSections |
بخش کانال را حذف می‌کند. |
insert |
POST /channelSections |
بخش کانال را به کانال کاربر اصالت‌سنجی‌شده اضافه می‌کند. هر کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند. |
list |
GET /channelSections |
فهرستی از منابع channelSection را که با معیارهای درخواست API مطابقت دارند برمی‌گرداند. |
update |
PUT /channelSections |
بخش کانال را به‌روزرسانی می‌کند. |
کانال‌ها
منبع channel حاوی اطلاعاتی درباره کانال YouTube است.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /channels |
مجموعه‌ای از صفر یا چند منبع channel را که با معیارهای درخواست مطابقت دارند برمی‌گرداند. |
update |
PUT /channels |
فراداده کانال را به‌روزرسانی می‌کند. این روش فقط از به‌روزرسانی‌های اشیاء brandingSettings و invideoPromotion منبع channel و ویژگی‌های فرزند آن‌ها پشتیبانی می‌کند. |
CommentThreads
یک منبع commentThread حاوی اطلاعاتی درباره یک رشته نظر YouTube است که شامل یک نظر سطح بالا و پاسخ‌ها، درصورت وجود، به آن نظر می‌شود. منبع commentThread می‌تواند نشان‌دهنده نظرات درباره ویدیو یا کانال باشد.
هم نظر سطح بالا و هم پاسخ‌ها درواقع منابع comment هستند که در منبع commentThread قرار گرفته‌اند. منبع commentThread لزوماً حاوی همه پاسخ‌های یک نظر نیست و اگر می‌خواهید همه پاسخ‌های یک نظر خاص را بازیابی کنید، باید از روش comments.list استفاده کنید. همچنین، برخی‌از نظرات پاسخ ندارند.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به https://www.googleapis.com/youtube/v3 |
||
list |
GET /commentThreads |
فهرستی از رشته‌های نظراتی که با پارامترهای درخواست API مطابقت دارند را برمی‌گرداند. |
insert |
POST /commentThreads |
نظر سطح بالای جدیدی ایجاد می‌کند. برای افزودن پاسخ به نظر موجود، از روش comments.insert استفاده کنید. |
نظرات
یک منبع comment حاوی اطلاعاتی درباره یک نظر YouTube است. منبع comment می‌تواند نشان‌دهنده نظری درباره ویدیو یا کانال باشد. علاوه‌براین، نظر می‌تواند یک نظر سطح بالا یا پاسخی به یک نظر سطح بالا باشد.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به 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 زبان برنامه‌ای را که وب‌سایت YouTube پشتیبانی می‌کند شناسایی می‌کند. زبان برنامه را می‌توان زبان واسط کاربر نیز نامید. برای وب‌سایت YouTube، زبان برنامه می‌تواند به‌طور خودکار براساس تنظیمات «حساب Google»، زبان مرورگر، یا مکان IP انتخاب شود. کاربر همچنین می‌تواند زبان UI را به‌صورت دستی از پاورقی سایت YouTube انتخاب کند.
هر منبع i18nLanguage یک کد زبان و یک نام را شناسایی می‌کند. هنگام فراخوانی روش‌های میانای برنامه‌سازی کاربردی مانند videoCategories.list، می‌توان از کد زبان به‌عنوان مقدار پارامتر hl استفاده کرد.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به 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 | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /i18nRegions |
فهرستی از مناطق محتوایی را که وب‌سایت YouTube پشتیبانی می‌کند برمی‌گرداند. |
اعضا
منبع member نشان‌دهنده عضو کانال برای کانال YouTube است. عضو به‌طور مکرر از محتواساز حمایت مالی می‌کند و مزایای ویژه دریافت می‌کند. برای مثال، اعضا می‌توانند زمانی که محتواساز حالت مختص اعضا را برای گپ روشن می‌کند، گپ بزنند.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /members |
اعضای (که قبلاً به‌عنوان «حامیان مالی» شناخته می‌شدند) یک کانال را فهرست می‌کند. درخواست میانای برنامه‌سازی کاربردی باید توسط مالک کانال مجاز شود. |
MembershipsLevels
منبع membershipsLevel سطح قیمت‌گذاری را برای محتواسازی که درخواست API را مجاز کرده است شناسایی می‌کند.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به https://www.googleapis.com/youtube/v3 |
||
list |
GET /membershipsLevels |
مجموعه‌ای از صفر یا بیشتر از membershipsLevel
منابع متعلق به کانالی که درخواست API را مجاز کرده است برمی‌گرداند. سطح‌ها به‌ترتیب نمایش ضمنی برگردانده می‌شوند. |
PlaylistItems
منبع playlistItem منبع دیگری را شناسایی می‌کند، مانند ویدیو، که در فهرست پخش گنجانده شده است. علاوه‌براین، منبع playlistItem
حاوی جزئیاتی درباره منبع گنجانده‌شده است که به‌طور خاص به نحوه استفاده از آن منبع
در آن فهرست پخش مربوط می‌شود.
YouTube همچنین از فهرست پخش برای شناسایی فهرست ویدیوهای بارگذاری‌شده کانال استفاده می‌کند، که هر
playlistItem در آن فهرست نشان‌دهنده یک ویدیو بارگذاری‌شده است. می‌توانید شناسه فهرست پخش را برای آن فهرست از channel resource
برای یک کانال معین بازیابی کنید. سپس می‌توانید از روش
playlistItems.list برای بازیابی فهرست
استفاده کنید.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /playlistItems |
موردی را از فهرست پخش حذف می‌کند. |
insert |
POST /playlistItems |
منبعی را به فهرست پخش اضافه می‌کند. |
list |
GET /playlistItems |
مجموعه‌ای از عناصر فهرست پخش را که با پارامترهای درخواست API مطابقت دارند برمی‌گرداند. می‌توانید همه موارد فهرست پخش را در یک فهرست پخش مشخص بازیابی کنید یا یک یا چند مورد فهرست پخش را با شناسه یکتای آن‌ها بازیابی کنید. |
update |
PUT /playlistItems |
مورد فهرست پخش را اصلاح می‌کند. برای مثال، می‌توانید موقعیت مورد را در فهرست پخش به‌روز کنید. |
فهرست‌های پخش
منبع playlist نشان‌دهنده فهرست پخش YouTube است. فهرست پخش مجموعه‌ای از ویدیوها است که می‌توان آن‌ها را به‌ترتیب مشاهده کرد و با کاربران دیگر هم‌رسانی کرد. به‌طور پیش‌فرض، فهرست‌های پخش برای سایر کاربران به‌طور عمومی قابل‌مشاهده هستند، اما فهرست‌های پخش می‌توانند عمومی یا خصوصی باشند.
YouTube همچنین از فهرست‌های پخش برای شناسایی مجموعه‌های خاص ویدیوها برای یک کانال استفاده می‌کند، مانند:
- ویدیوهای بارگذاری‌شده
- ویدیوهای دارای رده‌بندی مثبت (پسندیده)
- سابقه تماشا
- تماشا در فرصتی دیگر
به‌طور دقیق‌تر، این فهرست‌ها با یک کانال مرتبط هستند، که مجموعه‌ای از ویدیوها، فهرست‌های پخش، و سایر اطلاعات YouTube متعلق به یک شخص، گروه، یا شرکت است. می‌توانید شناسه‌های فهرست پخش را برای هریک از این فهرست‌ها از channel resource برای کانال موردنظر بازیابی کنید.
سپس می‌توانید از روش playlistItems.list برای بازیابی هریک از آن فهرست‌ها استفاده کنید. همچنین می‌توانید با فراخوانی روش‌های playlistItems.insert و playlistItems.delete، مواردی را به آن فهرست‌ها اضافه یا از آن‌ها حذف کنید.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /playlists |
فهرست پخش را حذف می‌کند. |
list |
GET /playlists |
مجموعه‌ای از فهرست‌های پخش را که با پارامترهای درخواست API مطابقت دارند برمی‌گرداند. برای مثال، می‌توانید همه فهرست‌های پخشی را که کاربر اصالت‌سنجی‌شده مالک آن‌ها است بازیابی کنید، یا می‌توانید یک یا چند فهرست پخش را با شناسه یکتای آن‌ها بازیابی کنید. |
insert |
POST /playlists |
فهرست پخش ایجاد می‌کند. |
update |
PUT /playlists |
فهرست پخش را اصلاح می‌کند. برای مثال، می‌توانید عنوان، شرح، یا وضعیت حریم خصوصی فهرست پخش را تغییر دهید. |
جستجو
نتیجه جستجو حاوی اطلاعاتی درباره ویدیو، کانال، یا فهرست پخش YouTube است که با پارامترهای جستجوی مشخص‌شده در درخواست API مطابقت دارد. درحالی‌که نتیجه جستجو به منبعی مشخصاً شناساننده، مانند ویدیو، اشاره می‌کند، داده‌های پایدار خودش را ندارد.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /search |
مجموعه‌ای از نتایج جستجو را برمی‌گرداند که با پارامترهای پُرسمان مشخص‌شده در درخواست API مطابقت دارند. به‌طور پیش‌فرض، مجموعه نتایج جستجو منابع video، channel، و playlist منطبق را شناسایی می‌کند، اما می‌توانید پُرسمان‌ها را نیز پیکربندی کنید تا فقط نوع خاصی از منبع را بازیابی کنند. |
اشتراک‌ها
یک منبع subscription حاوی اطلاعاتی درباره اشتراک کاربر YouTube است. اشتراک به کاربر اطلاع می‌دهد که ویدیوهای جدیدی به کانال اضافه شده است یا کاربر دیگری یکی از چندین اقدام را در YouTube انجام می‌دهد، مانند بارگذاری ویدیو، رتبه‌بندی ویدیو، یا نظر دادن درباره ویدیو.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها آن را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /subscriptions |
اشتراکی را حذف می‌کند. |
insert |
POST /subscriptions |
اشتراکی برای کانال کاربر اصالت‌سنجی‌شده اضافه می‌کند. |
list |
GET /subscriptions |
منابع اشتراکی را که با معیارهای درخواست میانای برنامه‌سازی کاربردی مطابقت دارند برمی‌گرداند. |
ریزعکس‌ها
منبع thumbnail اندازه‌های مختلف تصویر کوچک مرتبط با منبع را شناسایی می‌کند. تصاویر کوچک دارای ویژگی‌های زیر هستند:
- ویژگی
snippet.thumbnailsیک منبع، شیئی است که تصاویر کوچک موجود برای آن منبع را شناسایی می‌کند. - منبع
thumbnailشامل مجموعه‌ای از اشیا است. نام هر شیء (default،medium،high، و غیره) به اندازه تصویر کوچک اشاره دارد. - انواع مختلف منابع ممکن است از اندازه‌های مختلف تصویر ریزعکس پشتیبانی کنند.
- انواع مختلف منابع ممکن است اندازه‌های مختلفی را برای تصاویر کوچک با نام یکسان تعریف کنند. برای مثال، تصویر کوچک
defaultبرای منبعvideoمعمولاً ۱۲۰ پیکسل در ۹۰ پیکسل است و تصویر کوچکdefaultبرای منبعchannelمعمولاً ۸۸ پیکسل در ۸۸ پیکسل است. - منابع از یک نوع ممکن است همچنان اندازه‌های تصویر ریزعکس متفاوتی برای تصاویر خاص داشته باشند، بسته به وضوح تصویر اصلی یا محتوای بارگذاری‌شده در YouTube. برای مثال، یک ویدیو HD ممکن است از ریزعکس‌هایی با وضوح بالاتر نسبت به ویدیوهای غیر HD پشتیبانی کند.
- هر شیء که حاوی اطلاعاتی درباره اندازه تصویر کوچک است، دارای یک ویژگی
widthو یک ویژگیheightاست. بااین‌حال، ممکن است ویژگی‌های عرض و ارتفاع برای آن تصویر برگردانده نشود. - اگر تصویر کوچک بارگذاری‌شده با ابعاد موردنیاز مطابقت نداشته باشد، تصویر بدون تغییر نسبت ابعادی آن، به اندازه صحیح تغییر اندازه داده می‌شود. تصویر برش داده نمی‌شود، اما ممکن است شامل نوارهای سیاه باشد تا اندازه صحیح باشد.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به https://www.googleapis.com/youtube/v3 |
||
set |
POST /thumbnails/set |
یک ریزعکس سفارشی ویدیو را در YouTube بارگذاری می‌کند و آن را برای یک ویدیو تنظیم می‌کند. |
VideoAbuseReportReasons
منبع videoAbuseReportReason حاوی اطلاعاتی درباره دلیل پرچم‌گذاری ویدیو به‌دلیل داشتن محتوای توهین‌آمیز است. وقتی برنامه شما روش videos.reportAbuse را برای گزارش کردن ویدیو سوءاستفاده‌گر فراخوانی می‌کند، درخواست از اطلاعات منبع videoAbuseReportReason برای شناسایی دلیل گزارش شدن ویدیو استفاده می‌کند.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها آن را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
نشانی‌های وب نسبی به https://www.googleapis.com/youtube/v3 |
||
list |
GET /videoAbuseReportReasons |
فهرستی از دلایلی را که می‌توان برای گزارش ویدیوهای سوءاستفاده‌گرانه استفاده کرد، بازیابی کنید. |
VideoCategories
منبع videoCategory دسته‌ای را شناسایی می‌کند که با ویدیوهای بارگذاری‌شده مرتبط شده است یا می‌تواند مرتبط شود.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
list |
GET /videoCategories |
فهرستی از دسته‌هایی را که می‌توانند با ویدیوهای YouTube مرتبط شوند برمی‌گرداند. |
ویدیوها
منبع video نشان‌دهنده ویدیو YouTube است.
برای کسب اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست دارایی‌ها آن را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به 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 |
گزارش کردن ویدیو به‌دلیل داشتن محتوای توهین‌آمیز. |
ته‌نقش‌ها
منبع watermark تصویری را که درطول بازپخش ویدیوهای یک کانال مشخص نمایش داده می‌شود شناسایی می‌کند. همچنین می‌توانید یک کانال هدف را مشخص کنید که تصویر به آن پیوند داده شود، و جزئیات زمان‌بندی که تعیین می‌کند ته‌نقش در طول بازپخش ویدیو چه زمانی ظاهر شود و چه مدت قابل مشاهده باشد.
برای اطلاعات بیشتر درباره این منبع، نمایش منبع و فهرست مشخصه‌ها را ببینید.
| روش | درخواست HTTP | شرح |
|---|---|---|
شناسه‌های منبع یکسان مربوط به https://www.googleapis.com/youtube/v3 |
||
set |
POST /watermarks/set |
تصویر ته‌نقشی را در YouTube بارگذاری می‌کند و آن را برای کانال تنظیم می‌کند. |
unset |
POST /watermarks/unset |
تصویر ته‌نقش کانال را حذف می‌کند. |