Reguły i sposób edytowania strukturalnego

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 lub TableOfContents.

    • Usunięcie początku lub końca elementu Table, TableOfContents lub Equation bez usuwania całego elementu.

    • Usunięcie znaku nowego wiersza znajdującego się przed Table, TableOfContents lub SectionBreak 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.