代表内容所有者处理

注意:YouTube Content ID API 专供 YouTube 内容合作伙伴使用,并非所有开发者或 YouTube 用户都能使用。如果您在 Google API 控制台中未看到 YouTube Content ID API 列为某项服务,请访问 YouTube 帮助中心,详细了解 YouTube 合作伙伴计划。

YouTube 权利管理系统中的每个对象都与一个内容所有者相关联。内容所有者是对一系列资产拥有所有权的 YouTube 合作伙伴。当应用使用 YouTube Content ID API 时,对于其创建或操纵的资产、政策和声明,必须获得内容所有者的授权。当经过身份验证的应用有权访问内容所有者帐号的用户时,应用会获得该授权。如果经过身份验证的用户没有访问内容所有者帐号的权限,那么对 Content ID API 的调用会失败。

检索内容所有者的 ID

如需检索内容所有者的 ID,请调用 YouTube Content ID API 的 contentOwners.list 方法。API 响应包含与向请求授权的用户相关联的 contentOwner 资源列表。在每个资源中,id 属性都指定内容所有者的 ID。

如需查看以编程方式检索内容所有者 ID 的示例,请参阅上传视频并声明版权

代表内容所有者调用 YouTube API

YouTube Content ID API

由于大多数用户只能访问一个内容所有者帐号,因此 Content ID API 可以隐式确定用户所代表的内容所有者。因此,对于 Content ID API 调用,onBehalfOfContentOwner 参数是可选的。

但是,部分用户可以访问多个内容所有者帐号。对于这些用户,每个 API 请求都必须包含 onBehalfOfContentOwner 参数,以明确标识要使用的内容所有者帐号。

YouTube Data API (v3)

许多 YouTube Data API 方法也支持 onBehalfOfContentOwner 参数。使用该参数的方法采用委托机制,让应用能够对内容所有者管理的频道、这些受管频道中的视频或其他 API 资源执行操作。

在 YouTube Data API 中使用委托功能时,onBehalfOfContentOwner 参数始终为必需参数。该参数的值是唯一标识内容所有者的 ID。您可以通过调用 YouTube Content ID API 的 contentOwners.list 方法来以编程方式检索 ID。

某些 API 调用还需要额外的委托参数。以下列表介绍了两个示例:

每个特定方法的文档都详细介绍了何时支持委托,以及您是否需要设置除 onBehalfOfContentOwner 之外的其他参数。

YouTube Analytics API

要使用 YouTube Analytics API 检索内容所有者报告,请将 API 请求中的 ids 参数值设为 contentOwner==OWNER_ID,其中 OWNER_ID 指定内容所有者的 ID。