Criar um projeto de desenvolvedor

Os projetos de desenvolvedor, 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 importe 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ão facilmente confundidos com as de outro projeto.
  • Pode representar todos os integrations dentro do projeto.

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

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 uma ou mais integrations. Ao compartilhar um projeto com os membros da equipe de desenvolvimento, o proprietário pode permitir que outros usuários gerenciem todos os 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. Importe um projeto do console do Actions on Google.

Recomendamos a criação de apenas um projeto para todas as integrações Matter, tanto de teste quanto de produção, principalmente para evitar problemas ao testar com IDs de fornecedores e de produtos 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 Vamos começar, clique em Criar projeto.
  3. Insira o nome do seu projeto, que precisa aderir às diretrizes de nomenclatura de projetos.
  4. Clique em Criar novo projeto.

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

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

Um projeto Actions on Google atual poderá ser importado para o novo Developer Console, se for necessário adicionar suporte a Matter a uma integração Cloud-to-cloud ou Local Home existente.

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

  • A importação é unidirecional. Ela não pode ser revertida.
  • Somente o proprietário do projeto pode importar um projeto Actions on Google. O proprietário é quem criou o projeto, o que pode ser visualizado usando o link de membros.
  • O perfil da empresa de um projeto importado só pode ser editado no console do Actions on Google. As mudanças serão aplicadas ao Google Home Play Console.

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

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

Acessar o Play Console

  1. Clique em Criar um projeto.
  2. Digite um nome de projeto do Actions ou selecione um na lista suspensa. Por exemplo, na captura de tela a seguir, o nome é "My Matter project".
  3. Clique em Importar projeto.

Você será redirecionado de volta para os detalhes do projeto existentes em Developer Console.

Introdução ao Centro para Desenvolvedores do Google Home

Definir níveis de registro

Por padrão, apenas registros de erros 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 de nível de registro: registros de erros.

Níveis de registro do projeto da Central para Desenvolvedores 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 os 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 de sua equipe usando papéis predefinidos.

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

    Ou clique em Detalhes do projeto e em Gerenciar membros no GCP na seção Membros na parte inferior.

  2. Faça as alterações 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 IAM.

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

De acordo com sua configuração organizacional, erros de permissão podem ocorrer ao tentar criar projetos de desenvolvedor. Se isso acontecer, entre em contato com o administrador de Google Cloud e solicite permissões de Criador de projetos para sua conta.