Reguły i sposób edytowania strukturalnego

W tej sekcji opisujemy zachowania i ograniczenia, które musisz znać, gdy edytujesz dokumenty za pomocą interfejsu Google Docs API.

Ogólnie rzecz biorąc, nie możesz wykonywać edycji, które powodują nieprawidłową strukturę elementów w dokumencie. Sprawdź każdą documents.batchUpdate metodę żądania pod kątem ograniczeń i reguł, które mają zastosowanie do tych żądań.

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

Wstaw tekst

  • Wstawienie znaku nowego wiersza powoduje niejawne utworzenie elementu a Paragraph at that index. Styl akapitu nowego akapitu jest kopiowany z akapitu w bieżącym indeksie wstawiania, w tym listy i wypunktowania.
  • Tekst musi być wstawiony w obrębie istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu w indeksie początkowym tabeli. Tekst musi być wstawiony w poprzednim akapicie.
  • Interfejs API może niejawnie dostosować lokalizację, aby zapobiec wstawianiu w klastrach grafemów Unicode. W takim przypadku tekst jest wstawiany bezpośrednio po klastrze grafemów.
  • Style tekstu wstawionego są określane automatycznie, co zwykle zachowuje styl sąsiedniego tekstu. Zwykle styl tekstu wstawionego jest zgodny z tekstem 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 podstawowej płaszczyźnie wielojęzycznej Unicode (U+E000-U+F8FF) są usuwane z wstawionego tekstu.
  • 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ć publicznie dostępny i mieć długość nie większą niż 2 KB.
  • Obraz musi być wstawiony w obrębie istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu w indeksie początkowym tabeli.
  • Obrazów nie można wstawiać w przypisach dolnych 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, formatowanie zostanie zastosowane do każdego akapitu, który jest częściowo lub całkowicie pokryty tym zakresem.
  • Zakres może zostać rozszerzony o sąsiednie znaki nowego wiersza.
  • Jeśli zakres w pełni zawiera akapit należący do listy, wypunktowanie akapitu jest też aktualizowane o pasujący styl tekstu.
  • Więcej informacji znajdziesz w artykule Format tekstu.

Tworzenie wypunktowań akapitów

  • Tworzy wypunktowania dla wszystkich akapitów, które pokrywają się z podanym zakresem.
  • Poziom zagnieżdżenia każdego akapitu jest określany przez liczbę tabulatorów przed każdym akapitem.
  • Podczas tworzenia wypunktowań tabulatory są usuwane, co może zmienić indeksy części tekstu.
  • Jeśli dodasz wypunktowania akapitów, które pasują do wypunktowań listy bezpośrednio przed akapitem docelowym, akapit zostanie połączony z listą.
  • Więcej informacji znajdziesz w artykule Praca z listami.

Usuń tekst

  • Usunięcie tekstu, który przekracza granicę akapitu, może spowodować zmiany w stylach akapitów, listach, obiektach umieszczonych i zakładkach, ponieważ 2 akapity są scalane.

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

    • Usunięcie 1 jednostki kodu pary zastępczej.

    • Usunięcie ostatniego znaku nowego wiersza w elementach 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 nowego wiersza przed elementem Table, TableOfContents, lub SectionBreak bez usuwania 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.