Présentation du sélecteur Google

Ce document présente le sélecteur Google et l'API Google Picker. Il vous aide également à déterminer l'approche la plus adaptée à votre application.

Le sélecteur Google fournit une boîte de dialogue "Ouvrir un fichier" soignée pour les informations stockées dans Google Drive. Il permet aux utilisateurs de sélectionner ou d'importer des photos, des vidéos et des documents depuis leur compte Drive sans jamais quitter votre application.

L'API Google Picker est l'interface technique utilisée pour implémenter le sélecteur Google dans votre application. En utilisant l'API Google Picker, vous créez une interface familière qui gère la complexité de l'authentification et de la navigation dans les fichiers, en renvoyant des métadonnées de fichier spécifiques (telles que les ID et les URL) à votre application une fois qu'un utilisateur a fait une sélection.

Principaux cas d'utilisation

Le sélecteur Google est polyvalent et peut être adapté à différents workflows d'application :

  • Alternative à l'importation de fichiers : les utilisateurs peuvent importer un fichier dans Drive directement via le sélecteur Google.
  • Outils de collaboration : permettez aux utilisateurs d'associer des documents Google Docs ou des feuilles de calcul Google Sheets spécifiques à une tâche de gestion de projet ou à un événement d'agenda partagé.
  • Pièces jointes de composants : utilisez le sélecteur Google pour permettre aux utilisateurs de joindre des pièces justificatives depuis Drive à une note de frais ou à une demande d'assistance.

Comparaison entre les applications Web et les applications pour ordinateur et mobiles

Bien que la fonctionnalité de base reste la même, l'implémentation de l'API Google Picker diffère selon l'endroit où votre application s'exécute. Le tableau comparatif suivant liste les différences techniques et fonctionnelles lors de l'implémentation pour les applications Web par rapport aux applications pour ordinateur et mobiles.

Fonctionnalité Applications Web Applications pour ordinateur et mobile
Technologie principale Bibliothèque JavaScript côté client. Paramètres d'URL OAuth 2.0 et redirections HTTP.
Affichage S'intègre à la mise en page d'interface utilisateur existante de l'application. S'ouvre dans un nouvel onglet du navigateur système par défaut de l'utilisateur. ne peut plus être affiché dans une WebView intégrée.
Flux d'authentification Nécessite un jeton d'accès spécifique transmis via setOAuthToken. Déclenché par l'ajout de trigger_onepick=true à la requête OAuth.
Méthode de réponse Rappels JavaScript directs. URI de redirection ou schémas d'URL personnalisés.
Niveaux d'accès Flexible : peut utiliser drive.file, drive.readonly, etc. Strict : seul drive.file est autorisé et ne peut pas être combiné avec d'autres niveaux d'accès.
Configuration Utilise l'interface fluent PickerBuilder en JavaScript. Utilise des paramètres de chaîne de requête dans l'URL d'autorisation.

Notez que pour utiliser le champ d'application drive.file, l'utilisateur doit être connecté lorsqu'il accède au sélecteur Google.

Voici les principales différences stratégiques :

  • Les applications Web sont conçues pour une interactivité élevée et une personnalisation poussée (par exemple, des vues spécifiques par type de fichier et la restriction de la vue à des dossiers Drive spécifiques).
  • Les applications pour ordinateur et mobiles sont conçues pour la sécurité et la simplicité. Elles utilisent le navigateur système pour gérer l'authentification et la sélection de fichiers dans un flux unique et unifié.