2025.3.4
首页 ▸ Integrations ▸

YouTube

The YouTube integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] allows you to connect YouTube channels to Home Assistant. For every channel you add, it will create sensors for:

  • Views count
  • Subscriber count
  • The latest uploaded video

Prerequisites

To be able to configure the integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more], you need to have a YouTube channel. To learn how to create one, refer to the YouTube documentation.

You need to configure developer credentials to allow Home Assistant to access your Google Account. These credentials are the same as the ones for Nest, Google Mail and Google Sheets. These are not the same as the one for Google Calendar.

情景 1：您已经拥有凭据

在这种情况下，您需要做的就是启用 API：

  1. 转到 Google 开发者控制台 YouTube Data API v3 。
  2. 确认项目并 启用 API。
  3. 按照 配置 部分中描述的步骤继续进行。

情景 2：您尚未设置凭据

在这种情况下，您需要先生成一个客户端密钥：

生成客户端 ID 和客户端密钥

本节说明如何在 Google 开发者控制台 上生成客户端 ID 和客户端密钥。

  1. 首先，转到 Google 开发者控制台以启用 YouTube Data API v3 。
  2. 选择 创建项目，输入项目名称并选择 创建。
  3. 启用 YouTube Data API v3。
  4. 导航到 API 和服务（左侧边栏） > 凭据。
  5. 在左侧边栏，选择 OAuth 同意屏幕。
    • 选择 外部 并 创建。
    • 将 应用名称（请求同意的应用程序名称）设置为您想要的任何名称，例如 Home Assistant。
  6. 您需要选择一个 支持电子邮件。
    • 从下拉菜单中选择您的电子邮件地址。
  7. 在 开发者联系信息 下，输入您的电子邮件地址（可以与上面的相同）。
  8. 向下滚动并选择 保存并继续。
    • 您不需要在这里填写其他任何内容。添加此页面的其他信息（如应用标志）可能会触发 Google 的额外审核过程，并导致设置延迟几天。
  9. 然后，您将自动进入 范围 页面。
    • 您不需要在此处添加任何范围。选择 保存并继续 以移至 测试用户 页面。
    • 您不需要在 测试用户 页面添加任何内容。选择 保存并继续，这将带您到 摘要 页面。
    • 选择 返回仪表板。
  10. 重新选择 OAuth 同意屏幕 并在 发布状态 下选择 发布应用。
    • 否则您的凭据将每7天到期。
  11. 确保 发布状态 设置为 在生产中。
  12. 在左侧边栏中，选择 凭据，然后选择 创建凭据（在屏幕顶部），再选择 OAuth 客户端 ID。
  13. 将 应用程序类型 设置为 Web 应用程序，并给这个凭据集命名（例如 “Home Assistant Credentials”）。
  14. 将 https://my.home-assistant.io/redirect/oauth 添加到 授权重定向 URI 中，然后选择 创建。
    • 这不是占位符。它是必须使用的 URI。
  15. 然后，您将看到一个弹出窗口，显示 OAuth 客户端已创建，显示 您的客户端 ID 和 您的客户端密钥。
    • 请记下这些（例如，将其复制并粘贴到文本编辑器中），因为您稍后需要它们。
    • 记下这些字符串后，选择 确定。
    • 如果您在任何时候需要再次查找这些凭据，请导航到 API 和服务 > 凭据，您将在 OAuth 2.0 客户端 ID 下看到 Home Assistant Credentials（或您在上一步中命名的任何名称）。
    • 要查看 客户端 ID 和 客户端密钥，请选择铅笔图标。这将带您进入这些凭据的设置页面，信息将在页面右侧显示。
  16. 恭喜您！您现在是客户端密钥的保管者。将其保存在您的宝藏箱中。在大多数情况下，您的新凭据将在几分钟内激活。然而，Google 表示在某些情况下激活可能需要多达五小时。

配置

要将 YouTube service 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

集成设置将接下来给您提供进入 应用凭证（OAuth 客户端 ID 和客户端密钥）的说明，并授权 Home Assistant 连接到 YouTube。

OAuth 和设备授权步骤

  1. 继续执行选择您想要授权的帐户的步骤。

  2. 注意：您可能会收到一条消息，告知您该应用尚未经过验证，您需要确认才能继续。

  3. 现在您可以看到您授权 Home Assistant 访问的详细信息，底部有两个选项。选择 继续。

  4. 页面现在将显示 将账户链接到 Home Assistant 吗？，请注意 您的实例 URL。如果不正确，请参考 我的 Home Assistant。如果一切正常，请选择 链接账户。

  5. 您可以关闭窗口，然后返回 Home Assistant，在那里您应该会看到来自 Home Assistant 的 成功！ 消息。