Reguły i sposób edytowania strukturalnego

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

    • Usuń początek lub koniec Table, TableOfContents lub Equation bez usuwania całego elementu.

    • Usunięcie znaku nowego wiersza przed znakami 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 sekcji Wstawianie, usuwanie i przenoszenie tekstu.