Żądanie
Pojedyncza aktualizacja, która zostanie zastosowana w dokumencie.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: request . Konkretna prośba. Wymagane jest dokładnie jedno pole.
request może być tylko jedną z tych wartości:
|
|
replaceAllText
|
Zastępuje wszystkie wystąpienia określonego tekstu. |
insertText
|
Wstawia tekst w określonym miejscu. |
updateTextStyle
|
Aktualizuje styl tekstu w określonym zakresie. |
createParagraphBullets
|
Tworzenie punktorów dla akapitów. |
deleteParagraphBullets
|
Usunięcie punktorów z akapitów. |
createNamedRange
|
Tworzy zakres nazwany. |
deleteNamedRange
|
Usuwa zakres nazwany. |
updateParagraphStyle
|
Aktualizuje styl akapitu w określonym zakresie. |
deleteContentRange
|
Usunięcie treści z dokumentu. |
insertInlineImage
|
Wstawia obraz w treści w określonej lokalizacji. |
insertTable
|
Wstawia tabelę w określonej lokalizacji. |
insertTableRow
|
Wstawia pusty wiersz do tabeli. |
insertTableColumn
|
Wstawia do tabeli pustą kolumnę. |
deleteTableRow
|
Usuwa wiersz z tabeli. |
deleteTableColumn
|
Usuwa kolumnę z tabeli. |
insertPageBreak
|
Wstawia podział strony w określonym miejscu. |
deletePositionedObject
|
Usuwa pozycjonowany obiekt z dokumentu. |
updateTableColumnProperties
|
Aktualizuje właściwości kolumn w tabeli. |
updateTableCellStyle
|
Aktualizuje styl komórek tabeli. |
updateTableRowStyle
|
Aktualizuje styl wiersza w tabeli. |
replaceImage
|
Zastępuje obraz w dokumencie. |
updateDocumentStyle
|
Aktualizuje styl dokumentu. |
mergeTableCells
|
Scala komórki w tabeli. |
unmergeTableCells
|
Rozdziela komórki w tabeli. |
createHeader
|
Tworzy nagłówek. |
createFooter
|
Tworzy stopkę. |
createFootnote
|
Tworzy przypis. |
replaceNamedRangeContent
|
Zastępuje zawartość w zakresie nazwanym. |
updateSectionStyle
|
Aktualizuje styl sekcji określonego zakresu. |
insertSectionBreak
|
Wstawia podział sekcji w określonej lokalizacji. |
deleteHeader
|
Usuwa nagłówek z dokumentu. |
deleteFooter
|
Usuwa stopkę z dokumentu. |
pinTableHeaderRows
|
Aktualizuje liczbę przypiętych wierszy nagłówka w tabeli. |
Zastąp cały tekst
Zastępuje wszystkie wystąpienia tekstu pasującego do replace text
.
Zapis JSON |
---|
{ "replaceText": string, // Union field |
Pola | |
---|---|
replaceText
|
Tekst, który zastąpi dopasowany tekst. |
Pole sumy: criteria . Kryteria dopasowania tekstu do zastąpienia.
criteria może być tylko jedną z tych wartości:
|
|
containsText
|
Znajduje w dokumencie tekst pasujący do tego podłańcucha. |
Kryteria dopasowania podrzędnego
Kryteria pasujące do konkretnego ciągu tekstowego w dokumencie
Zapis JSON |
---|
{ "text": string, "matchCase": boolean } |
Pola | |
---|---|
text
|
Tekst do wyszukania w dokumencie. |
matchCase
|
Wskazuje, czy wyszukiwanie powinno brać pod uwagę wielkość liter:
|
Żądanie TextText
Wstawia tekst w określonym miejscu.
Zapis JSON |
---|
{ "text": string, // Union field |
Pola | |
---|---|
text
|
Tekst do wstawienia.
Wstawianie nowego wiersza spowoduje automatyczne utworzenie w tym indeksie nowego obiektu Style tekstu wstawionego tekstu będą określane automatycznie z zachowaniem stylu sąsiadującego tekstu. W większości przypadków styl wstawionego tekstu będzie pasował do tekstu tuż przed indeksem. Niektóre znaki kontrolne (U+0000-U+0008, U+000C-U+001F) i znaki z prywatnego obszaru wielojęzycznego Unicode (U+E000-U+F8FF) zostaną usunięte z wstawionego tekstu. |
Pole sumy: insertion_location . Lokalizacja, w której zostanie wstawiony tekst.
insertion_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia tekst o określonym indeksie w dokumencie.
Tekst musi być umieszczony w granicach istniejącego zasobu |
endOfSegmentLocation
|
Wstawia tekst na końcu nagłówka, stopki, przypisu lub treści dokumentu. |
Lokalizacja
Określona lokalizacja w dokumencie.
Zapis JSON |
---|
{ "segmentId": string, "index": integer } |
Pola | |
---|---|
segmentId
|
Identyfikator nagłówka, stopki lub przypisu, do którego należy lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu. |
index
|
Indeks oparty na wartości zero w jednostkach kodu UTF-16.
Indeks jest zależny od początku segmentu określonego przez |
LokalizacjaKoniec Segmentu
Lokalizacja na końcu treści, nagłówka, stopki lub przypisu Lokalizacja znajduje się tuż przed ostatnim wierszem w segmencie dokumentów.
Zapis JSON |
---|
{ "segmentId": string } |
Pola | |
---|---|
segmentId
|
Identyfikator nagłówka, stopki lub przypisu, do którego należy lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu. |
Żądanie TextTextStyle
Zaktualizuj styl tekstu.
Zapis JSON |
---|
{ "textStyle": { object ( |
Pola | |
---|---|
textStyle
|
Style służące do ustawiania tekstu. Jeśli wartość danego stylu odpowiada wartości stylu nadrzędnego, zostanie on ustawiony jako dziedziczony.
Niektóre zmiany stylu tekstu mogą powodować inne zmiany w celu powielania działania edytora Dokumentów. Więcej informacji znajdziesz w dokumentacji |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować pogrubienie tekstu, ustaw Aby zresetować właściwość do wartości domyślnej, wpisz nazwę pola maski, ale pozostaw to pole puste. |
Pole sumy: insertion_location . Typ zakresu, w którym zostanie zaktualizowany styl tekstu.
insertion_location może być tylko jedną z tych wartości:
|
|
range
|
Zakres tekstu do dostosowania. Zakres można rozszerzyć na sąsiednie wiersze. Jeśli zakres zawiera pełny akapit znajdujący się na liście, do informacji o punkcie akapitu zostanie dodany pasujący styl. Nie można wstawiać zakresów do względnego obiektu TextTextStyleRequest. |
Utwórz żądanie listy akapitów
tworzy punktory dla wszystkich akapitów, które nakładają się na dany zakres.
Poziom zagnieżdżania każdego akapitu jest określany na podstawie liczby wiodących kart na początku każdego akapitu. Aby uniknąć nadmiernego odstępu między akapitem a odpowiednim akapitem, żądanie spowoduje usunięcie tych wiodących kart. Może to zmienić indeksy fragmentów tekstu.
Jeśli akapit bezpośrednio przed aktualizowanymi akapitami znajduje się na liście z pasującymi gotowymi akapitami, aktualizowane są akapity do tej listy.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres, w którym chcesz zastosować gotowe ustawienia punktora. |
bulletPreset
|
Rodzaje glifów punktorowych do użycia. |
Punktor Glif
Gotowe wzorce glifów punktorowych na listach.
Wzorce używają tego rodzaju punktorów:
-
ARROW
: strzałka odpowiadająca kodowi Unicode U+2794. -
ARROW3D
: strzałka z cieniowaniem 3D odpowiadający punktowi kodu Unicode U+27a2. -
CHECKBOX
: pusty punkt oznaczający punkt kodowy Unicode U+274f. -
CIRCLE
: puste kółko odpowiadające punktowi kodowemu Unicode U+25cb. -
DIAMOND
: : stały romb odpowiadający punktowi kodu Unicode U+25c6 -
DIAMONDX
: romb z literą „x” odpowiadającą kodowi Unicode U+2756 -
HOLLOWDIAMOND
: pusty romb, odpowiadający kodowi Unicode U+25c7 -
DISC
: stałe kółko odpowiadające punktowi kodu Unicode U+25cf -
SQUARE
: stały kwadrat odpowiadający punktowi kodu Unicode U+25a0 -
STAR
: gwiazdka odpowiadająca kodowi Unicode U+2605 -
ALPHA
: mała litera, np. „a”, „b” lub „c”. -
UPPERALPHA
: wielka litera, np. „A”, „B” lub „C”. -
DECIMAL
: liczba, np. „1”, „2” lub „3”. -
ZERODECIMAL
: liczba, w której liczby pojedyncze są poprzedzone zerem, np. „01”, „02” lub „03”. Numery z więcej niż jedną cyfrą nie są poprzedzone zerem. -
ROMAN
: mała rzymska cyfra, np. „i”, „ii” lub „iii”. -
UPPERROMAN
: cyfra rzymska zapisana wielkimi literami, np. „I”, „II” lub „III”. -
LEFTTRIANGLE
: trójkąt skierowany w lewo odpowiadający punktowi kodu Unicode U+25c4
Wartości w polu enum | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
Gotowe ustawienia glifu punktora nie zostały określone. |
BULLET_DISC_CIRCLE_SQUARE
|
Lista z kropkami DISC , CIRCLE i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Lista z kropkami DIAMONDX , ARROW3D i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_CHECKBOX
|
Lista punktowana z glifami CHECKBOX na wszystkich poziomach zagnieżdżania listy.
|
BULLET_ARROW_DIAMOND_DISC
|
Lista z kropkami ARROW , DIAMOND i DISC w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_STAR_CIRCLE_SQUARE
|
Lista z kropkami STAR , CIRCLE i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Lista z kropkami ARROW3D , CIRCLE i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Lista z kropkami LEFTTRIANGLE , DIAMOND i DISC w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Lista z kropkami DIAMONDX , HOLLOWDIAMOND i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Lista z kropkami DIAMOND , CIRCLE i SQUARE w przypadku 3 pierwszych poziomów zagnieżdżania listy.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
Lista numerowana z
DECIMAL ,
ALPHA
i
ROMAN
glifami liczbowymi dla pierwszych 3 poziomów zagnieżdżania listy, po których następuje kropki.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Lista numerowana z
DECIMAL ,
ALPHA
i
ROMAN
glifami liczbowymi dla pierwszych 3 poziomów zagnieżdżania listy, po których następuje nawias.
|
NUMBERED_DECIMAL_NESTED
|
Lista numerowana z DECIMAL glifami liczbowymi rozdzielonymi kropkami, gdzie każdy poziom zagnieżdżania używa prefiksu glifu poziomu etapu jako jego prefiksu. Na przykład: '1., '1,1.', '2.', „2.2”.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Lista numerowana z
UPPERALPHA ,
ALPHA
i
ROMAN
glifami liczbowymi dla pierwszych 3 poziomów zagnieżdżania listy, po których następuje kropki.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Lista numerowana z
UPPERROMAN ,
UPPERALPHA
i
DECIMAL
glifami liczbowymi dla pierwszych 3 poziomów zagnieżdżania listy, po których następuje kropki.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Lista numerowana z
ZERODECIMAL ,
ALPHA
i
ROMAN
glifami liczbowymi dla pierwszych 3 poziomów zagnieżdżania listy, po których następuje kropki.
|
Prośba o usunięcie akapitu
Usunięcie punktorów ze wszystkich akapitów, które nakładają się na dany zakres.
Poziom zagnieżdżenia każdego akapitu zostanie zachowany wizualnie, dodając wcięcie na początku odpowiedniego akapitu.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres, z którego chcesz usunąć punktory. |
Żądanie CreateNamedRange
Tworzy NamedRange
, który odwołuje się do podanego zakresu.
Zapis JSON |
---|
{
"name": string,
"range": {
object (
|
Pola | |
---|---|
name
|
Nazwa zakresu nazw. Nazwy nie muszą być unikalne. Nazwy muszą składać się z co najmniej 1 znaku i nie mogą mieć więcej niż 256 znaków mierzone w jednostkach kodu UTF-16. |
range
|
Zakres, w którym chcesz zastosować nazwę. |
Żądanie deleteNamedRange
Usuwa NamedRange
.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: named_range_reference . Wartość określająca zakres lub zakresy do usunięcia. Należy ustawić dokładnie jedną wartość.
named_range_reference może być tylko jedną z tych wartości:
|
|
namedRangeId
|
Identyfikator zakresu nazwanego do usunięcia. |
name
|
Nazwa zakresów do usunięcia. Wszystkie zakresy nazwane o podanej nazwie zostaną usunięte. |
Żądanie UpdateParagraphStyle
Zaktualizuj styl wszystkich akapitów, które nakładają się na dany zakres.
Zapis JSON |
---|
{ "paragraphStyle": { object ( |
Pola | |
---|---|
paragraphStyle
|
Style do akapitów.
Niektóre zmiany stylu akapitu mogą powodować inne zmiany odzwierciedlające zachowanie edytora Dokumentów. Więcej informacji znajdziesz w dokumentacji |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować właściwość dopasowania stylu akapitu, ustaw Aby zresetować właściwość do wartości domyślnej, wpisz nazwę pola maski, ale pozostaw to pole puste. |
Pole sumy: insertion_location . Typ zakresu, w którym zostanie zaktualizowany styl akapitu.
insertion_location może być tylko jedną z tych wartości:
|
|
range
|
Zakres nakładający się na akapity. |
Prośba o usunięcie treści
Usunięcie treści z dokumentu.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres treści do usunięcia. Usunięcie tekstu przekraczającego granicę akapitu może spowodować zmianę stylów akapitu, list, rozmieszczonych obiektów i zakładek podczas łączenia obu akapitów. Próba usunięcia niektórych zakresów może spowodować nieprawidłową strukturę dokumentu. W takim przypadku zwracany jest błąd 400 – nieprawidłowe żądanie. Oto kilka przykładów nieprawidłowych żądań usunięcia:
|
Wstaw obraz w tekście
Wstawia InlineObject
zawierający obraz w określonej lokalizacji.
Zapis JSON |
---|
{ "uri": string, "objectSize": { object ( |
Pola | |
---|---|
uri
|
Identyfikator URI obrazu. Obraz jest pobierany raz podczas wstawiania i jest kopiowana do wyświetlania w dokumencie. Obrazy muszą być mniejsze niż 50 MB, nie mogą przekraczać 25 megapikseli i mieć format PNG, JPEG lub GIF.
Podany identyfikator URI musi być dostępny publicznie i mieć maksymalnie 2 kB. Identyfikator URI jest zapisywany z obrazem i dostępny za pomocą pola |
objectSize
|
Rozmiar, jaki powinien mieć obraz. Ta właściwość jest opcjonalna, a końcowy rozmiar obrazu w dokumencie jest określany zgodnie z tymi regułami: * Jeśli nie określono szerokości i wysokości, domyślny rozmiar obrazu jest obliczany na podstawie jego rozdzielczości. * Jeśli określisz jeden rozmiar, drugi zostanie obliczony w celu zachowania współczynnika proporcji obrazu. * Jeśli określono zarówno szerokość, jak i wysokość, obraz jest skalowany tak, aby pasował do podanych wymiarów, zachowując jego współczynnik proporcji. |
Pole sumy: insertion_location . Lokalizacja, w której zostanie wstawiony obraz.
insertion_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia obraz w określonym indeksie w dokumencie.
Obraz należy wstawić do istniejącego zasobu Obrazów w treści nie można wstawić do przypisu lub równania. |
endOfSegmentLocation
|
Wstawia tekst na końcu nagłówka, stopki lub treści dokumentu. Obrazów w treści nie można wstawiać do przypisu. |
Wstawienie żądania tabeli
Wstawia tabelę w określonej lokalizacji.
Przed tabelą będzie wstawiony znak nowego wiersza.
Zapis JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
Pola | |
---|---|
rows
|
Liczba wierszy w tabeli. |
columns
|
Liczba kolumn w tabeli. |
Pole sumy: insertion_location . Lokalizacja, w której zostanie wstawiony tabela.
insertion_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia tabelę z indeksem określonego modelu. Przed wstawianą tabelą zostanie wstawiony znak nowego wiersza, więc indeks rozpoczęcia będzie znajdować się we wskazanym indeksie lokalizacji + 1.
Tabela musi być wpisana w granicach istniejącego Tabela nie może być umieszczona w przypisie lub równaniu. |
endOfSegmentLocation
|
Wstawia tabelę na końcu danego nagłówka, stopki lub treści dokumentu. Przed tabelą będzie wstawiony znak nowego wiersza. Nie można wstawić tabel do przypisu. |
Wstaw żądanie wiersza tabeli
Wstawia pusty wiersz do tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli referencyjnej, z której zostaną wstawione wiersze. Nowy wiersz zostanie wstawiony powyżej (lub poniżej) wiersza, w którym znajduje się komórka referencyjna. Jeśli komórka referencyjna jest scaloną komórką, nowy wiersz zostanie wstawiony powyżej (lub poniżej) scalonej komórki. |
insertBelow
|
Określa, czy wstawić nowy wiersz poniżej referencyjnej lokalizacji komórki.
|
Lokalizacja komórki tabeli
Lokalizacja pojedynczej komórki w tabeli.
Zapis JSON |
---|
{
"tableStartLocation": {
object (
|
Pola | |
---|---|
tableStartLocation
|
Lokalizacja, w której dokument zaczyna się w tabeli. |
rowIndex
|
Indeks wiersza z zerem. Na przykład drugi wiersz w tabeli ma indeks równy 1. |
columnIndex
|
Indeks kolumny opartej na zerach. Na przykład druga kolumna w tabeli ma indeks równy 1. |
Żądanie RequestTableColumn
Wstawia do tabeli pustą kolumnę.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli referencyjnej, z której zostaną wstawione kolumny. Nowa kolumna zostanie wstawiona po lewej stronie (lub prawej) kolumnie, w której znajduje się komórka referencyjna. Jeśli komórka referencyjna jest scaloną komórką, w jej lewej (lub prawej) komórce pojawi się nowa kolumna. |
insertRight
|
Określa, czy po prawej stronie lokalizacji referencyjnej komórki chcesz wstawić nową kolumnę.
|
Prośba o usunięcie tabeli
Usuwa wiersz z tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli referencyjnej, z której zostanie usunięty wiersz. Wiersz, który obejmuje ta komórka, zostanie usunięty. Jeśli jest to scalona komórka, która obejmuje wiele wierszy, wszystkie wiersze, które obejmuje ta komórka, zostaną usunięte. Jeśli po usunięciu tej tabeli nie pozostanie w niej żaden wiersz, zostanie ona usunięta w całości. |
Żądanie deleteTableColumn
Usuwa kolumnę z tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli referencyjnej, z której kolumna zostanie usunięta. Kolumna, którą obejmuje ta komórka w zakresie, zostanie usunięta. Jeśli jest to scalona komórka, która obejmuje wiele kolumn, wszystkie kolumny zawierające ją, zostaną usunięte. Jeśli po usunięciu tej tabeli nie pozostaną w niej żadne kolumny, cała tabela zostanie usunięta. |
ŻądanieŻądanie podziału strony
Wstawia podział strony wraz ze znakiem nowego wiersza w określonym miejscu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: insertion_location . Lokalizacja, w której zostanie wstawiony podział strony.
insertion_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia podział strony przy określonym indeksie w dokumencie.
Podział strony należy wstawić w obrębie istniejącego tagu
Podziałów stron nie można wstawiać w tabeli, równaniu, przypisie, nagłówku ani stopce. Podziały stron można wstawić tylko w treści, dlatego pole |
endOfSegmentLocation
|
Wstawia podział strony na końcu treści dokumentu.
Podziałów stron nie można umieszczać w przypisach, nagłówkach ani stopkach. Podziały stron można wstawić tylko w treści, dlatego pole |
Element RequestPositionedObject
Usuwa PositionedObject
z dokumentu.
Zapis JSON |
---|
{ "objectId": string } |
Pola | |
---|---|
objectId
|
Identyfikator pozycjonowanego obiektu do usunięcia. |
Żądanie Poproś o zaktualizowanie właściwości kolumny tabeli
Aktualizuje TableColumnProperties
kolumn w tabeli.
Zapis JSON |
---|
{ "tableStartLocation": { object ( |
Pola | |
---|---|
tableStartLocation
|
Lokalizacja, w której dokument zaczyna się w tabeli. |
columnIndices[]
|
Lista indeksów kolumn opartych na zera, których właściwości należy zaktualizować. Jeśli nie określono indeksów, wszystkie kolumny zostaną zaktualizowane. |
tableColumnProperties
|
Właściwości kolumny tabeli do zaktualizowania.
Jeśli wartość |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby np. zaktualizować szerokość kolumny, ustaw |
Żądanie UpdateTableCellStyleRequest
Aktualizuje styl zakresu komórek tabeli.
Zapis JSON |
---|
{ "tableCellStyle": { object ( |
Pola | |
---|---|
tableCellStyle
|
Styl, który należy ustawić w komórkach tabeli. Podczas aktualizowania obramowania komórka współdzielona jest także dla sąsiedniej komórki. Właściwa właściwość obramowania jest też przylegająca. Obramowania scalone i niewidoczne nie są aktualizowane. Ponieważ aktualizacja ramki udostępnianej przez sąsiednie komórki w tym samym żądaniu może spowodować sprzeczne aktualizacje obramowania, zmiany w tym zakresie są stosowane w tej kolejności:
|
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować kolor tła komórki tabeli, ustaw Aby zresetować właściwość do wartości domyślnej, wpisz nazwę pola maski, ale pozostaw to pole puste. |
Pole sumy: cells . Komórki, które zostaną zaktualizowane.
cells może być tylko jedną z tych wartości:
|
|
tableRange
|
Zakres tabel reprezentujący podzbiór tabeli, do której zostały zastosowane aktualizacje. |
tableStartLocation
|
Lokalizacja, w której dokument zaczyna się w tabeli. Jeśli jest określona, aktualizacje są stosowane do wszystkich komórek w tabeli. |
Zakres tabel
Zakres tabel reprezentuje odniesienie do podzbioru tabeli.
Pamiętaj, że komórki określone przez zakres tabeli nie muszą tworzyć prostokąta. Załóżmy na przykład, że mamy tabelę 3 x 3, w której wszystkie komórki ostatniego wiersza są scalone. Tabela wygląda tak:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Zakres tabeli z lokalizacją komórki tabeli = (tableStartLocation, wiersz = 0, kolumna = 0), zakres wierszy = 3 i zakres kolumny = 2 określa następujące komórki:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki w miejscu, w którym zaczyna się zakres tabeli. |
rowSpan
|
Zakres wierszy zakresu tabeli. |
columnSpan
|
Zakres kolumn zakresu tabeli. |
Żądanie UpdateTableRowStyleRequest
Aktualizuje TableRowStyle
wierszy w tabeli.
Zapis JSON |
---|
{ "tableStartLocation": { object ( |
Pola | |
---|---|
tableStartLocation
|
Lokalizacja, w której dokument zaczyna się w tabeli. |
rowIndices[]
|
Lista indeksów wierszy o wartości 0, której styl należy zaktualizować. Jeśli nie określono indeksów, wszystkie wiersze zostaną zaktualizowane. |
tableRowStyle
|
Style do ustawienia w wierszach. |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować minimalną wysokość wiersza, ustaw |
Żądanie żądania grafiki
Zastępuje istniejący obraz nowym.
Zastąpienie obrazu powoduje usunięcie niektórych
image effects
z istniejącego obrazu, aby odzwierciedlić zachowanie edytora Dokumentów.
Zapis JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
Pola | |
---|---|
imageObjectId
|
Identyfikator dotychczasowego obrazu, który zostanie zastąpiony. Identyfikator można pobrać z odpowiedzi żądania get. |
uri
|
Identyfikator URI nowego obrazu. Obraz jest pobierany raz podczas wstawiania i jest kopiowana do wyświetlania w dokumencie. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
Długość identyfikatora URI nie może przekraczać 2 KB. Identyfikator URI zapisuje się z obrazem i ujawnia się w polu |
imageReplaceMethod
|
Metoda zastępowania. |
ImageReplaceMethod
Metoda zastępowania obrazu.
Wartości w polu enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Nieokreślona metoda zastępowania obrazów. Tej wartości nie można używać. |
CENTER_CROP
|
Skaluje obraz i wyśrodkowuje go tak, by wypełnił granice oryginalnego obrazu. Obraz może zostać przycięty, aby wypełnił granice oryginalnego obrazu. Wyrenderowany rozmiar będzie taki sam jak obraz oryginalny. |
Żądanie UpdateDocumentStyle
Aktualizuje DocumentStyle
.
Zapis JSON |
---|
{
"documentStyle": {
object (
|
Pola | |
---|---|
documentStyle
|
Style do ustawienia w dokumencie.
Niektóre zmiany stylu dokumentu mogą powodować inne zmiany odzwierciedlające zachowanie edytora Dokumentów. Więcej informacji znajdziesz w dokumentacji |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować tło, ustaw |
Żądanie MergeTableCells
Scala komórki w komórce Table
.
Zapis JSON |
---|
{
"tableRange": {
object (
|
Pola | |
---|---|
tableRange
|
Zakres tabeli określający, które komórki tabeli mają zostać scalone. Każdy tekst w scalanych komórkach zostanie scalony i zapisany w komórce „head” zakresu. Jest to komórka w lewym górnym rogu zakresu, gdy kierunek treści jest ustawiony na lewo lub prawo, a w prawym górnym rogu zakresu. Jeśli zakres nie jest prostokątny (może tak się zdarzyć w przypadku, gdy zakres obejmuje już scalone komórki lub gdy tabela nie jest prostokątna), zwracany jest błąd 400 nieprawidłowego żądania. |
Żądanie scalenia komórek tabel
Rozdziela komórki w: Table
.
Zapis JSON |
---|
{
"tableRange": {
object (
|
Pola | |
---|---|
tableRange
|
Zakres tabeli określający, które komórki tabeli mają zostać rozdzielone. Scalone komórki z tego zakresu nie zostaną scalone. Jeśli zakres nie obejmuje scalonych komórek, żądanie nie zrobi nic. Jeśli w dowolnej scalonej komórce jest tekst, to on pozostanie w komórce „head” wynikowego bloku niescalonych komórek. Komórka „head” to komórka w lewym górnym rogu, gdy kierunek treści znajduje się od lewej do prawej – w prawym górnym rogu. |
Utwórz żądanie nagłówka
Tworzy Header
. Nowy nagłówek jest stosowany do SectionStyle
w lokalizacji elementu SectionBreak
(jeśli został określony), w przeciwnym razie do DocumentStyle
.
Jeśli istnieje już nagłówek określonego typu, zwracany jest błąd 400 „złe żądanie”.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type
|
Typ nagłówka do utworzenia. |
sectionBreakLocation
|
Lokalizacja elementu |
Prośba o utworzenie stopki
Tworzy segment Footnote
i wstawia do niego nowy obiekt FootnoteReference
w podanej lokalizacji.
Nowy segment Footnote
będzie zawierać spację, po której będzie znak nowego wiersza.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: footnote_reference_location . Lokalizacja, w której należy wstawić przypis.
footnote_reference_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia przypis w określonym indeksie w dokumencie.
Odwołanie do przypisu musi zostać wstawione do limitów istniejącego
Odwołań do przypisów nie można wstawić do równania, nagłówka, stopki ani przypisu. Odwołania do przypisów można wstawiać tylko w treści, dlatego pole |
endOfSegmentLocation
|
Wstawia przypis na końcu treści dokumentu.
Odwołań do przypisów nie można wstawiać do nagłówka, stopki ani przypisu. Odwołania do przypisów można wstawiać tylko w treści, dlatego pole |
ŻądanieRequestNameContentContent
Zastępuje zawartość określonego elementu NamedRange
lub NamedRanges
określoną zawartością zastępczą.
Pamiętaj, że pojedynczy element NamedRange
może się składać z wielu nieciągłych wartości ranges
. W takim przypadku zostanie zastąpiona tylko treść z pierwszego zakresu. Pozostałe zakresy wraz z zawartością zostaną usunięte.
Jeśli zastąpienie lub usunięcie któregoś z tych zakresów spowodowałoby nieprawidłową strukturę dokumentu, zwracany jest błąd 400 dotyczący nieprawidłowego żądania.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: replacement_content . Zawartość, która ma zastąpić istniejącą zawartość zakresu nazwanego.
replacement_content może być tylko jedną z tych wartości:
|
|
text
|
Zastępuje zawartość określonych zakresów nazwanych konkretnym tekstem. |
Pole sumy: named_range_reference . Odwołanie do zakresów nazwanych, których zawartość zostanie zastąpiona.
named_range_reference może być tylko jedną z tych wartości:
|
|
namedRangeId
|
Identyfikator zakresu nazwanego, którego zawartość zostanie zastąpiona. Jeśli nie ma zakresu nazwanego o podanym identyfikatorze, zwracany jest błąd 400 „złe żądanie”. |
namedRangeName
|
Nazwa elementu
Jeśli występuje wiele elementów |
Żądanie UpdateSectionStyle
Aktualizuje SectionStyle
.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres nakładający się na sekcje.
Podziały sekcji można wstawić tylko w treści, dlatego pole |
sectionStyle
|
Style do ustawienia w sekcji.
Niektóre zmiany stylu sekcji mogą powodować inne zmiany odzwierciedlające działanie edytora Dokumentów. Więcej informacji znajdziesz w dokumentacji |
fields
|
Pola, które należy zaktualizować.
Musisz określić co najmniej jedno pole. Pierwiastek
Aby na przykład zaktualizować lewy margines, ustaw |
Żądanie podziału sekcji
Wstawia podział sekcji w danej lokalizacji.
Przed podziałem sekcji pojawi się znak nowego wiersza.
Zapis JSON |
---|
{ "sectionType": enum ( |
Pola | |
---|---|
sectionType
|
Typ sekcji do wstawienia. |
Pole sumy: insertion_location . Lokalizacja, w której chcesz wstawić przerwę.
insertion_location może być tylko jedną z tych wartości:
|
|
location
|
Wstawia nowy wiersz i podział sekcji w określonym indeksie w dokumencie.
Podział sekcji należy wstawić do limitów istniejącego znacznika
podziałów sekcji nie można umieszczać w tabeli, równaniu, przypisie, nagłówku ani stopce; Podziały sekcji można wstawić tylko w treści, dlatego pole |
endOfSegmentLocation
|
Wstawia nowy wiersz i podział sekcji na końcu treści dokumentu.
podziałów sekcji nie można umieszczać w przypisach, nagłówkach ani stopkach; Podziały sekcji można wstawić tylko w treści, dlatego pole |
Żądanie deleteHeader
Usuwa Header
z dokumentu.
Zapis JSON |
---|
{ "headerId": string } |
Pola | |
---|---|
headerId
|
Identyfikator nagłówka do usunięcia. Jeśli ten nagłówek jest zdefiniowany w |
PinTableHeaderRowsRequest
Aktualizuje liczbę przypiętych wierszy nagłówka tabeli.
Zapis JSON |
---|
{
"tableStartLocation": {
object (
|
Pola | |
---|---|
tableStartLocation
|
Lokalizacja, w której dokument zaczyna się w tabeli. |
pinnedHeaderRowsCount
|
Liczba wierszy tabeli do przypięcia, gdzie 0 oznacza, że wszystkie wiersze są odpięte. |