Creare un'integrazione cloud-to-cloud

Un progetto Cloud-to-cloud può avere una sola integrazione. Se devi lavorare con più di un'integrazione, devi creare un altro progetto per ogni integrazione aggiuntiva.

Per creare una nuova integrazione di Cloud-to-cloud, devi prima avere un progetto, come descritto in Crea un progetto per sviluppatori. Una volta configurato il progetto:

Vai alla Developer Console

  1. Nell'elenco dei progetti, fai clic su Apri accanto al progetto con cui vuoi lavorare.

  2. Fai clic su Aggiungi integrazione cloud-to-cloud.

    Se è la prima volta che crei un'integrazione di Cloud-to-cloud, viene visualizzata la pagina Risorse, dove puoi visualizzare la documentazione per lo sviluppo di Cloud-to-cloud e leggere informazioni su alcuni strumenti.

    Quando è tutto pronto per continuare, fai clic su Avanti: Sviluppa, che mostra la pagina Elenco di controllo. Fai clic su Avanti: configurazione.

    Se non è la prima volta che crei un'integrazione di Cloud-to-cloud, ti troverai nella pagina Configurazione.

  3. Nella pagina Configurazione, inserisci il nome dell'integrazione.

  4. Fai clic su Seleziona il tipo di dispositivo e seleziona il tipo di dispositivo dal menu a discesa.

  5. Nella sezione Branding dell'app, carica un'immagine PNG di 144 x 144 pixel che rappresenti il tuo servizio in Google Home app (GHA). Assicurati che l'icona rispetti queste linee guida (vedi l'esempio come riferimento):

    • È richiesto un logo rotondo.
    • Espandi il logo in modo che tocchi la cornice.
    • Se il logo è bianco, è necessario un bordo colorato.
    • Se il logo è trasparente, è necessario uno sfondo bianco con un bordo colorato.
    • Dietro il logo, lo sfondo deve essere trasparente.

    Immagine dei requisiti delle icone

  6. Nella sezione Collegamento dell'account, configura la tua app in modo da consentire gli accessi dagli Account Google. Devi configurare un server OAuth, quindi assicurati di studiare il collegamento degli account e di implementare un server OAuth 2.0 prima di configurare queste impostazioni.

  7. Nella sezione URL di fulfillment cloud, fornisci l'URL di fulfillment utilizzato per elaborare gli intent per la smart home.

    • Mantieni sempre la proprietà del tuo dominio. Gli URL dei tuoi prodotti devono rimandare a un dominio che controlli, non direttamente a un endpoint di Amazon Web Services, Google Cloud o di un altro provider cloud. In questo modo, se cambi servizio di hosting, devi solo aggiornare il reindirizzamento dietro il tuo dominio anziché modificare l'URL pubblico.
    • Posiziona un bilanciatore del carico nel tuo endpoint. Un bilanciatore del carico ti aiuta a eseguire la transizione graduale quando cambi l'infrastruttura, monitori le prestazioni e rilevi errori gravi prima che influiscano sui tuoi clienti.
  8. Facoltativamente, configura App Flip e Autorizzazioni.

  9. Nella sezione Controllo del livello di log, modifica le impostazioni per gli errori e tutti i log.

    • Se hai già completato questa operazione durante la configurazione del profilo dell'azienda, puoi saltare questo passaggio.
  10. Fai clic su Salva per salvare la configurazione dell'integrazione di Cloud-to-cloud.

Impostazioni facoltative

Configura App Flip

Nella sezione App Flip (facoltativo), puoi configurare la tua app in modo da consentire agli utenti Android di collegare più rapidamente i propri account nel tuo sistema di autenticazione ai propri Account Google. Per i dettagli, consulta App Flip per Android.

Autorizzazioni

In questa sezione puoi specificare gli ambiti di autorizzazione OAuth specifici richiesti dal tuo servizio. I tuoi utenti devono accettare queste autorizzazioni prima di poter utilizzare il tuo servizio.

Livelli di log

Puoi controllare la quantità di dati di logging salvati per la tua integrazione su Google Cloud. Puoi scegliere di conservare solo i log degli errori o di conservare tutti i log.

Per impostare i livelli di log, vai a Dettagli progetto > Controllo del livello di log: log degli errori. Per maggiori dettagli, consulta Imposta i livelli di log.

Modifica un'integrazione in fase di revisione

Per modificare l'integrazione:

Vai alla Developer Console

  1. Nell'elenco dei progetti, fai clic su Apri accanto al progetto con cui vuoi lavorare.

  2. Modifica le informazioni nella pagina Configurazione.

  3. Fai clic su Salva.

  4. Si aprirà una finestra popup che ti chiede di confermare che vuoi aggiornare l'integrazione. Fai clic su Aggiorna per continuare.

  5. Fai clic su Avanti: certifica per inviare l'integrazione.

  6. Fai clic su Invia per richiedere la revisione della certificazione.

Una volta inviata, la tua integration viene visualizzata nella sezione Inviata per la certificazione.

Una volta che il tuo integration è stato certificato, Google faciliterà il lancio del tuo integration.