Reguły i sposób edytowania strukturalnego

W tej sekcji opisano zachowania i ograniczenia, które należy 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 niejawnie tworzy w tym indeksie element Paragraph. Styl akapitu nowego akapitu jest kopiowany z akapitu w bieżącym indeksie wstawiania, w tym list i wypunktowań.
  • Tekst musi być wstawiony w ramach istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu na początku indeksu tabeli. Tekst musi być wstawiony w poprzednim akapicie.
  • Interfejs API może dostosować lokalizację domyślnie, aby zapobiec wstawianiu w grupach znakó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 mieć więcej niż 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.
  • Podczas tworzenia list punktowanych usuwane są karty wiodące, co może zmienić indeksy części tekstu.
  • Jeśli przed akapitem docelowym dodasz punkty akapitu, które pasują do punktów listy, akapit zostanie dołączony do listy.
  • 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, TableCell i 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 poszczególnych wierszy lub komórek tabeli; Usuwanie treści z komórki tabeli jest dozwolone.

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