Reguły i sposób edytowania strukturalnego

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 cały akapit należący do listy, fragment 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 lub TableOfContents.

    • Usuwanie początku lub końca Table TableOfContents lub Equation bez przez usunięcie całego elementu.

    • usunięcie znaku nowego wiersza przed znakiem Table, TableOfContents lub SectionBreak. 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.