Thumbnails: set

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

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

  • Максимальный размер файла: 2 МБ.
  • Допустимые типы 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 CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Фактическая учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube.

Тело запроса

Тело запроса содержит миниатюру загружаемого вами изображения. Тело запроса не содержит thumbnail ресурса.

Ответ

В случае успеха этот метод возвращает тело ответа следующей структуры:

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

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе:

Характеристики
kind string
Идентифицирует тип ресурса API. Значением будет youtube#thumbnailSetResponse .
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.