Ce guide présente les principales méthodes de requête et de réponse de 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 au langage. Ils 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 de manière spécifique au langage.
Méthodes de requête
L'API Docs est compatible avec les méthodes suivantes:
documents.create: créez 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.documents.batchUpdate: envoyez une liste de requêtes de modification à appliquer de manière atomique au document et renvoyez 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 ID du document.
Mises à jour groupées
La méthode documents.batchUpdate accepte 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 ni 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)
Consultez les bonnes pratiques concernant les requêtes par lot pour en savoir plus sur le traitement par lot de vos appels d'API Docs, ainsi que la documentation de référence documents.batchUpdate sur les types de requêtes et de réponses.
Opérations de mise à jour par lot
Il existe différents types de requêtes de mise à jour par lot. 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 de modification structurelle
- Requêtes par lot