Method: references.insert

通过以下方式之一创建参考文件：

  • 如果您的请求是上传参考文件，YouTube 会根据提供的内容创建参考文件。您可以提供视频/音频文件或预先生成的指纹。如果您提供的是预先生成的指纹，请在请求正文中将 reference 资源的 fpDirect 属性设置为 true。在此流程中，您可以使用多部分上传流程或可续传上传流程来提供参考内容。
  • 如果您想使用已声明版权的视频作为参考内容来创建参考文件，请使用 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 Overview。