Reguły i sposób edytowania strukturalnego

Ta sekcja opisuje zachowania i ograniczenia, które musisz wziąć pod uwagę podczas edytowania dokumentów za pomocą interfejsu Google Docs API.

Ogólnie nie możesz 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ń.

Poniżej znajdziesz podsumowanie najważniejszych reguł obowiązujących w tych metodach.

Wstaw tekst

  • Wstawienie znaku nowego wiersza powoduje niejawne utworzenie w tym indeksie wartości Paragraph. Styl akapitu nowego akapitu jest kopiowany z akapitu w bieżącym indeksie wstawienia, w tym list i wypunktowań.
  • Tekst musi być wstawiony w ramach istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu do indeksu początkowego tabeli. Tekst musi zostać wstawiony w poprzednim akapicie.
  • Interfejs API może dostosować lokalizację domyślnie, aby zapobiec wstawianiu w klastrach grafemów Unicode. W takim przypadku tekst jest wstawiany bezpośrednio po klastrze grafemów.
  • Styl tekstu w wstawionym tekście jest określany automatycznie, zazwyczaj zachowując styl sąsiadującego tekstu. Zazwyczaj styl tekstu w wstawionym tekście jest taki sam jak w tekście 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

  • Obraz musi mieć rozmiar mniejszy niż 50 MB, nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.
  • Podany identyfikator URI musi być dostępny publicznie i mieć maksymalnie 2 KB długości.
  • Obraz musi być wstawiony w ramach istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu na początku indeksu 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, zostanie ono zastosowane do każdego akapitu, który jest częściowo lub całkowicie pokrywany przez ten zakres.
  • Zakres może zostać rozszerzony o sąsiednie znaki nowego wiersza.
  • Jeśli zakres zawiera cały akapit należący do listy, znak odstępu w akapicie zostanie również zaktualizowany o odpowiednią czcionkę.
  • Więcej informacji znajdziesz w artykule Formatowanie tekstu.

Tworzenie punktów w akapitach

  • Tworzy punkty dla wszystkich akapitów, które pokrywają się z danym zakresem.
  • 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 przed akapitem docelowym dodasz punkty, które pasują do listy, akapit zostanie do niej dołączony.
  • 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.

  • Usunięcia, które powodują nieprawidłową strukturę dokumentu, są niedozwolone. Oto kilka przykładów nieprawidłowych żądań usunięcia:

    • Usuwanie jednej jednostki kodu pary zastępczej.

    • Usunięcie ostatniego znaku nowej linii w pliku 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 nowej linii przed elementem Table, TableOfContents lub SectionBreak, bez usuwania tego elementu;

    • Usuwanie pojedynczych wierszy lub komórek tabeli. Usuwanie treści w komórce tabeli jest dozwolone.

  • Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekstu.