Matter 統合を含むデベロッパー プロジェクトは、Google Home Developer Console で管理されます。このページでは、Developer Console で新しいデベロッパー プロジェクトを設定する方法について説明します。
プロジェクトに名前を付ける
プロジェクトに名前を付ける際は、次のような名前を作成することをおすすめします。
- プロジェクトに関する基本情報が含まれています。
- 別のプロジェクトの ID と混同されることがない。
- プロジェクト内のすべての integrationを表すことができます。
わかりやすい名前を付けることが重要です。project-gamma-798 などの一般的な名前は、事実上「カモフラージュ」され、他の一般的な名前のプロジェクトのリストで目立つことはありません。
プロジェクトに名前を付ける際は、次のガイダンスを考慮してください。
- 会社名を使用する
- プロジェクトまたはアクションのタイプを名前に使用する
- プロジェクト名に「test」を使用しないでください
たとえば、acme-smarthome と acme-lighting は明確で一意のプロジェクト名です。
プロジェクトを作成する
デベロッパー プロジェクトは、1 つ以上の統合を表します。プロジェクトを開発チームのメンバーと共有することで、オーナーは他のユーザーにプロジェクト内のすべての統合の管理を許可できます。
Google スマートホーム エコシステムの統合は、Developer Console を使用して管理されます。
テストと本番環境の両方で、すべての Matter 統合用に 1 つのプロジェクトのみを作成することをおすすめします。特に、Matter のテスト ベンダー ID と商品 ID を使用してテストする際の問題を回避するためです。
方法 1: 新しいプロジェクトを作成する
Developer Console に移動します。
- [プロジェクトの管理] ページで、[プロジェクトを作成] をクリックします。
- [開始] ページで、[プロジェクトを作成] をクリックします。
- プロジェクトの名前を入力します。この名前は、プロジェクト命名ガイドラインに準拠している必要があります。
- [新しいプロジェクトを作成] をクリックします。
新しいプロジェクトの [ホーム] ページにリダイレクトされます。
方法 2: Actions on Google コンソールから既存のプロジェクトをインポートする
既存の Cloud-to-cloud または Local Home SDK 統合に Matter サポートを追加する必要がある場合は、既存の Actions on Google プロジェクトを新しい Developer Console にインポートできます。
このメソッドには次の制限が適用されます。
- このインポートは一方向のみです。この操作は元に戻せません。
- 既存の Actions on Google プロジェクトをインポートできるのは、プロジェクト オーナーのみです。オーナーはプロジェクトを作成したユーザーです。メンバーリンクを使用して表示できます。
- インポートしたプロジェクトの企業プロフィールは、Actions on Google Console でのみ編集できます。ここでの変更は Google Home Developer Console に反映されます。
インポート後も、元の Actions on Google プロジェクトを使用して、既存の統合（Cloud-to-cloud、Local Home、App Discovery など）を管理できます。
Actions on Google Console から既存のプロジェクトをインポートするには、Developer Console に移動します。
- [プロジェクトを作成] をクリックします。
- 既存の Actions プロジェクト名を入力するか、プルダウン リストからプロジェクトを選択します（たとえば、次のスクリーンショットでは、プロジェクト名は「My matter project」です）。
- [プロジェクトをインポート] をクリックします。
Developer Console の既存のプロジェクトの詳細にリダイレクトされます。
ログレベルを設定する
デフォルトでは、プロジェクト内の各統合のエラーログのみが Google Cloud に保存されます。
各統合のすべてのログを Google Cloud に保存するには、[ログレベルの制御: エラーログ] セクションで [すべてのログ] を選択します。
この設定は、プロジェクト内のすべての統合に適用されます。これは、Cloud-to-cloud 統合でのみオーバーライドできます。すべてのログを Google Cloud に保存すると、ログ ストレージ容量を超えた場合に追加費用が発生する可能性があります。
ログの詳細については、Matter の Cloud Logging をご覧ください。
デベロッパー プロジェクトを共有する
事前定義ロールを使用して、チームのユーザーにプロジェクトへのアクセス権を追加または削除できます。
Developer Console の [ホーム] ページで、[メンバー] をクリックします。Google Cloud Console の [IAM と管理] > [IAM] ページに移動します。
または、[プロジェクトの詳細] をクリックし、下部の [メンバー] セクションで [GCP でメンバーを管理] をクリックします。
必要に応じて、Google Cloud Console ダッシュボードを使用して変更を加えます。
プロジェクトへのアクセスを変更する手順については、IAM を使用したプロジェクトのアクセス制御をご覧ください。
ユーザーのリストに追加されると、ユーザーは Developer Console でプロジェクトと統合を表示できます。
組織の設定によっては、デベロッパー プロジェクトを作成しようとすると権限エラーが発生することがあります。その場合は、Google Cloud 管理者に連絡して、アカウントにプロジェクト作成者の権限をリクエストしてください。