建立開發人員專案

我們建議您實作 OAuth 2.0 伺服器 建立 Cloud-to-cloud 專案。

開發人員專案 (包括 Cloud-to-cloud 整合) 是在 Google Home Developer Console 上管理。本頁說明如何在 Developer Console 上設定新的開發人員專案。

為專案命名

為專案命名時,建議使用以下名稱:

  • 包含專案的一些基本資訊。
  • 不會與其他專案的名稱混淆。
  • 可代表專案中的所有 integration。

有意義的名稱非常重要。如果使用「project-gamma-798」等一般名稱,專案就會「隱形」,在其他一般名稱專案的清單中不會特別顯眼。

為專案命名時,請參考下列指引:

  • 使用貴公司名稱
  • 在名稱中使用專案或動作類型
  • 專案名稱中請勿使用「測試」

舉例來說,acme-smarthomeacme-lighting 是清楚且不重複的專案名稱。

建立專案

開發人員專案代表一或多項整合,但只能有一項 Cloud-to-cloud 整合。專案擁有者可以與開發團隊成員共用專案,允許其他使用者管理專案中的所有整合。

Google 智慧住宅生態系統整合功能是透過 Developer Console 管理。

方法 1:建立新專案

前往 Developer Console

前往開發人員控制台

  1. 在「管理專案」頁面中,按一下「建立專案」
  2. 在「開始使用」頁面中,按一下「建立專案」
  3. 輸入專案名稱,並遵守專案命名規範
  4. 按一下「建立新專案」

系統會將您重新導向回新專案的「首頁」頁面。

方法 2:從 Actions on Google 控制台匯入現有專案

如果需要將 Matter 支援功能新增至現有的 Cloud-to-cloudLocal Home SDK 整合,現有的 Actions on Google 專案可以匯入新的 Developer Console

這個方法有下列限制:

  • 這項匯入作業僅為單向,請注意,這項操作無法復原。
  • 只有專案擁有者可以匯入現有專案。Actions on Google擁有者是專案建立者,可透過「成員」連結查看。
  • 匯入專案的公司簡介只能在 Actions on Google 控制台中編輯。Google Home 開發人員控制台會反映您在該處所做的變更。

匯入後,您仍可使用原始 Actions on Google 專案管理現有整合項目 (例如 Cloud-to-cloudLocal HomeApp Discovery)。

如要從 Actions on Google Console 匯入現有專案,請前往 Developer Console

前往開發人員控制台

  1. 按一下「建立專案」
  2. 輸入現有的 Actions 專案名稱,或從下拉式清單中選取專案 (例如在以下螢幕截圖中,專案名稱為「My matter project」)。
  3. 按一下「匯入專案」

系統會將您重新導向至 Developer Console 中的現有專案詳細資料。

Google Home 開發人員中心入門指南

設定記錄層級

根據預設,系統只會將每個專案整合的錯誤記錄檔儲存至 Google Cloud

如要將每個整合的所有記錄儲存至 Google Cloud,請在「記錄層級控制:錯誤記錄」部分選取「所有記錄」

Google Home 開發人員中心專案記錄層級

這項設定會套用至專案中的所有整合。只能針對Cloud-to-cloud整合覆寫這項設定。如果儲存空間用量超出上限,將所有記錄檔儲存至 Google Cloud 可能會產生額外費用。

如要進一步瞭解記錄,請參閱 Cloud Logging for Cloud-to-cloud

共用開發人員專案

您可以透過 預先定義的角色,在團隊使用者之間新增或移除專案存取權。

  1. Developer Console 的「首頁」點選「成員」,即可前往「IAM 與管理」>「IAM」頁面 Google Cloud Console

    或者,按一下「專案詳細資料」,然後點選底部的「成員」部分中的「在 GCP 中管理成員」

  2. 使用資訊主頁視需要進行變更。Google Cloud Console

如需修改專案存取權的操作說明,請參閱「使用 IAM 控管專案的存取權」。

加入使用者名單後,使用者就能在 Developer Console 中查看專案和任何整合項目。

根據機構設定,嘗試建立開發人員專案時,您可能會遇到權限錯誤。如果是,請與Google Cloud管理員聯絡,要求為您的帳戶授予專案建立者權限