YouTube · 设置指南
如何创建 YouTube 数据 API 密钥
StreamBruh 使用您的 YouTube Data API v3 密钥进行公共视频搜索和频道上传检查。 Google 云配额和 API 密钥限制可能会影响这些计划检查。
分步设置
创建或选择Google云项目
使用 Google 帐户登录 Google Cloud Console。为这些通知创建一个项目或选择您管理的项目。检查控制台标题中的预期项目是否处于活动状态。
启用YouTube Data API v3
在 APIs & Services → Library 中，搜索 YouTube Data API v3 并为该项目启用它。单独创建密钥并不能启用 API。
创建 API 密钥
打开 APIs & Services → Credentials，选择 Create credentials → API key，然后复制生成的密钥。限制其 API 访问 YouTube Data API v3。将密钥远离公共页面和源代码控制。
StreamBruh 从其服务器调用 Google，而不是从访问者的浏览器。网站或 HTTP 引用限制将阻止这些服务器请求。如果StreamBruh支持确认VPS有稳定的公共出口IP，您可以另外将密钥限制到该IP；否则保留 YouTube API 限制并监控使用情况。
将密钥保存在StreamBruh中
打开机器人和集成，将密钥粘贴到 YouTube API 密钥中，然后保存。保存的密钥被屏蔽。如果您想保留现有密钥，请在以后的编辑过程中将该字段留空。
选择搜索或频道
YouTube 搜索通知遵循与搜索词匹配的新公共视频；它的语言设置是相关性偏好而不是保证，并且以逗号分隔的阻止词排除包含这些术语的标题。通道通知接受 YouTube @handle 链接、通道 ID 链接、句柄或表单支持的通道 ID。
选择 Discord 目标通道，自定义消息并保存。检查按计划进行。搜索请求和通道检查以不同的速率消耗 YouTube API 配额；结果还取决于 YouTube 的可用性。
检查您的设置
- YouTube Data API v3 在与密钥相同的项目中启用。
- 密钥的 API 限制包括 YouTube Data API v3，其客户端限制允许 VPS。
- 频道链接解析或搜索配置保存，机器人可以发送到选定的 Discord 频道。
故障排除
API 密钥被拒绝
确认密钥属于所选项目，YouTube Data API v3已启用，并且其限制允许来自VPS的请求。浏览器引荐来源网址限制与服务器端调用不匹配。
配额已用完
查看 YouTube 数据 API 使用情况和 Google Cloud Console 中的配额。减少不必要的搜索或在符合条件的情况下通过 Google 请求配额延期；配额可用后重试。
没有发布视频
检查自上次检查以来新的公共视频是否与搜索或频道匹配，被阻止的单词是否排除了其标题，以及 Discord 频道是否仍然可发送。预定的检查不是即时的。