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