I progetti sviluppatore, che includono integrazioni Matter, sono gestiti nella nuova versione di 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 confuso con quello di un altro progetto.
- Può rappresentare tutte le integrazioni all'interno del progetto.
Anche se è facile trovare un nome generico come project-gamma-798, un nome di questo tipo viene a tutti gli effetti "mimetizzato" e non viene nominato in altri progetti con nomi generici.
Per assegnare un nome significativo e distinto, tieni presente queste linee guida quando assegni un nome al 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 o acme-lighting sono nomi di progetto chiari e univoci.
Crea il progetto
Un progetto sviluppatore rappresenta una o più integrazioni. Condividendo un progetto con i membri del proprio team di sviluppo, il proprietario può consentire ad altri utenti di gestire tutte le integrazioni nel progetto.
Le integrazioni con l'ecosistema della smart home di Google vengono gestite tramite il nuovo Developer Console. Esistono due metodi per configurare i progetti in Developer Console:
Ti consigliamo di creare un solo progetto per tutte le integrazioni, sia di test che di produzione, in particolare per evitare problemi durante i test con gli ID fornitore di test e gli ID prodotto di Matter.
Metodo 1: crea un nuovo progetto
Vai alla Developer Console:
- Nella pagina Gestisci progetti, fai clic su Crea un progetto.
- Nella pagina Inizia, fai clic su Crea progetto.
- Inserisci il nome del progetto, che deve rispettare le linee guida per la denominazione del progetto.
- Fai clic su Crea nuovo progetto.
Verrai reindirizzato alla home page del nuovo progetto.
Metodo 2: importa un progetto esistente dalla console Actions on Google
Un progetto Actions on Google esistente può essere importato nel nuovo Developer Console, se vuoi aggiungere il supporto Matter a un'integrazione Cloud-to-cloud o Local Home esistente.
A questo metodo si applicano le seguenti limitazioni:
- 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 è l'utente che ha creato il progetto, visibile tramite il link Membri.
- Il profilo aziendale di un progetto importato può essere modificato solo nella console Actions on Google. Le modifiche verranno applicate alla Developer Console di Google Home.
Dopo l'importazione, il progetto Actions on Google originale può ancora essere utilizzato per gestire le integrazioni esistenti (come Cloud-to-cloud, Local Home e App Discovery).
Per importare un progetto esistente da Actions on Google Console, vai a Developer Console:
- Fai clic su Crea un progetto.
- Inserisci il nome di un progetto Actions esistente o selezionane uno dall'elenco a discesa (ad esempio, nello screenshot di seguito, il nome del progetto è "Il mio progetto Matter").
- Fai clic su Importa progetto.
Il sistema ti reindirizzerà ai dettagli del progetto esistenti in Developer Console.
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.
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 scoprire di più sui log, consulta Cloud Logging per Matter.
Condividere un progetto sviluppatore
Puoi aggiungere o rimuovere l'accesso a un progetto da parte degli utenti del tuo team utilizzando i ruoli predefiniti.
Nella home page di Developer Console, fai clic su Membri per accedere alla pagina IAM e amministrazione > IAM sul Google Cloud Console.
In alternativa, fai clic su Dettagli progetto, quindi su Gestisci membri in Google Cloud nella sezione Membri in basso.
Apporta le modifiche necessarie utilizzando la dashboard Google Cloud Console.
Per istruzioni su come modificare l'accesso a un progetto, consulta la documentazione di Google Cloud per il controllo dell'accesso.
Una volta aggiunto all'elenco degli utenti, un utente può visualizzare il progetto ed eventuali integrazioni in Developer Console.