IMPORTANT: You must be part of the Matter Private Beta Program to start developing Matter devices and apps in the Google Home Developer Console. Apply now

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 still under development, so not all functions are ready for use. Only the following Matter functions are supported:

  • Develop
  • Test
  • Field Trial

In addition, 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 migrate 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.

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 including the following elements in the name of your project:

  • Company name
  • Action name

For example, 'yoyodyne-print-status' uses both elements.

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.

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.

If you wish to do this, be aware that this import is one-way only. It cannot be reversed.

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

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 the Members button, which takes you to the IAM & Admin > IAM page on the Google Cloud Platform Console.

    Or, click the Project details button, then click Manage members in GCP.

  2. Make changes as necessary using the GCP Console dashboard.

For instructions for how to modify access to a project, refer to the Google Cloud Platform (GCP) documentation for Access Control

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