Ce guide présente les principales méthodes de requête et de réponse qui constituent l'API Google Docs et explique comment mettre à jour un document par lots.
Vous pouvez appeler l'API Google Docs à l'aide d'une requête HTTP ou d'un appel de méthode dans une bibliothèque cliente spécifique à un langage. Ces concepts sont globalement équivalents.
L'API Google Docs renvoie une réponse HTTP, qui inclut généralement le résultat de l'appel de la requête. Lorsque vous utilisez une bibliothèque cliente pour effectuer des requêtes, les réponses sont renvoyées d'une manière spécifique au langage.
Méthodes de requête
L'API Docs est compatible avec les méthodes suivantes:
documents.create: créer un document Google Docs vierge.documents.get: renvoie une instance complète du document spécifié. Vous pouvez analyser le fichier JSON renvoyé pour en extraire le contenu, la mise en forme et d'autres fonctionnalités du document.documents.batchUpdate: permet d'envoyer une liste de demandes de modification à appliquer de manière atomique au document et de renvoyer une liste de résultats.
Les méthodes documents.get et documents.batchUpdate nécessitent un documentId comme paramètre pour spécifier le document cible. La méthode documents.create renvoie une instance du document créé, à partir de laquelle vous pouvez lire le documentId. Pour en savoir plus sur documentId, consultez la section Identifiant du document.
Mises à jour groupées
La méthode documents.batchUpdate prend une liste d'objets request, chacun spécifiant une seule requête à effectuer. Par exemple, mettez en forme un paragraphe,
puis ajoutez une image intégrée. Chaque requête est validée avant d'être appliquée, et les requêtes sont traitées dans l'ordre dans lequel elles apparaissent dans la requête par lot.
Toutes les requêtes de la mise à jour par lot sont appliquées de manière atomique. Autrement dit, si une requête n'est pas valide, la mise à jour entière échoue et aucune des modifications (potentiellement dépendantes) n'est appliquée.
Certaines méthodes documents.batchUpdate fournissent des réponses contenant des informations sur les requêtes appliquées. Ces méthodes renvoient un corps de réponse contenant une liste d'objets response. Les autres requêtes n'ont pas besoin de renvoyer d'informations et d'afficher une réponse vide. Les objets de la liste de réponses occupent le même ordre d'index que la requête correspondante.
Voici un modèle couramment utilisé pour effectuer des requêtes par lot:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
Pour en savoir plus sur le traitement par lot de vos appels d'API Docs, consultez les bonnes pratiques concernant les requêtes par lot, ainsi que la documentation de référence sur documents.batchUpdate pour les types de requêtes et de réponses.
Opérations de mise à jour groupée
Il existe différents types de requêtes de mise à jour groupée. Voici le détail des types de requêtes, regroupés en différentes catégories.
Articles associés
- Structure d'un document Google Docs
- Règles et comportement des modifications structurelles
- Requêtes par lot