Créer un projet de développeur

Les projets de développement, qui incluent des intégrations Matter, sont gérés sur Google Home Developer Console. Cette page explique comment configurer un nouveau projet de développeur sur Developer Console.

Restrictions

Les fonctionnalités Cloud-to-cloud ou Local Home SDK ne peuvent pas être ajoutées à un projet dans Developer Console. Si vous souhaitez ajouter la fonctionnalité Matter à une intégration Cloud-to-cloud ou Local Home existante, vous devez d'abord importer un projet Actions on Google existant.

Nommer le projet

Lorsque vous attribuez un nom à votre projet, nous vous recommandons de choisir un nom qui répond aux critères suivants:

  • Inclut quelques informations de base sur le projet.
  • Ne sera pas facilement confondu avec celui d’un autre projet.
  • Peut représenter tous les integrationau sein du projet.

Il est important de choisir des noms pertinents. Un nom générique tel que project-gamma-798 est en fait "camouflé" et ne se démarque pas dans une liste d'autres projets portant un nom générique.

Tenez compte des conseils suivants lorsque vous nommez votre projet:

  • Utiliser le nom de votre entreprise
  • Indiquez le type de projet ou d'action dans le nom
  • N'utilisez pas "test" dans le nom du projet.

Par exemple, acme-smarthome et acme-lighting sont des noms de projet clairs et uniques.

Créer le projet

Un projet de développement représente un ou plusieurs integrations. En partageant un projet avec les membres de son équipe de développement, le propriétaire peut autoriser d'autres utilisateurs à gérer tous les integrationdu projet.

Les écosystèmes pour la maison connectée integrationde Google sont gérés à l'aide de la nouvelle version de Developer Console. Il existe deux méthodes pour configurer des projets dans Developer Console:

  1. Créez un projet.
  2. Importer un projet existant à partir de la console Actions on Google

Nous vous recommandons de ne créer qu'un seul projet pour toutes vos intégrations Matter, à la fois pour les tests et la production, en particulier pour éviter les problèmes lors des tests avec des ID de fournisseur et des ID produit de test pour Matter.

Méthode 1: Créer un projet

Accédez à Developer Console:

Accéder à la Developer Console

  1. Sur la page Gérer les projets, cliquez sur Créer un projet.
  2. Sur la page Premiers pas, cliquez sur Créer un projet.
  3. Saisissez le nom de votre projet, qui doit respecter les consignes de dénomination des projets.
  4. Cliquez sur Créer un projet.

Vous êtes redirigé vers la page d'accueil du nouveau projet.

Méthode 2: Importer un projet existant depuis la console Actions on Google

Vous pouvez importer un projet Actions on Google existant dans le nouveau Developer Console si vous devez ajouter la prise en charge de Matter à une intégration Cloud-to-cloud ou Local Home existante.

Les restrictions suivantes s'appliquent à cette méthode:

  • Cette importation est à sens unique. Elle est irréversible.
  • Seul le propriétaire du projet peut importer un projet Actions on Google existant. Le propriétaire est la personne qui a créé le projet. Il peut être affiché via le lien Membres.
  • Le profil d'entreprise pour un projet importé ne peut être modifié que dans la console Actions on Google. Les modifications seront répercutées dans la Google Home Developer Console.

Après l'importation, le projet Actions on Google d'origine peut toujours être utilisé pour gérer les intégrations existantes (telles que Cloud-to-cloud, Local Home et App Discovery).

Pour importer un projet existant à partir de Actions on Google Console, accédez à Developer Console:

Accéder à la Developer Console

  1. Cliquez sur Create a Project (Créer un projet).
  2. Saisissez un nom de projet Actions existant ou sélectionnez un projet dans la liste déroulante (par exemple, dans la capture d'écran suivante, le nom du projet est "Mon projet Matter").
  3. Cliquez sur Import project (Importer un projet).

Vous êtes redirigé vers les détails du projet existant dans Developer Console.

Premiers pas avec le Google Home Developer Center

Définir des niveaux de journalisation

Par défaut, seuls les journaux d'erreurs sont enregistrés dans Google Cloud pour chaque intégration de votre projet.

Pour enregistrer tous les journaux dans Google Cloud pour chaque intégration, sélectionnez Tous les journaux dans la section Contrôle au niveau des journaux: journaux d'erreurs.

Niveaux de journalisation des projets Google Home Developer Center

Ce paramètre s'applique à toutes les intégrations de votre projet. Il ne peut pas être défini par intégration. L'enregistrement de tous les journaux dans Google Cloud peut entraîner des coûts supplémentaires en cas de dépassement de l'espace de stockage des journaux.

Pour en savoir plus sur les journaux, consultez la page Cloud Logging pour Matter.

Partager un projet de développeur

Vous pouvez ajouter ou supprimer l'accès à un projet pour les utilisateurs de votre équipe à l'aide de rôles prédéfinis.

  1. Sur la page Accueil de Developer Console, cliquez sur Membres pour accéder à la page IAM et administration > IAM sur le Google Cloud Console.

    Vous pouvez également cliquer sur Détails du projet, puis sur Gérer les membres dans GCP dans la section Membres au bas de la page.

  2. Apportez les modifications nécessaires à l'aide du tableau de bord Google Cloud Console.

Pour savoir comment modifier l'accès à un projet, consultez la section Contrôle des accès aux projets avec IAM.

Une fois ajouté à la liste des utilisateurs, l'utilisateur peut afficher le projet et toutes les intégrations dans le Developer Console.

Selon le paramètre de votre organisation, vous pouvez rencontrer des erreurs d'autorisation lorsque vous tentez de créer des projets de développement. Si tel est le cas, contactez votre administrateur Google Cloud et demandez-lui de vous accorder les autorisations de créateur de projet pour votre compte.