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, et renvoie des métadonnées de fichier spécifiques (telles que des ID et des URL) à votre application une fois qu'un utilisateur a effectué 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 collaboratifs : 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 : utilisez le sélecteur Google pour permettre aux utilisateurs de joindre des documents d'aide de Drive à une note de frais ou à un ticket d'assistance.

Comparaison des applications Web par rapport aux applications de bureau et mobiles

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

Fonctionnalité Applications Web Applications de bureau et mobiles
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 vue Web intégrée.
Flux d'authentification Nécessite un jeton d'accès spécifique transmis via setOAuthToken. Déclenché en ajoutant 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 Flexibles ; peuvent utiliser drive.file, drive.readonly, etc. Strictes ; seul drive.file est autorisé et ne peut pas être combiné avec d'autres niveaux d'accès.
Configuration Utilise l'interface fluide PickerBuilder en JavaScript. Utilise des paramètres de chaîne de requête dans l'URL d'autorisation.

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

Les principales différences stratégiques sont les suivantes :

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