Thumbnails: set

Загружает на YouTube собственный значок видео и устанавливает его для видео.

Этот метод поддерживает загрузку медиафайлов. Загружаемые файлы должны соответствовать следующим требованиям:

  • Максимальный размер файла: 50 МБ.
  • Допустимые MIME-типы медиаконтента: image/jpeg, image/png, application/octet-stream.

Влияние на квоту. Вызов этого метода сокращает квоту примерно на 50 единиц.

Примеры использования

Запрос

HTTP-запрос

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, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров 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 и ответ.