YouTube 数据 API v3 的 `.../auth/youtube.download` 范围是什么?

What is the `.../auth/youtube.download` scope for YouTube Data API v3?

在 YouTube 数据 API v3 的 select 范围屏幕中,您可以 select 以下范围:

Scope risk API Scope User-facing description?
(non-sensitive) YouTube Data API v3 .../auth/youtube.download Download your public YouTube videos

对我来说,这听起来很像 API 允许用户下载一些视频。由于它是非敏感范围,因此甚至不需要验证。但据我所知,the API neither supports nor allows downloading videos,甚至不是你自己的。那么这个作用域是做什么用的呢?我可以使用它吗?如果可以,如何使用?

考虑到范围 youtube.download 确实需要 OAuth,它用于下载经过身份验证的用户的视频,尽管根据 YouTube 数据 API 中范围的描述,这似乎仅适用于 public 个视频。

所以这里要澄清的是,虽然你不能下载任何 YouTube 视频,但似乎可以只获取当前 OAuth 用户的视频。

我已确认范围确实显示在向用户显示的 Google 登录中。

但是,它不授予对 .../auth/youtube.readonly 范围可用资源的访问权限,否则这似乎是权限最低的范围。

我也发现范围不在the official API reference, or in this list of scopes。由于我无法找到有关该范围的更多信息,我们必须在没有证据的情况下假设它不能(由普通用户)用于访问 YouTube 资源,下载您的拥有 public 个 YouTube 视频或其他。

我可以通过以下任何方式改进此答案:

  1. 证明实际上可以访问范围
  2. 的资源
  3. 与答案一致的官方声明
  4. 系统地证明 API 端点中的 none 接受范围

编辑: 在 Google 正式确认任何要点之前,请务必注意,根据 Developer Policies(正如@stvar 指出的那样评论)

Undocumented Services

You must not use undocumented APIs without express permission. You must access data from YouTube API services only according to the means stipulated in the authorized documentation of that YouTube API service.

You must not reverse engineer undocumented YouTube API services or otherwise attempt to derive the underlying source code of these API services.

我创建了 an issue in the official tracker,报告范围已出现但未记录。然而,回复指出:

This is working as intended. It is not available for public use and therefore will not be documented.

换句话说,范围是为了出现在选择屏幕中,但不能被普通用户使用。