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