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 资源:Verifier

方法
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
检索内容所有者的白名单频道列表。