Crée un document vierge à l'aide du titre indiqué dans la requête. Les autres champs de la requête, y compris tout contenu fourni, sont ignorés.
Renvoie le document créé.
Requête HTTP
POST https://docs.googleapis.com/v1/documents
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
Champs | |
---|---|
documentId |
Uniquement en sortie. ID du document. |
title |
Titre du document. |
tabs[] |
Onglets faisant partie d'un document Les onglets peuvent contenir des onglets enfants, qui sont imbriqués dans un autre onglet. Les onglets enfants sont représentés par le champ |
revisionId |
Uniquement en sortie. ID de la révision du document. Peut être utilisé dans les requêtes de mise à jour pour spécifier la révision d'un document à laquelle appliquer les mises à jour et le comportement de la requête si le document a été modifié depuis cette révision. Renseigné uniquement si l'utilisateur est autorisé à modifier le document. L'ID de révision n'est pas un numéro séquentiel, mais une chaîne opaque. Le format de l'ID de révision peut changer au fil du temps. Un ID de révision renvoyé n'est valide que pendant 24 heures après avoir été renvoyé et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision n'est pas modifié entre les appels, cela signifie que le document n'a pas été modifié. À l'inverse, un ID modifié (pour le même document et le même utilisateur) signifie généralement que le document a été mis à jour. Toutefois, un ID modifié peut également être dû à des facteurs internes, tels que des changements de format de l'ID. |
suggestionsViewMode |
Uniquement en sortie. Mode d'affichage des suggestions appliqué au document. Remarque: Lorsque vous modifiez un document, les modifications doivent être basées sur un document |
body |
Uniquement en sortie. Corps principal du document. Ancien champ: utilisez plutôt |
headers |
Uniquement en sortie. En-têtes du document, associés par ID d'en-tête. Ancien champ : utilisez plutôt |
footers |
Uniquement en sortie. Pieds de page du document, indexés par leur ID. Ancien champ : utilisez plutôt |
footnotes |
Uniquement en sortie. Notes de bas de page du document, associées par leur ID. Ancien champ : utilisez plutôt |
documentStyle |
Uniquement en sortie. Style du document. Ancien champ: utilisez plutôt |
suggestedDocumentStyleChanges |
Uniquement en sortie. Modifications suggérées pour le style du document, associées à l'ID de suggestion. Ancien champ: utilisez plutôt |
namedStyles |
Uniquement en sortie. Styles nommés du document. Ancien champ : utilisez plutôt |
suggestedNamedStylesChanges |
Uniquement en sortie. Modifications suggérées pour les styles nommés du document, associés par ID de suggestion. Ancien champ: utilisez plutôt |
lists |
Uniquement en sortie. Listes du document, classées par ID de liste. Ancien champ: utilisez plutôt |
namedRanges |
Uniquement en sortie. Plages nommées du document, triées par nom. Ancien champ : utilisez plutôt |
inlineObjects |
Uniquement en sortie. Objets intégrés dans le document, indexés par ID d'objet. Ancien champ : utilisez plutôt |
positionedObjects |
Uniquement en sortie. Objets positionnés dans le document, associés par ID d'objet. Ancien champ: utilisez plutôt |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Document
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Pour en savoir plus, consultez le guide d'autorisation.