Matter 統合を含むデベロッパー プロジェクトは、新しい Google Home Developer Console で管理されます。このページでは、Developer Console に新しいデベロッパー プロジェクトをセットアップする方法について説明します。
制限
Cloud-to-cloud または Local Home SDK 機能を Developer Console のプロジェクトに追加することはできません。Matter 機能を既存の Cloud-to-cloud または Local Home の統合に追加する場合は、まず既存の Actions on Google プロジェクトをインポートする必要があります。
プロジェクトに名前を付ける
プロジェクトに名前を付けるときは、次のような名前を使用することをおすすめします。
- プロジェクトに関する基本情報が含まれている。
- 他のプロジェクトと簡単に混同されることはありません。
- プロジェクト内のすべての統合を表します。
project-gamma-798 のような汎用名は簡単に思いつくことができますが、このような名前は実質的に「カモフラージュ」され、他の一般的な名前のプロジェクトのリストの中で目立たなくなります。
わかりやすいプロジェクト名にするため、プロジェクトに名前を付ける際は、次のガイダンスを参考にしてください。
- 会社名を使用してください
- 名前にプロジェクトやアクションのタイプを使用する
- プロジェクト名に「test」を使用しないでください。
たとえば、acme-smarthome や acme-lighting は明確で一意なプロジェクト名です。
プロジェクトを作成する
デベロッパー プロジェクトは、1 つ以上の統合を表します。開発チームのメンバーとプロジェクトを共有することで、オーナーは他のユーザーがプロジェクト内のすべての統合を管理できるように設定できます。
Google スマートホーム エコシステムの統合は、新しい Developer Console を使用して管理されます。Developer Console にプロジェクトを設定するには、次の 2 つの方法があります。
すべての統合（テストと本番環境の両方）に対して 1 つのプロジェクトのみを作成することをおすすめします。特に、Matter のテストベンダー ID とプロダクト ID を使用してテストする際の問題を回避するためです。
方法 1: 新しいプロジェクトを作成する
Developer Console に移動します。
- [プロジェクトの管理] ページで、[プロジェクトを作成] をクリックします。
- [スタートガイド] ページで [プロジェクトを作成] をクリックします。
- プロジェクトの名前を入力します。プロジェクトの命名ガイドラインを遵守する必要があります。
- [新しいプロジェクトを作成] をクリックします。
新しいプロジェクトの [ホーム] ページにリダイレクトされます。
方法 2: Actions on Google コンソールから既存のプロジェクトをインポートする
既存の Cloud-to-cloud または Local Home の統合に Matter のサポートを追加する場合は、既存の 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 に移動します。
- [プロジェクトを作成] をクリックします。
- 既存の Actions プロジェクト名を入力するか、プルダウン リストからプロジェクトを選択します（たとえば、以下のスクリーンショットでは、プロジェクト名は「MyMatter project」です）。
- [プロジェクトをインポート] をクリックします。
Developer Console の既存のプロジェクトの詳細にリダイレクトされます。
ログレベルの設定
デフォルトでは、プロジェクト内の統合ごとにエラーログのみが Google Cloud に保存されます。
統合ごとにすべてのログを Google Cloud に保存するには、[ログレベルの管理: エラーログ] セクションで [すべてのログ] を選択します。
この設定は、プロジェクト内のすべての統合に適用されます。統合ごとに設定することはできません。ログのストレージ容量を超過している場合、すべてのログを Google Cloud に保存すると追加費用が発生する場合があります。
ログの詳細については、Matter 向け Cloud Logging をご覧ください。
デベロッパー プロジェクトを共有する
事前定義ロールを使用して、チームのユーザーの間でプロジェクトへのアクセス権を追加または削除することができます。
Developer Console の [ホーム] ページで [メンバー] をクリックします。これにより、Google Cloud Console の [IAM と管理] > [IAM] ページに移動します。
または、[プロジェクトの詳細] をクリックし、下部の [メンバー] セクションの [GCP でメンバーを管理] をクリックします。
必要に応じて、Google Cloud Console ダッシュボードを使用して変更します。
プロジェクトへのアクセス権を変更する方法については、アクセス制御の Google Cloud ドキュメントをご覧ください。
ユーザーのリストに追加されたユーザーは、Developer Console でプロジェクトと統合を表示できます。