Heads up! New Developer Preview programs are rolling out soon. Apply here and be one of the first to try new tools and provide feedback.

Create a developer project

Developer projects, which include Matter integrations, are managed on the new Google Home Developer Console. This page explains how to set up a new developer project on the Developer Console.

Restrictions

The Developer Console is in Developer Preview. All major Matter features are available for use, as outlined in the Developer checklist.

Cloud-to-cloud or Local Home SDK functionality cannot be added to a project in the Developer Console. If you wish to add Matter functionality to an existing Cloud-to-cloud or Local Home integration, you must import an existing Actions on Google project first.

Name the project

When naming your project, it's good practice to compose a name that:

  • Incorporates some basic information about the project.
  • Won't be easily confused with that of another project.
  • Can represent all the integrations within the project.

While it's easy to come up with a generic name such as project-gamma-798, such a name is effectively "camouflaged" and won't stand out in a list of other generically-named projects.

In order to ensure a meaningful and distinct project name, consider this guidance when naming your project:

  • Use your company name
  • Use the type of project or action in the name
  • Do not use "test" in the project name

For example, acme-smarthome or acme-lighting are clear and unique project names.

Create the project

A developer project represents one or more integrations. By sharing a project with the members of their development team, the owner can allow other users to manage all integrations in the project.

Google Smart Home Ecosystem integrations are managed using the new Developer Console. There are two methods of setting up projects in the Developer Console:

  1. Create a new project.
  2. Import an existing project from the Actions on Google console.

We recommend creating only one project for all your integrations, both testing and production, particularly to avoid issues when testing with test Vendor IDs and Product IDs for Matter.

Method 1: Create a new project

Go to the Developer Console:

Go to the Developer Console

  1. On the Manage projects page, click Create a project.
  2. On the Get started page, click Create project.
  3. Enter the name of your project, which should adhere to the project naming guidelines.
  4. Click Create new project.

You are redirected back to the Home page for the new project.

Method 2: Import an existing project from the Actions on Google console

An existing Actions on Google project may be imported into the new Developer Console, if you wish to add Matter support to an existing Cloud-to-cloud or Local Home integration.

The following restrictions apply to this method:

  • This import is one-way only. It cannot be reversed.
  • Only the project owner can import an existing Actions on Google project. The owner is whoever created the project, which is viewable using the Members link.
  • The Company Profile for an imported project can only be edited in the Actions on Google Console. Changes there will be reflected in the Google Home Developer Console.

After import, the original Actions on Google project can still be used to manage existing integrations (such as Cloud-to-cloud, Local Home, App Discovery).

To import an existing project from the Actions on Google Console, go to the Developer Console:

Go to the Developer Console

  1. Click Create a Project.
  2. Enter an existing Actions project name or select a project from the drop-down list (for example, in the screenshot, below, the project name is "My matter project").
  3. Click Import project.

You are redirected back to the existing project details in Developer Console.

Google Home Developer Center Get
started

Set log levels

By default, only error logs are saved to Google Cloud for each integration in your project.

To save all logs to Google Cloud for each integration, select All logs in the Log level control: Error logs section.

Google Home Developer Center project log levels

This setting applies to all integrations in your project. It cannot be set per integration. Saving all logs to Google Cloud may incur additional cost if your log storage space is exceeded.

To learn more about logs, see Cloud Logging for Matter.

Share a developer project

You may add or remove access to a project among the users on your team using predefined roles.

  1. On the Home page of the Developer Console click Members, which takes you to the IAM & Admin > IAM page on the Google Cloud Console.

    Or, click Project details, then click Manage members in GCP in the Members section at the bottom.

  2. Make changes as necessary using the Google Cloud Console dashboard.

For instructions for how to modify access to a project, refer to the Google Cloud documentation for Access Control.

Once added to the list of users, a user can view the project and any integrations in the Developer Console.