Matter 統合を含むデベロッパー プロジェクトは、Google Home Developer Console で管理されます。このページでは、Developer Console で新しいデベロッパー プロジェクトを設定する方法について説明します。
制限事項
プロジェクトに名前を付ける
プロジェクトに名前を付けるときは、次のような名前を付けることをおすすめします。
- プロジェクトに関する基本情報が組み込まれています。
- 他のプロジェクトの ID と簡単に混同されない。
- プロジェクト内のすべての integrationを表すことができます。
わかりやすい名前を付けることが重要です。project-gamma-798 などの一般的な名前は効果的に「カモフラージュ」され、他の一般的な名前のプロジェクトのリストに目立つことはありません。
プロジェクトに名前を付ける際は、次のガイダンスを考慮してください。
- 会社名を使用する
- プロジェクトまたはアクションの種類を名前に含める
- プロジェクト名に「test」を使用しないでください
たとえば、acme-smarthome と acme-lighting は明確で一意のプロジェクト名です。
プロジェクトを作成する
デベロッパー プロジェクトは、1 つ以上の統合を表します。プロジェクトを開発チームのメンバーと共有することで、オーナーは他のユーザーにプロジェクト内のすべての統合を管理させることができます。
Google スマートホーム エコシステムの統合は、Developer Console を使用して管理されます。
特に、Matter のテストベンダー ID とプロダクト ID でテストする際に問題が発生しないように、テスト環境と本番環境の両方で、すべての Matter 統合に 1 つのプロジェクトのみを作成することをおすすめします。
方法 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 コンソールのみです。変更は Google Home デベロッパー コンソールに反映されます。
インポート後も、元の Actions on Google プロジェクトを使用して、既存の統合（Cloud-to-cloud、Local Home、App Discovery など）を管理できます。
Actions on Google Console から既存のプロジェクトをインポートするには、Developer Console に移動します。
- [プロジェクトを作成] をクリックします。
- 既存の Actions プロジェクト名を入力するか、プルダウン リストからプロジェクトを選択します（次のスクリーンショットでは、プロジェクト名は「My matter project」です）。
- [Import 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 管理者に連絡し、アカウントのプロジェクト作成者の権限をリクエストしてください。