Google Photos
Google Photos 集成允许您使用 Home Assistant 将照片上传到您的 Google Photos
前提条件
您需要配置开发者凭据以允许 Home Assistant 访问您的 Google 帐户。 这些凭据与 Nest、Google Tasks 和 Google Mail 的凭据相同。 这些与以前为 Google Calendar 推荐的 设备授权 凭据不同。
如果您已经设置了正确的凭据,您可以执行步骤 1,然后跳到下面说明的步骤 13。
生成客户端 ID 和客户端密钥
本节解释了如何在 Google 开发者控制台
- 首先,访问 Google 开发者控制台以启用 Google Photos Library API
- 向导会要求您选择一个项目来管理您的应用程序。选择一个项目并点击 继续。
- 验证您的 Google Photos Library API 是否已启用,并选择 转到凭据。
- 导航到 API 和服务(左侧边栏)> 凭据
。 - 点击屏幕左侧的字段,OAuth 同意屏幕。
- 选择 外部 并点击 创建。
- 将 应用名称(请求同意的应用程序名称)设置为您想要的任何名称,例如 Home Assistant。
- 然后,您需要选择 支持电子邮件。为此,从下拉菜单中选择您的电子邮件地址。
- 最后,您需要填写部分内容:开发者联系信息。为此,输入您的电子邮件地址(上面的地址也是可以的)。
- 滚动到底部并选择 保存并继续。您不需要填写其他任何内容,否则可能会启用额外审核。
- 然后,您将自动转到 范围 页面。您不需要在此处添加任何范围,因此选择 保存并继续 移动到 可选信息 页面。您不需要在 可选信息 页面添加任何内容,因此选择 保存并继续,这将带您到 摘要 页面。选择 返回仪表板。
- 再次选择 OAuth 同意屏幕 并将 发布状态 设置为 生产中。否则,您的凭证每 7 天将过期。
- 确保 发布状态 设置为生产中。
- 在屏幕左侧菜单中选择 凭据,然后选择 创建凭据(在屏幕顶部),然后选择 OAuth 客户端 ID。
- 将应用类型设置为 Web 应用程序,为此凭证集命名(如 “Home Assistant Credentials”)。
- 将
https://my.home-assistant.io/redirect/oauth
添加到 授权重定向 URI 然后选择 创建。这不是占位符,必须使用此 URI。 - 然后,您将看到一个弹出窗口,显示 OAuth 客户端创建,并展示 您的客户端 ID 和 您的客户端密钥。请记下这些(例如,将它们复制并粘贴到文本编辑器中),因为您稍后需要它们。记下这些字符串后,选择 确定。如果您在任何时候需要再次找到这些凭据,请导航到 API 和服务 > 凭据,您会在 OAuth 2.0 客户端 ID 下看到 Home Assistant Credentials(或您在前一步中命名的任何名称)。要查看 客户端 ID 和 客户端密钥,请选择铅笔图标。这将带您到这些凭据的设置页面,信息将显示在页面右侧。
- 请双重检查 Google Photos Library API 是否已自动启用。为此,从菜单中选择 库,然后搜索 Google Photos Library API。如果它已启用,您将看到 API 已启用,旁边有一个绿色勾号。如果未启用,则启用它。
配置
要将 Google Photos integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:
手动配置步骤
如果上述 My 按钮不起作用,您也可以手动执行以下步骤:
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角,选择
Add Integration 按钮。 -
从列表中选择 Google Photos。
-
按照屏幕上的说明完成设置。
接下来的集成设置将给您提供输入 应用凭据(OAuth 客户端 ID 和客户端密钥)的说明,并授权 Home Assistant 访问您的 Google Photos。
OAuth 和设备授权步骤
-
持续处理您想要授权的帐户选择步骤。
-
注意:您可能会收到一条消息,告诉您该应用尚未经过验证,您需要确认才能继续。
-
您现在可以看到您授权 Home Assistant 访问的详细信息,并在底部有两个选项。选择 继续。请记住,这将敏感地访问您的私人照片库。
-
页面现在将显示 将帐户链接到 Home Assistant?,请注意 您的实例 URL。如果这不正确,请参考 我的 Home Assistant。如果一切正常,请选择 链接帐户。
-
您可以关闭窗口,返回到 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 |
故障排除
如果您的凭据有错误,您可以在 应用凭据 用户界面中删除它们。