Method: references.insert

通过以下某种方式创建引用：

  • 如果您的请求是上传参考文件，YouTube 会根据提供的内容创建参考文件。您可以提供视频/音频文件或预先生成的指纹。如果您要提供预先生成的指纹，请在请求正文中将 reference 资源的 fpDirect 属性设置为 true。在此流程中，您可以使用多部分或resumable上传流程来提供参考内容。
  • 如果您想将收到版权主张的视频用作参考内容来创建参考文件，请使用 claimId 参数来标识版权主张。

HTTP 请求

  • 上传 URI，用于媒体上传请求：
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • 元数据 URI，用于仅包含元数据的请求：
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

网址采用 gRPC 转码语法。

查询参数

参数
claimId

string

claimId 参数指定应根据其创建参考文件的现有版权主张的 YouTube 版权主张 ID。（已声明版权的视频将用作参考内容）。
onBehalfOfContentOwner

string

onBehalfOfContentOwner 参数用于标识用户代表的内容所有者。此参数支持其帐号与多个内容所有者相关联的用户。

请求正文

请求正文包含一个 Reference 实例。

响应正文

如果成功，则响应正文包含一个 Reference 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/youtubepartner

有关详情，请参阅 OAuth 2.0 概览。