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

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