Google Photos

Google Photos 集成允许您使用 Home Assistant 将照片上传到您的 Google Photos。该集成添加了一个上传照片的操作和一个 媒体源,以查看或投放由 Home Assistant 上传的内容。此集成不会使 Home Assistant 访问您整个的 Google Photos 库。

前提条件

您需要配置开发者凭据以允许 Home Assistant 访问您的 Google 帐户。 这些凭据与 NestGoogle TasksGoogle Mail 的凭据相同。 这些与以前为 Google Calendar 推荐的 设备授权 凭据不同。

如果您已经设置了正确的凭据,您可以执行步骤 1,然后跳到下面说明的步骤 13。

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

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

  1. 首先,访问 Google 开发者控制台以启用 Google Photos Library API
  2. 向导会要求您选择一个项目来管理您的应用程序。选择一个项目并点击 继续
  3. 验证您的 Google Photos Library API 是否已启用,并选择 转到凭据
  4. 导航到 API 和服务(左侧边栏)> 凭据
  5. 点击屏幕左侧的字段,OAuth 同意屏幕
  6. 选择 外部 并点击 创建
  7. 应用名称(请求同意的应用程序名称)设置为您想要的任何名称,例如 Home Assistant
  8. 然后,您需要选择 支持电子邮件。为此,从下拉菜单中选择您的电子邮件地址。
  9. 最后,您需要填写部分内容:开发者联系信息。为此,输入您的电子邮件地址(上面的地址也是可以的)。
  10. 滚动到底部并选择 保存并继续。您不需要填写其他任何内容,否则可能会启用额外审核。
  11. 然后,您将自动转到 范围 页面。您不需要在此处添加任何范围,因此选择 保存并继续 移动到 可选信息 页面。您不需要在 可选信息 页面添加任何内容,因此选择 保存并继续,这将带您到 摘要 页面。选择 返回仪表板
  12. 再次选择 OAuth 同意屏幕 并将 发布状态 设置为 生产中。否则,您的凭证每 7 天将过期。
  13. 确保 发布状态 设置为生产中。
  14. 在屏幕左侧菜单中选择 凭据,然后选择 创建凭据(在屏幕顶部),然后选择 OAuth 客户端 ID
  15. 将应用类型设置为 Web 应用程序,为此凭证集命名(如 “Home Assistant Credentials”)。
  16. https://my.home-assistant.io/redirect/oauth 添加到 授权重定向 URI 然后选择 创建。这不是占位符,必须使用此 URI。
  17. 然后,您将看到一个弹出窗口,显示 OAuth 客户端创建,并展示 您的客户端 ID您的客户端密钥。请记下这些(例如,将它们复制并粘贴到文本编辑器中),因为您稍后需要它们。记下这些字符串后,选择 确定。如果您在任何时候需要再次找到这些凭据,请导航到 API 和服务 > 凭据,您会在 OAuth 2.0 客户端 ID 下看到 Home Assistant Credentials(或您在前一步中命名的任何名称)。要查看 客户端 ID客户端密钥,请选择铅笔图标。这将带您到这些凭据的设置页面,信息将显示在页面右侧。
  18. 请双重检查 Google Photos Library API 是否已自动启用。为此,从菜单中选择 ,然后搜索 Google Photos Library API。如果它已启用,您将看到 API 已启用,旁边有一个绿色勾号。如果未启用,则启用它。

配置

要将 Google Photos integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

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

接下来的集成设置将给您提供输入 应用凭据(OAuth 客户端 ID 和客户端密钥)的说明,并授权 Home Assistant 访问您的 Google Photos。

OAuth 和设备授权步骤
  1. 持续处理您想要授权的帐户选择步骤。

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

  3. 您现在可以看到您授权 Home Assistant 访问的详细信息,并在底部有两个选项。选择 继续。请记住,这将敏感地访问您的私人照片库。

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

  5. 您可以关闭窗口,返回到 Home Assistant,您应该看到来自 Home Assistant 的 成功! 消息。

操作 google_photos.upload

您可以使用 google_photos.upload 操作从 Home Assistant 上传照片到 Google Photos。

上传操作详细信息
数据属性 可选 描述 示例
filename 要上传的图像路径。 /mnt/image.jpg
album 上传内容的目标相册名称。 伦敦度假
config_entry_id Google Photos 配置条目的 ID。 a1bee602deade2b09bc522749bbce48e

故障排除

如果您的凭据有错误,您可以在 应用凭据 用户界面中删除它们。