Żądanie
Pojedyncza aktualizacja, która ma zostać zastosowana do dokumentu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
request Konkretna prośba do zastosowania. Wymagane jest dokładnie 1 pole.
request
może być tylko jednym z tych elementów:
|
|
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
|
Tworzy punktory akapitów. |
deleteParagraphBullets
|
Usuwa punktory z akapitów. |
createNamedRange
|
Tworzy zakres nazwany. |
deleteNamedRange
|
Usuwa zakres nazwany. |
updateParagraphStyle
|
Aktualizuje styl akapitu w określonym zakresie. |
deleteContentRange
|
Usuwa zawartość dokumentu. |
insertInlineImage
|
Wstawia obraz wbudowany w określoną lokalizację. |
insertTable
|
Wstawia tabelę w określonej lokalizacji. |
insertTableRow
|
Wstawia pusty wiersz do tabeli. |
insertTableColumn
|
Wstawia pustą kolumnę do tabeli. |
deleteTableRow
|
Usuwa wiersz z tabeli. |
deleteTableColumn
|
Usuwa kolumnę z tabeli. |
insertPageBreak
|
Wstawia podział strony w określonym miejscu. |
deletePositionedObject
|
Usuwa umieszczony obiekt z dokumentu. |
updateTableColumnProperties
|
Aktualizuje właściwości kolumn w tabeli. |
updateTableCellStyle
|
Zmienia styl komórek tabeli. |
updateTableRowStyle
|
Aktualizuje styl wierszy w tabeli. |
replaceImage
|
Zastępuje obraz w dokumencie. |
updateDocumentStyle
|
Zmienia 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 treść w nazwanym zakresie. |
updateSectionStyle
|
Aktualizuje styl sekcji określonego zakresu. |
insertSectionBreak
|
Wstawia podział sekcji w podanej lokalizacji. |
deleteHeader
|
Usuwa nagłówek z dokumentu. |
deleteFooter
|
Usuwa stopkę z dokumentu. |
pinTableHeaderRows
|
Aktualizuje liczbę przypiętych wierszy nagłówka w tabeli. |
ReplaceAllTextRequest
Zastępuje wszystkie wystąpienia tekstu pasującego do kryteriów wartością
replace text
Zapis JSON |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
Pola | |
---|---|
replaceText
|
Tekst, który zastąpi dopasowany tekst. |
tabsCriteria
|
Opcjonalnie: Kryteria służące do określania, na których kartach ma być zamieniana treść. W przypadku jego pominięcia zastąpienie zostanie zastosowane na wszystkich kartach. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
Pole sumy
criteria Kryteria używane do dopasowania tekstu do zamiany.
criteria
może być tylko jednym z tych elementów:
|
|
containsText
|
Znajduje w dokumencie tekst pasujący do tego podłańcucha. |
SubstringMatchCriteria
Kryteria, które pasują do konkretnego ciągu tekstu w dokumencie.
Zapis JSON |
---|
{ "text": string, "matchCase": boolean } |
Pola | |
---|---|
text
|
Tekst do wyszukania w dokumencie. |
matchCase
|
Wskazuje, czy wyszukiwanie ma uwzględniać wielkość liter:
|
TabsCriteria
Kryteria określające, na których kartach jest uruchamiane żądanie.
Zapis JSON |
---|
{ "tabIds": [ string ] } |
Pola | |
---|---|
tabIds[]
|
Lista identyfikatorów kart, na których jest wykonywane żądanie. |
InsertTextRequest
Wstawia tekst w określonym miejscu.
Zapis JSON |
---|
{ "text": string, // Union field |
Pola | |
---|---|
text
|
Tekst do wstawienia.
Wstawienie znaku nowego wiersza spowoduje niejawnie utworzenie nowego
Style tekstu wstawionego tekstu będą określane automatycznie, zasadniczo zachowując styl sąsiedniego tekstu. W większości przypadków styl tekstu wstawionego tekstu będzie taki sam jak tekst bezpośrednio przed indeksem wstawiania. Niektóre znaki sterujące (U+0000-U+0008, U+000C-U+001F) oraz znaki z obszaru przeznaczonego do prywatnego użytku wielojęzycznych Unicode (U+E000-U+F8FF) zostaną usunięte z wstawionego tekstu. |
Pole sumy
insertion_location Miejsce, w którym zostanie wstawiony tekst.
insertion_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia tekst w określonym indeksie w dokumencie.
Tekst musi zostać wstawiony w granicach istniejącego
|
endOfSegmentLocation
|
Wstawia tekst na końcu nagłówka, stopki, przypisu lub treści dokumentu. |
Lokalizacja
Określone miejsce w dokumencie.
Zapis JSON |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
Pola | |
---|---|
segmentId
|
Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu. |
index
|
Indeks liczony od zera w jednostkach kodu UTF-16.
Indeks jest ustawiany względem początku segmentu określonego przez
|
tabId
|
Karta, na której znajduje się lokalizacja. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
EndOfSegmentLocation
Lokalizacja na końcu treści, nagłówka, stopki lub przypisu. Lokalizacja znajduje się bezpośrednio przed ostatnim nowym wierszem w segmencie dokumentu.
Zapis JSON |
---|
{ "segmentId": string, "tabId": string } |
Pola | |
---|---|
segmentId
|
Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu. |
tabId
|
Karta, na której znajduje się lokalizacja. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
UpdateTextStyleRequest
Zmień styl tekstu.
Zapis JSON |
---|
{ "textStyle": { object ( |
Pola | |
---|---|
textStyle
|
Style do ustawienia w tekście. Jeśli wartość określonego stylu jest zgodna z wartością stylu nadrzędnego, to styl zostanie ustawiony na dziedziczenie.
Niektóre zmiany stylu tekstu mogą spowodować inne zmiany, które będą odzwierciedlić działanie edytora Dokumentów. Zobacz dokumentację:
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zmienić styl tekstu na pogrubienie, ustaw
Aby zresetować właściwość do wartości domyślnej, podaj jej nazwę w masce pola, ale pozostaw samo pole nieskonfigurowane. |
Pole sumy
insertion_location Typ zakresu, w którym styl tekstu zostanie zaktualizowany.
insertion_location
może być tylko jednym z tych elementów:
|
|
range
|
Zakres tekstu do stylizacji. Zakres można rozszerzyć o sąsiednie znaki nowego wiersza. Jeśli zakres obejmuje w całości akapit należący do listy, punktor akapitu zostanie również zaktualizowany o odpowiedni styl tekstu. Nie można wstawiać zakresów wewnątrz względnego UpdateTextStyleRequest. |
CreateParagraphBulletsRequest
Tworzy punktory dla wszystkich akapitów, które nakładają się na dany zakres.
Poziom zagnieżdżenia każdego akapitu jest określany przez zliczenie poprzedzających znaków tabulacji przed każdym akapitem. Aby uniknąć nadmiernego odstępu między punktorem a odpowiednim akapitem, usuniemy te początkowe znaki tabulacji. Może to spowodować zmianę indeksów części tekstu.
Jeśli akapit tuż przed aktualizacją akapitu znajduje się na liście z pasującymi ustawieniami, aktualizowane akapity zostaną dodane do tej listy.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres, w którym chcesz zastosować gotowe ustawienie punktora. |
bulletPreset
|
Rodzaje glifów punktowanych, których chcesz użyć. |
BulletGlyphPreset
Gotowe wzorce glifów punktowanych na potrzeby list.
We wzorach użyte są następujące rodzaje punktorów:
-
ARROW
: strzałka odpowiadająca punktowi kodowemu Unicode U+2794 -
ARROW3D
: strzałka z cieniowaniem 3D odpowiadająca punktowi kodowemu Unicode U+27a2 -
CHECKBOX
: pusty kwadrat odpowiadający punktowi kodowemu Unicode U+274f -
CIRCLE
: puste kółko odpowiadające punktowi kodowemu Unicode U+25cb -
DIAMOND
: pełny romb odpowiadający punktowi kodowemu Unicode U+25c6 -
DIAMONDX
: romb ze znakiem „x” odpowiadającym punktowi kodowemu Unicode U+2756 -
HOLLOWDIAMOND
: pusty romb odpowiadający punktowi kodowemu Unicode U+25c7 -
DISC
: ciągłe koło odpowiadające punktowi kodowemu Unicode U+25cf -
SQUARE
: pełny kwadrat odpowiadający punktowi kodowemu Unicode U+25a0 -
STAR
: gwiazdka odpowiadająca punktowi kodowemu Unicode U+2605 -
ALPHA
: mała litera, np. „a”, „b” lub „c”. -
UPPERALPHA
: duża litera, np. „A”, „B” lub „C”. -
DECIMAL
: liczba, np. „1”, „2” lub „3”. -
ZERODECIMAL
: liczba, w której przypadku jednocyfrowe liczby są poprzedzone zerem, np. „01”, „02” lub „03”. Liczby mające więcej niż jedną cyfrę nie mają prefiksu zera. -
ROMAN
: mała cyfra rzymska, np. „i”, „ii” lub „iii”. -
UPPERROMAN
: duża cyfra rzymska, np. „I”, „II” lub „III”. -
LEFTTRIANGLE
: trójkąt skierowany w lewo, odpowiadający punktowi kodowemu Unicode U+25c4
Wartości w polu enum | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
Gotowe ustawienie glifu punktora nie jest określone. |
BULLET_DISC_CIRCLE_SQUARE
|
Lista punktowana ze znakiem
DISC ,
CIRCLE
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Lista punktowana ze znakiem
DIAMONDX ,
ARROW3D
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_CHECKBOX
|
Lista punktowana z
CHECKBOX
glify punktowana na wszystkich poziomach zagnieżdżenia listy.
|
BULLET_ARROW_DIAMOND_DISC
|
Lista punktowana ze znakiem
ARROW ,
DIAMOND
oraz
DISC
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_STAR_CIRCLE_SQUARE
|
Lista punktowana ze znakiem
STAR ,
CIRCLE
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Lista punktowana ze znakiem
ARROW3D ,
CIRCLE
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Lista punktowana ze znakiem
LEFTTRIANGLE ,
DIAMOND
oraz
DISC
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Lista punktowana ze znakiem
DIAMONDX ,
HOLLOWDIAMOND
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Lista punktowana ze znakiem
DIAMOND ,
CIRCLE
oraz
SQUARE
glif punktora dla pierwszych 3 poziomów zagnieżdżenia listy.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
Lista numerowana z
DECIMAL ,
ALPHA
oraz
ROMAN
glify liczbowe dla pierwszych 3 poziomów zagnieżdżenia listy, po których występują kropki.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Lista numerowana z
DECIMAL ,
ALPHA
oraz
ROMAN
glify liczbowe dla pierwszych 3 poziomów zagnieżdżenia listy, po których następuje nawias.
|
NUMBERED_DECIMAL_NESTED
|
Lista numerowana z
DECIMAL
glify liczbowe rozdzielone kropkami, przy czym każdy poziom zagnieżdżenia używa glifu z poprzedniego poziomu zagnieżdżenia jako prefiksu. Na przykład: „1.”, '1.1.', '2.', „2.2.”.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Lista numerowana z
UPPERALPHA ,
ALPHA
oraz
ROMAN
glify liczbowe dla pierwszych 3 poziomów zagnieżdżenia listy, po których występują kropki.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Lista numerowana z
UPPERROMAN ,
UPPERALPHA
oraz
DECIMAL
glify liczbowe dla pierwszych 3 poziomów zagnieżdżenia listy, po których występują kropki.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Lista numerowana z
ZERODECIMAL ,
ALPHA
oraz
ROMAN
glify liczbowe dla pierwszych 3 poziomów zagnieżdżenia listy, po których występują kropki.
|
DeleteParagraphBulletsRequest
Usuwa ze wszystkich akapitów punkty, które pokrywają się z danym zakresem.
Poziom zagnieżdżenia każdego akapitu zostanie wizualnie zachowany przez dodanie wcięcia na początku odpowiedniego akapitu.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres, z którego chcesz usunąć punktory. |
CreateNamedRangeRequest
Tworzy
NamedRange
w odniesieniu do danego zakresu.
Zapis JSON |
---|
{
"name": string,
"range": {
object (
|
Pola | |
---|---|
name
|
Nazwa zakresu nazwanego. Nazwy nie muszą być unikalne. Nazwy muszą składać się z co najmniej 1 do 256 znaków (mierzonych w jednostkach kodu UTF-16). |
range
|
Zakres, do którego ma zostać zastosowana nazwa. |
DeleteNamedRangeRequest
Usuwa
NamedRange
Zapis JSON |
---|
{ "tabsCriteria": { object ( |
Pola | |
---|---|
tabsCriteria
|
Opcjonalnie: Kryteria służące do określania, na których kartach powinno nastąpić usunięcie zakresu. W przypadku pominięcia tego pola usunięcie zakresu jest stosowane do wszystkich kart. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
Pole sumy
named_range_reference Wartość określająca zakres lub zakresy do usunięcia. Musisz ustawić tylko jedną opcję.
named_range_reference
może być tylko jednym z tych elementów:
|
|
namedRangeId
|
Identyfikator nazwanego zakresu do usunięcia. |
name
|
Nazwy zakresów do usunięcia. Wszystkie nazwane zakresy o podanej nazwie zostaną usunięte. |
UpdateParagraphStyleRequest
Zaktualizuj styl wszystkich akapitów, które pokrywają się z podanym zakresem.
Zapis JSON |
---|
{ "paragraphStyle": { object ( |
Pola | |
---|---|
paragraphStyle
|
Style, które mają zostać ustawione w akapitach.
Niektóre zmiany stylu akapitu mogą spowodować inne zmiany, które mają na celu odzwierciedlenie działania edytora Dokumentów. Zobacz dokumentację:
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby na przykład zaktualizować właściwość wyrównania stylu akapitu, ustaw
Aby zresetować właściwość do wartości domyślnej, podaj jej nazwę w masce pola, ale pozostaw samo pole nieskonfigurowane. |
Pole sumy
insertion_location Typ zakresu, w którym styl akapitu zostanie zaktualizowany.
insertion_location
może być tylko jednym z tych elementów:
|
|
range
|
Zakres nakładający się na akapity, których styl chcesz określić. |
DeleteContentRangeRequest
Usuwa zawartość dokumentu.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres treści do usunięcia. Usunięcie tekstu, który przekracza granice akapitu, może spowodować zmianę stylów akapitu, list, pozycji obiektów i zakładek w wyniku scalenia dwóch akapitów. Próba usunięcia określonych zakresów może skutkować nieprawidłową strukturą dokumentu. W takim przypadku zwracany jest błąd 400 nieprawidłowego żądania. Oto kilka przykładów nieprawidłowych żądań usunięcia:
|
InsertInlineImageRequest
Wstawia element
InlineObject
zawierające zdjęcie w danej lokalizacji.
Zapis JSON |
---|
{ "uri": string, "objectSize": { object ( |
Pola | |
---|---|
uri
|
Identyfikator URI obrazu. Obraz jest pobierany przy wstawieniu, a jego kopia jest zapisywana w celu wyświetlenia w dokumencie. Rozmiar obrazu nie może przekraczać 50 MB, a rozdzielczość 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ć maksymalnie 2 KB. Sam identyfikator URI jest zapisywany razem z obrazem i udostępniany przez
|
objectSize
|
Rozmiar, jaki ma być widoczny w dokumencie. Ta właściwość jest opcjonalna, a ostateczny rozmiar obrazu w dokumencie jest określany na podstawie tych reguł: * Jeśli nie podasz ani szerokości, ani wysokości, domyślny rozmiar obrazu będzie obliczany na podstawie jego rozdzielczości. * Jeśli określisz jeden wymiar, obliczony zostanie drugi wymiar, aby zachować współczynnik proporcji obrazu. * Jeśli określono zarówno szerokość, jak i wysokość, obraz jest skalowany, by pasował do podanych wymiarów przy zachowaniu współczynnika proporcji. |
Pole sumy
insertion_location Lokalizacja, w której obraz zostanie wstawiony.
insertion_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia obraz w określonym indeksie w dokumencie.
Obraz musi zostać wstawiony w granicach istniejącego
Obrazów wbudowanych nie można wstawiać do przypisów ani równań. |
endOfSegmentLocation
|
Wstawia tekst na końcu nagłówka, stopki lub treści dokumentu. Obrazów w treści nie można wstawiać do przypisu. |
InsertTableRequest
Wstawia tabelę w określonej lokalizacji.
Przed wstawiona tabela zostanie 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 wstawiona tabela.
insertion_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia tabelę w określonym indeksie modelu. Przed wstawionym tabelą zostanie wstawiony znak nowego wiersza, dlatego indeks początkowy tabeli będzie się znajdował w określonym indeksie lokalizacji + 1.
Tabela musi zostać wstawiona w granicach istniejącego
Nie można wstawiać tabel wewnątrz przypisów ani równań. |
endOfSegmentLocation
|
Wstawia tabelę na końcu danego nagłówka, stopki lub treści dokumentu. Przed wstawiona tabela zostanie wstawiony znak nowego wiersza. W przypisie nie można wstawiać tabel. |
InsertTableRowRequest
Wstawia pusty wiersz do tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli odniesienia, z której będą wstawiane wiersze. Nowy wiersz zostanie wstawiony powyżej (lub poniżej) wiersza, w którym znajduje się komórka odwołania. Jeśli komórka z odwołaniem jest scaloną komórką, powyżej (lub poniżej) scalonej komórki zostanie wstawiony nowy wiersz. |
insertBelow
|
Określa, czy wstawić nowy wiersz pod lokalizacją komórki odwołania.
|
TableCellLocation
Lokalizacja pojedynczej komórki w tabeli.
Zapis JSON |
---|
{
"tableStartLocation": {
object (
|
Pola | |
---|---|
tableStartLocation
|
Lokalizacja w dokumencie, w której zaczyna się tabela. |
rowIndex
|
Indeks wiersza liczony od zera. Na przykład indeks wiersza drugiego wiersza tabeli wynosi 1. |
columnIndex
|
Indeks kolumny liczony od zera. Na przykład druga kolumna w tabeli ma indeks kolumny wynoszący 1. |
InsertTableColumnRequest
Wstawia pustą kolumnę do tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli odwołania, z której zostaną wstawione kolumny. Nowa kolumna zostanie wstawiona po lewej (lub prawej) kolumnie, w której znajduje się komórka odwołania. Jeśli komórka z odwołaniem jest scaloną komórką, po lewej lub prawej stronie scalonej komórki zostanie wstawiona nowa kolumna. |
insertRight
|
Określa, czy wstawić nową kolumnę po prawej stronie lokalizacji komórki odwołania.
|
DeleteTableRowRequest
Usuwa wiersz z tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli odniesienia, z której zostanie usunięty wiersz. Wiersz tej spanu komórki zostanie usunięty. Jeśli jest to scalona komórka obejmująca wiele wierszy, wszystkie wiersze, w których znajduje się rozpiętość komórek, zostaną usunięte. Jeśli po usunięciu danych w tabeli nie pozostaną żadne wiersze, zostanie usunięta cała tabela. |
DeleteTableColumnRequest
Usuwa kolumnę z tabeli.
Zapis JSON |
---|
{
"tableCellLocation": {
object (
|
Pola | |
---|---|
tableCellLocation
|
Lokalizacja komórki tabeli odniesienia, z której kolumna zostanie usunięta. Kolumna z zakresami tej komórki zostanie usunięta. Jeśli jest to scalona komórka obejmująca wiele kolumn, wszystkie kolumny, w których znajdują się rozpiętości komórek, zostaną usunięte. Jeśli po usunięciu danych w tabeli nie pozostaną żadne kolumny, zostanie usunięta cała tabela. |
InsertPageBreakRequest
Wstawia w określonym miejscu podział strony, a po nim nowy wiersz.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
insertion_location Lokalizacja, w której zostanie wstawiony podział strony.
insertion_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia podział strony w określonym indeksie w dokumencie.
Podział strony musi zostać wstawiony w granicach istniejącego
Podziałów stron nie można wstawiać do tabeli, równania, przypisu, nagłówka ani stopki. Podziały stron można wstawiać tylko wewnątrz treści, więc tag
|
endOfSegmentLocation
|
Wstawia podział strony na końcu treści dokumentu.
Podziałów stron nie można wstawiać w przypisach, nagłówkach ani stopkach. Podziały stron można wstawiać tylko wewnątrz treści, więc tag
|
DeletePositionedObjectRequest
Usuwa
PositionedObject
z dokumentu.
Zapis JSON |
---|
{ "objectId": string, "tabId": string } |
Pola | |
---|---|
objectId
|
Identyfikator umieszczonego obiektu do usunięcia. |
tabId
|
Karta, na której znajduje się umieszczony obiekt do usunięcia. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
UpdateTableColumnPropertiesRequest
Aktualizuje
TableColumnProperties
kolumn w tabeli.
Zapis JSON |
---|
{ "tableStartLocation": { object ( |
Pola | |
---|---|
tableStartLocation
|
Lokalizacja w dokumencie, w której zaczyna się tabela. |
columnIndices[]
|
Lista indeksów kolumn od zera, których właściwość należy zaktualizować. Jeśli nie określisz indeksów, zaktualizowane zostaną wszystkie kolumny. |
tableColumnProperties
|
Właściwości kolumny tabeli do zaktualizowania.
Jeśli wartość zmiennej
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zaktualizować szerokość kolumny, ustaw
|
UpdateTableCellStyleRequest
Aktualizuje styl zakresu komórek tabeli.
Zapis JSON |
---|
{ "tableCellStyle": { object ( |
Pola | |
---|---|
tableCellStyle
|
Styl, który ma być ustawiany w komórkach tabeli. Jeśli podczas aktualizowania obramowań komórka ma wspólne obramowanie z sąsiednim komórką, odpowiednia właściwość obramowania sąsiedniej komórki również jest aktualizowana. Obramowania, które zostały scalone i niewidoczne, nie są aktualizowane. Zaktualizowanie obramowania współdzielonego przez sąsiednie komórki w tym samym żądaniu może spowodować konflikty, dlatego aktualizacje obramowania są stosowane w tej kolejności:
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zaktualizować kolor tła komórki tabeli, ustaw
Aby zresetować właściwość do wartości domyślnej, podaj jej nazwę w masce pola, ale pozostaw samo pole nieskonfigurowane. |
Pole sumy
cells Komórki, które zostaną zaktualizowane.
cells
może być tylko jednym z tych elementów:
|
|
tableRange
|
Zakres tabeli reprezentujący podzbiór tabeli, do której zastosowano aktualizacje. |
tableStartLocation
|
Lokalizacja w dokumencie, w której zaczyna się tabela. Jeśli określisz wartość, aktualizacje zostaną zastosowane do wszystkich komórek w tabeli. |
TableRange
Zakres tabeli jest odwołaniem do podzbioru tabeli.
Pamiętaj, że komórki określone przez zakres tabeli nie muszą tworzyć prostokątów. Załóżmy na przykład, że mamy tabelę o wymiarach 3 x 3, w której wszystkie komórki z ostatniego wiersza są ze sobą scalone. Tabela wygląda tak:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Zakres tabeli z lokalizacją komórki tabeli = (tabelaStartLocation, wiersz = 0, kolumna = 0), spanem wierszy = 3, a rozpiętość 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 której zaczyna się zakres tabeli. |
rowSpan
|
Rozpiętość wierszy zakresu tabeli. |
columnSpan
|
Rozpiętość kolumn zakresu tabeli. |
UpdateTableRowStyleRequest
Aktualizuje
TableRowStyle
wierszy w tabeli.
Zapis JSON |
---|
{ "tableStartLocation": { object ( |
Pola | |
---|---|
tableStartLocation
|
Lokalizacja w dokumencie, w której zaczyna się tabela. |
rowIndices[]
|
Lista indeksów wierszy od zera, których styl ma zostać zaktualizowany. Jeśli nie określisz indeksów, zaktualizowane zostaną wszystkie wiersze. |
tableRowStyle
|
Style do ustawienia w wierszach. |
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zaktualizować minimalną wysokość wiersza, ustaw
|
ReplaceImageRequest
Zastępuje istniejący obraz nowym.
Zastąpienie obrazu usuwa niektóre
image effects
z istniejącego obrazu, aby odzwierciedlić działanie edytora Dokumentów.
Zapis JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
Pola | |
---|---|
imageObjectId
|
Identyfikator istniejącego obrazu, który zostanie zastąpiony. Identyfikator można pobrać z odpowiedzi na żądanie get. |
uri
|
Identyfikator URI nowego obrazu. Obraz jest pobierany przy wstawieniu, a jego kopia jest zapisywana w celu wyświetlenia w dokumencie. Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.
Podany identyfikator URI nie może przekraczać 2 KB. Identyfikator URI jest zapisywany razem z obrazem i udostępniany przez
|
imageReplaceMethod
|
Metoda zastępowania. |
tabId
|
Karta, na której znajduje się obraz, który chcesz zastąpić. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
ImageReplaceMethod
Metoda zastępowania obrazu.
Wartości w polu enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Nieokreślona metoda zastępowania obrazu. Tej wartości nie można używać. |
CENTER_CROP
|
Skaluje i wyśrodkowuje obraz, by wypełnić granice oryginalnego obrazu. Obraz może zostać przycięty w celu wypełnienia granic oryginalnego obrazu. Wyrenderowany rozmiar obrazu będzie taki sam jak obrazu oryginalnego. |
UpdateDocumentStyleRequest
Aktualizuje
DocumentStyle
Zapis JSON |
---|
{
"documentStyle": {
object (
|
Pola | |
---|---|
documentStyle
|
Style do ustawienia w dokumencie.
Niektóre zmiany stylu dokumentu mogą spowodować inne zmiany, które mają na celu odzwierciedlenie działania edytora Dokumentów. Zobacz dokumentację:
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zaktualizować tło, ustaw
|
tabId
|
Karta zawierająca styl do zaktualizowania. W przypadku jego pominięcia żądanie jest stosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
MergeTableCellsRequest
Scala komórki w
Table
Zapis JSON |
---|
{
"tableRange": {
object (
|
Pola | |
---|---|
tableRange
|
Zakres tabeli określający, które komórki tabeli mają zostać scalone. Wszelki tekst w scalanych komórkach zostanie połączony i przechowywany w sekcji „head” komórki zakresu. Jeśli kierunek treści jest ustawiony na od lewej do prawej, jest to lewa górna komórka zakresu, a w innym przypadku prawa górna. Jeśli zakres nie jest prostokątny (co może się zdarzyć, gdy zakres obejmuje komórki, które zostały już scalone, lub tabela ma kształt nieprostokątny), zwracany jest błąd nieprawidłowego żądania 400. |
UnmergeTableCellsRequest
Rozdziela komórki
Table
Zapis JSON |
---|
{
"tableRange": {
object (
|
Pola | |
---|---|
tableRange
|
Zakres tabeli określający, które komórki tabeli mają zostać rozdzielić. Wszystkie scalone komórki w tym zakresie zostaną rozdzielone. Nie ma to wpływu na komórki, które już zostały rozdzielone. Jeśli zakres nie zawiera scalonych komórek, żądanie nie przyniesie żadnego efektu. Jeśli któraś ze scalonych komórek zawiera tekst, pozostanie on w obszarze „head” wynikowym blokiem niescalonych komórek. „Głowa” komórka to lewa górna komórka, jeśli kierunek treści jest ułożony od lewej do prawej, a prawy górna w przeciwnym razie. |
CreateHeaderRequest
Tworzy
Header
Nowy nagłówek zostanie zastosowany do
SectionStyle
w miejscu
SectionBreak
jeśli został określony. W przeciwnym razie jest stosowany do
DocumentStyle
Jeśli nagłówek określonego typu już istnieje, zwracany jest błąd 400 nieprawidłowego żądania.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type
|
Typ nagłówka do utworzenia. |
sectionBreakLocation
|
Lokalizacja
|
CreateFootnoteRequest
Tworzy
Footnote
segment i wstawia nowy
FootnoteReference
w danym miejscu.
Nowy
Footnote
będzie zawierał spację, po której następuje znak nowego wiersza.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
footnote_reference_location Lokalizacja, w której zostanie wstawione odwołanie do przypisu.
footnote_reference_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia odwołanie do przypisu w określonym indeksie w dokumencie.
Odwołanie do przypisu musi zostać wstawione w granicach istniejącego
Odwołań do przypisów nie można wstawiać w równaniu, nagłówku, stopce ani przypisie. Odwołania do przypisów można wstawiać tylko w treści, więc tag
|
endOfSegmentLocation
|
Wstawia odwołanie do przypisu na końcu treści dokumentu.
Odwołań do przypisów nie można wstawiać w nagłówku, stopce ani przypisie. Odwołania do przypisów można wstawiać tylko w treści, więc tag
|
ReplaceNamedRangeContentRequest
Zastępuje zawartość określonego
NamedRange
lub
NamedRanges
z daną zawartością zastępczą.
Pamiętaj, że osoba fizyczna
NamedRange
może składać się z wielu nieciągłych
ranges
W tym przypadku zamieniona zostanie tylko treść z pierwszego zakresu. Pozostałe zakresy wraz z zawartością zostaną usunięte.
Jeśli zastąpienie lub usunięcie dowolnego zakresu spowodowałoby nieprawidłową strukturę dokumentu, zwracany jest błąd 400 nieprawidłowego żądania.
Zapis JSON |
---|
{ "tabsCriteria": { object ( |
Pola | |
---|---|
tabsCriteria
|
Opcjonalnie: Kryteria służące do określania, na których kartach ma być zamieniana treść. W przypadku jego pominięcia zastąpienie zostanie zastosowane na wszystkich kartach. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
Pole sumy
replacement_content Treść, która ma zastąpić istniejącą zawartość nazwanego zakresu.
replacement_content
może być tylko jednym z tych elementów:
|
|
text
|
Zamienia zawartość określonych nazwanych zakresów na podany tekst. |
Pole sumy
named_range_reference Odwołanie do nazwanych zakresów, których zawartość zostanie zastąpiona.
named_range_reference
może być tylko jednym z tych elementów:
|
|
namedRangeId
|
Identyfikator nazwanego zakresu, którego treść zostanie zastąpiona. Jeśli nie ma zakresu nazwanego o podanym identyfikatorze, zwracany jest błąd nieprawidłowego żądania 400. |
namedRangeName
|
Nazwa
W przypadku wielu
|
UpdateSectionStyleRequest
Aktualizuje
SectionStyle
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres nakładający się na sekcje, dla których chcesz określić styl.
Podziały sekcji można wstawiać tylko wewnątrz treści, więc tag
|
sectionStyle
|
Style, które zostaną ustawione w sekcji.
Niektóre zmiany stylu sekcji mogą powodować inne zmiany, które mają na celu odzwierciedlenie działania edytora Dokumentów. Zobacz dokumentację:
|
fields
|
Pola, które wymagają aktualizacji.
Musisz określić co najmniej jedno pole. Poziom główny
Aby np. zaktualizować lewy margines, ustaw
|
InsertSectionBreakRequest
Wstawia podział sekcji w podanej lokalizacji.
Przed podziałem sekcji zostanie wstawiony znak nowego wiersza.
Zapis JSON |
---|
{ "sectionType": enum ( |
Pola | |
---|---|
sectionType
|
Typ sekcji do wstawienia. |
Pole sumy
insertion_location Lokalizacja, w której zostanie wstawiona przerwa.
insertion_location
może być tylko jednym z tych elementów:
|
|
location
|
Wstawia nowy wiersz i podział sekcji w określonym indeksie w dokumencie.
Podział sekcji musi zostać wstawiony w granicach istniejącego
podziałów sekcji nie można wstawiać do tabeli, równania, przypisu, nagłówka ani stopki; Podziały sekcji można wstawiać tylko wewnątrz treści, więc tag
|
endOfSegmentLocation
|
Wstawia nowy wiersz i podział sekcji na końcu treści dokumentu.
podziałów sekcji nie można wstawiać w przypisach, nagłówkach ani stopkach; Podziały sekcji można wstawiać tylko wewnątrz treści, więc tag
|
DeleteHeaderRequest
Usuwa
Header
z dokumentu.
Zapis JSON |
---|
{ "headerId": string, "tabId": string } |
Pola | |
---|---|
headerId
|
Identyfikator nagłówka do usunięcia. Jeśli ten nagłówek jest zdefiniowany na
|
tabId
|
Karta zawierająca nagłówek do usunięcia. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie z wieloma kartami:
|
PinTableHeaderRowsRequest
Aktualizuje liczbę przypiętych wierszy z nagłówkami w tabeli.
Zapis JSON |
---|
{
"tableStartLocation": {
object (
|
Pola | |
---|---|
tableStartLocation
|
Lokalizacja w dokumencie, w której zaczyna się tabela. |
pinnedHeaderRowsCount
|
Liczba wierszy tabeli do przypięcia. Wartość 0 oznacza, że wszystkie wiersze są odpięte. |