W tej sekcji opisano zachowania i ograniczenia, o których musisz wiedzieć edytować dokumenty przy użyciu interfejsu API Dokumentów Google.
Ogólnie rzecz biorąc, nie można wprowadzać zmian, które powodują nieprawidłową strukturę
elementów w dokumencie. Przejrzyj każdą
documents.batchUpdate
metody żądania, by poznać ograniczenia i reguły, które mają zastosowanie do tych ograniczeń
prośbę.
Poniżej znajdziesz podsumowanie najważniejszych reguł obowiązujących w tych metodach.
Wstaw tekst
- Wstawienie znaku nowego wiersza powoduje niejawne wstawienie
Paragraph
indeksu. Styl akapitu w nowym akapicie jest skopiowany z akapitu w bieżącym indeksie wstawiania, włącznie z listami i punktorami. - Tekst musi znajdować się w granicach istniejącego elementu
Paragraph
. Dla: Na przykład nie można wstawić tekstu do indeksu początkowego tabeli. Tekst musi być umieszczone w poprzednim akapicie. - Interfejs API może niejawnie dostosowywać lokalizację, aby uniemożliwić wstawianie miejsc w obrębie danej strony. Klastry grafemowe Unicode. W takim przypadku tekst jest wstawiany bezpośrednio po gromadzeniu grafemowym.
- Style tekstu wstawionego tekstu są określane automatycznie, zwykle zachowywanie stylu sąsiedniego tekstu. Zwykle styl tekstu dla argumentu wstawiony tekst pasuje do tekstu bezpośrednio przed indeksem wstawiania.
- Niektóre znaki sterujące (
U+0000-U+0008, U+000C-U+001F
) i znaki z z obszaru prywatnego użytku uniwersalnego Unicode Basic Multilingual Plane (U+E000-U+F8FF
) został usunięty z wstawionego tekstu. - Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekst.
Wstaw obrazy w tekście
- Rozmiar obrazu nie może przekraczać 50 MB, a jego rozdzielczość nie może przekraczać 25 megapikseli. być w formacie PNG, JPEG lub GIF.
- Podany identyfikator URI musi być publicznie dostępny i mieć maksymalnie 2 KB.
- Obraz musi znajdować się w granicach istniejącego obiektu
Paragraph
. Dla: Na przykład nie można wstawić tekstu do indeksu początkowego tabeli. - Obrazów nie można wstawiać w przypisach ani równaniach.
- Więcej informacji znajdziesz w artykule Wstawianie obrazów w tekście.
Formatowanie tekstu
- Gdy zastosujesz do zakresu formatowanie na poziomie akapitu, zastosowane do dowolnego akapitu, który częściowo lub całkowicie się nachodzi na siebie. zakres dat.
- Zakres może zostać rozszerzony o sąsiednie znaki nowego wiersza.
- Jeśli zakres obejmuje w całości akapit należący do listy, makro Punktor został też zaktualizowany o pasujący styl tekstu.
- Więcej informacji znajdziesz w artykule Formatowanie tekstu.
Utwórz punktory akapitu
- Tworzy punktory dla wszystkich akapitów, które nakładają się na dany zakres.
- Poziom zagnieżdżenia każdego akapitu jest określany na podstawie liczby początkowych przed każdym akapitem.
- Wiodące karty są usuwane podczas tworzenia punktorów, co może zmienić indeksy części tekstu.
- Jeśli dodasz wypunktowanie akapitu, które odpowiadają punktom na liście znajdującej się tuż przed akapitu docelowego, to akapit zostanie połączony z listą.
- Więcej informacji znajdziesz w artykule Praca z listami.
Usuwanie tekstu
Usunięcie tekstu, który przekracza granice akapitu, może spowodować zmiany w style akapitów, listy, umieszczone obiekty i zakładki akapity zostały scalone.
Nie można usuwać plików, które powodują nieprawidłową strukturę dokumentu. Niektóre Przykłady nieprawidłowych żądań usunięcia:
Usuwanie 1 jednostki kodu z pary zastępczej.
Usuwanie ostatniego znaku nowego wiersza w
Body
,Header
,Footer
,Footnote
,TableCell
lubTableOfContents
.Usuwanie początku lub końca
Table
,TableOfContents
lubEquation
bez przez usunięcie całego elementu.Usuwam znak nowego wiersza przed znakiem
Table
,TableOfContents
lubSectionBreak
bez usuwania elementu.Usuwanie pojedynczych wierszy lub komórek tabeli. usunięcie treści, w komórce tabeli.
Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekst.