建立開發人員專案

建議您實作 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 控制台匯入現有專案

如要為現有的 Cloud-to-cloudLocal Home SDK 整合功能新增 Matter 支援,可以將現有的 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 Developer Center 專案記錄層級

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

如要進一步瞭解記錄,請參閱「Cloud logging for Cloud-to-cloud 」。

共用開發人員專案

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

  1. Developer Console 的「首頁」上,按一下「成員」,系統會將您帶往「IAM 與管理」>「身分與存取權管理」頁面 Google Cloud Console

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

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

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

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

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