Strukturelle Bearbeitungsregeln und -verhalten

In diesem Abschnitt werden Verhaltensweisen und Einschränkungen beschrieben, die Sie beachten müssen, wenn Sie Dokumente mit der Google Docs API bearbeiten.

Im Allgemeinen können Sie keine Änderungen vornehmen, die zu einer ungültigen Struktur von Elementen in einem Dokument führen. Prüfen Sie jede documents.batchUpdate-Anfragemethode auf Einschränkungen und Regeln, die für diese Anfragen gelten.

In den folgenden Abschnitten werden die wichtigsten Regeln dieser Methoden zusammengefasst.

Text einfügen

  • Wenn Sie ein Zeilenumbruchzeichen einfügen, wird an dieser Stelle implizit ein Paragraph erstellt. Der Absatzstil des neuen Absatzes wird aus dem Absatz am aktuellen Einfügeindex kopiert, einschließlich Listen und Aufzählungszeichen.
  • Der Text muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Beispielsweise kann Text nicht am Startindex einer Tabelle eingefügt werden. Der Text muss im vorherigen Absatz eingefügt werden.
  • Die API passt den Ort möglicherweise implizit an, um Einfügungen innerhalb von Unicode-Grapheme-Clustern zu verhindern. In diesem Fall wird der Text direkt nach dem Grapheme-Cluster eingefügt.
  • Textstile für eingefügten Text werden automatisch bestimmt. Dabei wird in der Regel der Stil des benachbarten Texts beibehalten. Normalerweise entspricht der Textstil für den eingefügten Text dem Text direkt vor dem Einfügeindex.
  • Einige Steuerzeichen (U+0000-U+0008, U+000C-U+001F) und Zeichen aus dem Bereich „Private Use Area“ der Unicode Basic Multilingual Plane (U+E000-U+F8FF) werden aus dem eingefügten Text entfernt.
  • Weitere Informationen finden Sie unter Text einfügen, löschen und verschieben.

Inline-Bilder einfügen

  • Das Bild darf nicht größer als 50 MB und 25 Megapixel sein und muss im PNG-, JPEG- oder GIF-Format vorliegen.
  • Der angegebene URI muss öffentlich zugänglich und maximal 2 KB lang sein.
  • Das Bild muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Beispielsweise kann kein Text am Startindex einer Tabelle eingefügt werden.
  • Bilder können nicht in eine Fußnote oder Gleichung eingefügt werden.
  • Weitere Informationen finden Sie unter Inline-Bilder einfügen.

Text formatieren

  • Wenn Sie einen Bereich auf Absatzebene formatieren, wird die Formatierung auf alle Absätze angewendet, die teilweise oder vollständig von diesem Bereich überlappen.
  • Der Bereich kann um benachbarte Zeilenumbrüche erweitert werden.
  • Wenn der Bereich einen ganzen Absatz enthält, der zu einer Liste gehört, wird auch der Aufzählungspunkt des Absatzes mit dem entsprechenden Textstil aktualisiert.
  • Weitere Informationen finden Sie unter Text formatieren.

Aufzählungspunkte für Absätze erstellen

  • Erstellt Aufzählungszeichen für alle Absätze, die sich mit dem angegebenen Bereich überschneiden.
  • Die Verschachtelungsebene jedes Absatzes wird durch die Anzahl der Tabulatorzeichen vor dem jeweiligen Absatz bestimmt.
  • Die vorangestellten Tabulatorzeichen werden beim Erstellen der Aufzählungspunkte entfernt, was die Indizes von Textteilen ändern kann.
  • Wenn Sie Absatzpunkte, die mit denen einer Liste übereinstimmen, direkt vor dem Zielabsatz hinzufügen, wird der Absatz mit der Liste verknüpft.
  • Weitere Informationen finden Sie unter Listen verwenden.

Text löschen

  • Wenn Sie Text löschen, der eine Absatzgrenze überschreitet, kann es beim Zusammenführen der beiden Absätze zu Änderungen an Absatzformaten, Listen, positionierten Objekten und Lesezeichen führen.

  • Löschungen, die eine ungültige Dokumentstruktur verursachen, sind nicht zulässig. Hier einige Beispiele für ungültige Löschanfragen:

    • Löschen einer Codeeinheit eines Surrogatenpaars

    • Löschen Sie das letzte Zeichen für neue Zeile in einem CDATA-Abschnitt vom Typ Body, Header, Footer, Footnote, TableCell oder TableOfContents.

    • Start oder Ende eines Table-, TableOfContents- oder Equation-Elements löschen, ohne das gesamte Element zu löschen

    • Löschen Sie das Zeichen für neue Zeile vor einem Table, TableOfContents oder SectionBreak, ohne das Element zu löschen.

    • Einzelne Zeilen oder Zellen einer Tabelle löschen Das Löschen von Inhalten in einer Tabellenzelle ist zulässig.

  • Weitere Informationen finden Sie unter Text einfügen, löschen und verschieben.