W tej sekcji opisano zachowania i ograniczenia, z którymi należy się zapoznać podczas edytowania dokumentów 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. Sprawdź każdą metodę żądania documents.batchUpdate
pod kątem ograniczeń i reguł, które mają zastosowanie do tych żądań.
W sekcjach poniżej znajdziesz podsumowanie najważniejszych zasad obowiązujących w tych metodach.
Wstaw tekst
- Wstawienie znaku nowego wiersza pośrednio powoduje utworzenie w danym indeksie pozycji
Paragraph
. Styl akapitu nowego akapitu jest kopiowany z akapitu w bieżącym indeksie wstawiania, w tym list i punktorów. - Tekst musi mieścić się w granicach istniejącego elementu
Paragraph
. Na przykład tekstu nie można wstawić w indeksie początkowym tabeli. Tekst należy wstawić w poprzednim akapicie. - Interfejs API może pośrednio dostosować lokalizację, aby zapobiec wstawieniu w klastrach grafemów Unicode. Tekst jest wtedy wstawiony za gromadą grafemów.
- Style tekstu wstawionego są określane automatycznie, zazwyczaj z zachowaniem stylu sąsiadującego tekstu. Zazwyczaj styl wstawionego tekstu jest taki sam jak tekst umieszczony bezpośrednio przed indeksem wstawiania.
- Niektóre znaki kontrolne (
U+0000-U+0008, U+000C-U+001F
) i znaki z pola Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF
) są pozbawione wstawionego tekstu. - Więcej informacji znajdziesz w sekcji Wstawianie, usuwanie i przenoszenie tekstu.
Wstaw obrazy do treści
- Obraz musi mieć rozmiar mniejszy niż 50 MB i nie może być większy niż 25 megapikseli oraz musi być w formacie PNG, JPEG lub GIF.
- Podany identyfikator URI musi być publicznie dostępny, a jego długość nie może przekraczać 2 KB.
- Obraz musi zostać wstawiony w granicach istniejącego elementu
Paragraph
. Na przykład tekstu nie można wstawić w indeksie początkowym tabeli. - Nie można wstawiać obrazów w przypisach lub równaniach.
- Więcej informacji znajdziesz w artykule Wstawianie obrazów do treści.
Formatowanie tekstu
- Jeśli zastosujesz formatowanie na poziomie akapitu do zakresu, formatowanie zostanie zastosowane do każdego akapitu, który częściowo lub całkowicie zasłania się tym zakresem.
- Zakres można rozszerzyć, aby uwzględnić sąsiednie nowe wiersze.
- Jeśli zakres obejmuje cały akapit należący do listy, punktor jest też aktualizowany o pasujący styl tekstu.
- Więcej informacji znajdziesz w artykule Formatowanie tekstu.
Tworzenie punktorów akapitów
- Tworzy punktory dla wszystkich akapitów, które pokrywają się z podanym zakresem.
- Poziom zagnieżdżenia każdego akapitu jest określany na podstawie liczby znaków tabulacji na początku każdego akapitu.
- Początkowe karty są usuwane podczas tworzenia punktorów, co może spowodować zmianę indeksów części tekstu.
- Jeśli bezpośrednio przed akapitem docelowym dodasz punktory pasujące do tych na liście, akapit ten zostanie połączony z listą.
- Więcej informacji znajdziesz w artykule Praca z listami.
Usuwanie tekstu
Usunięcie tekstu, który przekracza granicę akapitu, może spowodować zmianę stylów akapitu, list, pozycji obiektów i zakładek w miarę scalania dwóch akapitów.
Nie można usuwać, które powodują nieprawidłową strukturę dokumentu. Przykłady nieprawidłowych żądań usunięcia:
Usunięcie jednej jednostki kodu z pary zastępczej.
usunięcie ostatniego znaku nowego wiersza w elemencie
Body
,Header
,Footer
,Footnote
,TableCell
lubTableOfContents
.Usuń początek lub koniec
Table
,TableOfContents
lubEquation
bez usuwania całego elementu.Usunięcie znaku nowego wiersza przed znakami
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 sekcji Wstawianie, usuwanie i przenoszenie tekstu.