Crea un progetto sviluppatore

I progetti di sviluppo, che includono le integrazioni Matter, sono gestiti nella Google Home Developer Console. Questa pagina spiega come configurare un nuovo progetto sviluppatore su Developer Console.

Restrizioni

Impossibile aggiungere la funzionalità Cloud-to-cloud o Local Home SDK a un progetto in Developer Console. Se vuoi aggiungere la funzionalità Matter a un'integrazione Cloud-to-cloud o Local Home esistente, devi prima importare un progetto Actions on Google esistente.

Assegna un nome al progetto

Quando assegni un nome al progetto, è buona norma comporre un nome che:

  • Incorpora alcune informazioni di base sul progetto.
  • Non verrà facilmente confusa con quella di un altro progetto.
  • Può rappresentare tutti gli elementi integrationall'interno del progetto.

I nomi significativi sono importanti. Un nome generico come project-gamma-798 viene effettivamente "camuffato" e non risalta nell'elenco di altri progetti con nomi generici.

Prendi in considerazione le seguenti indicazioni quando assegni un nome al tuo progetto:

  • Utilizza il nome della tua azienda
  • Utilizza il tipo di progetto o azione nel nome
  • Non usare "test" nel nome del progetto

Ad esempio, acme-smarthome e acme-lighting sono nomi di progetto chiari e univoci.

Creare il progetto

Un progetto sviluppatore rappresenta uno o più integration. Condividendo un progetto con i membri del team di sviluppo, il proprietario può consentire ad altri utenti di gestire tutti gli elementi integrationdel progetto.

Gli ecosistemi per la smart home di Google integrationsono gestiti utilizzando il nuovo Developer Console. Esistono due metodi per configurare i progetti in Developer Console:

  1. Crea un nuovo progetto.
  2. Importare un progetto esistente dalla console Actions on Google.

Ti consigliamo di creare un solo progetto per tutte le integrazioni Matter, sia di test che di produzione, in particolare per evitare problemi durante i test con gli ID fornitore e gli ID prodotto di test per Matter.

Metodo 1: crea un nuovo progetto

Vai a Developer Console:

Vai alla Developer Console

  1. Nella pagina Gestisci progetti, fai clic su Crea un progetto.
  2. Nella pagina Inizia, fai clic su Crea progetto.
  3. Inserisci il nome del progetto, che deve rispettare le linee guida per la denominazione del progetto.
  4. Fai clic su Crea nuovo progetto.

Verrai reindirizzato alla home page del nuovo progetto.

Metodo 2: importa un progetto esistente dalla console di Actions on Google

Un progetto Actions on Google esistente potrebbe essere importato nel nuovo Developer Console, se devi aggiungere il supporto Matter a un'integrazione Cloud-to-cloud o Local Home esistente.

A questo metodo si applicano le seguenti restrizioni:

  • Questa importazione è solo unidirezionale. L'operazione non può essere annullata.
  • Solo il proprietario del progetto può importare un progetto Actions on Google esistente. Il proprietario è la persona che ha creato il progetto, visualizzabile tramite il link Membri.
  • Il profilo aziendale per un progetto importato può essere modificato solo nella console di Actions on Google. Le modifiche verranno applicate nella Developer Console di Google Home.

Dopo l'importazione, il progetto Actions on Google originale può ancora essere utilizzato per gestire le integrazioni esistenti, ad esempio Cloud-to-cloud, Local Home e App Discovery.

Per importare un progetto esistente da Actions on Google Console, vai a Developer Console:

Vai alla Developer Console

  1. Fai clic su Crea un progetto.
  2. Inserisci il nome di un progetto Actions esistente o seleziona un progetto dall'elenco a discesa (ad esempio, nello screenshot seguente, il nome del progetto è "Il mio progetto Matter").
  3. Fai clic su Importa progetto.

Verrai reindirizzato ai dettagli del progetto esistente in Developer Console.

Developer Center di Google Home
Per iniziare

Imposta livelli di log

Per impostazione predefinita, solo i log degli errori vengono salvati in Google Cloud per ogni integrazione nel progetto.

Per salvare tutti i log in Google Cloud per ogni integrazione, seleziona Tutti i log nella sezione Controllo a livello di log: log degli errori.

Livelli dei log di progetto del Developer Center di Google Home

Questa impostazione si applica a tutte le integrazioni nel progetto. Non può essere impostato per integrazione. Il salvataggio di tutti i log su Google Cloud potrebbe comportare costi aggiuntivi se viene superato lo spazio di archiviazione dei log.

Per ulteriori informazioni sui log, consulta Cloud Logging per Matter.

Condividere un progetto sviluppatore

Puoi aggiungere o rimuovere l'accesso a un progetto tra gli utenti del tuo team utilizzando i ruoli predefiniti.

  1. Nella home page di Developer Console, fai clic su Membri per accedere alla pagina IAM e amministrazione > IAM nella pagina Google Cloud Console.

    In alternativa, fai clic su Dettagli progetto e poi su Gestisci membri in Google Cloud nella sezione Membri in basso.

  2. Apporta le modifiche necessarie utilizzando la dashboard Google Cloud Console.

Per istruzioni su come modificare l'accesso a un progetto, consulta Controllo dell'accesso per i progetti con IAM.

Una volta aggiunto all'elenco degli utenti, un utente può visualizzare il progetto ed eventuali integrazioni in Developer Console.

In base alle impostazioni della tua organizzazione, potresti riscontrare errori di autorizzazione quando cerchi di creare progetti sviluppatore. Contatta il tuo amministratore Google Cloud e richiedi le autorizzazioni di Autore progetto per il tuo account.