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 exécuter de modifications qui entraînent la 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 nouvelle ligne crée implicitement un Paragraph au niveau de cet index. Le style de paragraphe du nouveau paragraphe est copié à partir du paragraphe dans 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, le texte ne peut pas être inséré à 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 les clusters de graphèmes Unicode. Dans ce cas, le texte est inséré juste après le cluster de graphèmes.
  • Les styles du texte inséré sont déterminés automatiquement, généralement en préservant le style du texte voisin. En règle générale, le style du texte inséré correspond à celui qui précède l'index d'insertion.
  • Certains caractères de contrôle (U+0000-U+0008, U+000C-U+001F) et certains caractères de la zone d'utilisation privée 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 doit pas dépasser 25 mégapixels et doit être au format PNG, JPEG ou GIF.
  • L'URI fourni doit être accessible publiquement et ne doit pas dépasser 2 Ko.
  • L'image doit être insérée dans les limites d'un élément Paragraph existant. Par exemple, le texte ne peut pas être inséré à 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 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 à tout paragraphe qui est partiellement ou complètement chevauché 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 de tabulations au début de chaque paragraphe.
  • Les onglets de début 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 juste 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 franchit la limite d'un paragraphe peut entraîner des modifications au niveau des styles de paragraphe, des listes, des objets positionnés et des favoris lors de la fusion des deux paragraphes.

  • Les suppressions générant 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

    • Supprimer le dernier caractère de retour à la ligne d'une Body, Header, Footer, Footnote, TableCell ou TableOfContents.

    • Supprimer le début ou la fin d'un Table, d'un TableOfContents ou d'un Equation sans supprimer l'intégralité de l'élément.

    • Supprimer le caractère de retour à la ligne avant Table, TableOfContents ou SectionBreak sans supprimer l'élément

    • Supprimer des lignes ou des cellules individuelles d'un tableau Il est possible de supprimer le contenu d'une cellule de tableau.

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