channel
и video
теперь также содержат свойство, определяющее статус «сделано для детей» для этого канала или видео. 10 января 2020 г. также были обновлены Условия обслуживания API-сервисов YouTube и Политика для разработчиков. Дополнительную информацию см. в истории изменений для Сервиса API данных YouTube и Условиях обслуживания API-сервисов YouTube .Обновляет метаданные видео.
Влияние квоты: вызов этого метода имеет стоимость квоты 50 единиц.
Общие варианты использования
Запрос
HTTP-запрос
PUT https://www.googleapis.com/youtube/v3/videos
Авторизация
Этот запрос требует авторизации по крайней мере в одной из следующих областей ( подробнее об аутентификации и авторизации ).
Объем |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Параметры
В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.
Параметры | ||
---|---|---|
Обязательные параметры | ||
part | string В этой операции параметр part служит двум целям. Он определяет свойства, которые будут установлены операцией записи, а также свойства, которые будут включены в ответ API.Обратите внимание, что этот метод переопределит существующие значения для всех изменяемых свойств, которые содержатся в любых частях, указанных в значении параметра. Например, настройка конфиденциальности видео содержится в части status . Таким образом, если ваш запрос обновляет частное видео, а значение параметра part запроса включает часть status , параметр конфиденциальности видео будет обновлен до любого значения, указанного в тексте запроса. Если в тексте запроса не указано значение, существующая настройка конфиденциальности будет удалена, а видео вернется к настройке конфиденциальности по умолчанию.Кроме того, не все части содержат свойства, которые можно задать при вставке или обновлении видео. Например, объект statistics инкапсулирует статистику, которую YouTube рассчитывает для видео, и не содержит значений, которые вы можете установить или изменить. Если в значении параметра указана part , которая не содержит изменяемых значений, эта part все равно будет включена в ответ API.Следующий список содержит имена part , которые можно включить в значение параметра:
| |
Дополнительные параметры | ||
onBehalfOfContentOwner | string Этот параметр можно использовать только в правильно авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя CMS YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют множеством различных каналов YouTube и управляют ими. Это позволяет владельцам контента пройти аутентификацию один раз и получить доступ ко всем своим видео и данным канала без необходимости предоставлять учетные данные для аутентификации для каждого отдельного канала. Фактическая учетная запись CMS, с которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube. |
Тело запроса
Предоставьте видеоресурс в теле запроса. Для этого ресурса:
Вы должны указать значение для этих свойств:
-
id
-
snippet.title
— это свойство требуется только в том случае, если запрос обновляетsnippet
video
. -
snippet.categoryId
— это свойство требуется только в том случае, если запрос обновляетsnippet
video
.
-
Вы можете установить значения для этих свойств:
-
snippet.categoryId
-
snippet.defaultLanguage
-
snippet.description
-
snippet.tags[]
-
snippet.title
-
status.embeddable
-
status.license
-
status.privacyStatus
-
status.publicStatsViewable
-
status.publishAt
— если вы установите значение для этого свойства, вы также должны установить для свойстваstatus.privacyStatus
значениеprivate
. -
status.selfDeclaredMadeForKids
-
recordingDetails.locationDescription
( устарело ) -
recordingDetails.location.latitude
( устарело ) -
recordingDetails.location.longitude
( устарело ) -
recordingDetails.recordingDate
-
localizations.(key)
-
localizations.(key).title
-
localizations.(key).description
Если вы отправляете запрос на обновление и в нем не указано значение свойства, которое уже имеет значение, существующее значение свойства будет удалено.
-
Ответ
В случае успеха этот метод возвращает видеоресурс в теле ответа.
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .
Тип ошибки | Сведения об ошибке | Описание |
---|---|---|
badRequest (400) | defaultLanguageNotSet | Запрос API пытается добавить локализованные сведения о видео без указания языка сведений о видео по умолчанию. |
badRequest (400) | invalidCategoryId | Свойство snippet.categoryId указывает недопустимый идентификатор категории. Используйте метод videoCategories.list для получения поддерживаемых категорий. |
badRequest (400) | invalidDefaultBroadcastPrivacySetting | Запрос пытается установить недопустимый параметр конфиденциальности для широковещательной рассылки по умолчанию. |
badRequest (400) | invalidDescription | В метаданных запроса указано недопустимое описание видео. |
badRequest (400) | invalidPublishAt | В метаданных запроса указано недопустимое запланированное время публикации. |
badRequest (400) | invalidRecordingDetails | Объект recordingDetails в метаданных запроса указывает недопустимые сведения о записи. |
badRequest (400) | invalidTags | В метаданных запроса указаны недопустимые ключевые слова для видео. |
badRequest (400) | invalidTitle | В метаданных запроса указан недопустимый или пустой заголовок видео. |
badRequest (400) | invalidVideoMetadata | Метаданные запроса недействительны. |
forbidden (403) | forbidden | |
forbidden (403) | forbiddenEmbedSetting | Запрос пытается установить недопустимую настройку встраивания для видео. Обратите внимание, что некоторые каналы могут не иметь разрешения предлагать встроенные проигрыватели для прямых трансляций. Дополнительную информацию см. в Справочном центре YouTube . |
forbidden (403) | forbiddenLicenseSetting | Запрос пытается установить недействительную лицензию для видео. |
forbidden (403) | forbiddenPrivacySetting | Запрос пытается установить недопустимый параметр конфиденциальности для видео. |
notFound (404) | videoNotFound | Видео, которое вы пытаетесь обновить, не найдено. Проверьте значение поля id в тексте запроса, чтобы убедиться, что оно правильное. |
Попробуй это!
Используйте APIs Explorer , чтобы вызвать этот API и просмотреть запрос и ответ API.