Les projets de développement, qui incluent des intégrations Matter, sont gérés sur le Google Home Developer Console. Cette page explique comment configurer un nouveau projet de développeur sur le 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, il est recommandé de composer un nom qui:
- Inclut des informations de base sur le projet.
- Ne se confondra pas facilement avec celui d’un autre projet.
- Peut représenter tous les integrationdu projet.
Les noms doivent avoir un sens. Un nom générique tel que project-gamma-798 est effectivement "camouflé" et ne se démarquera pas dans une liste d'autres projets ayant un nom générique.
Tenez compte des conseils suivants lorsque vous attribuez un nom à votre projet:
- Utiliser le nom de votre entreprise
- Utilisez 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 integration. 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 Google pour la maison connectée integrationsont gérés à l'aide du nouveau Developer Console. Il existe deux méthodes pour configurer des projets dans Developer Console:
Nous vous recommandons de ne créer qu'un seul projet pour toutes vos intégrations Matter, à la fois de test et de production, en particulier pour éviter les problèmes lors des tests avec les ID de fournisseur et les ID produit de test pour Matter.
Méthode 1: Créer un projet
Accédez à Developer Console:
Accéder à la Developer Console
- Sur la page Gérer les projets, cliquez sur Créer un projet.
- Sur la page Premiers pas, cliquez sur Créer un projet.
- Saisissez le nom de votre projet. Il doit respecter les consignes de dénomination des projets.
- Cliquez sur Créer un projet.
Vous êtes redirigé vers la page Accueil du nouveau projet.
Méthode 2: Importer un projet existant à partir de la console Actions on Google
Un projet Actions on Google existant peut être importé dans la nouvelle 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. Cette opération est irréversible.
- Seul le propriétaire du projet peut importer un projet Actions on Google existant. Le propriétaire correspond à la personne qui a créé le projet. Vous pouvez la consulter en cliquant sur le lien Membres.
- Le profil d'entreprise d'un projet importé ne peut être modifié que dans la console Actions on Google. Les modifications apportées seront répercutées dans la console développeur de Google Home.
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
- Cliquez sur Créer un projet.
- 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 "My Matter project").
- Cliquez sur Importer un projet.
Vous êtes redirigé vers les détails du projet existant dans Developer Console.
Définir les 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 de la journalisation: journaux d'erreurs.
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 de vos journaux.
Pour en savoir plus sur les journaux, consultez la page Cloud Logging pour Matter.
Partager un projet de développement
Vous pouvez ajouter ou supprimer l'accès à un projet des utilisateurs de votre équipe à l'aide des rôles prédéfinis.
Sur la page Accueil de Developer Console, cliquez sur Membres pour accéder à la page IAM et administration > IAM de Google Cloud Console.
Vous pouvez également cliquer sur Détails du projet, puis sur Gérer les membres dans GCP dans la section Membres en bas de la page.
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 page Contrôle des accès aux projets avec IAM.
Une fois ajouté à la liste des utilisateurs, il peut afficher le projet et les intégrations dans Developer Console.
Selon votre paramètre d'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 les autorisations de créateur de projet pour votre compte.