Strukturelle Bearbeitungsregeln und -verhalten

In diesem Abschnitt werden Verhaltensweisen und Einschränkungen beschrieben, die Sie beim Bearbeiten von Dokumenten mit der Google Docs API beachten müssen.

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 für diese Methoden zusammengefasst.

Text einfügen

  • Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein Paragraph an diesem Index erstellt. Der Absatzstil des neuen Absatzes wird aus dem Absatz am aktuellen Einfügeindex kopiert, einschließlich Listen und Aufzählungszeichen.
  • Text muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. So kann beispielsweise kein Text an den Startindex einer Tabelle eingefügt werden. Der Text muss in den vorherigen Absatz eingefügt werden.
  • Die API kann den Speicherort implizit anpassen, um Einfügungen in Unicode-Grapheme-Clustern zu verhindern. In diesem Fall wird der Text direkt nach dem Graphem-Cluster eingefügt.
  • Die Textstile für eingefügten Text werden automatisch ermittelt. In der Regel wird dabei der Stil des benachbarten Textes beibehalten. Normalerweise entspricht der Textstil für den eingefügten Text dem Text direkt vor dem Einfügungsindex.
  • Einige Steuerzeichen (U+0000-U+0008, U+000C-U+001F) und Zeichen aus dem Unicode Basic Multilingual Plane Private Use Area (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 muss kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem muss es im PNG-, JPEG- oder GIF-Format vorliegen.
  • Der angegebene URI muss öffentlich zugänglich sein und darf höchstens 2 KB lang sein.
  • Das Bild muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. So kann beispielsweise kein Text an den Startindex einer Tabelle eingefügt werden.
  • Bilder können nicht innerhalb von Fußnoten oder Gleichungen eingefügt werden.
  • Weitere Informationen finden Sie unter Inline-Bilder einfügen.

Text formatieren

  • Wenn Sie die Formatierung auf Absatzebene auf einen Bereich anwenden, wird die Formatierung auf jeden Absatz angewendet, der diesen Bereich teilweise oder vollständig überdeckt.
  • Der Bereich kann auf angrenzende Zeilenumbrüche erweitert werden.
  • Wenn der Bereich einen Absatz vollständig 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.

Absatzpunkte erstellen

  • Erstellt Aufzählungspunkte für alle Absätze, die sich mit dem angegebenen Bereich überschneiden.
  • Die Verschachtelungsebene eines Absatzes wird durch die Anzahl der vorangestellten Tabulatoren vor jedem Absatz bestimmt.
  • Die führenden Tabs werden beim Erstellen der Aufzählungszeichen entfernt, wodurch sich die Indexe von Teilen des Textes ändern können.
  • Wenn Sie Absatzpunkte hinzufügen, die mit denen einer Liste direkt vor dem Zielabsatz übereinstimmen, wird der Absatz mit der Liste verbunden.
  • Weitere Informationen finden Sie unter Mit Listen arbeiten.

Text löschen

  • Wenn Sie Text löschen, der eine Absatzgrenze überschreitet, können beim Zusammenführen der beiden Absätze Änderungen an Absatzstilen, Listen, positionierten Objekten und Lesezeichen vorgenommen werden.

  • Löschungen, die zu einer ungültigen Dokumentstruktur führen, sind nicht zulässig. Ungültige Löschanfragen sind beispielsweise:

    • Eine Codeeinheit eines Ersatzpaares wird gelöscht.

    • Das letzte Zeilenumbruchzeichen von Body, Header, Footer, Footnote, TableCell oder TableOfContents wird gelöscht.

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

    • Das Zeilenumbruchzeichen vor einem Table, TableOfContents oder SectionBreak wird gelöscht, ohne das Element zu löschen.

    • Einzelne Zeilen oder Zellen einer Tabelle löschen Der Inhalt einer Tabellenzelle kann gelöscht werden.

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