Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Crea e gestisci le app collegate utilizzando AppFunctions e Android MCP in Google Connected Console

Utilizza Google Connected Console per integrare le AppFunctions on-device della tua app per Android con Gemini su Android. Creando un'app connessa con il tipo di connessione MCP Android e collegandola alla tua app Play, consenti a Gemini su Android di attivare azioni e completare attività direttamente nella tua app per conto degli utenti.

Questa guida illustra il workflow self-service end-to-end in Google Connected Console, tra cui la creazione di app connesse, il collegamento di app di Google Play, la configurazione di schede di app pubbliche, il caricamento e l'invio di app bundle, i test di anteprima on-device e la pubblicazione in produzione.

Prerequisiti

Prima di iniziare, assicurati di disporre di quanto segue:

Accesso a un account sviluppatore registrato in Google Connected Console:
- Accettazione dei Termini di servizio: la prima volta che la tua organizzazione accede alle App connesse in Google Connected Console, un proprietario dell'account o un amministratore deve esaminare e accettare i Termini di servizio delle App connesse prima che i membri del team possano crearle.
- Autorizzazioni utente: se hai ricevuto un invito a un account sviluppatore Connected Console esistente, ma non riesci a creare app connesse, chiedi al proprietario o all'amministratore dell'account di concederti l'autorizzazione Visualizza app connesse o Crea e gestisci app connesse nella pagina Utenti e autorizzazioni. Devi anche disporre delle autorizzazioni di gestione delle release per la tua app Play pertinente per caricare app bundle e gestire le release.
Un'app Play esistente nel tuo account Google Connected Console:
- La tua app Play deve già esistere nello stesso account sviluppatore per poterla collegare alla tua app connessa. Ogni app Play può essere collegata a una sola app connessa Android MCP.
- Assicurati che la tua app Play abbia una scheda dello Store predefinita configurata con un'icona dell'app e le lingue supportate. Le lingue della scheda dello Store dell'app Play e il targeting per paese determinano dove è disponibile l'app Android connessa a MCP.
Un Android App Bundle (.aab) con AppFunctions implementate:
- Configura l'app bundle in modo che abbia come target i dispositivi mobili Android, che sono la piattaforma supportata per l'integrazione dell'app Gemini on-device.
Categoria di app connessa e metadati visibili al pubblico: prepara gli asset e i dettagli che costituiscono la presenza pubblica della tua app connessa:
- Categoria dell'app connessa: il dominio o la categoria di settore dell'app connessa. Ogni categoria definisce i requisiti di funzionalità di base e non può essere modificata dopo la creazione.
- Nome app: il nome visualizzato dell'app connessa mostrato agli utenti nei prodotti Google e utilizzato quando gli utenti menzionano l'app con @ in Gemini.
- Icona dell'app connessa: un'icona dell'app di 512 x 512 px in formato JPEG o PNG, con una dimensione massima del file di 1 MB (1024 KB).
- Descrizione dell'app: un breve riepilogo che descrive cosa può fare la tua app connessa per gli utenti.
- Funzionalità dell'app: almeno tre funzionalità personalizzate che mostrano agli utenti cosa può fare la tua app quando decidono se connettersi, oltre alle funzionalità predefinite definite dalla categoria della tua app.
- Prompt di esempio: almeno tre prompt di esempio che insegnano agli utenti come richiamare la tua app in Gemini e li aiutano a capire cosa possono chiedere.
- URL delle norme: un URL accessibile pubblicamente per le tue norme sulla privacy.
- URL dei Termini di servizio: un URL accessibile pubblicamente per i Termini di servizio.
- URL del sito web (facoltativo): un URL accessibile pubblicamente che rimanda al tuo sito web per l'attribuzione.

Registra, testa e pubblica AppFunctions con Gemini

Una volta soddisfatti i prerequisiti, completa i seguenti passaggi per registrare la tua app Android connessa a MCP, collegare la tua app Play, compilare i dettagli dell'app, caricare e inviare le tue AppFunctions, eseguire i test on-device e pubblicare in produzione.

Passaggio 1: crea un'app connessa MCP per Android e collegala alla tua app Play

Per creare un'app connessa e collegarla alla tua app Play, segui questi passaggi:

Accedi a Google Connected Console.
Nella pagina Home, seleziona Crea app.
Nella finestra di dialogo Scegli cosa creare:
- Se ti viene chiesto di accettare i Termini di servizio delle App connesse, seleziona Visualizza termini, leggi e accetta il contratto, quindi seleziona Crea. Solo un amministratore dell'account può accettare il contratto.
- In caso contrario, seleziona Crea nella scheda App collegata.
Nella finestra di dialogo Assegna un nome all'app connessa, digita un nome per l'app connessa. Questo è il nome che visualizza l'app connessa nei prodotti Google ed è il modo in cui gli utenti menzionano l'app connessa utilizzando @. Seleziona Avanti.
Nella finestra di dialogo Seleziona una categoria di app connessa, seleziona il dominio, la categoria o il settore della tua app dal menu Seleziona una categoria.

Nota: la categoria di app connessa definisce i requisiti di funzionalità di base e non può essere modificata in un secondo momento. Per utilizzare una categoria diversa in un secondo momento, devi creare una nuova app connessa.
Nella finestra di dialogo Scegli il tipo di connessione, scegli Android MCP.

Per una procedura dettagliata sulla configurazione di un'app connessa al server MCP, consulta la guida all'integrazione di Google Play Console. Per il momento, puoi scegliere un solo tipo di connessione per app connessa e non puoi modificarlo in un secondo momento.
Seleziona Crea app collegata.
Nella finestra di dialogo Seleziona app, trova l'app Play che contiene (o conterrà) le tue AppFunctions e selezionala. Puoi filtrare l'elenco utilizzando la ricerca.
- Le app di Google Play già collegate a un'altra app connessa non possono essere selezionate.
- Assicurati di selezionare l'app Play corretta che vuoi collegare. Una volta selezionata un'app Play, non può essere modificata.

In questo modo, si apre la pagina di riepilogo della gestione dell'app connessa, dove puoi continuare a configurare i dettagli dell'app connessa, monitorare le versioni dell'app connessa e gestire i tester.

Passaggio 2: fornisci i dettagli dell'app connessa

Prima di caricare app bundle contenenti AppFunctions, configura l'aspetto della tua app connessa per gli utenti in Gemini.

Segui questi passaggi per fornire i dettagli dell'app collegata:

Nella pagina di gestione dell'app collegata, nella scheda Android MCP in Aggiungi i dettagli dell'app collegata, seleziona Aggiungi i dettagli dell'app (o Gestisci se stai aggiornando i dettagli esistenti).
Nella parte superiore della pagina Dettagli sull'app, verifica il campo Nome app collegata. Se necessario, puoi aggiornare il nome. Questo nome viene mostrato agli utenti nei prodotti Google e viene utilizzato quando gli utenti menzionano la tua app con @.
Nella sezione Dettagli pubblici, in Icona, carica l'icona dell'app (JPG o PNG, fino a 1 MB e 512 x 512 px).
Completa i seguenti campi:
- Descrizione: inserisci un riepilogo conciso di una sola frase (meno di 30 parole) che descriva le funzionalità principali della tua app connessa e cosa può fare. Questo testo viene mostrato agli utenti e non viene utilizzato come istruzioni per il modello.
- Funzionalità: inserisci almeno tre attività di alto valore che la tua app connessa può eseguire. Seleziona Aggiungi funzionalità per aggiungere altre voci. Non includere numeri all'inizio delle funzionalità. Includi una sola funzionalità per voce. Se la categoria dell'app connessa include funzionalità predefinite, queste vengono visualizzate nella parte superiore dell'elenco e non possono essere modificate.
- Prompt di esempio: inserisci almeno tre prompt di esempio che aiutino gli utenti a capire cosa possono chiedere. Seleziona Aggiungi prompt di esempio per aggiungere voci.
  - Inizia almeno due prompt con @<YourAppName> (ad esempio, @Order Tracker where is my last order?).
  - Menziona <YourAppName> in modo naturale in almeno un prompt senza iniziare con il nome della tua app (ad esempio, Track my recent order on Order Tracker).
  - Non includere prefissi numerati (1., 2., 3.) né racchiudere i prompt tra virgolette ("...").
- Localizzazione multilingue: per fornire traduzioni per Descrizione, Funzionalità e Prompt di esempio, racchiudi il testo di ogni lingua nei tag di lingua all'interno del campo di immissione. Ad esempio:
```
<en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>
```
  Connected Console convalida automaticamente i tag e visualizza le impostazioni internazionali rilevate sotto ogni campo (ad esempio, Found translations for 2 languages: en-US, es-ES).
- URL dei Termini di servizio: inserisci un link https:// o http:// valido ai tuoi Termini di servizio.
- URL delle norme: inserisci un link https:// o http:// valido alle tue norme sulla privacy.
- URL del sito web (facoltativo): inserisci un link al tuo sito web per l'attribuzione.

Passaggio 3: carica un app bundle contenente le tue AppFunction e invia l'app connessa

Dopo aver salvato i dettagli dell'app collegata, carica un Android App Bundle contenente le tue AppFunctions nell'app Google Play collegata e invia la versione dell'app collegata per il test.

Per caricare un app bundle contenente le tue AppFunction, segui questi passaggi:

Nella pagina di gestione dell'app connessa, nella scheda Android MCP in Carica un app bundle che contiene le tue AppFunctions, seleziona Carica app bundle per andare alla panoramica Testa e rilascia dell'app Play collegata.
In alternativa, apri l'app Play collegata direttamente in Google Connected Console. Nel menu di navigazione a sinistra dell'app Play, vai a Test > Test interni (o un altro canale di test) e seleziona Crea nuova release (o Modifica release se hai già una versione bozza).
In App bundle, seleziona Carica per caricare il bundle .aab con AppFunctions oppure seleziona Aggiungi dalla raccolta se hai caricato il bundle dopo aver completato il passaggio 2.
Al termine del caricamento, vai alla sezione Sono state rilevate funzionalità dell'app nel tuo app bundle nella pagina della release. Verifica che il nome dell'app collegata, il codice di versione del bundle, il numero di strumenti rilevati, il numero di lingue e il targeting per paese dell'app Play vengano visualizzati come previsto e che i controlli automatici non segnalino problemi. Se vengono visualizzati errori di convalida, segui le istruzioni riportate in Risolvi i problemi relativi ad AppFunctions prima di continuare.
Nella parte inferiore della pagina della release, seleziona Invia l'app connessa e continua.

Se selezioni Invia l'app connessa e continua, la tua versione di AppFunctions viene inviata a Gemini per i test di anteprima e la tua release di Play viene spostata alla pagina di anteprima della release. Se vuoi eseguire l'iterazione su AppFunctions utilizzando build locali senza incrementare il codice di versione dell'app bundle, lascia la release di Google Play in stato di bozza e non selezionare Salva e pubblica. La pubblicazione di una release di Google Play blocca il codice di versione del bundle, che non può più essere eliminato e ricaricato. Eventuali modifiche successive richiedono un codice di versione dell'app bundle incrementato. Se i tuoi tester installano l'app direttamente dal canale di test interno di Google Play anziché tramite sideload, completa l'implementazione del test interno e incrementa il codice di versione nei caricamenti futuri.

Passaggio 4: verifica la versione dell'app connessa

Dopo aver inviato l'app connessa dalla pagina della release di Play, verifica che la versione dell'app connessa sia pronta per l'anteprima:

Nella pagina di gestione dell'app connessa, nella scheda Android MCP, accanto a Versioni, seleziona Visualizza.
Nella pagina Versioni, verifica che la versione inviata venga visualizzata nella sezione Disponibile per i tester (con l'icona Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
- Seleziona Visualizza in qualsiasi riga della versione per esaminare le AppFunctions rilevate e l'istantanea di sola lettura dei dettagli sull'app acquisita per quella versione.
- Le versioni create da un app bundle caricato per cui non hai ancora selezionato Invia l'app connessa e continua vengono visualizzate in Invio in attesa.

Passaggio 5: testa l'app connessa

Per rendere la tua app connessa disponibile per i tester, devi aggiungerli nella pagina Gestisci i tester. Solo gli utenti che aggiungi all'elenco dei tester possono visualizzare e interagire con la tua app connessa non pubblicata. Puoi aggiungere solo tester con un account @gmail.com.

Nella pagina di riepilogo dell'app connessa, nella scheda Testa la tua app, seleziona Aggiungi tester (o Gestisci tester se ne hai già aggiunti alcuni).
Nella pagina Gestisci i tester, seleziona le mailing list esistenti o seleziona Crea una mailing list per aggiungere gli Account Google autorizzati a testare la tua integrazione. Assicurati di includere il tuo indirizzo email se vuoi testare l'app.
Seleziona Salva.

Nota: una volta aggiunti i tester, possono essere necessari fino a 10 minuti prima che la tua app connessa diventi visibile per questi account.
I tester nell'app Gemini possono richiamare l'app connessa digitando @ seguito dal nome dell'app connessa e selezionandola dal menu. Puoi anche visualizzare e collegare la tua app in Gemini andando su Impostazioni e guida > App collegate nella barra di navigazione a sinistra.

Prima di eseguire i test on-device, verifica che ogni tester soddisfi i seguenti requisiti:

Aver eseguito l'accesso su uno smartphone o tablet Android utilizzando un Account Google incluso nell'elenco di indirizzi email configurato nel Passaggio 5.
Eseguire la build esatta dell'app per Android il cui codice versione del bundle corrisponde alla versione inviata nel Passaggio 4.

Ti consigliamo di testare attentamente l'integrazione:

Prova tutti i tuoi prompt di esempio.
Testa sia le chiamate esplicite @<AppName> sia le query in linguaggio naturale.
Verifica la gestione dei parametri degli strumenti, i prompt di conferma e l'esecuzione end-to-end nelle tue AppFunction.

Quando i test ti soddisfano, puoi inviare l'app connessa a Google per la revisione.

Passaggio 6: pubblica l'app connessa per gli utenti

A differenza delle integrazioni MCP ospitate su server, un'app connessa Android MCP non richiede un'azione di revisione o pubblicazione separata nella pagina di gestione delle app connesse. La versione dell'app connessa viene invece esaminata da Google e pubblicata automaticamente quando rilasci in produzione la versione dell'app Google Play contenente l'app bundle AppFunctions.

Una volta completati i test e quando è tutto pronto per il lancio agli utenti:

In Google Connected Console, apri l'app Play collegata e vai a Release > Produzione nel menu di navigazione a sinistra (o promuovi la release testata da un canale di test a Produzione).
Seleziona Crea nuova release (o modifica una bozza di release di produzione esistente) e aggiungi l'app bundle contenente le AppFunctions verificate utilizzando Aggiungi dalla raccolta o Carica.
Vai alla sezione Sono state rilevate funzionalità dell'app nel tuo app bundle per confermare la versione dell'app connessa, il numero di strumenti, il numero di lingue della scheda dello Store e il targeting per paese dell'app Google Play e assicurati che i controlli automatici non mostrino problemi di blocco.
Seleziona Invia l'app connessa e continua, completa i dettagli della release e invia la release di produzione dell'app Play per la revisione e l'implementazione.

Una volta approvata e implementata la release di produzione dell'app Play:

La tua app connessa Android MCP diventa disponibile in Gemini su Android per gli utenti nei paesi e nelle lingue target della tua app Play.
Nella pagina di gestione dell'app connessa (App connesse > Gestisci), la scheda Stato dell'app connessa viene aggiornata a Pubblicata, mostrando il codice di versione dell'app bundle pubblicato e la data di pubblicazione. La versione viene visualizzata in Pubblicata nella pagina Versioni.
Per distribuire in un secondo momento gli strumenti AppFunctions aggiornati, crea un nuovo app bundle con un codice di versione incrementato, testalo utilizzando un canale di test e pubblica una nuova release di Play in Produzione. Se vuoi aggiornare anche i metadati pubblici dell'app collegata (ad esempio funzionalità o prompt di esempio), salva le modifiche in App collegate > Gestisci > Dettagli sull'app prima di caricare il nuovo app bundle.

Aggiorna l'app bundle per modificare AppFunctions

Se vuoi eseguire l'iterazione di AppFunctions durante i test interni senza incrementare il codice di versione dell'app per Android, puoi rimuovere ed eliminare un app bundle in bozza non pubblicato prima di caricarlo di nuovo:

Aggiorna l'implementazione di AppFunctions nel tuo progetto Android e genera un nuovo app bundle .aab.
Rimuovi l'app bundle precedente da qualsiasi versione bozza in cui l'hai aggiunto:
1. Apri l'app Play collegata in Google Connected Console e seleziona Test interni (o il canale contenente la versione bozza) nel menu di navigazione a sinistra.
2. Nella versione bozza, seleziona Modifica release.
3. Individua l'app bundle, seleziona il menu con tre puntini (⋮) e seleziona Rimuovi app bundle.
4. Seleziona Salva come bozza.
Elimina l'app bundle inutilizzato dalla tua raccolta:
1. Nel menu di navigazione a sinistra dell'app Play, seleziona Ultime release e bundle (se non vedi il bundle nell'elenco, seleziona Visualizza tutti gli app bundle).
2. Apri i dettagli dell'app bundle e, se il pulsante Elimina app bundle è disponibile, seleziona Elimina app bundle. In questo modo, il codice di versione viene liberato e puoi caricare l'app bundle aggiornato senza incrementare il codice di versione.
Se l'opzione Elimina app bundle non è disponibile (ad esempio perché la release è già stata pubblicata in un canale), incrementa il valore versionCode nella configurazione di compilazione dell'app, genera un nuovo app bundle, quindi carica e invia la nuova versione come descritto nel passaggio 4.

Risolvi i problemi relativi ad AppFunctions

Utilizza le seguenti indicazioni per risolvere gli errori dei controlli automatici e i problemi di configurazione comuni.

Risolvi gli errori dei controlli automatici su una release

Eventuali problemi identificati dai controlli automatici di AppFunctions vengono visualizzati nella pagina di preparazione della release (ad esempio Crea release per test interni) e nella sezione Non riuscita (con un badge Risolvi i problemi per pubblicare) nella pagina Versioni dell'app connessa.

Se i controlli automatici segnalano problemi con l'app bundle, segui questi passaggi:

Risolvi i problemi di AppFunctions sottostanti nel codice dell'app per Android e crea un app bundle aggiornato.
Se la release precedente è ancora una bozza e vuoi riutilizzare lo stesso codice di versione:
1. Nel menu di navigazione a sinistra dell'app Play, seleziona Test interni (o il canale pertinente) e seleziona Modifica release nella versione bozza.
2. Seleziona il menu con tre puntini (⋮) accanto all'app bundle e seleziona Rimuovi app bundle.
3. Seleziona Salva come bozza.
4. Nel menu di navigazione a sinistra, seleziona Release e bundle più recenti (seleziona Visualizza tutti gli app bundle, se necessario), seleziona il bundle e poi Elimina app bundle.
5. Torna alla versione bozza, carica l'app bundle corretto e seleziona Invia l'app connessa e continua.
Se non è possibile eliminare il bundle precedente, incrementa il valore versionCode dell'app bundle, carica il nuovo bundle nella release e seleziona Invia l'app connessa e continua.

Problemi comuni di configurazione e integrazione

La seguente tabella descrive i problemi comuni che potresti riscontrare durante la configurazione dell'app connessa, il caricamento del bundle o i test, insieme alle relative cause e soluzioni:

Problema	Messaggio o sintomo della console	Causa	Risoluzione
App bundle caricato prima di creare o collegare un'app connessa	La pagina della release mostra Crea o collega un'app connessa.	Il file `.aab` caricato contiene AppFunctions, ma l'app Play non è ancora collegata a un'app Android MCP connessa.	Completa i passaggi da 1 a 3 per creare un'app connessa, seleziona Android MCP, collega la tua app Play e salva i Dettagli sull'app. Quindi, elimina e ricarica l'app bundle o carica un nuovo bundle con un `versionCode` incrementato.
App bundle caricato prima di salvare i dettagli dell'app connessa	La pagina della release mostra Dettagli dell'app connessa obbligatori e un pulsante Fornisci i dettagli dell'app connessa.	L'app Play è collegata a un'app collegata MCP per Android, ma i campi obbligatori nella pagina Dettagli sull'app non sono stati salvati prima del caricamento del bundle.	Seleziona Fornisci i dettagli dell'app connessa (o vai ad App connesse > Gestisci > Aggiungi dettagli dell'app), compila e salva tutti i campi obbligatori, quindi elimina e ricarica il bundle o carica un nuovo bundle con un `versionCode` incrementato.
Impossibile selezionare l'app Play durante il collegamento	L'app Play di destinazione mostra il badge Già collegata o non viene visualizzata nella finestra di dialogo Seleziona app.	Ogni app Play può essere collegata a una sola app connessa Android MCP oppure l'app Play non è ancora stata creata in questo account sviluppatore.	Controlla le voci esistenti in App collegate per vedere se un'altra app collegata è già collegata alla tua app Play oppure crea prima l'app Play in Google Connected Console prima di collegarla.
Impossibile creare un'app connessa	L'opzione per creare un'app connessa non esiste o la creazione di un'app connessa mostra un avviso relativo alle autorizzazioni o ai Termini di servizio.	Il tuo account utente non dispone delle autorizzazioni per le app connesse oppure un proprietario o un amministratore dell'account non ha ancora accettato i Termini di servizio delle app connesse.	Chiedi a un proprietario dell'account o amministratore di accettare i Termini di servizio delle App connesse e di concedere al tuo account l'autorizzazione Visualizzazione di App connesse o Creazione e gestione di App connesse nella pagina Utenti e autorizzazioni.
Versione dell'app connessa bloccata in "In attesa di invio"	In App connesse > Gestisci > Versioni, la versione del bundle viene visualizzata in In attesa di invio anziché in Disponibile per i tester.	Google Connected Console ha rilevato AppFunctions nel bundle caricato, ma la versione dell'app connessa non è stata inviata dalla pagina della release.	Apri la release dell'app Play contenente il bundle e seleziona Invia l'app connessa e continua in modo che i tester possano visualizzarla in anteprima.
Esempio di prompt di errore di convalida nella pagina dei dettagli dell'app	Il modulo Scheda dell'app pubblica non può essere salvato e viene visualizzato un errore in Prompt di esempio.	I prompt non rispettano le regole di formattazione o di menzione oppure Nome app è stato modificato dopo la scrittura dei prompt.	Fornisci da tre a quattro prompt in totale: inizia almeno due con `@<YourAppName>`, menziona `<YourAppName>` in modo naturale senza `@` in almeno uno e rimuovi i prefissi numerati (`1.`, `2.`) o le virgolette circostanti (`"..."`).
App connessa non visibile ai tester in Gemini su Android	I tester non riescono a trovare l'app connessa in App connesse o utilizzando una menzione `@` nell'app Gemini per Android.	La propagazione è ancora in corso, l'account del tester non è idoneo o la versione dell'app installata non corrisponde.	Attendi circa 20 minuti dopo l'invio (e fino a 10 minuti dopo aver salvato i tester). Verifica che il tester utilizzi un account `@gmail.com` personale nell'elenco di indirizzi email salvati, utilizzi uno smartphone o un tablet Android e abbia installato la versione esatta del bundle inviato.