API Content ID YouTube – история изменений

Примечание. API Content ID YouTube предназначен для использования контент-партнерами YouTube и доступен не всем разработчикам и не всем пользователям YouTube. Если вы не видите API Content ID YouTube в качестве одной из служб, перечисленных в консоли API Google , посетите Справочный центр YouTube , чтобы узнать больше о Партнерской программе YouTube.

На этой странице перечислены изменения API Content ID YouTube и обновления документации.

10 ноября 2023 г.

Поле adFormats[] ресурса videoAdvertisingOption было обновлено, и теперь third_party_ads является единственным допустимым значением для этого поля. Следующие форматы объявлений больше не поддерживаются: instream_trueview , instream_standard , display , preroll , postroll . Более подробную информацию можно найти в статье поддержки .

1 июня 2023 г.

Примечание. Это объявление об устаревании.

Это обновление включает в себя следующие изменения:

• Обновления существующих ресурсов и методов

  • Поле breakPosition[] ресурса videoAdvertisingOption помечено как устаревшее и будет удалено в 2024 году.
    Методы videoAdvertisingOptions.update и videoAdvertisingOptions.patch уже игнорируют это поле.
  • Устаревшее поле adBreaks[].slot[] ресурса videoAdvertisingOption было удалено.
  • Устаревшие поля category и showCustomId ресурса asset были удалены.
  • Поле timeStatusLastModified нового ресурса claim сообщает время последнего изменения утверждения.
  • Параметр isVideoShortsEligible нового метода claimSearch.list можно использовать для фильтрации видео, на которые заявлены права, по их критериям для YouTube Shorts .

• Новые ресурсы и методы

  • API теперь поддерживает список ресурсов YouTube Music :
    • Ресурсы musicRelease можно перечислить с помощью метода musicReleases.list .
    • Ресурсы musicTrack можно перечислить с помощью метода musicTracks.list .
    • Ресурсы musicChangeRequest можно перечислить с помощью метода musicChangeRequests.list .

20 декабря 2022 г.

Определение параметра запроса ownershipRestriction метода assetSearch.list было обновлено, чтобы уточнить, что если значение этого параметра равно none , значение параметра metadataSearchFields также должно использовать хотя бы один фильтр идентификатора. Это изменение документации не отражает изменение поведения API.

9 ноября 2022 г.

Документация по методам asset.get и asset.list была обновлена, чтобы уточнить, как поддерживаются несколько значений:

• fetchMatchPolicy ( получить , список )
• fetchMetadata ( получить , список )
• fetchOwnership ( получить , список )

28 сентября 2022 г.

Информация о лицензии была добавлена ​​в asset resource .

18 июля 2022 г.

Документация по inactiveReasons claimSearch.list была обновлена, чтобы отразить улучшения, обеспечивающие согласованность с YouTube Studio:

• Ранее Studio удалила поддержку Audio Swap и Song Erase . Соответствующие значения API, audio_removed и song_erased , были молча проигнорированы и теперь недокументированы.
• channel_whitelisted заменен на channel_allowlisted . Предыдущее значение больше не документировано, но все еще поддерживается.
• Теперь поддерживаются значения closed_disabled_monetization , closed_manually , closed_no_adsense , closed_own_video_match , reference_removed , replaced и video_modified .

14 июня 2022 г.

Документация по ресурсам assetSearch была обновлена ​​и теперь отражает два новых свойства: isrcs[] и iswcs[] . Каждое из новых значений свойств isrcs[] и iswcs[] содержит массив строковых значений, каждое из которых указывает ISRC или ISWC, в зависимости от обстоятельств, которые сопоставляются с активом, идентифицированным в результате поиска.

Рекомендуется использовать новые свойства вместо свойств isrc и iswc , уже включенных в ресурсы assetSearch , поскольку новые свойства предоставляют более точные данные. В то время как новые свойства потенциально содержат массив строковых значений, каждое из свойств isrc и iswc идентифицирует только один код ISRC или ISWC, связанный с результатом поиска.

12 мая 2022 г.

Ссылки на клиентские библиотеки были обновлены и теперь указывают на стандартные клиентские библиотеки API Google. Обновлены предварительно созданные привязки для PHP.

3 мая 2022 г.

Параметр status claimSearch.list теперь поддерживает больше фильтров на основе потенциальных сведений о заявке.

2 мая 2022 г.

Документация для Response метода assetSearch.list была обновлена, чтобы отразить улучшения для обеспечения совместимости с AIP-158 :

• В описании pageInfo.totalResults явно упоминается, что значение является приблизительным, а не фактическим.
• Поля pageInfo.resultsPerPage и pageInfo.startIndex были удалены.

25 апреля 2022 г.

Документация по ресурсу assetLabels.list была обновлена, чтобы прояснить значение параметров запроса labelPrefix и q , а также задокументировать, что запрос/ответ поддерживает разбиение на страницы.

8 декабря 2021 г.

Документация по claimSearch.list была обновлена, чтобы правильно отразить два варианта использования, которые охватывает этот метод:

• Поиск по идентификатору (объект, ссылка или видео) или строке запроса.
• Поиск по дате создания заявки, дате изменения или статусу

Каждый вариант использования поддерживает свой набор параметров запроса. Документация claimSearch.list была обновлена, чтобы объяснить, какие параметры поддерживаются для каждого варианта использования.

17 ноября 2021 г.

Это обновление включает в себя следующие изменения:

• Метод claims.update теперь поддерживает возможность обновления статуса неактивной или потенциальной заявки на active . Определение свойства status ресурса claim предоставляет более подробную информацию.
• Документация по claim и ресурсам claimSearch была обновлена, чтобы отразить добавление нового объекта studioInfo , который содержит ссылки на страницы Студии YouTube, связанные с заявкой.
• Список значений, поддерживаемых для параметра origin claimSearch.list , изменился. Параметр теперь поддерживает четыре дополнительных значения: batchTool , inProductShorts , melodyMatch и youTubeAdmin . Кроме того, значения dropboxUpload и webUpload больше не поддерживаются.

26 февраля 2021 г.

Документация по параметру videoId claimSearch.list была обновлена ​​и отмечено, что значение параметра теперь принимает максимум 10 идентификаторов видео, разделенных запятыми. API вернет ошибку badRequest — код ответа HTTP 400 — если значение содержит более 10 идентификаторов видео.

6 декабря 2018 г.

Примечание. Это объявление об устаревании.

Документация API была обновлена: удалены ссылки на ресурс contentOwnerAdvertisingOptions и его методы. Эти методы использовались минимально, и до этого объявления с пользователями API, которые их использовали, связались отдельно.

21 марта 2018 г.

Это обновление содержит следующие изменения:

• Свойство metadataMine.artist теперь необходимо задавать каждый раз, когда вы вставляете , обновляете или исправляете ресурс музыкального видео или звукозаписи. API теперь возвращает ошибку, если свойство не установлено для этих типов ресурсов. Кроме того, обратите внимание, что свойство metadataMine.artist поддерживается только для исполнителей музыкальных видео и звукозаписи.

24 июля 2017 г.

Это обновление содержит следующие изменения:

• Новый ресурс package представляет собой группу файлов, доставленных через Интернет, SFTP или другой механизм доставки. API поддерживает два метода для этого ресурса:

  • Метод package.insert проверяет и загружает пакет только с метаданными, содержащий ровно один файл метаданных.
  • Метод package.get получает информацию о ранее загруженном пакете.

• Для метода validator.validate определение свойства uploaderName было обновлено, чтобы отметить, что значение идентифицирует не партнера по контенту, загружающего данные, а скорее значение, такое как web-google или yt-google , которое идентифицирует конкретную учетную запись загрузчика, которую использует владелец контента.

• Свойство status reference ресурса больше не использует значение duplicate_on_hold , чтобы указать, что ссылка является дубликатом другой ссылки. Вместо этого, если ссылка является дубликатом, значение свойства status теперь устанавливается в inactive , а значение свойства statusReason — REASON_DUPLICATE_FOR_OWNERS .

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

17 апреля 2017 г.

Это обновление содержит следующие изменения:

• Новый ресурс assetShare , который имеет отношение только к составным активам, определяет связь между двумя представлениями ресурса актива. Эти представления отражают новую модель издательских данных , предназначенную для обеспечения большей прозрачности и контроля над тем, как ваши права связаны с активами звукозаписей.

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

  Кроме того, каждый владелец композиции имеет свой собственный долевой актив. Доля композиции представляет собой информацию, которую конкретный издатель предоставил для композиционного актива. Доля композиции может быть связана со многими звукозаписями.

  Ресурс assetShare определяет связь между представлением композиции и общим ресурсом композиции. Новый метод assetShares.list позволяет вам выполнить одно из следующих действий:

  • Укажите идентификатор представления композиции и получите соответствующую долю композиции, принадлежащую партнеру, авторизующему запрос, если такая доля существует.
  • Укажите идентификатор общего ресурса композиции, принадлежащего партнеру по контенту, и получите список всех представлений композиции, с которыми связан этот общий ресурс.

• В новом руководстве «Управление составными активами» объясняется, как различные методы API обрабатывают запросы в зависимости от того, идентифицируют ли идентификаторы активов, отправленные в эти методы, представления композиции или общие ресурсы композиции.

• Новое свойство claimedVideoOptions.autoGeneratedBreaks ресурса contentOwnerAdvertisingOptions указывает, должен ли YouTube автоматически создавать рекламные паузы в заявленных видеороликах продолжительностью более 10 минут. Хотя это свойство влияет на все видео владельца контента длительностью более 10 минут, если на видео имеется несколько заявок, первый партнер, заявивший права на видео, устанавливает поведение по умолчанию для этого свойства по отношению к этому видео.

11 августа 2016 г.

Это обновление содержит следующие изменения:

• Недавно опубликованные Условия использования API-сервисов YouTube («Обновленные условия»), подробно обсуждаемые в блоге разработчиков и разработчиков YouTube , содержат богатый набор обновлений текущих Условий обслуживания. Помимо обновленных условий , которые вступят в силу 10 февраля 2017 г., это обновление включает в себя несколько подтверждающих документов, которые помогут объяснить политики, которым должны следовать разработчики.

  Полный набор новых документов описан в истории изменений Обновленных условий . Кроме того, будущие изменения в Обновленных условиях или в подтверждающих документах также будут объяснены в этой истории изменений. Вы можете подписаться на RSS-канал со списком изменений в этой истории изменений по ссылке в этом документе.

31 мая 2016 г.

Это обновление содержит следующие изменения:

• Новые ресурсы и методы

  • Новый метод validator.validate позволяет определить, содержит ли файл метаданных ошибки проверки, которые не позволяют YouTube успешно его обработать. Если файл содержит ошибки, свойство errors ответа API содержит список ошибок проверки с указанием серьезности, причины и местоположения каждой ошибки.

• Новые и обновленные ошибки

  • Методы assets.patch и assets.update теперь поддерживают следующую ошибку. Напоминаем, что метод может поддерживать несколько ошибок одного и того же типа. Полный список возможных ошибок см. в документации по ошибкам для каждого метода или на странице ошибок .

    Ошибки
    invalidValue (400)	parameters.assetId Запрос не выполнен, поскольку обновляемый ресурс был объединен с другим ресурсом. Повторно отправьте запрос, используя идентификатор этого актива, который возвращается в сообщении об ошибке, в качестве значения параметра assetId .

28 марта 2016 г.

Это обновление содержит следующие изменения:

• Обновления существующих ресурсов и методов

  • Новое свойство matchInfo.matchSegments[] ресурса claim содержит список, в котором каждый элемент описывает сегмент заявленного видео, который соответствует части эталонного видео. Утверждение может иметь несколько сегментов соответствия. Например, если аудио- и видеоконтент загруженного видео совпадает с содержимым эталонного видео, будет два сегмента соответствия. Один сегмент будет описывать совпадение аудио, а другой — совпадение видео.

    Для каждого сегмента соответствия API возвращает продолжительность и тип (аудио или видео) соответствующего контента. API также определяет временные сдвиги, с которыми начинается и заканчивается каждый сегмент совпадения как в заявленном видео, так и в эталонном видео.

  • Заданное значение свойства contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[] ресурса contentOwnerAdvertisingOptions теперь можно обновить при вызове методов contentOwnerAdvertisingOptions.patch или contentOwnerAdvertisingOptions.update .

  • Свойство allowedOptions.autoGeneratedBreaks ресурса contentOwnerAdvertisingOptions , доступное только для чтения, устарело.

• Новые и обновленные ошибки

  • Метод claims.update API теперь поддерживает следующую ошибку. Напоминаем, что метод может поддерживать несколько ошибок одного и того же типа. Полный список возможных ошибок см. в документации по ошибкам для каждого метода или на странице ошибок .

    Ошибки
    badRequest (400)	alreadyClaimed Заявка является дубликатом другой существующей заявки и не может быть обновлена.

  • Метод assets.list время от времени истекает и возвращает код ответа HTTP 500 ( Internal Server Error ), особенно когда запрос извлекает данные для многих активов и значение параметра fetchMatchPolicy является effective . Если в вашем запросе assets.list указано несколько идентификаторов активов и возвращается ошибка 500 , попробуйте повторно отправить запрос для одного актива или меньшего количества активов.

  • Документация по ошибкам references.insert была обновлена, и в ней указано, что если запрос загружает поврежденный справочный файл, эта проблема не выявляется до тех пор, пока не будет обработана сама ссылка. Таким образом, даже если запрос references.insert возвращает успешный ответ, ссылка может быть не обработана успешно. Мы рекомендуем после вставки ссылки выполнить опрос с помощью метода references.list , чтобы убедиться, что ссылка активирована должным образом.

3 февраля 2016 г.

Это обновление содержит следующие изменения:

• Обновления существующих ресурсов и методов

  • API теперь поддерживает товарные объявления. В товарных объявлениях выделяются продукты, которые связаны с содержанием видео или представлены в нем. Эти рекламные объявления представляют собой спонсируемые карточки , которые отображаются во время видео. Карты добавляются автоматически рекламной системой. Зрители видят тизер карточки в течение нескольких секунд, а также могут щелкнуть значок в правом верхнем углу видео, чтобы просмотреть карточки видео.

    В результате этого изменения product_listing теперь может быть включен в значения следующих свойств:

    Ресурс/метод API	Свойство
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • Новые методы createdBefore и createdAfter метода assetSearch.list предписывают API возвращать только активы, созданные до и/или после определенной даты.

  • В ответе API на запрос assetSearch.list свойство type теперь поддерживает значение art_track_video . Справочный центр YouTube предоставляет дополнительную информацию о видео с обложкой альбома.

  • claimSearch.list поддерживает следующие новые параметры:

    Параметры
    referenceId	Этот параметр фильтра указывает идентификатор ссылки YouTube, по которой вы получаете заявки.
    inactiveReasons	Этот необязательный параметр позволяет ограничить ответ API, включив в него только неактивные утверждения на основании указанных причин, по которым утверждения стали неактивными. В определении параметра перечислены типы неактивных заявок, по которым можно выполнять поиск.
    partnerUploaded	Этот необязательный логический параметр позволяет указать, что ответ API должен включать только утверждения, загруженные партнером или не загруженные партнером.

  • Новый объект references#origination reference ресурса содержит информацию, описывающую источник ссылки.

  • Метод references.insert теперь поддерживает возможность загрузки ссылок, созданных с помощью программного обеспечения YouTube gfp_gen. Если вы предоставляете предварительно созданный отпечаток пальца, установите для свойства fpDirect значение true в загруженном reference ресурсе.

    Обратите внимание, что благодаря этому изменению API больше не возвращает ошибку, если вы попытаетесь установить свойство fpDirect при загрузке ссылки.

• Новые и обновленные ошибки

  В документации теперь перечислены ошибки, возвращаемые методами ресурса whitelist .

  Кроме того, в следующей таблице указаны новые ошибки, которые поддерживает API, и методы, которые могут возвращать каждую ошибку. Обратите внимание, что метод может возвращать несколько ошибок одного и того же типа. Дополнительную информацию см. в документации по ошибкам для каждого метода или на странице ошибок .

  Ошибки
  badRequest (400)	inappropriateCampaignTarget Методы campaigns.insert и campaigns.update возвращают эту ошибку, если кампания пытается показать видео, которое может быть неприемлемым для некоторых пользователей. Чтобы устранить эту ошибку, выберите другой контент для размещения.
  badRequest (400)	canNotCreatePartnerUploadedClaim OnCompositionOrSoundRecordingAssets claims.insert возвращает эту ошибку, если вы пытаетесь создать загруженную партнером заявку с активом композиции или звукозаписи.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim claims.insert возвращает эту ошибку, если заявка на музыкальную запись, записанную в указанном видео, уже существует. Заявления о прямой композиции нельзя добавлять через API.
  badRequest (400)	asset_id Метод references.insert возвращает эту ошибку, если запрос попытался создать ссылку через файл, но в запросе не указан идентификатор актива.
  badRequest (400)	canNotBeActivated Метод references.update возвращает эту ошибку, если ссылку невозможно активировать, возможно, из-за статуса ссылки или условий владения.
  badRequest (400)	videoNotClaimed Метод videoAdvertisingOptions.get возвращает эту ошибку, если вы не заявили права на видео, для которого пытаетесь получить параметры рекламы, в результате чего запрошенная информация становится для вас недоступной.

18 декабря 2015 г.

Законы Европейского Союза (ЕС) требуют предоставления определенной информации и получения согласия от конечных пользователей в ЕС. Таким образом, конечные пользователи в Европейском Союзе должны соблюдать Политику согласия пользователей ЕС . Мы добавили уведомление об этом требовании в Условия использования API YouTube .

21 апреля 2015 г.

Это обновление содержит следующие изменения:

• Новый ресурс campaign представляет собой конкретную кампанию владельца контента , которая позволяет владельцу контента использовать аннотации для продвижения контента в видео, на которые заявлены права и загружены пользователями. Например, владелец контента может создать кампанию, которая будет добавлять ссылки на страницу просмотра фильма для любых заявленных пользователем видеороликов, содержащих сцены из этого фильма.

  API поддерживает методы для get , list , insert , update , patch и delete ресурсов campaign .

• API поддерживает несколько новых ошибок для новых методов campaigns.get , campaigns.insert , campaigns.update и campaigns.delete .

30 марта 2015 г.

Это обновление содержит следующие изменения:

• Обновления существующих ресурсов и методов

  • Новый параметр isrcs метода assetSearch.list позволяет указать список до 50 ISRC. Ответ API будет включать активы, связанные с этими ISRC.

  • Свойство event[].reason ресурса claimHistory поддерживает следующие новые значения. Каждая причина объясняет, почему произошло конкретное событие, связанное с претензией:

    • закрытое_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • закрытый_reference_conflict

  • Новый параметр sort claimSearch.list указывает метод, который будет использоваться для упорядочивания ресурсов в ответе API. По умолчанию ресурсы сортируются в обратном хронологическом порядке (от самых новых к самым старым) по датам их создания. Вы также можете сортировать ресурсы по количеству просмотров заявленного контента от наибольшего к наименьшему.

    Обратите внимание, что если claimSearch.list также устанавливает значение параметра status в значение appealed , disputed , pending , potential или routedForReview ,то результаты сортируются по времени истечения периода рассмотрения претензии.

  • Методы ownership.update и ownership.patch теперь правильно перечисляют все свойства, которые можно обновить при вызове этих методов. Это изменение представляет собой исправление документации API и не указывает на изменение функциональности API.

  • Параметры fetchMatchPolicy для методов assets.get и assets.list теперь effective как поддерживаемые значения. Это значение указывает серверу API получить политику соответствия, которую YouTube применяет к ресурсу.

  • Параметры id для методов assets.list , claims.list , contentOwners.list , policies.list , publishers.list и references.list теперь отмечают, что их значения параметров могут содержать максимум 50 идентификаторов, разделенных запятыми.

• Новые и обновленные ошибки

  В таблице ниже указаны новые ошибки, которые поддерживает API, и методы, которые могут возвращать каждую ошибку. Обратите внимание, что метод может возвращать несколько ошибок одного и того же типа.

  Дополнительную информацию см. в документации по ошибкам для каждого метода или на странице ошибок .

  Тип ошибки	Детализация ошибки	Описание
  badRequest (400)	tooManyIsrcs	Метод assetSearch.list возвращает эту ошибку, если параметр isrcs указывает более 50 ISRC.
  badRequest (400)	videoIsPrivate	claims.insert возвращает эту ошибку, если вы пытаетесь заявить права на частное видео. Вы можете заявить права на видео только в том случае, если его статус конфиденциальности является public или unlisted .
  notModified (304)	blockOutsideOwnershipUnchanged	claims.update возвращает эту ошибку, если флаг blockOutsideOwnership в утверждении не был успешно изменен. Существует несколько причин, по которым может возникнуть эта ошибка. Типичный пример: указанная модификация не влияет на заявленное видео.

7 ноября 2014 г.

Это обновление содержит следующие изменения:

• Обновления существующих ресурсов и методов

  • Параметр status claimSearch.list теперь поддерживает значение routedForReview . Это значение ограничивает результаты только заявками, которые требуют проверки вручную на основе правила в политике сопоставления объекта.

  • Свойство event[].reason ресурса claimHistory поддерживает следующие новые значения. Каждая причина объясняет, почему произошло конкретное событие, связанное с претензией:

    • закрытый_invalid_reference_segment
    • закрытый_noadsense
    • приостановленная_монетизация_на_канале
    • video_content_modified

  • Свойство origin.source ресурса claim , которое идентифицирует источник утверждения, теперь поддерживает значение melodyMatch . Заявка на совпадение мелодии указывает на то, что в заявленном видео используется музыкальная композиция со ссылкой.

  • Документация метода references.insert была обновлена, чтобы правильно отразить, что API использует две разные конечные точки для этого метода. Это не изменение функциональности API, а скорее исправление существующей документации.

    • Если запрос загружает новый справочный файл, правильная конечная точка:

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • Если запрос создает ссылку с использованием видео, на которое заявлены права, в качестве эталонного контента, правильная конечная точка:

      POST https://www.googleapis.com/youtube/partner/v1/references

• Новые и обновленные ошибки

  В таблице ниже указаны новые ошибки, которые поддерживает API, и методы, которые могут возвращать каждую ошибку. Обратите внимание, что метод может возвращать несколько ошибок одного и того же типа.

  Дополнительную информацию см. в документации по ошибкам для каждого метода или на странице ошибок .

  Тип ошибки	Детализация ошибки	Описание
  badRequest (400)	invalidLabelName	Методы assets.insert , assets.update и assetLabels.insert возвращают эту ошибку, если имя метки актива недопустимо. Имена меток должны содержать от двух до 30 символов. Они не могут содержать угловые скобки, запятые, двоеточия, амперсанды или вертикальную трубку (|).
  badRequest (400)	ownerHaveMaximumNumberOfLabels	Методы assets.insert , assets.update и assetLabels.insert возвращают эту ошибку, если владелец контента уже определил 2500 уникальных меток ресурсов, что является максимально допустимым в настоящее время числом.
  badRequest (400)	tooManyLabelsOnOneAsset	Методы assets.insert и assets.update возвращают эту ошибку, если актив уже связан с 30 метками активов, что является максимально допустимым в настоящее время числом.
  badRequest (400)	channelMonetizationSuspended	Методы claims.insert и claims.update возвращают эту ошибку, если канал видео заблокирован из-за претензий партнеров.
  badRequest (400)	channelNotActive	Метод claims.update возвращает эту ошибку, если канал видео не активен.

• Методы assets.insert и assets.update больше не возвращают ошибку badRequest для некоторых ресурсов, если ресурс в теле запроса не содержит свойства metadataMine.contentType .

23 сентября 2014 г.

Это обновление содержит следующие изменения:

• Изменение идентификатора владельца контента

  Изменения идентификатора владельца контента, объявленные в истории изменений 9 июля 2014 г., вступили в силу. В результате этого изменения API теперь возвращает сгенерированный уникальный идентификатор для идентификации владельца контента, связанного либо с прошедшим проверку пользователем, либо с ресурсом, управляемым через API. Раньше API возвращал в качестве идентификатора удобочитаемое имя, например «qrs_network».

  Это изменение влияет на следующие функции API и, скорее всего, повлияет на партнеров, которые имеют жестко запрограммированные партнерские коды в своих приложениях.

  • API теперь возвращает новый идентификатор в качестве значения свойств ресурса, которые ранее возвращали код партнера, например свойства id ресурса contentOwner .
  • Все методы API поддерживают параметр onBehalfOfContentOwner , который идентифицирует владельца контента, от имени которого выполняется запрос API. После изменения в параметре должен быть установлен новый идентификатор вместо кода партнера. Во избежание нарушений кода параметр будет принимать любое значение в течение переходного периода.
  • После изменения параметр contentOwnerId метода contentOwners.list должен указывать новый идентификатор вместо кода партнера.

• Обновления существующих ресурсов и методов

  • Новый параметр metadataSearchFields метода assetSearch.list позволяет указать поля метаданных актива, в которых вы хотите выполнять поиск, а также значения, которые вы хотите искать в этих полях. Значение параметра представляет собой список пар полей и значений, разделенных запятыми; внутри пары поле и значение разделяются двоеточием.

  • Новый объект appliedPolicy ресурса claim указывает политику, которую YouTube фактически применяет к утверждению. Значение объекта является ресурсом policy . Этот ресурс содержит информацию о политике для стран, в которых владелец контента, отправивший запрос, владеет заявленным активом.

    Применяемая политика может отличаться от политики, определенной владельцем контента, двумя способами:

    1. Он учитывает политики, установленные другими владельцами, которые частично владеют заявленным активом на некоторых из тех же территорий, что и владелец контента, отправивший запрос API.

    2. Он учитывает административную политику YouTube, которая применяется на территориях, где владелец контента владеет заявленным ресурсом.

  • Новое свойство uploaderChannelId ресурса claimHistory идентифицирует идентификатор канала, на который было загружено видео, на которое заявлены права.

8 сентября 2014 г.

Это обновление содержит следующие изменения:

• Новые ресурсы и методы

  • Новый ресурс assetLabel идентифицирует текстовую метку, которую можно назначить активу. Метки активов позволяют размещать ресурсы в настраиваемых категориях, что упрощает организацию библиотеки активов. Вы можете искать активы по их меткам, что также может упростить сценарии использования, требующие обновления определенных групп активов.

    • Метод assetLabels.list позволяет получить список меток владельца контента.
    • Метод assetLabels.insert позволяет создать новую метку актива. Вы также можете создавать новые метки, вызвав метод assets.update и обновив метки для актива. Сервер API автоматически создаст новый ресурс assetLabel для любой ранее неопределенной метки.

• Обновления существующих ресурсов и методов

  • Свойство label[] asset было обновлено, чтобы отметить, что вы можете вызвать метод assets.update для обновления меток актива. Однако вы не можете установить метки актива при вызове метода assets.insert .

    В новом руководстве «Использование меток активов» объясняется, как создавать и получать метки активов, а также как обновлять метки активов или выполнять поиск активов, связанных с определенными метками.

• Новые и обновленные ошибки

  API поддерживает несколько новых ошибок для новых методов assetLabels.list и assetLabels.insert .

9 июля 2014 г.

Это обновление содержит следующие изменения:

• Изменение идентификатора владельца контента

  Исторически API использовал удобочитаемый партнерский код, например «qrs_network», для уникальной идентификации владельца контента, связанного либо с прошедшим проверку пользователем, либо с ресурсом, управляемым через API. В третьем квартале 2014 года API перейдет на использование уникального 22-значного идентификатора для идентификации владельцев контента. Это изменение затрагивает следующие функции API и, скорее всего, повлияет на партнеров, которые имеют жестко закодированные партнерские коды в своих приложениях.

  • API вернет 22-значный идентификатор в качестве значения свойств ресурса, которые ранее возвращали код партнера, например свойства id ресурса contentOwner .
  • Все методы API поддерживают параметр onBehalfOfContentOwner , который идентифицирует владельца контента, от имени которого выполняется запрос API. После изменения в качестве параметра следует установить 22-значный идентификатор вместо кода партнера. Во избежание нарушений кода параметр будет принимать любое значение в течение переходного периода.
  • После изменения параметр contentOwnerId метода contentOwners.list должен указывать 22-значный идентификатор вместо кода партнера.

• Обновления существующих ресурсов и методов

  • Ресурс asset теперь поддерживает свойство label , которое определяет список меток актива, связанных с активом. Вы можете применить метку к нескольким ресурсам, чтобы сгруппировать их. Вы можете использовать ярлыки в качестве поисковых фильтров для массового обновления, загрузки отчетов или фильтрации YouTube Analytics.

  • Метод assetSearch.list теперь поддерживает следующие дополнительные параметры:

    • labels : результаты ограничиваются включением только ресурсов, связанных с указанными ярлыками. По умолчанию API возвращает ресурсы, соответствующие всем указанным меткам. Однако вы можете использовать параметр includeAnyProvidedLabel , чтобы указать API возвращать ресурсы, соответствующие любой из указанных меток.
    • includeAnyProvidedLabel : используемый вместе с параметром labels , этот параметр указывает API, возвращающим активы, которые связаны с любой из меток, указанных в значении параметра labels .

  • Ресурс claimHistory теперь содержит следующие новые свойства:

    • Свойство event[].source.userEmail предоставляет адрес электронной почты пользователя, инициировавшего событие.
    • Свойство event[].typeDetails.disputeNotes содержит примечания к спору для события dispute_create .

  • claimSearch.list теперь поддерживает следующие необязательные параметры:

    • createdAfter : ограничивает результаты включением только утверждений, созданных после указанной даты.
    • createdBefore : ограничивает результаты включением только утверждений, созданных до указанной даты.
    • includeThirdPartyClaims : используемый вместе с параметром videoId , этот параметр указывает, следует ли включать сторонние утверждения в результаты API.

• Более подробная информация об ошибке

  В документации по ошибкам теперь указан код ответа HTTP для каждого типа ошибки.

• Новые и обновленные ошибки

  В таблице ниже указаны новые ошибки, которые поддерживает API, и методы, которые могут возвращать каждую ошибку. Обратите внимание, что метод может возвращать несколько ошибок одного и того же типа. Например, при попытке вставить ресурс asset , в котором отсутствует обязательное поле метаданных, возвращается required ошибка. На самом деле может быть несколько обязательных полей метаданных, каждое из которых будет возвращать ошибку с немного отличающимся сообщением.

  Дополнительную информацию см. в документации по ошибкам для каждого метода или на странице ошибок .

  Метод	Ошибки
  assetSearch.list	invalidValue — API не поддерживает возможность поиска активов шоу или сезона. Измените значение параметра type на поддерживаемое значение.
  assets.insert	conflict - слишком много активов с тем же идентификатором (например, пользовательский идентификатор, ISRC и т. Д.) Уже существует. conflict - слишком много копий указанного актива уже существует. invalidValue - Пользователь, вызывающий API, не имеет разрешения на создание активов указанного типа.
  assets.patch assets.update	badRequest - API не поддерживает преобразование типа актива, которое вы пытались.
  claimSearch.list	badRequest - Параметр includeThirdPartyClaims может использоваться только в сочетании с videoId фильтром.
  ownership.patch ownership.update	badRequest - вы не можете обновить право собственности на активу Art Track.
  references.patch references.update	badRequest - ссылка находится в неверном состоянии для операции, которую вы пытаетесь.

3 февраля 2014 г.

Это обновление содержит следующие изменения:

• Обновления существующих ресурсов и методов

  • Ресурс asset теперь может иметь type значение art_track_video .

  • Ресурс claimSearch теперь включает в себя следующие новые свойства:

    • Объект origin содержит информацию, которая описывает способ создания претензии.
    • Свойство thirdPartyClaim содержит логическое значение, которое указывает, была ли претензия подана владельцем контента, отличным от того, что связано с пользователем, выполняющим поиск.

  • Метод claimSearch.list .

    • contentType : ограничивает результаты, включающие только только для аудио, претензии только на видео или претензии аудиовизуальных претензий.
    • origin : указывает одно или несколько претензий, таких как descriptiveSearch или videoMatch , для которого вы хотите найти претензии.
    • status : ограничивает результаты, включающие только претензии, которые имеют указанный статус.

  • Собственность status claim в настоящее время поддерживает следующие дополнительные значения: appealed , disputed , potential , takedown и unknown .

  • Новая собственность ресурса claim в blockOutsideOwnership показывает, следует ли заблокировать заявленное видео на территориях, где оно не принадлежат. По умолчанию заявленное видео по -прежнему будет просмотрено в странах, где данные о праве собственности не были определены для актива, связанного с претензией.

  • Новое разрешение Resource contentOwnerAdvertisingOption allowedOptions.autoGeneratedBreaks указывает, может ли партнер выбрать Midroll, рекламные объявления в потоке при автоматическом времени разрыва, автоматически определяемые YouTube.

  • Метод contentOwners.list теперь может быть вызван с помощью токена авторизации, который указывает https://www.googleapis.com/auth/youtubepartner-content-owner-readonly Scope.

  • Новая собственность policy ресурса timeUpdated указывает время, когда политика была в последний раз обновлена.

  • Метод policies.list теперь поддерживает необязательный параметр sort , который можно использовать для указания того, что результаты должны быть отсортированы в восходящем или нисходящем порядке времени, когда они были в последний раз обновляться.

  • Новое свойство expiryTime referenceConflict указывает время, когда период рассмотрения справочного конфликта закончится, что приведет к истечению конфликта.

  • Новое свойство autoGeneratedBreaks от videoAdvertisingOption показывает, должно ли видео показать Midroll, в одновременную рекламу в Time Times, автоматически определяемое YouTube.

• Новые и обновленные ошибки

  В таблице ниже определяются новые ошибки, которые поддерживает API, и методы, которые могут вернуть каждую ошибку. Обратите внимание, что метод может вернуть несколько ошибок, которые имеют одинаковый тип ошибки. Например, required ошибка возвращается, если вы пытаетесь вставить ресурс asset , в котором отсутствует необходимое поле метаданных. На самом деле, может быть более одного необходимого поля метаданных, каждое из которых вернет ошибку с немного другим сообщением.

  Пожалуйста, обратитесь к документации по ошибке для каждого метода или на странице ошибок для получения дополнительной информации.

  Метод	Ошибки
  assets.insert assets.update	badRequest - API не поддерживает операции записи на Art Track Assets.
  claimSearch.list	invalidValue - параметр pageToken в запросе определяет неверный токен страницы.
  claims.insert	badRequest - утверждение, которое вы пытаетесь создать, является недействительным, потому что канал видео не активен. badRequest - видео, которое вы пытаетесь утверждать, освобождается от политики снятия. Для запроса, пожалуйста, свяжитесь с [email protected] badRequest -ваш запрос не может быть обработан, потому что вы не можете создать сторонние претензии на указанном видео. conflict - YouTube не может создать запрошенную претензию, потому что видео противостояло уведомлению о ударе. conflict - YouTube не может создать запрошенную претензию, потому что видео имеет активное претензии.
  references.insert	badRequest - заявленное видео, которое вы пытаетесь использовать, было удалено или отклонено, или его обработка не удалась.

• Ошибки contentOwnerNotProvided и internalError , которые не являются специфическими для конкретного метода API, больше не перечислены на каждой странице метода. Их описания все еще можно найти в разделе общих ошибок в документации по ошибке API.

12 сентября 2013 г.

Это обновление содержит следующие изменения:

• Новые ресурсы и методы

  • Новый ресурс referenceConflict определяет конфликт между двумя эталонными файлами и перечисляет совпадения, которые существовали между этими файлами, когда конфликт был идентифицирован. Метод referenceConflicts.list позволяет вам получить список неразрешенных справочных конфликтов, связанных с авторизованным владельцем контента. Метод referenceConflicts.get позволяет получить справочный конфликт, указав его уникальный идентификатор справочного конфликта.

  Обновления существующих ресурсов и методов

  • API теперь поддерживает способность получить эффективную политику соответствия для актива. Это изменение параллельно изменению, опубликованных 16 июля 2013 года, которые включали поддержку для получения канонического набора метаданных и данных собственности для актива.

    Чтобы получить эффективную политику соответствия для актива, установите значение параметра fetchMatchPolicy для effective при вызове assets.get или assets.list Methods. В ответе API объект matchPolicyEffective в каждом возвращенном ресурсе asset содержит эффективную политику соответствия для этого актива.

  • Новый объект ownershipConflicts asset Resource содержит информацию о конфликтах собственности актива. Структура объекта аналогична структуре ресурса ownership , который определяет каждый тип прав, которые может иметь владелец актива. (Для большинства типов активов владельцы могут просто иметь общее владение активами, но для активов композиции владельцы могут указать свое право собственности на права на производительность, права на синхронизацию или механические права.)

    Аналогичным образом, объект ownershipConflicts содержит отдельные списки, которые определяют конфликты для общих прав собственности, прав на эффективность, права на синхронизацию и механические права. Для каждого конфликта данные идентифицируют территории, на которых возникает конфликт, владельцы, которые предоставили противоречивые данные собственности, и процент актива, который, как утверждает каждый конфликтующий владелец.

  • assets.get and assets.get Методы теперь поддерживают новый параметр fetchOwnershipConflicts . Параметр имеет логическое значение, которое указывает, должен ли запрос API получить конфликты собственности для активов в ответе API. Значение по умолчанию является false , что означает, что конфликты собственности не возвращаются.

  • Определение параметра q assetSearch.list Method было обновлено для определения полей метаданных, которые ищут YouTube.

  • Документация органа запроса для метода references.insert В настоящее время указывает, что вы должны установить значение свойства contentType . Это изменение обновляет документацию, чтобы правильно отражать фактическую функцию API, но не представляет изменения функциональности API.

• Новые и обновленные ошибки

  • API поддерживает новую forbidden ошибку, которая не зависит от определенного метода, которая указывает на то, что запрашиваемая операция не может быть разрешена учетной записью службы.

  • Метод assets.insert в настоящее время определяет ошибки метаданных, которые возникают в свойствах в объекте metadataMine , а не в объекте metadata , который был устарел по состоянию на обновление API 16 июля 2013 года.

  • Страница ошибок была обновлена ​​так, чтобы для каждого ресурса, который поддерживает методы update и patch , страница содержит одну таблицу, в которой перечислены ошибки, возвращаемые этими двумя методами. Ранее на странице перечислялась ошибки для каждого метода отдельно, хотя списки всегда были одинаковыми.

16 июля 2013 г.

Это обновление содержит следующие изменения:

• Новые ресурсы и методы

  • Новый метод claimHistory.get . Возвращенный ресурс claimHistory содержит список событий, связанных с претензией, такие как создание претензии, обновляемое, оспоренное или закрытое.

  • Новый метод claimSearch.list .

    • Претензии связаны с конкретным активом.
    • Претензии связаны с конкретным видео.
    • Претензии соответствуют строке запроса, представленной в запросе.

    Каждый ресурс claimSnippet в ответе API содержит подробную информацию о претензии, включая уникальный идентификатор претензии, его статус, его тип ( audio , video или audiovisual ), а также актива и видео, связанное с претензией. В ресурсе также указывается количество просмотров для заявленного видео и названия заявленного видео.

• Обновления существующих ресурсов и методов

  • В документации теперь перечислены поддерживаемые значения для свойств, которые имеют набор перечисленных значений. Такие свойства включают свойство type ресурса asset и свойство status claim .

  • Для assets.get and assets.list Методы API теперь поддерживает значения, разделенные запятыми, для параметров запроса fetchMetadata и fetchOwnership , что позволяет вам получить несколько наборов данных метаданных или собственности.

    Приведенный ниже список объясняет соответствующие изменения в структуре ресурса asset insert а также воздействие этих изменений на методы API, которые get , list update patch ресурсы asset .

    • Объект metadata был устарел и заменен metadataMine и metadataEffective объектами. Новые объекты позволяют ресурсу asset включать как набор метаданных, предоставленных владельцем контента, который делает запрос API, а также канонический набор метаданных, который определил YouTube, является наиболее точным, полным набором метаданных для актива.

    • Аналогичным образом, объект ownership был заменен объектами ownershipMine и ownershipEffective .

    • Объект matchPolicy был заменен на объект matchPolicyMine . (В настоящее время API не поддерживает способность получить эффективную политику соответствия для актива.)

    ПРИМЕЧАНИЕ. Чтобы обеспечить обратную совместимость, если запрошен только одна версия метаданных, один набор данных о собственности или одна политика соответствия, в ответ API ответ будет включать устаревший объект, а также вновь поддерживаемый объект. Например, если запрос устанавливает параметр fetchMetadata на mine , ответ API будет содержать объект metadata и объект metadataMine , оба из которых будут содержать одни и те же данные. (Возможность установить fetchMetadata=mine была поддержана до обновления функции, позволяющей вам получить несколько версий метаданных.)
    
    Однако, если параметр fetchMetadata установлен на mine,effective , ответ API будет содержать metadataMine и metadataEffective объекты, но он не будет содержать объект metadata . (Возможность установить fetchMetadata=mine,effective не была поддержана до обновления этой функции, поэтому нет необходимости возвращать объект metadata для обратной совместимости.) Тот же принцип также применим к параметрам fetchOwnership и fetchMatchPolicy .
    
    Аналогичным образом, для обратной совместимости запрос на insert , update или patch ресурса asset может включать либо объект metadataMine , либо объект metadata . Тот же принцип применим к настройке данных о собственности ресурса asset или политики соответствия.

  • assetId , q и videoId параметры claims.list . Чтобы найти претензии, используя любой из этих критериев, используйте метод претензий. Список , который поддерживает все эти параметры.

  • В ресурсе ownership значениями general[].ratio , соотношения производительности double performance[].ratio synchronization[].ratio mechanical[].ratio integer

  • Определение правил policy ресурса rules[].action теперь перечисляет допустимые значения для этого свойства: block , monetize , takedown и track . Тем не менее, обратите внимание, что вы не можете использовать API для применения политики снятия к претензии.

  • Новое свойство reference Resource claimId присутствует, если ссылка была создана путем связи актива с существующим видео на YouTube, которое было загружено на канал YouTube, связанный с вашей учетной записью CMS. В этом случае это поле содержит идентификатор претензии, который представляет результирующую связь между активом и видео.

  • Новое свойство reference ресурса excludedIntervals[] определяет список интервалов времени во время ссылки, который YouTube должен игнорировать при попытке соответствовать ссылке. Каждый интервал указывает время начала и окончания, измеренное за несколько секунд с начала видео.

  • API больше не требует references.patch чтобы свойство status было установлено в reference ресурсе, который отправляется в органе references.update .

  • Документация была исправлена, чтобы правильно описать формат ответа API для метода videoAdvertisingOptions.getEnabledAds . Ответ, который представляет собой ресурс youtubePartner#videoAdvertisingOptionGetEnabledAds , содержит следующую информацию:

    • id - идентификатор, который YouTube использует для однозначного идентификации заявленного видео, связанного с настройками.

    • adBreaks - список объектов, в которых каждый объект содержит информацию о точке до, во время или после воспроизведения видео при разрешении рекламы. Каждый объект также может указывать другие атрибуты разрыва AD, такие как слоты AD, которые встречаются во время разрыва, и типы ADS, которые могут запускать во время каждого слота.

    • adsOnEmbeds - логическое поле, которое указывает, может ли YouTube показывать рекламу, когда видео воспроизводится во встроенном игроке.

    • countriesRestriction - список объектов, в которых каждый объект идентифицирует список территорий и форматов рекламы, которые используются во время воспроизведения видео на этих территориях.

• Новые и обновленные ошибки

  • В таблице ниже определяются новые ошибки, которые поддерживает API, и методы, которые могут вернуть каждую ошибку. Это также идентифицирует ошибки, которые изменились. Обратите внимание, что метод может вернуть несколько ошибок, которые имеют одинаковый тип ошибки. Например, required ошибка возвращается, если вы пытаетесь вставить ресурс asset , в котором отсутствует необходимое поле метаданных. На самом деле, может быть более одного необходимого поля метаданных, каждое из которых вернет ошибку с немного другим сообщением.

    Пожалуйста, обратитесь к документации по ошибке для каждого метода или на странице ошибок для получения дополнительной информации.

    Метод	Ошибки
    assets.insert assets.update assets.patch	invalidValue и required ошибки, ранее связанные с дочерними свойствами объекта metadata , теперь связаны с теми же дочерними свойствами в объекте metadataMine .
    claimHistory.get	notFound - утверждение, за которое вы пытаетесь получить историю, не может быть найдено. required - в запросе не указывается значение для параметра claimId .
    claimSearch.list claims.list	badRequest - запрос определяет неверные критерии. В большинстве случаев можно указать один из следующих параметров фильтра: q , assetId , videoId .
    claims.insert	badRequest - утверждение, которое вы пытаетесь создать, является недействительным, потому что запрошенный владелец контента не является владельцем актива, связанного с претензией. badRequest - владелец контента, которого вы действуете от имени, не имеет разрешения на создание политик с указанным действием. invalidValue -Владелец контента, которого вы действуете от имени, не имеет разрешения на то, чтобы получить пользовательские видеоролики через API.
    contentOwners.list	badRequest - запрос определяет неверные критерии. Точно один из следующих параметров фильтра должен быть указан: fetchMine , id . (Ранее в ошибке перечислялась другой набор параметров фильтра - has_conflicts_with , restrict_to_user , name_prefix и id .)
    ownership.update ownership.patch	badRequest - запрос, который обновляет данные владения композиционным активом, должен указывать данные о гранулированных владениях; mechanical , performance , synchronization и/или lyric права, а не general права собственности. Тип lyric прав вновь поддерживается.
    policies.insert policies.update policies.patch	invalidValue - Запрос содержит неверное правило политики, поскольку API не поддерживает создание или изменение политик, которые указывают действие takedown . Эта ошибка, которая сообщает о причине invalidPolicyTakedownAction , заменяет устаревшую ошибку invalidPolicyConditionalTakedown .
    references.insert	badRequest - запрос должен либо отправить файл носителя, либо указать значение для параметра запроса claimId . Тем не менее, запрос не может отправлять файл носителя и указать значение для параметра запроса claimId . badRequest - ссылка на тот же контент уже был создан из другой претензии на одном и том же видео на YouTube. badRequest - API не поддерживает возможность установить значение для свойства fpDirect при создании ссылки. internalError - есть проблема с загруженным носителем. invalidValue - значение параметра запроса contentType , assetId или claimId является недействительным. Ошибка определяет неверное значение. notFound - Актив или утверждение, которое вы указали, не могут быть найдены. Пожалуйста, проверьте значения параметров assetId и claimId в вашем запросе. required - запрос должен указать значение для параметра contentType .
    references.insert references.update references.patch	invalidValue - excludedIntervals , указанные для ссылки, недопустимы. Обратите внимание, что вы не можете указать интервалы исключения при деактивации ссылки.

10 мая 2013 г.

Это обновление содержит следующие изменения:

• YouTube больше не идентифицирует экспериментальные функции и услуги API. Вместо этого мы теперь предоставляем список API YouTube, которые подчиняются политике детектирования .

8 апреля 2013 г.

Это обновление содержит следующие изменения:

• API был переименован в API идентификатора контента на YouTube.

• Несколько свойств изменились в ресурсе assetMatchPolicy :

  • Стоимость kind изменилась с youtubePartner#policy до youtubePartner#assetMatchPolicy .
  • Новая собственность policyId содержит значение, которое однозначно определяет сохраненный ресурс политики .
  • rules[].subaction теперь является списком строк, а не строки.
  • rules[].conditions.contentMatchType Значение свойства теперь является списком строк, а не строки.
  • Свойства id , name и description были удалены.

• Документация для метода assetMatchPolicy.update была обновлена, чтобы отразить тот факт, что вы можете установить значения либо для объекта policyId , либо для объекта rules[] при вызове метода.

• Ресурс claims теперь поддерживает несколько новых свойств:

  Имя свойства	Ценить	Описание
  timeCreated	datetime	Дата и время, когда претензия была создана.
  matchInfo	object	Объект matchInfo содержит информацию о соответствующем контенте, который генерировал претензию. Эта информация включена в ресурс claim только в том случае, если претензия была автоматически сгенерирована, потому что загруженное видео соответствует существующему эталонному файлу.
  matchInfo. referenceId	string	Уникальный идентификатор, который YouTube использует для определения эталонной reference , которая сгенерировала совпадение.
  matchInfo. longestMatch	object	longestMatch объект содержит информацию о самом длинном совпадении между ссылкой и загруженным видео.
  matchInfo.longestMatch. durationSecs	unsigned long	Продолжительность матча, в считанные секунды.
  matchInfo.longestMatch. userVideoOffset	unsigned long	Смещение времени, когда начинается матч, измеренный в секунды с начала загруженного видео.
  matchInfo.longestMatch. referenceOffset	unsigned long	Смещение времени, когда начинается матч, измеренный в секундах с начала ссылки.
  matchInfo. totalMatch	object	Объект totalMatch содержит информацию об общем количестве загруженного видео, которое соответствовало ссылке, и об общем количестве ссылки, которая соответствовала загруженному видео. Эти значения могут отличаться, если соответствующий контент работает в цикле либо в загруженном видео, либо в ссылке. Например, если загруженное видео включает в себя 10-секундный клип из ссылки, но клип повторяется шесть раз, то общий соответствующий контент в загруженном видео составляет 60 секунд, но общее соответствие содержимого в ссылке составляет всего 10 секунд .
  matchInfo.totalMatch. userVideoDurationSecs	unsigned long	Общая длина, в считанные секунды, загруженного видео контента, соответствующего ссылке.
  matchInfo.totalMatch. referenceDurationSecs	unsigned long	Общая длина в считанные секунды, эталонный контент, который соответствует загруженному видео.
  origin	object	Объект origin содержит информацию, которая описывает источник претензии.
  origin. source	string	Источник претензии.

• Собственность policy в ресурсе claims была обновлена, чтобы отметить, что значение не может быть обновлено для претензии AudiosWap.

• Собственность metadataHistory Resource timeProvidedMs была переименована в TimeProvided .

• Собственность ownershipHistory Resource timeProvidedMs была переименована в TimeProvided .

• Определение метода ownershipHistory.list . Однако, если владелец контента представил данные собственности с помощью нескольких источников данных (API, контент и т. Д.), Список будет содержать самые последние данные для каждого владельца контента и источника данных.

• Несколько свойств изменились в policy ресурсе:

  • Собственность rule была переименована в правила .
  • rules[].subaction теперь является списком строк, а не строки.
  • rules[].conditions.contentMatchType Значение свойства теперь является списком строк, а не строки.

• Документация для policies.insert и политики. Методы policies.update были обновлены, чтобы отразить тот факт, что вы можете установить значения для объекта rules[] при вызове этих методов.

• Несколько методов API поддерживают новые типы ошибок. В таблице ниже идентифицируется метод и кратко идентифицирует типы вновь поддерживаемых ошибок. Во многих случаях может быть несколько ошибок для данного типа. Например, required ошибка возвращается, если вы пытаетесь вставить ресурс asset , в котором отсутствует необходимое поле метаданных. На самом деле, может быть более одного необходимого поля метаданных, каждое из которых вернет ошибку с немного другим сообщением.

  Пожалуйста, обратитесь к документации по ошибке для каждого метода или на странице ошибок для получения дополнительной информации.

  Метод	Ошибки
  assets.insert	invalidValue - поле метаданных активов содержит неверное значение. required - требуемое поле метаданных активов отсутствует.
  assets.update assets.patch	forbidden - обновленный актив не принадлежит партнеру, пытающемуся завершить обновление. invalidValue - поле метаданных активов содержит неверное значение. notFound - Активин ассоциируется с сезонным активом или активом, который не может быть найден. required - требуемое поле метаданных активов отсутствует.
  claims.insert	badRequest - запрос пытается получить видео, но претензия не разрешена.
  ownership.update ownership.patch	badRequest - Запрос определяет общую собственность более 100 процентов на территории.
  policies.insert policies.patch policies.update	conflictingPolicyRules - политика содержит противоречивые политические правила.

• На странице новых ошибок перечислены ошибки, которые API может вернуть. Страница включает в себя общие ошибки, которые могут возникнуть для нескольких различных методов API, а также ошибок, специфичных для метода.

18 января 2013 г.

Это обновление содержит следующие изменения:

• Недавно документированный метод videoAdvertisingOptions.getEnabledAds позволяет получить подробную информацию о типах объявлений, которые разрешены для указанного видео-партнера или пользовательского видео.

• Определение параметра assetSearch.list Method ownershipRestriction было обновлено, чтобы отметить, что значение параметра по умолчанию - это mine , что указывает на то, что API должен получать только активы, принадлежащие текущему пользователю.

• Документация метода assets.list отражает следующие изменения:

  • Параметр id теперь требуется.

  • Недавно поддерживаемый параметр fetchMatchPolicy позволяет указать, должен ли запрос API также получить политику совпадения, которую вы установили для актива.

  • Недавно поддерживаемый параметр fetchOwnership позволяет указать, должен ли запрос API также получить данные собственности для актива.

  • Список активов, которые возвращает API, больше не содержит данные о странице. В результате свойство nextPageToken и объект pageInfo были удалены из ответа API. Объект pageInfo содержал свойства totalResults , resultsPerPage и свойства startIndex .

• Документация по ресурсам claims была обновлена, чтобы отметить, что вы должны указать политику при создании претензии. (YouTube в настоящее время не применяет вашу политику использования по умолчанию, если вставленная претензия не указывает политику, хотя ранее в документации указано, что это произошло.)

• Собственность policy ресурса hasUnpublishedDraft была устарела.

• policies.list Вновь поддерживаемый id Method Method позволяет идентифицировать сохраненные политики, которые должен получить запрос API. Можно извлечь только политики, принадлежащие к ныне аутентифицированному владельцу контента.

• Определение параметра releaseClaims как для references.patch , так inactive references.update В этом случае вы также можете установить true параметра releaseClaims для выпуска всех требований соответствия, произведенных в соответствии с ссылкой.

• references.patch и references.update МЕТОДЫ были обновлены, чтобы отметить, что вы должны указать статус ссылки при выполнении любой из этих операций.

• Несколько методов API поддерживают новые типы ошибок. Таблица ниже идентифицирует метод и вновь поддерживаемые ошибки:

  Метод	Тип ошибки	Деталь ошибки	Описание
  guideCategories.list	notFound	Unavailable	Актив, для которого вы пытаетесь получить политику матча, не может быть найден.
  claims.get	notFound	Unavailable	Утверждение, что вы пытаетесь извлечь, не может быть найдено.
  ownership.patch	invalidValue	Unavailable	Предоставленные вами данные владения содержат неверную стоимость.
  ownership.update	invalidValue	Unavailable	Предоставленные вами данные владения содержат неверную стоимость.