Distribuzione di app

Le sezioni che seguono forniscono informazioni utili sulla distribuzione delle app nella versione gestita di Google Play.

Installa app

Puoi installare app per Android dal Google Play Store sui dispositivi che utilizzano le norme. Per utilizzare questa funzionalità, devi conoscere il nome del pacchetto dell'app che vuoi installare. Per trovare il nome del pacchetto dell'app, hai due opzioni:

1. Il nome del pacchetto dell'app si trova nell'URL della pagina del Google Play Store. Ad esempio, l'URL della pagina dell'app Google Chrome è

   https://play.google.com/store/apps/details?id=com.android.chrome

   e il nome del pacchetto è com.android.chrome.

2. Puoi incorporare l'iframe della versione gestita di Google Play nella tua console EMM per consentire ai clienti di sfogliare il Google Play Store. Quando il cliente seleziona un'app nell'iframe, la console EMM riceve il nome del pacchetto nell'evento.

Puoi quindi aggiungere l'app nel regolamento del dispositivo:

"applications":[
   {
      "installType":"FORCE_INSTALLED",
      "packageName":"com.android.chrome",
   },
],

Quando applichi il criterio a un dispositivo, l'app viene installata sul dispositivo o aggiunta alla versione gestita di Google Play Store sul dispositivo.

Distribuire app per i test chiusi

In Play Console, gli sviluppatori di app possono creare una release chiusa (canale chiuso) per testare le versioni pre-release della loro app con un gruppo di tester. Questo tipo di test si chiama test chiuso. Il supporto della distribuzione in canali chiusi consente alle organizzazioni di testare le app di terze parti, nonché le app private sviluppate internamente.

Quando configurano un test chiuso in Play Console, gli sviluppatori di app possono scegliere come target fino a 100 organizzazioni (enterprises). Puoi utilizzare l'API Android Management per recuperare i canali chiusi scelti come target per un'azienda e distribuirli sui dispositivi utilizzando il regolamento.

App idonee per i test chiusi

Prima di configurare un test chiuso, gli sviluppatori di app devono assicurarsi che la loro app soddisfi i seguenti requisiti:

• Una versione di produzione dell'app è pubblicata su Google Play (o su Google Play gestito, per le app private)
• In Google Play Console, la versione gestita di Google Play è attivata nella pagina Impostazioni avanzate dell'app.
• Tutte le versioni chiuse dell'app soddisfano i requisiti per i codici di versione.

Aggiungere un'azienda ai test chiusi

Quando configurano un test chiuso, gli sviluppatori di app possono concedere a un'organizzazione l'accesso ai test chiusi aggiungendo il proprio ID organizzazione. I tuoi clienti possono trovare il proprio ID organizzazione seguendo queste istruzioni:

1. Accedi alla versione gestita di Google Play con un account amministratore.
2. Fai clic su Impostazioni amministratore.
3. Copia la stringa ID organizzazione dalla casella Informazioni sull'organizzazione e inviala allo sviluppatore.

Per le app private, lo sviluppatore deve anche aggiungere l'ID organizzazione di ogni azienda partecipante nella scheda Versione gestita di Google Play della pagina Impostazioni avanzate dell'app. Per le istruzioni, consulta Pubblicare app private da Play Console.

Distribuire tracce chiuse agli utenti

Per recuperare un elenco di canali disponibili per un'azienda per un'app specifica, chiama enterprises.applications. L'elenco appTrackInfo[] incluso nella risposta contiene quanto segue per determinate app:

• trackId: l'identificatore univoco del canale, ricavato da releaseTrackId nell'URL della pagina di Play Console che mostra le informazioni sul canale dell'app.
• trackAlias: il nome leggibile del canale, modificabile in Play Console.

Per installare un canale chiuso sul dispositivo di un utente, specifica accessibleTrackIds nei criteri del dispositivo:

"applications":[
   {
      "installType":"AVAILABLE",
      "packageName":"com.google.android.gm",
      "accessibleTrackIds":[
          "123456",
          "789101"
       ]
   },
],

Se un criterio contiene più canali della stessa app (come nell'esempio riportato sopra), il criterio installa il canale con il codice di versione più alto.

I trackId verranno rimossi automaticamente dalla chiamata enterprises.applications in determinati scenari, come i seguenti:

• L'APK del canale viene promosso a un altro canale o alla produzione.
• La versione di produzione è aggiornata con una versione successiva a quella del canale.
• Uno sviluppatore interrompe il canale.

Nota: per impostazione predefinita, l'app viene aggiornata con la modalità di aggiornamento predefinita. Se vuoi che l'app venga aggiornata più rapidamente, puoi attivare la modalità di priorità elevata.

---

Iframe della versione gestita di Google Play

Con l'iframe della versione gestita di Google Play, puoi incorporare la versione gestita di Google Play direttamente nella tua console EMM per offrire ai clienti un'esperienza di gestione della mobilità unificata.

Figura 1. Iframe della versione gestita di Google Play

L'iframe contiene una barra del titolo e un menu laterale espandibile. Dal menu, gli utenti possono accedere a diverse pagine:

• Cerca app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionarle.
• App private: consente agli amministratori IT di pubblicare e gestire app private per la loro azienda.
• App web: consente agli amministratori IT di pubblicare e distribuire le scorciatoie dei siti web come app.
• Organizza app: consente agli amministratori IT di configurare il modo in cui le app vengono organizzate nell'app Play Store sui dispositivi degli utenti.

---

Funzionalità

Questa sezione descrive le funzionalità disponibili nell'iframe della versione gestita di Google Play. Per informazioni su come incorporare l'iframe e implementare queste funzionalità, consulta Aggiungere l'iframe alla console.

Cerca applicazioni

La pagina Cerca app (mostrata nella Figura 1) consente agli amministratori IT di cercare, sfogliare e selezionare le app di Google Play.

Casella di ricerca

Nella pagina è attiva per impostazione predefinita una casella di ricerca nella barra del titolo. La casella di ricerca supporta funzionalità come il suggerimento automatico e restituisce risultati provenienti da app elencate pubblicamente su Google Play. I risultati della ricerca vengono visualizzati all'interno dell'iframe.

Nota: se nella tua console è già integrata una funzionalità di ricerca, puoi disattivare la casella di ricerca e passare le query di ricerca nell'URL dell'iframe. Per ulteriori dettagli, consulta la sezione Parametri URL in Passaggio 2: esegui il rendering dell'iframe.

Nota: se stai cercando app private o web, utilizza l'ID della tua azienda per trovarle meglio. Per visualizzare l'ID dell'azienda, fai clic sull'icona a forma di ingranaggio con una persona nell'angolo in alto a destra dell'iframe e copia il testo dal campo ID.

App private

Figura 2. Schermata dei dettagli delle app private

La pagina App private consente agli amministratori IT di pubblicare e gestire le app private direttamente dalla console EMM. Per semplificare la pubblicazione di app private per gli amministratori IT, la pagina:

• Crea in silenzio un account Play Console per conto dell'azienda e concede l'accesso amministrativo agli amministratori IT.
• Viene rinunciata alla quota di registrazione di Play Console di 25 $precedentemente richiesta per pubblicare app.
• Richiede solo l'APK e il titolo di un'app.
• Pubblica le app in appena 10 minuti (rispetto alle 2 ore di Play Console).
  Nota: le app pubblicate dalla pagina App private non possono mai essere rese pubbliche.

La prima volta che un amministratore IT pubblica un'app nell'iframe, quest'ultimo crea in silenzio un account Play Console per conto dell'azienda. Se esegue modifiche avanzate, gli viene chiesto di accedere con un Account Google, che può essere qualsiasi (ad es. Gmail, Cloud Identity). Questo Account Google viene aggiunto come amministratore dell'account Play Console dell'azienda. In seguito, un amministratore IT può utilizzare il proprio Account Google per accedere direttamente a Play Console, dove può:

• Aggiungere e gestire gli account amministratore.
• Aggiungi dettagli avanzati dell'app, tra cui descrizioni, screenshot e altro ancora.
• Annullare la pubblicazione delle app.

Le istruzioni per gli amministratori IT su come utilizzare la pagina App private sono disponibili nel Centro assistenza della versione gestita di Google Play.

Pulsante Seleziona

Dopo la pubblicazione di un'app, un amministratore IT può modificarne il titolo e l'APK nella pagina dei dettagli dell'app. Nella pagina dei dettagli dell'app viene visualizzato anche un pulsante SELEZIONA (vedi Figura 2). Devi specificare l'azione che viene eseguita quando l'amministratore IT fa clic su questo pulsante (vedi onproductselect nel passaggio 3. Gestire gli eventi di iframe).

App web

Figura 3. Il modulo per la creazione di app web.

La pagina App web consente agli amministratori IT di pubblicare le scorciatoie dei siti web come app private nella versione gestita di Google Play. Le app web sono identificabili dal nome del pacchetto (productId) e in genere richiedono 10 minuti per la pubblicazione. Dopo la pubblicazione, vengono approvate automaticamente per l'azienda e possono essere distribuite agli utenti come qualsiasi altra app approvata. Le app web sono compatibili con altre funzionalità dell'iframe di Google Play gestito: sono disponibili per la ricerca nella pagina di ricerca di Google Play e possono essere aggiunte alle raccolte.

Avviso: il titolo e l'icona di un'app web devono essere conformi alle Norme del programma per gli sviluppatori di Google Play. Le app non conformi non verranno pubblicate e rimarranno indicate come Non ancora disponibili.

Il modulo di creazione dell'app web richiede un titolo, un URL HTTPS o HTTP e un'immagine dell'icona (JPG 512 x 512 o PNG a 32 bit). Inoltre, gli amministratori IT possono scegliere tra le tre opzioni di visualizzazione:

• Schermo intero:l'app si apre in modalità a schermo intero. Le barre di stato e di navigazione del dispositivo sono nascoste.
• Autonomo (impostazione predefinita): l'app mostra la barra di stato e la barra di navigazione del dispositivo.
• UI minima:l'app mostra la barra di stato e la barra di navigazione del dispositivo, l'URL dell'app e un'opzione di aggiornamento. Per gli URL HTTP, questa è l'unica opzione disponibile.

Importante: le app web si aprono nel browser predefinito selezionato dall'utente (Impostazioni>App>App predefinite>App browser). Le funzionalità (ad es. a schermo intero, modalità autonoma, UI minima) dipendono dalla compatibilità del browser predefinito selezionato dall'utente. È importante notare che alcuni browser potrebbero non supportare tutte queste funzionalità. Gli amministratori IT devono verificare la compatibilità del browser prima del deployment.

La pagina App web consente inoltre agli amministratori IT di modificare ed eliminare le app web. L'eliminazione di un'app web determina la sua rimozione dalla versione gestita di Google Play Store di un utente, ma l'utente potrebbe comunque avere accesso all'app se è già installata sul suo dispositivo. Per eliminare un'app web dal dispositivo di un utente, consulta Eliminare le app. Le istruzioni per gli utenti su come creare e modificare le app web sono disponibili nel Centro assistenza Google Play gestito.

Pulsante Seleziona

Una volta pubblicata, la pagina dei dettagli di un'app web include un pulsante SELECT. Devi specificare l'azione (ad esempio, la distribuzione dell'app) che viene eseguita quando l'amministratore IT fa clic su questo pulsante (vedi onproductselect nel passaggio 3. Gestisci gli eventi iframe.

Organizza le app

Figura 4. L'iframe della versione gestita di Google Play che mostra la pagina Organizza app.

La pagina Organizza app consente agli amministratori IT di organizzare le app in raccolte (chiamate anche cluster). Ad esempio, un amministratore IT può creare una raccolta Principali per le app di uso frequente o una raccolta Spese per le app correlate al monitoraggio delle spese, alla registrazione dei viaggi e così via. Le raccolte vengono visualizzate nella home page del Play Store sui dispositivi dell'utente.

I fornitori EMM devono utilizzare SELECT mode nei parametri dell'URL iframe per consentire la ricerca e l'aggiunta di app alle raccolte.

Sui dispositivi dell'utente, l'app Play Store mostra solo le app di una raccolta disponibili per l'utente (o il dispositivo). Se una raccolta non include app disponibili per l'utente (o per il dispositivo), non verrà visualizzata nel Play Store.

Figura 5. Raccolte di app (cluster)
su un dispositivo.

Gli amministratori IT possono anche modificare, eliminare e copiare le raccolte esistenti nella pagina Organizza app. Le istruzioni per gli utenti su come eseguire queste attività sono disponibili nel Centro assistenza della versione gestita di Google Play.

---

Aggiungi l'iframe alla console

Passaggio 1: Generare un token web

Chiama enterprises.webTokens.create per generare un token web che identifica l'azienda. La risposta contiene il value del token.

• Imposta parentFrameUrl sull'URL del frame principale che ospita l'iframe.
• Utilizza iframeFeature per specificare le funzionalità da attivare nell'iframe: PLAY_SEARCH, PRIVATE_APPS, WEB_APPS, STORE_BUILDER (organizza le app). Se iframeFeature non è impostato, l'iframe attiva tutte le funzionalità per impostazione predefinita.

Passaggio 2: Esegui il rendering dell'iframe

Di seguito è riportato un esempio di come eseguire il rendering dell'iframe della versione gestita di Google Play:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Questo codice genera un iframe all'interno del contenitore div. Gli attributi da applicare al tag iframe possono essere impostati con l'opzione "attributes", come accennato in precedenza.

Parametri URL

La tabella seguente elenca tutti i parametri disponibili per l'iframe che possono essere aggiunti all'URL come parametri URL, ad esempio:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',

Parametro	Pagina	Obbligatorio	Descrizione
token	N/D	Sì	Il token restituito dal passaggio 1.
iframehomepage	N/D	No	La pagina iniziale visualizzata quando viene visualizzato l'iframe. I valori possibili sono PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizza app). Se non specificato, il seguente ordine di precedenza determina la pagina visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale	N/D	No	Un tag lingua BCP 47 ben formato utilizzato per localizzare i contenuti nell'iframe. Se non è specificato, il valore predefinito è en_US.
mode	Cerca applicazioni	No	SELECT: consente agli amministratori IT di selezionare le app. APPROVE (valore predefinito): consente agli amministratori IT di selezionare, approvare e annullare l'approvazione delle app. Ritiro: questa modalità è deprecata. Utilizza SELECT instead. Questo metodo non sarà più accessibile a nessuno dopo il 30 settembre 2025. La modalità APPROVE funziona solo se PlaySearch.ApproveApps è impostato su true nel token web.
showsearchbox	Cerca applicazioni	No	TRUE (valore predefinito): mostra la casella di ricerca e avvia la query di ricerca dall'interno dell'iframe. FALSE: la casella di ricerca non viene visualizzata.
search	Cerca applicazioni	No	Stringa di ricerca. Se specificato, l'iframe indirizza l'amministratore IT ai risultati di ricerca con la stringa specificata. Nota: includere questo parametro solo se la casella di ricerca si trova al di fuori dell'iframe (showsearchbox = FALSE).

Passaggio 3: Gestire gli eventi iframe

Nell'ambito dell'integrazione, devi anche gestire i seguenti eventi.

Evento	Descrizione
onproductselect	L'utente seleziona o approva un'app. Viene restituito un oggetto contenente: { "packageName": The package name of the app, e.g. "com.google.android.gm", "productId": The product ID of the app, e.g. "app:com.google.android.gm", "action": The type of action performed on the document. Possible values are: "approved", "unapproved" or "selected." If you implement the iframe in SELECT mode, the only possible value is "selected". }

L'esempio seguente mostra come ascoltare onproductselect:

iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);

---

Caricare la tua app sul Google Play Store

Se tu o il tuo cliente sviluppate un'app per Android, potete caricarla sul Play Store utilizzando Google Play Console.

Se non vuoi che l'app sia disponibile pubblicamente sul Play Store, puoi limitarla a un'unica azienda utilizzando Google Play Console. Un'altra opzione è pubblicare un'app privata tramite programmazione utilizzando l'API Custom App Publishing di Google Play. Le app private sono disponibili solo per l'azienda a cui sono limitate. Possono essere comunque installati utilizzando un criterio, ma non sono visibili agli utenti esterni alla tua azienda.