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ń.

W sekcjach poniżej znajdziesz podsumowanie najważniejszych zasad dotyczących tych metod.

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 zostać wstawiony w ramach istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu na początku indeksu 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.
  • Z wstawionego tekstu usuwane są niektóre znaki sterujące (U+0000-U+0008, U+000C-U+001F) oraz znaki z obszaru prywatnego podstawowej płaszczyzny wielojęzycznej Unicode (U+E000-U+F8FF).
  • Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekstu.

Wstawianie obrazów 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 w 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, aby obejmował sąsiednie znaki końca wiersza.
  • Jeśli zakres zawiera cały akapit należący do listy, znak odstępu w tym 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 przez liczbę tabulatorów przed każdym akapitem.
  • Tabulatory wiodące są usuwane podczas tworzenia list wypunktowanych, 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

  • Usuwanie tekstu, który przekracza granicę akapitu, może spowodować zmiany w stylach akapitów, listach, obiektach z pozycjonowaniem i zakładkach, ponieważ dwa akapity są łączone.

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

    • Usuwanie jednej jednostki kodu pary zastępczej.

    • Usunięcie ostatniego znaku nowej linii w plikach Body, Header, Footer, Footnote, TableCellTableOfContents.

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

    • usunięcie znaku końca wiersza przed elementem Table, TableOfContents lub SectionBreak, bez usuwania tego elementu;

    • usuwanie poszczególnych 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.