開發人員專案 (包括 Matter 整合) 是在 Google Home Developer Console 中管理。本頁面說明如何在 Developer Console 上設定新的開發人員專案。
為專案命名
為專案命名時，建議採用符合下列條件的名稱：
- 納入專案的一些基本資訊。
- 不會與其他專案混淆。
- 可代表專案中的所有 integration。
有意義的名稱很重要。project-gamma-798 等一般名稱實際上是「偽裝」的，不會在其他一般名稱專案清單中脫穎而出。
命名專案時，請參考下列指引：
- 使用公司名稱
- 在名稱中使用專案或動作類型
- 專案名稱請勿使用「test」
例如，acme-smarthome 和 acme-lighting 是清楚且不重複的專案名稱。
建立專案
開發人員專案代表一或多項整合。擁有者只要與開發團隊成員共用專案，就能允許其他使用者管理專案中的所有整合項目。
Google 智慧住宅生態系統整合項目是透過 Developer Console 管理。
建議您只建立一個專案，用於所有 Matter 整合 (包括測試和正式環境)，特別是避免在使用測試供應商 ID 和 Matter 產品 ID 進行測試時發生問題。
方法 1：建立新專案
前往 Developer Console：
- 在「管理專案」頁面中，按一下「建立專案」。
- 在「Get started」(開始使用) 頁面，按一下「Create project」(建立專案)。
- 輸入專案名稱，請務必遵守專案命名規範。
- 按一下「Create new project」(建立新專案)。
系統會將您重新導向至新專案的「Home」(首頁) 頁面。
方法 2：從 Actions on Google 控制台匯入現有專案
如需在現有 Cloud-to-cloud 或 Local Home SDK 整合中加入 Matter 支援，可將現有 Actions on Google 專案匯入新的 Developer Console。
這個方法有以下限制：
- 這項匯入作業僅限單向。這項操作無法復原。
- 只有專案擁有者可以匯入現有的 Actions on Google 專案。擁有者是建立專案的人，可透過「Members」(成員) 連結查看。
- 匯入專案的公司資料只能在 Actions on Google 主控台中編輯。變更會反映在 Google Home 開發人員控制台中。
匯入後，原始 Actions on Google 專案仍可用於管理現有整合項目 (例如 Cloud-to-cloud、Local Home、App Discovery)。
如要從 Actions on Google Console 匯入現有專案，請前往 Developer Console：
- 按一下「建立專案」。
- 輸入現有的動作專案名稱，或從下拉式清單中選取專案 (例如，在下方螢幕截圖中，專案名稱為「My matter project」)。
- 按一下「匯入專案」。
系統會將您重新導向至 Developer Console 中的現有專案詳細資料。
設定記錄層級
根據預設，系統只會將錯誤記錄儲存至專案中各項整合的 Google Cloud。
如要將各項整合的所有記錄儲存至 Google Cloud，請在「Log level control: Error logs」(記錄層級控制：錯誤記錄) 部分選取「All logs」(所有記錄)。
這項設定會套用至專案中的「所有」整合項目。只有 Cloud-to-cloud 整合項目可以覆寫這項設定。如果記錄儲存空間超出上限，將所有記錄儲存至 Google Cloud 可能會產生額外費用。
如要進一步瞭解記錄，請參閱「Matter 的 Cloud Logging 」。
共用開發人員專案
您可以使用 預先定義的角色，新增或移除團隊成員的專案存取權。
在Developer Console的「Home」(首頁) 頁面上，按一下「Members」(成員)，系統會將您導向Google Cloud Console的「IAM & Admin」(IAM 與管理) >「IAM」(身分與存取權管理) 頁面。
或者，按一下「Project details」(專案詳細資料)，然後在底部的「Members」(成員) 區段中，點選「Manage members in GCP」(在 GCP 中管理成員)。
視需要使用 Google Cloud Console 資訊主頁進行變更。
如要瞭解如何修改專案存取權，請參閱「使用 IAM 控管專案的存取權」。
使用者加入清單後，即可在 Developer Console 中查看專案和任何整合項目。
根據組織設定，嘗試建立開發人員專案時，可能會發生權限錯誤。如果是，請與 Google Cloud 管理員聯絡，要求為帳戶授予專案建立者權限。