YouTube Content ID API

YouTube Content ID API 可用于管理 YouTube 资产及其关联的内容、参考文件、所有权、权利和政策。

服务：youtubepartner.googleapis.com

如要调用此服务，我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务，则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档：

服务端点

服务端点是一个基础网址，指定了 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
此方法可检索合作伙伴拥有的与指定资产视图 ID 对应的资产份额列表，也可检索与合作伙伴拥有的指定资产份额 ID 相关联的资产视图列表。

REST 资源：assets

方法
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 资源：campaigns

方法
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 资源：claims

方法
get GET /youtube/partner/v1/claims/{claimId}
按 ID 检索特定版权主张。
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 资源：contentOwners

方法
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 资源：ownership

方法
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 资源：package

方法
get GET /youtube/partner/v1/package/{packageId}
检索指定软件包的信息。
insert POST /youtube/partner/v1/package
插入仅包含元数据的软件包。

REST 资源：policies

方法
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 资源：references

方法
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
按 ID 检索参考资料列表，或检索指定资产的参考资料列表。
patch PATCH /youtube/partner/v1/references/{referenceId}
修补参考。
update PUT /youtube/partner/v1/references/{referenceId}
更新参考。

REST 资源：spreadsheetTemplate

方法
list GET /youtube/partner/v1/spreadsheetTemplate
检索内容所有者的电子表格模板列表。

REST 资源：uploader

方法
list GET /youtube/partner/v1/uploader
检索内容所有者的上传者列表。

REST 资源：validator

方法
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 资源：whitelists

方法
delete DELETE /youtube/partner/v1/whitelists/{id}
移除内容所有者的列入许可名单的频道。
get GET /youtube/partner/v1/whitelists/{id}
按 ID 检索特定的已列入许可名单的渠道。
insert POST /youtube/partner/v1/whitelists
将 YouTube 频道加入内容所有者的白名单。
list GET /youtube/partner/v1/whitelists
检索内容所有者的许可名单中的频道列表。