Règles et comportement des modifications de structure

Cette section décrit les comportements et les limites que vous devez comprendre vous pouvez modifier des documents à l'aide de l'API Google Docs.

En général, vous ne pouvez pas effectuer de modifications qui causent la structure incorrecte de dans un document. Examiner chaque documents.batchUpdate de requête pour 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 à cela de l'index. Le style 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 élément Paragraph existant. Pour 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 Clusters de graphèmes Unicode Dans ce cas, le texte est inséré juste après l'amas de graphèmes.
  • Le style du texte inséré est déterminé automatiquement. En règle générale, sans perdre le style du texte voisin. En général, le style de texte de Le texte inséré correspond au texte situé juste avant l'index d'insertion.
  • Certains caractères de contrôle (U+0000-U+0008, U+000C-U+001F) et ceux provenant de la zone d'utilisation privée du plan multilingue Unicode Basic (U+E000-U+F8FF) sont sont supprimées du texte inséré.
  • Pour en savoir plus, consultez la section Insérer, supprimer et déplacer texte.

Insérer des images intégrées

  • L'image ne doit pas dépasser 50 Mo et 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. Pour 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, la mise en forme est appliqué à tout paragraphe partiellement ou entièrement chevauché par ce la plage d'adresses IP.
  • La plage peut être étendue pour inclure les sauts de ligne adjacents.
  • Si la plage contient l'intégralité d'un paragraphe appartenant à une liste, la fonction puce 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 avant chaque paragraphe.
  • Les onglets de début sont supprimés lors de la création des puces, ce qui peut changer les index de parties du texte.
  • Si vous ajoutez des puces de paragraphe qui correspondent à celles d'une liste juste avant paragraphe cible, le paragraphe est joint à la liste.
  • Pour en savoir plus, consultez Utiliser des listes.

Supprimer du texte

  • La suppression de texte qui dépasse la limite d'un paragraphe peut entraîner des modifications les styles de paragraphe, les listes, les objets positionnés et les favoris paragraphes sont fusionnés.

  • Les suppressions générant une structure de document non valide ne sont pas autorisées. Un peu Voici quelques exemples de demandes 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'un Body Header Footer Footnote, TableCell ou TableOfContents.

    • Suppression du début ou de la fin d'une Table TableOfContents ou Equation sans supprimer l'intégralité de l'élément.

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

    • Supprimer des lignes ou des cellules individuelles d'un tableau Suppression du contenu... dans une cellule du tableau est autorisé.

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