Videos: update

Теперь в API можно отмечать каналы и видео как предназначенные для детей. Кроме того, ресурсы channel и video теперь содержат свойство, которое определяет статус канала или видео ("предназначено для детей"). Условия использования сервисов YouTube API и правила для разработчиков также были обновлены 10 января 2020 года. Подробнее об этом можно узнать из истории изменений YouTube Data API Service и Условий использования сервисов YouTube API.

Обновляет метаданные видео.

Влияние на квоту. Вызов этого метода имеет стоимость квоты в 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, которые можно включить в значение параметра:
  • brandPartner
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube.

Параметр onBehalfOfContentOwner указывает, что учетные данные, которые используются для авторизации запроса, идентифицируют пользователя системы управления контентом YouTube, действующего от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которым принадлежит множество каналов. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.

Тело запроса

В теле запроса укажите ресурс video. Для этого ресурса:

  • Для следующих свойств необходимо указать значение:

    • 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. Это свойство можно задать, только если видео имеет статус доступа private и никогда не публиковалось.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Если вы отправляете запрос на обновление и в нем не указано значение для свойства, у которого оно уже есть, существующее значение будет удалено.

Ответ

В случае успеха этот метод возвращает в теле ответа ресурс video.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые 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 и ответ.