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