Videos: update

API теперь поддерживает возможность пометить ваш канал или видео как «предназначенные для детей». Кроме того, ресурсы 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 , которые можно включить в значение параметра:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Дополнительные параметры
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.