Google Drive

Google Drive est un connecteur : il relie une application MeDo à un compte Google, afin que l'application puisse rechercher dans ce Drive, ouvrir les détails d'un fichier, créer des dossiers et des fichiers texte, importer depuis une URL publique, télécharger, déplacer ou copier, écraser un fichier, et mettre un élément à la corbeille après confirmation. Le partage et les changements de permissions ne sont pas inclus.

#Ce que vous pouvez construire

• Un navigateur de fichiers privé. Listez un dossier choisi, ouvrez les détails des fichiers, et actualisez à la demande.
• Une page de sauvegarde de rapports. Enregistrez une note texte ou une URL publique dans un dossier nommé, puis confirmez qu'elle y est bien arrivée.
• Un espace de travail de dossier partagé. Conservez les fichiers projet dans un dossier, copiez-les ou déplacez-les lorsque le propriétaire nomme la cible, et affichez la nouvelle organisation.
• Un tableau de nettoyage. Trouvez des fichiers dans un dossier et ne les mettez à la corbeille qu'après confirmation de chaque élément.

Google Drive convient lorsque l'application doit travailler avec de vrais fichiers que le propriétaire conserve déjà dans Drive — navigateurs, sauvegardes et espaces de dossiers. Ce n'est pas un outil d'administration du partage et il ne peut pas vider la corbeille, voir Limites.

#Exemples de construction

Copiez l'un de ces textes dans la zone de saisie. Le premier est le point de départ le plus simple et déjà utile.

Use @Google Drive to build a private file browser that lists a chosen folder and opens file details.

Use @Google Drive to build a report backup page that saves a text note or a public URL into a named folder and confirms it landed.

Use @Google Drive to build a shared-folder workspace that copies or moves a file after I name the target folder.

Use @Google Drive to build a cleanup board that finds files in a folder and trash them only after I confirm each item.

La formulation compte : dites quel dossier l'application doit utiliser. « Un navigateur privé pour le dossier de rapports de l'équipe » produit une application différente de « une page qui liste des fichiers ».

#Préparer et connecter

Vous avez besoin d'un compte Google qui peut déjà ouvrir les fichiers Drive que l'application doit utiliser. Aucune clé API, aucun projet Google Cloud, aucune configuration de facturation.

1. Ouvrez Skills & Connectors dans la barre latérale et recherchez Google Drive.
2. Ouvrez la carte Google Drive et cliquez sur Connect.
3. Connectez-vous au compte Google et autorisez l'accès demandé par MeDo.
4. Le bouton passe à Connected. C'est l'état de succès ; vous n'avez rien à recopier dans l'application.

Si vous commencez à construire avant de connecter, MeDo le détecte et affiche un bouton de connexion Google Drive sous sa réponse. Vous pouvez connecter depuis là. Si aucun bouton n'apparaît, utilisez la carte du connecteur décrite ci-dessus.

#Utilisation dans votre application

• L'application utilise le Drive connecté du propriétaire, pas le compte Google de chaque visiteur. Toute personne qui atteint une vue de fichiers voit le même Drive. Placez les navigateurs de fichiers, les imports et la corbeille derrière la propre connexion de votre application, et limitez-les aux personnes qui doivent y avoir accès. Une page intitulée « privée » n'est pas un contrôle d'accès à elle seule.
• Nommez le dossier dans le prompt. Collez un lien ou un ID de dossier lorsque c'est possible ; les noms peuvent entrer en collision. L'application doit afficher le nom du dossier qu'elle a réellement ouvert.
• Les lectures s'actualisent à la demande. Il n'y a pas de synchronisation en direct avec Drive. Ajoutez un contrôle d'actualisation plutôt que d'attendre que de nouveaux fichiers apparaissent tout seuls.
• La mise à la corbeille est d'abord confirmée. MeDo demande confirmation avant de déplacer un élément vers la corbeille. La suppression définitive et le vidage de la corbeille ne sont pas disponibles.
• Les données propres à l'application restent dans l'application. Libellés, statuts de relecture et notes qui ne sont pas des champs Drive appartiennent aux tables de votre application, avec pour clé le vrai ID de fichier.

#Limites et dépannage

« Connexion requise » s'affiche dans l'application. Demandez au propriétaire de l'application d'ouvrir la carte du connecteur et de cliquer sur Connect, puis de recharger.

La recherche renvoie le mauvais dossier. Les noms de dossiers peuvent entrer en collision. Utilisez l'ID de dossier d'un résultat précédent ou collez le lien du dossier, puis actualisez.

Une mise à la corbeille a été refusée. La corbeille exige une confirmation explicite dans l'application. Vérifiez que l'étape de confirmation a bien eu lieu avant de réessayer.

Un lien de téléchargement a cessé de fonctionner. Les URL de téléchargement sont de courte durée. Demandez un nouveau téléchargement plutôt que de réutiliser un ancien lien.

Les visiteurs voient des fichiers alors qu'ils ne devraient pas. La connexion est partagée. Ajoutez une connexion et des restrictions côté serveur à l'application ; voir Gérer l'accès et les rôles.

#Voir aussi

• Catalogue de connecteurs — les autres connecteurs et leur usage.
• Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
• Gérer l'accès et les rôles — restreignez qui peut lire et modifier les données connectées.