建立開發人員專案

建議您實作 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 的「首頁」上,按一下「成員」,系統會將您帶往 Google Cloud Console 的「IAM 與管理」>「IAM」頁面

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

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

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

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

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