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