REST Resource: claims

资源:Claim

claim 可将合作伙伴或用户上传的视频与视频匹配的资产关联起来。版权声明指明视频是否与资产的音频、视频或视听(音频和视频)部分相匹配。该版权主张还指定了权利所有者希望 YouTube 将哪项政策应用于已主张版权的视频。

JSON 表示法
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
字段
kind

string

API 资源的类型。对于 claim 资源,此值为 youtubePartner#claim

policy

object (Policy)

负责查看版权主张的所有者提供的政策。

timeCreated

string

版权主张的创建时间。

contentType

string

此值用于指明版权主张涵盖的是已主张版权的内容的音频、视频或视听部分。

ugcType

string

版权主张针对 UGC 的类型(标准、付费、歌曲)。

isPartnerUploaded

boolean

指明版权主张是否为合作伙伴上传的版权主张。

timeStatusLastModified

string

版权主张状态和/或状态详情的上次修改时间。

blockOutsideOwnership

boolean

指明是否应在没有明确拥有版权的任何地方禁播已主张版权的视频。

status

string

版权主张的状态。更新版权主张时,您可以将其状态从 active 更新为 inactive 以有效地撤消版权主张,但 API 不支持对版权主张状态进行其他更新。

appliedPolicy

object (Policy)

对版权主张的查看所有者应用的政策。这与该视频的最终版权主张政策不同,因为它不考虑同一版权主张的其他合作伙伴的政策。

id

string

YouTube 指定并用来唯一标识版权主张的 ID。

assetId

string

用于标识与版权主张相关联的资产的唯一 YouTube 资产 ID。

videoId

string

用于标识与版权主张相关联的视频的唯一 YouTube 视频 ID。

origin

object (Origin)

matchInfo

object (MatchInfo)

如果此版权主张是根据提供的参考文件自动生成的,则此部分会提供生成此版权主张的匹配项的详细信息。

studioInfo

object (StudioInfo)

包含链接回工作室中与版权主张相关的页面的网址。

原点

此对象包含描述元数据或所有权数据来源的信息。

JSON 表示法
{
  "source": string
}
字段
source

string

MatchInfo

与声明相关的匹配信息。

JSON 表示法
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
字段
matchSegments[]

object (MatchSegment)

有关每个匹配细分的详细信息。列表中的每一项都包含与版权主张相关联的一个匹配片段的相关信息。匹配细分受众群可以有多个。例如,如果一个上传的视频的音频和视频内容与参考视频的音频和视频内容匹配,则会出现两个匹配片段。一个片段描述音频匹配,另一个片段描述视频匹配。

referenceId

string

生成此匹配项的参考 ID。

longestMatch

object (LongestMatch)

参考文件与用户视频之间的最长匹配度的详情。

totalMatch

object (TotalMatch)

相互匹配的参考视频内容和用户视频内容的总数详细信息。请注意,如果参考文件或用户视频包含循环,这两个值可能会不同。

MatchSegment

与版权主张中的单个匹配片段相关的信息。

JSON 表示法
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
字段
video_segment

object (Segment)

videoSegment 对象包含已声明版权的视频的匹配部分的相关信息。

reference_segment

object (Segment)

referenceSegment 对象包含有关参考内容的匹配部分的信息。

channel

string

指明已声明版权的视频与参考视频的匹配方式。

manual_segment

object (Segment2)

在插入手动版权主张时,manualSegment 对象包含有关声称匹配的视频中特定部分的信息。

片段

此资源表示一个简单的细分,其开始和结束时间格式为“hh:mm:ss.mmm”字符串。

JSON 表示法
{
  "start": string,
  "duration": string,
  "kind": string
}
字段
start

string

片段的开始时间,以毫秒为单位。

duration

string

片段的时长(以毫秒为单位)。

kind

string

API 资源的类型。对于细分资源,该值为 youtubePartner#segment

Segment2

此资源表示另一个简单的细分,其开始和结束时间格式为“hh:mm:ss.mmm”字符串。

JSON 表示法
{
  "start": string,
  "kind": string,
  "finish": string
}
字段
start

string

片段的开始时间,以毫秒为单位。

kind

string

API 资源的类型。对于细分资源,该值为 youtubePartner#segment

finish

string

片段的结束时间(以毫秒为单位),从开始算起。

LongestMatch

最长的版权主张匹配。

JSON 表示法
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
字段
durationSecs

string

参考文件与用户视频之间最长匹配的时长。

userVideoOffset

string

用户视频开始最长匹配时的偏移量(以秒为单位)。

referenceOffset

string

最长匹配开始处的引用中的偏移量(以秒为单位)。

TotalMatch

版权主张匹配总数。

JSON 表示法
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
字段
userVideoDurationSecs

string

用户视频中与参考文件匹配的内容总数(以秒为单位)。

referenceDurationSecs

string

参考文件中与用户视频匹配的内容总数(以秒为单位)。

方法

get

根据 ID 检索特定声明。

insert

创建版权主张。

list

用于检索与当前经过身份验证的用户相关联的内容所有者所管理的声明列表。

patch

通过更改政策或状态来修补现有版权主张。

update

通过更改政策或状态来更新现有的版权主张。