W tej sekcji opisujemy zachowania i ograniczenia, które musisz znać podczas edytowania dokumentów przy użyciu interfejsu Google Dokumenty API.
Ogólnie nie można wprowadzać zmian, które powodują nieprawidłową strukturę elementów w dokumencie. Zapoznaj się z poszczególnymi metodami żądania documents.batchUpdate
pod kątem ograniczeń i reguł, które mają zastosowanie do tych żądań.
Poniżej znajdziesz podsumowanie najważniejszych reguł obowiązujących w tych metodach.
Wstaw tekst
- Wstawienie znaku nowego wiersza powoduje niejawną utworzenie tagu
Paragraph
w tym indeksie. Styl akapitu w nowym akapicie jest kopiowany z akapitu w bieżącym indeksie wstawiania, w tym list i punktów. - Tekst musi znajdować się w granicach istniejącego elementu
Paragraph
. Na przykład nie można wstawić tekstu do indeksu początkowego tabeli. Tekst należy wstawić w poprzednim akapicie. - Interfejs API może niejawnie dostosowywać lokalizację, aby uniemożliwić wstawianie reklam w klastrach grafemowych Unicode. W takim przypadku tekst jest wstawiany bezpośrednio za gromadem grafemowym.
- Style wstawionego tekstu są określane automatycznie, co zwykle zachowuje styl sąsiedniego tekstu. Zwykle styl tekstu wstawionego tekstu jest zgodny z tekstem bezpośrednio przed indeksem wstawiania.
- Niektóre znaki sterujące (
U+0000-U+0008, U+000C-U+001F
) i znaki z obszaru prywatnego użytku w ramach Unicode Basic Multilingual Plane Private Plane (U+E000-U+F8FF
) są usuwane ze wstawionego tekstu. - Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekstu.
Wstaw obrazy w tekście
- Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi 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
. 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 formatowanie na poziomie akapitu do zakresu, formatowanie zostanie zastosowane do wszystkich akapitów, które częściowo lub całkowicie pokrywają się z tym zakresem.
- Zakres może zostać rozszerzony o sąsiednie znaki nowego wiersza.
- Jeśli zakres obejmuje cały akapit należący do listy, punktor akapitu zostanie również zaktualizowany o odpowiedni 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 kart prowadzących do akapitu.
- Podczas tworzenia punktorów wiodące karty są usuwane, co może zmienić indeksy części tekstu.
- Jeśli tuż przed akapitem docelowym dodasz punktory zgodne z listą, 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 stylach akapitów, listach, znajdujących się obiektach i zakładkach, gdy 2 akapity zostaną scalone.
Nie można usuwać plików, które powodują nieprawidłową strukturę dokumentu. Oto kilka przykładów nieprawidłowych żądań usunięcia:
Usuwanie 1 jednostki kodu z pary zastępczej.
Usuwam ostatni znak nowego wiersza znaków
Body
,Header
,Footer
,Footnote
,TableCell
lubTableOfContents
.Usunięcie początku lub końca elementu
Table
,TableOfContents
lubEquation
bez usuwania całego elementu.Usunięcie znaku nowego wiersza znajdującego się przed
Table
,TableOfContents
lubSectionBreak
bez usuwania elementu.Usuwanie pojedynczych wierszy lub komórek tabeli. Usuwanie zawartości komórki tabeli jest dozwolone.
Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekstu.