Google Docs

Google Docs est un connecteur : il relie une application MeDo à un compte Google, afin que l'application puisse rechercher les Docs de ce compte, ouvrir un titre et un lien, lire le texte brut visible, créer ou copier un document, ajouter du Markdown, remplir des espaces réservés littéraux, et remplacer un document entier après confirmation. Le choix de dossier, les listes de fichiers Drive, l'export PDF, les commentaires et la suppression ne sont pas inclus.

#Ce que vous pouvez construire

• Un chercheur de documents privé. Recherchez des Docs, en choisissez un, et affichez son titre, son lien et son texte brut.
• Un rédacteur de propositions. Créez un nouveau Google Doc à partir de Markdown que vous relisez, puis affichez le titre et le lien.
• Un remplisseur de modèles. Copiez un Doc sélectionné et remplacez des espaces réservés littéraux après avoir prévisualisé le texte recherché et le texte de remplacement.
• Un espace de notes de réunion. Ajoutez du Markdown à un Doc choisi, et ne remplacez le document entier qu'après confirmation.

Google Docs convient lorsque l'application doit travailler avec de vrais documents que le propriétaire conserve déjà dans Docs — chercheurs, pages de propositions, remplissage de modèles et notes. Ce n'est pas un navigateur Drive et il ne peut pas supprimer de documents, 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 Docs to build a private document finder where I search my Docs, pick one, and see its title, link, and plaintext.

Use @Google Docs to build a private proposal writer that creates a new Google Doc from markdown I review, then shows the title and link.

Use @Google Docs to build a template filler that copies a selected Doc and replaces literal placeholders after I preview the find and replace text.

Use @Google Docs to build a meeting-notes workspace that appends markdown to a chosen Doc, and can replace the whole document only after I confirm.

La formulation compte : nommez le document ou la recherche visée. « Remplir le modèle de contrat T3 » produit une application différente de « une page qui liste des documents ».

#Préparer et connecter

Vous avez besoin d'un compte Google qui peut déjà ouvrir les Docs 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 Docs.
2. Ouvrez la carte Google Docs 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 Docs 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 les Docs connectés du propriétaire, pas le compte Google de chaque visiteur. Toute personne qui atteint une vue de document voit les mêmes Docs. Placez les chercheurs et les écritures 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.
• Partez d'un ID de document ou d'une recherche étroite. Affichez le titre et le lien renvoyés avant d'écrire. Les nouveaux documents et les copies atterrissent à la racine de Mon Drive du propriétaire ; ce connecteur ne peut pas choisir un dossier.
• Les métadonnées ne sont pas le corps. Le titre et le lien viennent d'une consultation de document. Le texte visible vient du texte brut. N'attendez pas de l'appel de métadonnées qu'il renvoie le document complet.
• Le remplissage d'espaces réservés est du texte littéral. Les remplacements correspondent à des chaînes exactes, pas à des expressions régulières.
• Le remplacement du document entier est d'abord confirmé. MeDo demande confirmation avant d'écraser un Doc entier.
• Les lectures s'actualisent à la demande. Il n'y a pas de synchronisation en direct avec Google Docs. Ajoutez un contrôle d'actualisation plutôt que d'attendre que du nouveau texte apparaisse tout seul.
• Les données propres à l'application restent dans l'application. Libellés, statuts de relecture et notes qui ne sont pas des champs Doc appartiennent aux tables de votre application, avec pour clé le vrai ID de document.

#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 document. Les titres peuvent entrer en collision. Utilisez l'ID de document d'un résultat précédent ou collez le lien du Doc, puis actualisez.

Un remplacement de document entier a été refusé. Remplacer tout le Doc exige une confirmation explicite dans l'application. Vérifiez que l'étape de confirmation a bien eu lieu avant de réessayer.

Les visiteurs voient des documents 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.
• Google Drive — fichiers et dossiers, pas les corps de documents.
• Google Sheets — plages de tableur, pas des Docs.
• 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.