Reguły i sposób edytowania strukturalnego

W tej sekcji opisujemy zachowania i ograniczenia, które musisz znać podczas edytowania dokumentów za pomocą interfejsu Google Docs API.

Zasadniczo 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 reguł dotyczących tych metod.

Wstaw tekst

  • Wstawienie znaku nowego wiersza powoduje niejawne utworzenie elementu Paragraph w tym indeksie. Styl akapitu nowego akapitu jest kopiowany z akapitu w bieżącym indeksie wstawiania, w tym listy i punktorów.
  • 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 zostać wstawiony w poprzednim akapicie.
  • Interfejs API może niejawnie dostosować lokalizację, aby zapobiec wstawianiu w obrębie klastrów grafemów Unicode. W takim przypadku tekst jest wstawiany bezpośrednio po klastrze grafemów.
  • Style tekstu wstawionego tekstu są określane automatycznie, zwykle z zachowaniem stylu sąsiedniego tekstu. Zwykle styl tekstu wstawionego jest taki sam jak styl tekstu bezpośrednio przed indeksem wstawienia.
  • Niektóre znaki sterujące (U+0000-U+0008, U+000C-U+001F) i znaki z obszaru prywatnego użytku podstawowej wielojęzycznej płaszczyzny Unicode (U+E000-U+F8FF) są usuwane z wstawianego tekstu.
  • Więcej informacji znajdziesz w artykule Wstawianie, usuwanie i przenoszenie tekstu.

Wstawianie obrazów w treści

  • Obraz musi mieć rozmiar mniejszy niż 50 MB, nie może przekraczać 25 megapikseli i musi być w jednym z formatów PNG, JPEG lub GIF.
  • Podany identyfikator URI musi być dostępny publicznie i mieć długość maksymalnie 2 KB.
  • Obraz musi być wstawiony w granicach 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 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 objęty tym zakresem.
  • Zakres może zostać rozszerzony o sąsiednie znaki nowego wiersza.
  • Jeśli zakres w całości obejmuje akapit należący do listy, punktor akapitu jest też aktualizowany o pasujący styl tekstu.
  • Więcej informacji znajdziesz w artykule Formatowanie tekstu.

Tworzenie punktorów akapitów

  • Tworzy punktor 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 na początku akapitu.
  • Podczas tworzenia punktorów wiodące 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 zostaną połączone.

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

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

    • Usunięcie ostatniego znaku nowego wiersza w przypadku Body, Header, Footer, Footnote, TableCell lub TableOfContents.

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

    • Usunięcie znaku nowego wiersza przed znakiem 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.