In diesem Abschnitt werden Verhaltensweisen 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 der Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF
) ist 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. - Bilder können nicht innerhalb einer 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 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
oderTableOfContents
.Löschen des Anfangs oder Endes eines
Table
,TableOfContents
oderEquation
ohne das gesamte Element löschen.Löschen des Zeilenumbruchzeichens vor
Table
,TableOfContents
oderSectionBreak
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.