在创建 Cloud-to-cloud项目之前,我们建议先实现 OAuth 2.0 服务器。
开发者项目(包括 Cloud-to-cloud 集成)在 Google Home Developer Console 上进行管理。本页介绍了如何在 Developer Console上设置新的开发者项目。
为项目命名
为项目命名时,最好采用以下命名方式:
- 包含一些关于项目的基本信息。
- 不会与其他项目的名称混淆。
- 可以代表项目中的所有内容。 integration
有意义的名称非常重要。如果采用通用名称(例如 project-gamma-798),则该名称实际上会被“隐藏”,并且在其他采用通用名称的项目列表中不会突出显示。
为项目命名时,请考虑以下指南:
- 使用公司名称
- 在名称中使用项目或操作的类型
- 请勿在项目名称中使用“test”
例如,acme-smarthome 和 acme-lighting 是清晰且唯一的项目名称。
创建项目
开发者项目代表一个或多个 集成,其中只能有一个Cloud-to-cloud 集成。通过与开发团队成员共享项目,项目所有者可以允许其他用户管理项目中的所有集成。
Google 智能家居生态系统集成使用 Developer Console进行管理。
方法 1:创建新项目
前往Developer Console:
- 在管理项目 页面上,点击创建项目 。
- 在开始使用 页面上,点击创建项目 。
- 输入项目的名称,该名称应遵循项目命名 指南。
- 点击创建新项目 。
系统会将您重定向回新项目的首页 。
方法 2:从 Actions on Google 控制台导入现有项目
现有的 Actions on Google 项目可以导入到新的 Developer Console 中,如果您需要为现有的 Cloud-to-cloud 或 Local Home SDK 集成添加 Matter 支持。
此方法有以下限制:
- 此导入是单向的,无法撤消。
- 只有项目所有者才能导入现有的 Actions on Google 项目。所有者是指创建项目的人员,您可以使用 “成员”链接查看该人员。
- 导入项目的公司资料只能在 Actions on Google 控制台 中进行修改。在 Actions on Google 控制中所做的更改将反映在 Google Home 开发者 控制台中。
导入后,您仍然可以使用原始的 Actions on Google 项目 来管理现有集成(例如Cloud-to-cloud、 Local Home、App Discovery)。
如需从 Actions on Google Console 导入现有项目,请前往 Developer Console:
- 点击创建项目 。
- 输入现有 Actions 项目名称,或从下拉列表中选择一个项目(例如,在以下屏幕截图中,项目名称为“My matter project”)。
- 点击导入项目 。
系统会将您重定向回现有项目详情中 Developer Console。
设置日志级别
默认情况下,系统只会将项目中的每个 集成的错误日志保存到 Google Cloud。
如需将每个集成的所有日志保存到 Google Cloud,请在 日志级别控制:错误日志 部分中选择 所有 日志。
此设置适用于项目中的所有集成。 它只能针对 Cloud-to-cloud 集成进行替换。将所有日志保存到 Google Cloud 如果超出日志存储空间,可能会产生额外 费用。
如需详细了解日志,请参阅Cloud logging for Cloud-to-cloud 。
共享开发者项目
您可以使用 预定义角色,在团队中的用户之间添加或移除对项目的访问权限。
在 Developer Console 的 首页 上,点击 成员,系统会将您转到 Google Cloud Console 上的 IAM 和管理 > IAM 页面 。
或者,点击项目详情 ,然后在底部的 成员 部分中点击在 GCP 中管理成员 。
使用 Google Cloud Console 信息中心根据需要进行更改。
如需了解如何修改对项目的访问权限,请参阅 使用 IAM 对项目进行访问权限控制。
添加到用户列表后,用户可以在Developer Console中查看项目和任何 集成。
根据您的组织设置,您在尝试创建开发者项目时可能会遇到权限错误。如果遇到这种情况,请与您的 Google Cloud管理员联系,并请求为您的账号授予 Project Creator 权限。