Strukturelle Bearbeitungsregeln und -verhalten

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

Im Allgemeinen können Sie keine Änderungen vornehmen, die die ungültige Struktur von Elemente in einem Dokument. Überprüfen Sie jedes documents.batchUpdate Anfragemethode für Einschränkungen und Regeln, -Anfragen.

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

Text einfügen

  • Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein Paragraph dabei -Index. Der Absatzstil des neuen Absatzes wird aus dem Absatz kopiert beim aktuellen Einfügungsindex, einschließlich Listen und Aufzählungszeichen.
  • Text muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Für Beispiel: Text kann nicht am Startindex einer Tabelle eingefügt werden. Der Text muss im vorherigen Absatz eingefügt.
  • Die API kann den Standort implizit anpassen, um das Einfügen von Unicode-Graphem-Cluster. In diesem Fall wird der Text direkt nach dem Graphem-Cluster.
  • Textstile für eingefügten Text werden automatisch ermittelt, in der Regel den Stil des angrenzenden Textes beibehalten. In der Regel wird der Textstil Der eingefügte Text stimmt mit dem Text unmittelbar vor dem Einfügungsindex überein.
  • Einige Steuerzeichen (U+0000-U+0008, U+000C-U+001F) und Zeichen aus die Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF) sind aus dem eingefügten Text entfernt.
  • Weitere Informationen finden Sie unter Einfügen, löschen und verschieben Text.

Inline-Bilder einfügen

  • Das Bild muss kleiner als 50 MB sein, darf 25 Megapixel nicht überschreiten und muss in einem der Formate PNG, JPEG oder GIF 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. Für Beispiel: Text kann nicht 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 auf jeden Absatz angewendet, der teilweise oder vollständig Bereich.
  • 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, Aufzählungszeichen wird ebenfalls 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 vor jedem Absatz ein.
  • Die vorangehenden Tabs werden beim Erstellen der Aufzählungszeichen entfernt, was sich möglicherweise die Indexe von Textteilen.
  • Wenn Sie Aufzählungszeichen für Absätze direkt vor dem Listeneintrag wird der Absatz mit der Liste verknüpft.
  • Weitere Informationen finden Sie unter Mit Listen arbeiten.

Text löschen

  • Das Löschen von Text, der die Absatzgrenze überschreitet, kann zu Änderungen an Absatzstile, Listen, positionierte Objekte und Lesezeichen. Absätze zusammengeführt.

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

    • Löschen einer Codeeinheit eines Ersatzwertpaars.

    • Löschen des letzten Zeilenumbruchzeichens eines Body, Header Footer Footnote TableCell oder TableOfContents.

    • Löschen des Anfangs oder Endes eines Table, TableOfContents oder Equation ohne das gesamte Element 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 Inhalte löschen in einer Tabellenzelle erlaubt ist.

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