Règles et comportement des modifications de structure

Cette section décrit les comportements et les limites que vous devez connaître lorsque vous modifiez des documents à l'aide de l'API Google Docs.

En général, vous ne pouvez pas effectuer de modifications qui entraînent une structure d'éléments non valide dans un document. Vérifiez chaque méthode de requête documents.batchUpdate pour connaître les contraintes et les règles qui s'appliquent à ces requêtes.

Les sections suivantes récapitulent les règles clés de ces méthodes.

Insérer du texte

  • L'insertion d'un caractère de nouvelle ligne crée implicitement un Paragraph à cet index. Le style de paragraphe du nouveau paragraphe est copié à partir du paragraphe à l'index d'insertion actuel, y compris les listes et les puces.
  • Le texte doit être inséré dans les limites d'un Paragraph existant. Par exemple, vous ne pouvez pas insérer de texte à l'index de début d'un tableau. Le texte doit être inséré dans le paragraphe précédent.
  • L'API peut ajuster implicitement l'emplacement pour éviter les insertions dans les groupes de graphèmes Unicode. Dans ce cas, le texte est inséré immédiatement après le cluster de graphèmes.
  • Les styles de texte pour le texte inséré sont déterminés automatiquement, en préservant généralement le style du texte voisin. En règle générale, le style de texte du texte inséré correspond au texte immédiatement avant l'indice d'insertion.
  • Certains caractères de contrôle (U+0000-U+0008, U+000C-U+001F) et caractères de la zone à usage privé du plan multilingue de base Unicode (U+E000-U+F8FF) sont supprimés du texte inséré.
  • Pour en savoir plus, consultez Insérer, supprimer et déplacer du texte.

Insérer des images intégrées

  • L'image ne doit pas dépasser 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
  • L'URI fourni doit être accessible au public et ne pas dépasser 2 ko.
  • L'image doit être insérée dans les limites d'un Paragraph existant. Par exemple, vous ne pouvez pas insérer de texte à l'index de début d'un tableau.
  • Vous ne pouvez pas insérer d'images dans une note de bas de page ni dans une équation.
  • Pour en savoir plus, consultez Insérer des images intégrées.

Mettre en forme du texte

  • Lorsque vous appliquez une mise en forme au niveau du paragraphe à une plage, elle est appliquée à tous les paragraphes partiellement ou complètement chevauchés par cette plage.
  • La plage peut être étendue pour inclure les sauts de ligne adjacents.
  • Si la plage contient entièrement un paragraphe appartenant à une liste, la puce du paragraphe est également mise à jour avec le style de texte correspondant.
  • Pour en savoir plus, consultez Mettre en forme le texte.

Créer des puces de paragraphe

  • Crée des puces pour tous les paragraphes qui chevauchent la plage donnée.
  • Le niveau d'imbrication de chaque paragraphe est déterminé par le nombre d'onglets d'en-tête avant chaque paragraphe.
  • Les onglets d'en-tête sont supprimés lors de la création des puces, ce qui peut modifier les index de certaines parties du texte.
  • Si vous ajoutez des puces de paragraphe qui correspondent à celles d'une liste immédiatement avant le paragraphe cible, le paragraphe est joint à la liste.
  • Pour en savoir plus, consultez Utiliser des listes.

Supprimer du texte

  • Si vous supprimez du texte qui traverse une limite de paragraphe, les styles de paragraphe, les listes, les objets positionnés et les signets peuvent changer lorsque les deux paragraphes sont fusionnés.

  • Les suppressions qui entraînent une structure de document non valide ne sont pas autorisées. Voici quelques exemples de requêtes de suppression non valides:

    • Suppression d'une unité de code d'une paire de substitution.

    • Suppression du dernier caractère de nouvelle ligne d'un élément Body, Header, Footer, Footnote, TableCell ou TableOfContents.

    • Suppression du début ou de la fin d'un élément Table, TableOfContents ou Equation sans supprimer l'élément entier.

    • Suppression du caractère de nouvelle ligne avant un Table, TableOfContents ou SectionBreak sans supprimer l'élément.

    • Supprimer des lignes ou des cellules individuelles d'une table La suppression du contenu d'une cellule de tableau est autorisée.

  • Pour en savoir plus, consultez Insérer, supprimer et déplacer du texte.