این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Thumbnails: set

یک تصویر کوچک ویدیوی سفارشی را در YouTube آپلود می کند و آن را برای یک ویدیو تنظیم می کند.

این روش از آپلود رسانه پشتیبانی می کند. فایل های آپلود شده باید با این محدودیت ها مطابقت داشته باشند:

حداکثر حجم فایل: 2 مگابایت
انواع MIME رسانه پذیرفته شده: image/jpeg ، image/png ، application/octet-stream

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای تقریباً 50 واحدی دارد.

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

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube.upload`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

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

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

بدنه درخواست حاوی تصویر کوچکی است که در حال آپلود آن هستید. بدنه درخواست حاوی منبع thumbnail نیست.

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

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:

خواص
`kind`	`string` نوع منبع API را مشخص می کند. مقدار `youtube#thumbnailSetResponse` خواهد بود.
`etag`	`etag` Etag این منبع
`items[]`	`list` لیستی از ریز عکسها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا	جزئیات خطا	شرح
`badRequest (400)`	`invalidImage`	محتوای تصویر ارائه شده نامعتبر است.
`badRequest (400)`	`mediaBodyRequired`	درخواست شامل محتوای تصویر نمی شود.
`forbidden (403)`	`forbidden`	تصویر کوچک را نمی توان برای ویدیوی مشخص شده تنظیم کرد. ممکن است درخواست به درستی مجاز نباشد.
`forbidden (403)`	`forbidden`	کاربر احراز هویت شده مجوز آپلود و تنظیم تصاویر کوچک ویدیوی سفارشی را ندارد.
`notFound (404)`	`videoNotFound`	ویدیویی که می‌خواهید یک تصویر کوچک برای آن درج کنید پیدا نمی‌شود. مقدار پارامتر `videoId` درخواست را بررسی کنید تا مطمئن شوید که درست است.
`tooManyRequests (429)`	`uploadRateLimitExceeded`	این کانال اخیراً تصاویر کوچک زیادی را بارگذاری کرده است. لطفاً بعداً دوباره درخواست را امتحان کنید.

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