Matter 統合を含むデベロッパー プロジェクトは、 Google Home Developer Console で管理されます。このページでは、Developer Consoleで 新しいデベロッパー プロジェクトを設定する方法について説明します。
プロジェクトに名前を付ける
プロジェクトに名前を付ける際は、次の点に注意してください。
- プロジェクトに関する基本的な情報を含める。
- 別のプロジェクトの名前と混同しないようにする。
- プロジェクト内のすべての 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 コンソールから既存のプロジェクトをインポートする
既存の Actions on Google プロジェクトは、既存の Cloud-to-cloud または Local Home SDK 統合に Matter サポートを追加する必要がある場合は、新しい Developer Console にインポートできます。
この方法には次の制限があります。
- このインポートは一方向のみです。元に戻すことはできません。
- 既存の Actions on Google プロジェクトをインポートできるのは、プロジェクト オーナーのみです。オーナーはプロジェクトを作成したユーザーであり、 [メンバー] リンクで確認できます。
- インポートされたプロジェクトの会社プロフィールは、 Actions on Google コンソールでのみ編集できます。変更は 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 に保存するには、[All logs] セクションで [Log level control: Error logs] を選択します。
この設定は、プロジェクト内のすべての統合に適用されます。 Cloud-to-cloud 統合でのみオーバーライドできます。ログの保存容量を超過すると、すべてのログを Google Cloud に保存すると追加 費用が発生する可能性があります。
ログの詳細については、 Cloud Logging for Matter をご覧ください。
デベロッパー プロジェクトを共有する
事前定義されたロールを使用して、チームのユーザー間でプロジェクトへのアクセス権を追加または削除できます。
Developer Console の [ホーム] ページで [メンバー] をクリックすると、Google Cloud Console の [IAM と管理] > [IAM] ページに移動します。
または、[プロジェクトの詳細] をクリックし、[GCP でメンバーを管理] を [メンバー] セクションの下部でクリックします。
Google Cloud Console ダッシュボードを使用して、必要に応じて変更します。
プロジェクトへのアクセス権を変更する手順については、 IAM を使用したプロジェクトのアクセス制御をご覧ください。
ユーザーのリストに追加されると、ユーザーは Developer Console でプロジェクトと 統合を表示できます。
組織の設定によっては、デベロッパー プロジェクトを作成しようとすると権限エラーが発生する場合があります。その場合は、 Google Cloud管理者に連絡して、 プロジェクト作成者の権限をアカウントにリクエストしてください。