Videos: update

API теперь поддерживает возможность пометить ваш канал или видео как предназначенные для детей. Кроме того, channel и video теперь содержат свойство, которое определяет статус канала или видео «сделано для детей». Условия использования API-сервисов YouTube и Правила для разработчиков также были обновлены 10 января 2020 года. Для получения дополнительной информации см. историю изменений Сервиса 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 , которые можно включить в значение параметра:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

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