Загружает пользовательскую миниатюру видео на 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.