资源:Claim
claim
可将合作伙伴或用户上传的视频与视频匹配的资产关联起来。版权声明指明视频是否与资产的音频、视频或视听(音频和视频)部分相匹配。该版权主张还指定了权利所有者希望 YouTube 将哪项政策应用于已主张版权的视频。
JSON 表示法 |
---|
{ "kind": string, "policy": { object ( |
字段 | |
---|---|
kind |
API 资源的类型。对于 |
policy |
负责查看版权主张的所有者提供的政策。 |
timeCreated |
版权主张的创建时间。 |
contentType |
此值用于指明版权主张涵盖的是已主张版权的内容的音频、视频或视听部分。 |
ugcType |
版权主张针对 UGC 的类型(标准、付费、歌曲)。 |
isPartnerUploaded |
指明版权主张是否为合作伙伴上传的版权主张。 |
timeStatusLastModified |
版权主张状态和/或状态详情的上次修改时间。 |
blockOutsideOwnership |
指明是否应在没有明确拥有版权的任何地方禁播已主张版权的视频。 |
status |
版权主张的状态。更新版权主张时,您可以将其状态从 |
appliedPolicy |
对版权主张的查看所有者应用的政策。这与该视频的最终版权主张政策不同,因为它不考虑同一版权主张的其他合作伙伴的政策。 |
id |
YouTube 指定并用来唯一标识版权主张的 ID。 |
assetId |
用于标识与版权主张相关联的资产的唯一 YouTube 资产 ID。 |
videoId |
用于标识与版权主张相关联的视频的唯一 YouTube 视频 ID。 |
origin |
|
matchInfo |
如果此版权主张是根据提供的参考文件自动生成的,则此部分会提供生成此版权主张的匹配项的详细信息。 |
studioInfo |
包含链接回工作室中与版权主张相关的页面的网址。 |
原点
此对象包含描述元数据或所有权数据来源的信息。
JSON 表示法 |
---|
{ "source": string } |
字段 | |
---|---|
source |
|
MatchInfo
与声明相关的匹配信息。
JSON 表示法 |
---|
{ "matchSegments": [ { object ( |
字段 | |
---|---|
matchSegments[] |
有关每个匹配细分的详细信息。列表中的每一项都包含与版权主张相关联的一个匹配片段的相关信息。匹配细分受众群可以有多个。例如,如果一个上传的视频的音频和视频内容与参考视频的音频和视频内容匹配,则会出现两个匹配片段。一个片段描述音频匹配,另一个片段描述视频匹配。 |
referenceId |
生成此匹配项的参考 ID。 |
longestMatch |
参考文件与用户视频之间的最长匹配度的详情。 |
totalMatch |
相互匹配的参考视频内容和用户视频内容的总数详细信息。请注意,如果参考文件或用户视频包含循环,这两个值可能会不同。 |
MatchSegment
与版权主张中的单个匹配片段相关的信息。
JSON 表示法 |
---|
{ "video_segment": { object ( |
字段 | |
---|---|
video_segment |
|
reference_segment |
|
channel |
指明已声明版权的视频与参考视频的匹配方式。 |
manual_segment |
在插入手动版权主张时, |
片段
此资源表示一个简单的细分,其开始和结束时间格式为“hh:mm:ss.mmm”字符串。
JSON 表示法 |
---|
{ "start": string, "duration": string, "kind": string } |
字段 | |
---|---|
start |
片段的开始时间,以毫秒为单位。 |
duration |
片段的时长(以毫秒为单位)。 |
kind |
API 资源的类型。对于细分资源,该值为 |
Segment2
此资源表示另一个简单的细分,其开始和结束时间格式为“hh:mm:ss.mmm”字符串。
JSON 表示法 |
---|
{ "start": string, "kind": string, "finish": string } |
字段 | |
---|---|
start |
片段的开始时间,以毫秒为单位。 |
kind |
API 资源的类型。对于细分资源,该值为 |
finish |
片段的结束时间(以毫秒为单位),从开始算起。 |
LongestMatch
最长的版权主张匹配。
JSON 表示法 |
---|
{ "durationSecs": string, "userVideoOffset": string, "referenceOffset": string } |
字段 | |
---|---|
durationSecs |
参考文件与用户视频之间最长匹配的时长。 |
userVideoOffset |
用户视频开始最长匹配时的偏移量(以秒为单位)。 |
referenceOffset |
最长匹配开始处的引用中的偏移量(以秒为单位)。 |
TotalMatch
版权主张匹配总数。
JSON 表示法 |
---|
{ "userVideoDurationSecs": string, "referenceDurationSecs": string } |
字段 | |
---|---|
userVideoDurationSecs |
用户视频中与参考文件匹配的内容总数(以秒为单位)。 |
referenceDurationSecs |
参考文件中与用户视频匹配的内容总数(以秒为单位)。 |
方法 |
|
---|---|
|
根据 ID 检索特定声明。 |
|
创建版权主张。 |
|
用于检索与当前经过身份验证的用户相关联的内容所有者所管理的声明列表。 |
|
通过更改政策或状态来修补现有版权主张。 |
|
通过更改政策或状态来更新现有的版权主张。 |