Criar um projeto de desenvolvedor

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

Restrições

Não é possível adicionar a funcionalidade Cloud-to-cloud ou Local Home SDK a um projeto no Developer Console. Se você quiser adicionar a funcionalidade Matter a uma integração Cloud-to-cloud ou Local Home atual, primeiro será necessário importar um projeto Actions on Google.

Dar um nome ao projeto

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

• Incorpora algumas informações básicas sobre o projeto.
• Não será facilmente confundido com o de outro projeto.
• Pode representar todos os integrations no projeto.

Nomes significativos são importantes. Um nome genérico como project-gamma-798 é efetivamente "camuflado" e não se destacará em uma lista de outros projetos com nomes genéricos.

Considere as seguintes orientações ao nomear seu projeto:

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

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

Criar o projeto

Um projeto de desenvolvedor representa um ou mais integrations. Ao compartilhar um projeto com os membros da equipe de desenvolvimento, o proprietário pode permitir que outros usuários gerenciem todas as integrations no projeto.

Os ecossistemas de casa inteligente do Google integrationsão gerenciados usando o novo Developer Console. Há dois métodos para configurar projetos no Developer Console:

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

Recomendamos criar apenas um projeto para todas as integrações de Matter, tanto de teste quanto de produção, especialmente para evitar problemas ao testar com IDs de fornecedores e de produtos 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 Começar, clique em Criar projeto.
3. Insira o nome do seu projeto, que deve seguir as diretrizes de nomenclatura do projeto.
4. Clique em Criar novo projeto.

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

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

Um projeto Actions on Google já existente pode ser importado para o novo Developer Console se você precisar adicionar suporte a 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 de um projeto importado só pode ser editado no console do Actions on Google. As mudanças feitas serão refletidas no Google Home Developer Console.

Após a importação, o projeto Actions on Google original ainda pode ser usado para gerenciar integrações atuais (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. Insira um nome de projeto do Actions ou selecione um projeto na lista suspensa (por exemplo, na captura de tela a seguir, o nome do projeto é "Meu projeto do caso").
3. Clique em Importar projeto.

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

Definir níveis de registro

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

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

Esta 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 no Google Cloud poderá gerar mais custos 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

É possível adicionar ou remover o acesso a um projeto entre os usuários da equipe usando papéis predefinidos.

1. Na página Início do Developer Console, clique em Membros, que leva você à página IAM e administrador > IAM no 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 instruções sobre como modificar o acesso a um projeto, consulte Controle de acesso para projetos com o IAM.

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

De acordo com sua configuração organizacional, você pode encontrar erros de permissão ao tentar criar projetos de desenvolvedor. Se esse for o caso, entre em contato com o administrador do Google Cloud e solicite permissões de criador de projetos para sua conta.