跳到主要内容

发布 GVA 云到云集成

认证并发布云到云集成​

当云到云集成创建并配置完成后，即可与该集成的开发者账号配合使用。这是用于创建并配置该集成的账号。在该集成处于开发阶段时，会自动对该账号开放测试，并且可以 与有限的一组测试用户共享。

要让该集成公开可用，需要先对其进行认证并发布。将集成与固件完成测试并确认其按预期工作后，即可提交认证。

本节介绍在 Google Home 开发者控制台 中对云到云集成进行认证和发布的步骤。

备注

Google 已将智能家居开发从 Google Actions 控制台迁移到 Google Home 开发者控制台。 Smart Home Actions 现称为 云到云集成，认证属于 Works with Google Home (WWGH) 计划的一部分，其认证流程可在新控制台的 Cloud-to-cloud > Certify 中进行管理。

前提条件​

在 OAuth 页面添加 Action 标志和授权声明​

为了通过认证，OAuth 页面必须包含以下授权声明：“登录即表示授权 Google 控制你的设备”。请按照以下步骤将该授权声明添加到 OAuth 页面。

  1. 准备一张带有 Action 标志和授权声明“登录代表你授权谷歌控制你的设备”的图片，例如：


  1. 登录页面将会如下所示：

  1. 登录 AWS 控制台。打开 Cognito 服务页面。如果出现 New console experience 选项，启用该选项。

  2. 点击 User Pools。

  3. 点击 rainmaker-user-email-mobile-pool。

  4. 在 App Integration 部分，向下滚动并选择 esp-rainmaker-google-action。

  5. 向下滚动到 Hosted UI customization。

  6. 在 UI customization 的 logo 字段上传图片。

  7. 向上滚动并点击 View Hosted UI，检查 OAuth 页面是否已包含该标志。

    Launch Hosted UI

10． 尝试使用 Google Home 应用为集成进行账号关联，并确保登录页面显示徽标和授权声明。

完善公司资料​

在提交集成以进行认证之前，需要先填写 公司资料。可从 Project home 打开，或者直接访问 https://console.home.google.com/projects/<project_id>/details（将 <project_id> 替换为项目 ID），并填写所有详细信息：

  • 公司信息 - Company name 和 Company website。此基本信息仅对 Google 可见。
  • 公司资产 - 上传一个 Company logo（192 x 192 px，JPG 或 PNG）。该 logo 将用于营销和推广页面，以及在启用了账号关联的集成中使用。
  • 隐私政策 —— 公司的隐私政策 URL。
  • 联系信息——总部 Address 和 Country，以及 Developer、Marketing 和 Business 联系人（每个联系人的姓名和邮箱）。

GVA Company Profile

GVA Company Profile Contact

注意

在提交认证申请之前，必须先完成并通过验证公司资料。审核期间，Google 支持团队可能会就这些细节提出疑问，因此请确保每个字段都填写正确——尤其是公司或产品 website 以及 contact 详细信息。最重要的是，此处提到的公司网站上也必须展示公司标志。

准备工作​

在提交集成进行认证之前，请准备好以下信息。

  • 用于集成的隐私政策和使用条款 URL。
  • 品牌名称——产品的品牌名称
  • 产品的购买链接
  • 简短描述——对集成的单行简介。
  • 完整描述——用户将看到的关于集成的描述。该描述应详细说明使用该集成可以完成什么。
  • 关键词——与该集成相关或用于描述该集成的简单搜索词。
  • 示例短语（支持语音命令的示例）
  • 集成的公开名称。
  • 一个测试账户（至少关联一个测试设备）
  • OAuth 页面——你的 OAuth 页面截图，当用户将账号关联到你的集成时可见。
  • 小型徽标（图标）——小型徽标的要求如下：
    • 圆形图标
    • 192 x 192 像素
    • 透明背景、PNG 格式
    • 白色图标需加上彩色边框
  • 横幅图片，以下为具体要求：
    • 1920 x 1080 像素
    • 透明背景、PNG 格式
  • 应用程序图标，以下为具体要求：
    • 圆形
    • 144 x 144 像素
    • 透明背景、PNG 格式
    • 白色图标需加上彩色边框
  • 联系信息——开发者姓名和邮箱。谷歌团队将使用这些信息，就你的集成的认证状态与你联系。
  • 开发者详细信息

获取测试结果​

  1. 保持测试设备或开发板为在线状态。
  2. 确保上述测试节点与测试用户相关联，并且测试用户已经在 Google Home 应用中完成了与 Action 的关联。
  3. 登录 Google Home 开发者控制台，打开项目，并前往 Cloud-to-cloud > Test。
  4. 在集成中点击 Test，输入测试名称，并选择要测试的设备。
  5. 点击 Next: Test plan，选择要运行的测试套件。
  6. 点击 Run Test。测试环境页面会显示测试执行的实时状态和日志。
  7. 完成测试套件需要一些时间。
  8. 测试套件完成后，确保没有任何 Failed 测试用例。
  9. 如果没有失败的测试用例，点击 Submit 提交认证所需的结果。也可以点击 Done 在测试历史页面查看本次运行。提交认证时需要提供测试套件结果 ID。
Home Graph 查看器

要在 Home Graph 中验证设备的实时状态，打开 Home Graph Viewer。使用与集成关联的 Google 账号登录，在 Project ID 字段中输入 Project ID，然后点击 Sync，即可列出所有设备及其当前状态。使用 Sync 按钮刷新设备状态。

提交以供认证​

1．在开发者控制台中，转到 Cloud-to-cloud > Certify。已完成先决条件的集成会显示在 Ready for certification review 下。

  1. 填写 Submit certification 页面中的所有部分，并上传所有所需信息，包括：
    • 验证信息 - 测试账号凭据（用户名、密码，若需要则提供 2FA PIN 码）、OAuth 页面截图、在市场上的产品链接，以及设备或 Google Home app 接收通知的视频（如适用）。
    • 文档 - 测试套件结果 ID，以及针对有安全影响的设备的 UL/CE 认证证书（或确认并无此类设备）。 3． 在认证提交过程中为常见必填问题添加答案：
    • Is this integration tied to a commercial product?（这个集成是否与商业产品绑定？） -> 是
    • Does your integration implement SCENE trait only?（你的集成是否仅实现场景特性？） -> 是
    • Type of Submission（提交类型）-> Cloud
    • Traits that require manual testing（需要人工测试的特性）-> 如果你的设备可以报告状态，请选择 "I have no traits that require manual testing"，否则请选择 "Command Only" otherwise.
    • Have you implemented Notifications to your devices, and requires certification（你的设备是否启用通知功能，并且需要认证？） -> 否
    • If you cannot implement notifications on compatible traits, please specify an ETA when it can be implemented.（如果你目前不支持通知兼容的特征，请预计可以启用该功能的时间。）-> 如果你的设备不是传感器，无需填写
    • Have you added app flip to your integration, and need that to be certified?（你是否已将 app flip 添加到集成中，并且需要对其进行认证？） -> 否。
    • If no, please specify an ETA if you have one.（若未启用，请预计可以启用的时间） -> 无需填写
    • UL Certificate -> 如果你的设备不是烹饪设备，无需上传
  2. 所有部分完成后，提交集成以供认证审核。
  3. 可以在 Cloud-to-cloud > Certify 中跟踪审核进度，其中会列出正在认证的集成。
  4. 当集成通过审核后，谷歌会将你的集成上线。已批准的集成每周发布一次。
  5. 通过认证后，即可获得 Works with Google Home (WWGH) 徽章的资格。前往 Partner Marketing Hub 获取用于设备的 WWGH 徽章素材。
  6. 你将收到来自谷歌认证团队的认证状态更新。

On this page