Règles et comportement des modifications de structure

Cette section décrit les comportements et les limites que vous devez comprendre 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 non valide des éléments d'un document. Examinez 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 principales règles de ces méthodes.

Insérer du texte

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

Insérer des images intégrées

  • La taille de l'image doit être inférieure à 50 Mo, ne peut pas dépasser 25 mégapixels et doit être au format PNG, JPEG ou GIF.
  • L'URI fourni doit être accessible publiquement et ne pas dépasser 2 Ko.
  • L'image doit être insérée dans les limites d'un Paragraph existant. Par exemple, du texte ne peut pas être inséré au niveau de l'index de début d'une table.
  • Les images ne peuvent pas être insérées dans une note de bas de page ou une équation.
  • Pour en savoir plus, consultez la section 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, celle-ci est appliquée à tous les paragraphes partiellement ou complètement chevauchés par cette plage.
  • Vous pouvez étendre la plage pour inclure des 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 de tabulations précédant chaque paragraphe.
  • Les onglets de début sont supprimés lors de la création des puces, ce qui peut modifier les index des parties du texte.
  • Si vous ajoutez des puces de paragraphe correspondant à 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

  • La suppression de texte qui traverse une limite de paragraphe peut entraîner des modifications des styles de paragraphe, des listes, des objets positionnés et des favoris lors de la fusion des deux paragraphes.

  • Les suppressions entraînant une structure de document incorrecte 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'intégralité de l'élément.

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

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

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