Criar um projeto de desenvolvedor

Os projetos do desenvolvedor, que incluem integrações Matter, são gerenciados no novo Google Home Developer Console. Esta página explica como configurar um novo projeto de desenvolvedor no Developer Console.

Restrições

A funcionalidade Cloud-to-cloud ou Local Home SDK não pode ser adicionada a um projeto no Developer Console. Se você quiser adicionar a funcionalidade Matter a uma integração Cloud-to-cloud ou Local Home existente, primeiro importe um projeto Actions on Google.

Dar um nome ao projeto

Ao nomear seu projeto, é recomendável escrever um nome que:

  • Incorpora algumas informações básicas sobre o projeto.
  • Não será facilmente confundido com o de outro projeto.
  • Pode representar todas as integrações dentro do projeto.

Embora seja fácil criar um nome genérico, como project-gamma-798, esse nome é efetivamente "camuflado" e não se destaca em uma lista de outros projetos com nomes genéricos.

Para garantir um nome de projeto significativo e distinto, considere esta orientação ao nomear seu projeto:

  • Use o nome da sua empresa
  • Usar o tipo de projeto ou ação no nome
  • Não use "test" no nome do projeto

Por exemplo, acme-smarthome ou acme-lighting são nomes claros e exclusivos do projeto.

Criar o projeto

Um projeto do desenvolvedor representa uma ou mais integrações. Ao compartilhar um projeto com os membros da equipe de desenvolvimento, o proprietário pode permitir que outros usuários gerenciem todas as integrações do projeto.

As integrações do ecossistema de casa inteligente do Google são gerenciadas usando o novo Developer Console. Há dois métodos de configurar projetos no Developer Console:

  1. Crie um novo projeto.
  2. Importe um projeto existente no console do Actions on Google.

Recomendamos criar apenas um projeto para todas as integrações, tanto de teste quanto de produção, especialmente para evitar problemas ao testar com IDs de fornecedor e de produto de teste para Matter.

Método 1: criar um novo projeto

Acesse o Developer Console:

Acessar o Play Console

  1. Na página Gerenciar projetos, clique em Criar um projeto.
  2. Na página Primeiros passos, clique em Criar projeto.
  3. Digite o nome do projeto, que deve seguir as diretrizes de nomenclatura de projetos.
  4. Clique em Criar novo projeto.

Você será redirecionado para a Página inicial do novo projeto.

Método 2: importar um projeto do Console do Actions on Google

Um projeto Actions on Google atual pode ser importado para o novo Developer Console, se você quiser adicionar suporte Matter a uma integração Cloud-to-cloud ou Local Home existente.

As seguintes restrições se aplicam a este método:

  • Essa importação é unidirecional. Ela não pode ser revertida.
  • Somente o proprietário do projeto pode importar um projeto Actions on Google existente. O proprietário é quem criou o projeto, que pode ser visualizado usando o link "Membros".
  • O perfil da empresa para um projeto importado só pode ser editado no Console do Actions on Google. As alterações serão refletidas no Google Home Developer Console.

Após a importação, o projeto Actions on Google original ainda poderá ser usado para gerenciar integrações existentes (como Cloud-to-cloud, Local Home, App Discovery).

Para importar um projeto existente do Actions on Google Console, acesse o Developer Console:

Acessar o Play Console

  1. Clique em Criar um projeto.
  2. Digite o nome de um projeto do Actions ou selecione um na lista suspensa. Por exemplo, na captura de tela abaixo, o nome do projeto é "Meu projeto".
  3. Clique em Import project.

Você será redirecionado para os detalhes do projeto existente em Developer Console.

Central de desenvolvedores do Google Home
Primeiros passos

Definir níveis de registro

Por padrão, somente os registros de erro são salvos em Google Cloud para cada integração no projeto.

Para salvar todos os registros em Google Cloud para cada integração, selecione Todos os registros na seção Controle no nível do registro: registros de erro.

Níveis de registro do projeto na Central do desenvolvedor do Google Home

Essa configuração se aplica a todas as integrações no seu projeto. Ele não pode ser definido por integração. Salvar todos os registros em Google Cloud poderá gerar custos adicionais se o espaço de armazenamento de registros for excedido.

Para saber mais sobre registros, consulte Cloud Logging para Matter.

Compartilhar um projeto de desenvolvedor

Você pode adicionar ou remover o acesso a um projeto entre os usuários em sua equipe usando papéis predefinidos.

  1. Na Página inicial do Developer Console, clique em Membros, que leva você à página IAM e administrador > IAM na Google Cloud Console.

    Também é possível clicar em Detalhes do projeto e em Gerenciar membros no GCP na seção Membros na parte inferior.

  2. Faça mudanças conforme necessário usando o painel Google Cloud Console.

Para ver instruções sobre como modificar o acesso a um projeto, consulte a documentação de Google Cloud para controle de acesso.

Depois de adicionado à lista de usuários, o usuário pode ver o projeto e todas as integrações no Developer Console.