YouTube Content ID API

API идентификаторов контента YouTube позволяет управлять ресурсами YouTube, а также связанным с ними контентом, ссылками, правами собственности и политиками.

Сервис: youtubepartner.googleapis.com

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки, предоставляемые Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов к API.

Документ об обнаружении

Документ Discovery — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов для IDE и других инструментов, взаимодействующих с API Google. Один сервис может предоставлять несколько документов Discovery. Данный сервис предоставляет следующий документ Discovery:

конечная точка сервиса

Конечная точка сервиса — это базовый URL-адрес, указывающий сетевой адрес API-сервиса. Один сервис может иметь несколько конечных точек. Данный сервис имеет следующую конечную точку, и все приведенные ниже URI являются относительными к этой конечной точке:

  • https://youtubepartner.googleapis.com

REST-ресурс: assetLabels

Методы
insert POST /youtube/partner/v1/assetLabels
Вставьте метку актива для владельца.
list GET /youtube/partner/v1/assetLabels
Получает список всех меток активов для владельца.

REST-ресурс: assetMatchPolicy

Методы
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
Получает политику соответствия, назначенную указанному ресурсу владельцем контента, связанным с аутентифицированным пользователем.
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
Вносит изменения в политику сопоставления ресурса.
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
Обновляет политику сопоставления актива.

REST-ресурс: assetRelationships

Методы
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
Удаляет связь между двумя активами.
insert POST /youtube/partner/v1/assetRelationships
Создает связь, объединяющую два актива.
list GET /youtube/partner/v1/assetRelationships
Получает список взаимосвязей для заданного актива.

REST-ресурс: assetSearch

Методы
list GET /youtube/partner/v1/assetSearch
Поиск активов на основе метаданных активов.

REST-ресурс: assetShares

Методы
list GET /youtube/partner/v1/assetShares
Этот метод либо получает список долей активов, принадлежащих партнеру и соответствующих указанному идентификатору представления актива , либо получает список представлений активов, связанных с указанным идентификатором доли актива, принадлежащей партнеру.

REST-ресурс: активы

Методы
get GET /youtube/partner/v1/assets/{assetId}
Получает метаданные для указанного ресурса.
insert POST /youtube/partner/v1/assets
Вставляет ресурс с указанными метаданными.
list GET /youtube/partner/v1/assets
Получает список активов на основе метаданных активов.
patch PATCH /youtube/partner/v1/assets/{assetId}
Вносит изменения в метаданные указанного ресурса.
update PUT /youtube/partner/v1/assets/{assetId}
Обновляет метаданные для указанного ресурса.

REST-ресурс: кампании

Методы
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
Удаляет указанную кампанию для владельца.
get GET /youtube/partner/v1/campaigns/{campaignId}
Получает информацию о конкретной кампании для владельца.
insert POST /youtube/partner/v1/campaigns
Вставьте новую рекламную кампанию для владельца, используя указанные данные кампании.
list GET /youtube/partner/v1/campaigns
Получает список кампаний для владельца.
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
Исправьте данные для конкретной кампании.
update PUT /youtube/partner/v1/campaigns/{campaignId}
Обновите данные для конкретной кампании.

REST-ресурс: claimHistory

Методы
get GET /youtube/partner/v1/claimHistory/{claimId}
Получает историю рассмотрения указанного заявления.

REST-ресурс: claimSearch

Методы
list GET /youtube/partner/v1/claimSearch
Получает список заявок, соответствующих критериям поиска.

REST-ресурс: утверждения

Методы
get GET /youtube/partner/v1/claims/{claimId}
Извлекает конкретное утверждение по идентификатору.
insert POST /youtube/partner/v1/claims
Создаёт претензию.
list GET /youtube/partner/v1/claims
Получает список утверждений, администрируемых владельцем контента, связанным с текущим аутентифицированным пользователем.
patch PATCH /youtube/partner/v1/claims/{claimId}
Вносит изменения в существующую заявку, либо изменяя ее условия, либо ее статус.
update PUT /youtube/partner/v1/claims/{claimId}
Обновляет существующую заявку, изменяя либо ее условия, либо статус.

REST-ресурс: владельцы контента

Методы
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
Получает информацию о владельце указанного контента.
list GET /youtube/partner/v1/contentOwners
Получает список владельцев контента , соответствующих критериям запроса.

REST-ресурс: liveCuepoints

Методы
insert POST /youtube/partner/v1/liveCuepoints
Вставляет точку воспроизведения в прямую трансляцию.

REST-ресурс: metadataHistory

Методы
list GET /youtube/partner/v1/metadataHistory
Получает список всех метаданных, предоставленных для ресурса, независимо от того, какой владелец контента предоставил эти данные.

REST-ресурс: musicChangeRequests

Методы
create POST /youtube/partner/v1/music/changeRequests
Создает запрос на изменение музыки, который отправляется в релиз или трек.
list GET /youtube/partner/v1/music/changeRequests
Получает список запросов на изменение музыки, поступивших в связи с релизом или треком.

REST-ресурс: musicReleases

Методы
list GET /youtube/partner/v1/music/releases
Получает список музыкальных релизов.

REST-ресурс: musicTracks

Методы
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
Получает список музыкальных треков.

REST-ресурс: собственность

Методы
get GET /youtube/partner/v1/assets/{assetId}/ownership
Получает данные о правах собственности, предоставленные владельцем контента, связанным с авторизованным пользователем, для указанного ресурса.
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
Предоставляет новую информацию о владельце указанного актива.
update PUT /youtube/partner/v1/assets/{assetId}/ownership
Предоставляет новую информацию о владельце указанного актива.

REST-ресурс: ownershipHistory

Методы
list GET /youtube/partner/v1/ownershipHistory
Получает список данных о владельцах ресурса, независимо от того, какой владелец контента предоставил эти данные.

REST-ресурс: пакет

Методы
get GET /youtube/partner/v1/package/{packageId}
Получает информацию для указанного пакета.
insert POST /youtube/partner/v1/package
Вставляет пакет, содержащий только метаданные.

Ресурсы REST: политики

Методы
get GET /youtube/partner/v1/policies/{policyId}
Получает указанную сохраненную политику.
insert POST /youtube/partner/v1/policies
Создает сохраненную политику.
list GET /youtube/partner/v1/policies
Получает список сохраненных политик владельца контента.
patch PATCH /youtube/partner/v1/policies/{policyId}
Вносит изменения в указанную сохраненную политику.
update PUT /youtube/partner/v1/policies/{policyId}
Обновляет указанную сохраненную политику.

REST-ресурс: referenceConflicts

Методы
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
Получает информацию об указанном конфликте ссылок.
list GET /youtube/partner/v1/referenceConflicts
Получает список неразрешенных конфликтов ссылок.

Ресурсы REST: ссылки

Методы
get GET /youtube/partner/v1/references/{referenceId}
Извлекает информацию об указанном объекте.
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references

Создает ссылку одним из следующих способов:

  • Если ваш запрос предполагает загрузку файла-образца, YouTube создаст этот файл на основе предоставленного контента.
list GET /youtube/partner/v1/references
Получает список ссылок по идентификатору или список ссылок для указанного актива.
patch PATCH /youtube/partner/v1/references/{referenceId}
Патчи — это отсылка.
update PUT /youtube/partner/v1/references/{referenceId}
Обновляет ссылку.

REST-ресурс: шаблон электронной таблицы

Методы
list GET /youtube/partner/v1/spreadsheetTemplate
Получает список шаблонов электронных таблиц для владельца контента.

REST-ресурс: загрузчик

Методы
list GET /youtube/partner/v1/uploader
Получает список пользователей, загрузивших контент, для владельца контента.

REST-ресурс: валидатор

Методы
validate POST /youtube/partner/v1/validator
Проверьте файл метаданных.
validateAsync POST /youtube/partner/v1/validatorAsync
Проверка файла метаданных в асинхронном режиме.
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
Получите статус асинхронной проверки.

REST-ресурс: videoAdvertisingOptions

Методы
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
Получает настройки рекламы для указанного видео.
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
Получает подробную информацию о типах разрешенной рекламы для указанного видео, загруженного партнером или пользователем.
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
Изменяет настройки рекламы для указанного видео.
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
Обновляет настройки рекламы для указанного видео.

Ресурс REST: белые списки

Методы
delete DELETE /youtube/partner/v1/whitelists/{id}
Удаляет канал из белого списка для владельца контента.
get GET /youtube/partner/v1/whitelists/{id}
Получает доступ к конкретному каналу из белого списка по идентификатору.
insert POST /youtube/partner/v1/whitelists
Добавьте YouTube-канал в белый список для владельцев контента.
list GET /youtube/partner/v1/whitelists
Получает список разрешенных каналов для владельца контента.