Strukturelle Bearbeitungsregeln und -verhalten

In diesem Abschnitt werden Verhalten und Einschränkungen beschrieben, die Sie verstehen sollten, 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

  • Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein Paragraph an diesem Index erstellt. Der Absatzstil des neuen Absatzes wird einschließlich Listen und Aufzählungszeichen aus dem Absatz im aktuellen Einfügungsindex kopiert.
  • Text muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Beispielsweise kann kein Text am Startindex einer Tabelle eingefügt werden. Der Text muss im vorherigen Absatz eingefügt werden.
  • Die API kann den Standort implizit anpassen, um Einfügungen in Unicode-Grafikclustern zu verhindern. In diesem Fall wird der Text direkt nach dem Graphem-Cluster eingefügt.
  • Textstile für eingefügten Text werden automatisch bestimmt, wobei in der Regel der Stil des angrenzenden Textes beibehalten wird. In der Regel entspricht der Textstil für den eingefügten Text dem Text unmittelbar 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 eingefügtem 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 sich im PNG-, JPEG- oder GIF-Format befinden.
  • 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. Beispielsweise kann kein Text am Startindex einer Tabelle eingefügt werden.
  • Innerhalb einer Fußnote oder Gleichung können keine Bilder 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 jeden Absatz angewendet, der sich teilweise oder vollständig mit diesem Bereich überschneidet.
  • Der Bereich kann so erweitert werden, dass auch benachbarte Zeilenumbrüche einbezogen 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.

Aufzählungszeichen 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 vorangehenden 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, 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 Mit Listen arbeiten.

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 Ersatzwertpaars.

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

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

    • Löschen des Zeilenumbruchzeichens vor Table, TableOfContents oder SectionBreak, ohne das Element zu löschen.

    • Einzelne Zeilen oder Zellen einer Tabelle löschen Das Löschen des Inhalts einer Tabellenzelle ist zulässig.

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