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。
保留所有权利。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-21。"],[],["The content details how to create a reference on YouTube, either by uploading a file (video/audio or fingerprint) via multipart or resumable upload or by using an existing claimed video. The request is a `POST` operation to a specified URI with parameters like `claimId` (for using a claimed video) and `onBehalfOfContentOwner`. The request body contains `Reference` data, and a successful response also returns `Reference` data. This operation requires specific authorization scope.\n"]]