Questo documento introduce Google Picker e l'API Google Picker. Inoltre, ti aiuta a decidere quale approccio è più adatto alla tua app.
Il selettore Google fornisce una finestra di dialogo "Apri file" raffinata per le informazioni archiviate su Google Drive. Consente agli utenti di selezionare o caricare foto, video e documenti dal proprio account Drive senza mai uscire dall'applicazione.
L'API Google Picker è l'interfaccia tecnica utilizzata per implementare Google Picker nella tua app. Utilizzando l'API Google Picker, crei un'interfaccia familiare che gestisce la complessità dell'autenticazione e della navigazione dei file, restituendo metadati specifici dei file (come ID e URL) alla tua app una volta che l'utente effettua una selezione.
Casi d'uso principali
Il selettore Google è versatile e può essere adattato a vari flussi di lavoro delle applicazioni:
- Alternativa al caricamento di file: gli utenti possono caricare un file in Drive direttamente tramite Google Picker.
- Strumenti di collaborazione: consentono agli utenti di collegare documenti Google o Fogli Google specifici a un'attività di gestione dei progetti o a un evento di calendario condiviso.
- Allegati di asset: utilizza Google Picker per consentire agli utenti di allegare la documentazione di supporto da Drive a una nota spese o a una richiesta di assistenza.
Confronto tra app web e app mobile e desktop
Sebbene la funzionalità di base rimanga coerente, l'implementazione dell'API Google Picker varia a seconda di dove viene eseguita l'app. La seguente tabella di confronto elenca le differenze tecniche e funzionali durante l'implementazione per le app web rispetto alle app per computer e dispositivi mobili.
| Funzionalità | App web | App per computer e dispositivi mobili |
|---|---|---|
| Tecnologia principale | Libreria JavaScript lato client. | Parametri URL OAuth 2.0 e reindirizzamenti HTTP. |
| Rendering | Si integra nel layout dell'interfaccia utente esistente dell'app. | Si apre in una nuova scheda del browser di sistema predefinito dell'utente. Non possono più essere visualizzati all'interno di una WebView incorporata. |
| Flusso di autenticazione | Richiede un token di accesso specifico passato tramite setOAuthToken. |
Attivato dall'aggiunta di trigger_onepick=true alla richiesta OAuth. |
| Metodo di risposta | Callback JavaScript diretti. | URI di reindirizzamento o schemi URL personalizzati. |
| Ambiti | Flessibile; può utilizzare drive.file, drive.readonly e così via. |
Rigoroso: è consentito solo drive.file e non può essere combinato con altri ambiti. |
| Configurazione | Utilizza l'interfaccia fluida PickerBuilder in JavaScript. |
Utilizza i parametri della stringa di query nell'URL di autorizzazione. |
Tieni presente che l'utente deve aver eseguito l'accesso quando accede al selettore Google.
Le principali differenze strategiche sono:
- Le app web sono progettate per un'elevata interattività e una personalizzazione approfondita (ad esempio visualizzazioni specifiche per tipo di file e limitazione della visualizzazione a cartelle di Drive specifiche).
- Le app per computer e dispositivi mobili sono progettate per la sicurezza e la semplicità e utilizzano il browser di sistema per gestire l'autenticazione e la selezione dei file in un unico flusso unificato.
Argomenti correlati
- Integrare il selettore Google nelle app web
- Integrare Google Picker in app mobile e desktop
- Utilizzare Google Picker in Google Apps Script
- Scegliere gli ambiti dell'API Google Drive