Requests

Żądanie

Pojedyncza aktualizacja, która ma zostać zastosowana do dokumentu.

Zapis JSON
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
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

object (ReplaceAllTextRequest)

Zastępuje wszystkie wystąpienia określonego tekstu.

insertText

object (InsertTextRequest)

Wstawia tekst w określonym miejscu.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualizuje styl tekstu w określonym zakresie.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Tworzy punktory akapitów.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Usuwa punktory z akapitów.

createNamedRange

object (CreateNamedRangeRequest)

Tworzy zakres nazwany.

deleteNamedRange

object (DeleteNamedRangeRequest)

Usuwa zakres nazwany.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualizuje styl akapitu w określonym zakresie.

deleteContentRange

object (DeleteContentRangeRequest)

Usuwa zawartość dokumentu.

insertInlineImage

object (InsertInlineImageRequest)

Wstawia obraz wbudowany w określoną lokalizację.

insertTable

object (InsertTableRequest)

Wstawia tabelę w określonej lokalizacji.

insertTableRow

object (InsertTableRowRequest)

Wstawia pusty wiersz do tabeli.

insertTableColumn

object (InsertTableColumnRequest)

Wstawia pustą kolumnę do tabeli.

deleteTableRow

object (DeleteTableRowRequest)

Usuwa wiersz z tabeli.

deleteTableColumn

object (DeleteTableColumnRequest)

Usuwa kolumnę z tabeli.

insertPageBreak

object (InsertPageBreakRequest)

Wstawia podział strony w określonym miejscu.

deletePositionedObject

object (DeletePositionedObjectRequest)

Usuwa umieszczony obiekt z dokumentu.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualizuje właściwości kolumn w tabeli.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Zmienia styl komórek tabeli.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Aktualizuje styl wierszy w tabeli.

replaceImage

object (ReplaceImageRequest)

Zastępuje obraz w dokumencie.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Zmienia styl dokumentu.

mergeTableCells

object (MergeTableCellsRequest)

Scala komórki w tabeli.

unmergeTableCells

object (UnmergeTableCellsRequest)

Rozdziela komórki w tabeli.

createHeader

object (CreateHeaderRequest)

Tworzy nagłówek.

createFootnote

object (CreateFootnoteRequest)

Tworzy przypis.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Zastępuje treść w nazwanym zakresie.

updateSectionStyle

object (UpdateSectionStyleRequest)

Aktualizuje styl sekcji określonego zakresu.

insertSectionBreak

object (InsertSectionBreakRequest)

Wstawia podział sekcji w podanej lokalizacji.

deleteHeader

object (DeleteHeaderRequest)

Usuwa nagłówek z dokumentu.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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 (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Pola
replaceText

string

Tekst, który zastąpi dopasowany tekst.

tabsCriteria

object (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ę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli nazwa zostanie pominięta, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli karta zostanie udostępniona, zamiennik zostanie zastosowany do określonych kart.

  • Jeśli pominiesz ten zapis, zastąpimy go na wszystkich kartach.

Pole sumy criteria Kryteria używane do dopasowania tekstu do zamiany. criteria może być tylko jednym z tych elementów:
containsText

object (SubstringMatchCriteria)

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

string

Tekst do wyszukania w dokumencie.

matchCase

boolean

Wskazuje, czy wyszukiwanie ma uwzględniać wielkość liter:

  • True : wielkość liter w wyszukiwaniu ma znaczenie.
  • False : wielkość liter w wyszukiwaniu nie jest rozróżniana.

TabsCriteria

Kryteria określające, na których kartach jest uruchamiane żądanie.

Zapis JSON
{
  "tabIds": [
    string
  ]
}
Pola
tabIds[]

string

Lista identyfikatorów kart, na których jest wykonywane żądanie.

InsertTextRequest

Wstawia tekst w określonym miejscu.

Zapis JSON
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
text

string

Tekst do wstawienia.

Wstawienie znaku nowego wiersza spowoduje niejawnie utworzenie nowego Paragraph dla tego indeksu. Styl akapitu w nowym akapicie zostanie skopiowany z akapitu w bieżącym indeksie wstawiania, w tym list i punktorów.

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

object (Location)

Wstawia tekst w określonym indeksie w dokumencie.

Tekst musi zostać wstawiony w granicach istniejącego Paragraph Na przykład tekstu nie można wstawić w indeksie początkowym tabeli (np. między tabelą a jej poprzednim akapitem). Tekst należy wstawić w poprzednim akapicie.

endOfSegmentLocation

object (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

string

Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu.

index

integer

Indeks liczony od zera w jednostkach kodu UTF-16.

Indeks jest ustawiany względem początku segmentu określonego przez segmentId

tabId

string

Karta, na której znajduje się lokalizacja. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

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

string

Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się lokalizacja. Pusty identyfikator segmentu oznacza treść dokumentu.

tabId

string

Karta, na której znajduje się lokalizacja. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

UpdateTextStyleRequest

Zmień styl tekstu.

Zapis JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
textStyle

object (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ę: TextStyle .

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny textStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zmienić styl tekstu na pogrubienie, ustaw fields do "bold"

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

object (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 (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Pola
range

object (Range)

Zakres, w którym chcesz zastosować gotowe ustawienie punktora.

bulletPreset

enum (BulletGlyphPreset)

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 (Range)
  }
}
Pola
range

object (Range)

Zakres, z którego chcesz usunąć punktory.

CreateNamedRangeRequest

Tworzy NamedRange w odniesieniu do danego zakresu.

Zapis JSON
{
  "name": string,
  "range": {
    object (Range)
  }
}
Pola
name

string

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

object (Range)

Zakres, do którego ma zostać zastosowana nazwa.

DeleteNamedRangeRequest

Usuwa NamedRange

Zapis JSON
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
Pola
tabsCriteria

object (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ę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli ten argument nie zostanie pominięty, usunięcie zakresu dotyczy pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli zakres zostanie podany, usunięcie zakresu dotyczy określonych kart.

  • Jeśli zakres nie zostanie podany, usunięcie zakresu dotyczy wszystkich kart.

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

string

Identyfikator nazwanego zakresu do usunięcia.

name

string

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 (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
paragraphStyle

object (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ę: ParagraphStyle .

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny paragraphStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby na przykład zaktualizować właściwość wyrównania stylu akapitu, ustaw fields do "alignment"

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

object (Range)

Zakres nakładający się na akapity, których styl chcesz określić.

DeleteContentRangeRequest

Usuwa zawartość dokumentu.

Zapis JSON
{
  "range": {
    object (Range)
  }
}
Pola
range

object (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 (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
uri

string

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 ImageProperties.content_uri .

objectSize

object (Size)

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

object (Location)

Wstawia obraz w określonym indeksie w dokumencie.

Obraz musi zostać wstawiony w granicach istniejącego Paragraph Nie można go na przykład wstawić na początku indeksu tabeli (np. między tabelą a jej poprzednim akapitem).

Obrazów wbudowanych nie można wstawiać do przypisów ani równań.

endOfSegmentLocation

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
rows

integer

Liczba wierszy w tabeli.

columns

integer

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

object (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 Paragraph Nie można go na przykład wstawić na początku indeksu tabeli (np. między istniejącą tabelą a jej poprzednim akapitem).

Nie można wstawiać tabel wewnątrz przypisów ani równań.

endOfSegmentLocation

object (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 (TableCellLocation)
  },
  "insertBelow": boolean
}
Pola
tableCellLocation

object (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

boolean

Określa, czy wstawić nowy wiersz pod lokalizacją komórki odwołania.

  • True : wstaw pod komórką.
  • False : wstaw nad komórką.

TableCellLocation

Lokalizacja pojedynczej komórki w tabeli.

Zapis JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
Pola
tableStartLocation

object (Location)

Lokalizacja w dokumencie, w której zaczyna się tabela.

rowIndex

integer

Indeks wiersza liczony od zera. Na przykład indeks wiersza drugiego wiersza tabeli wynosi 1.

columnIndex

integer

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 (TableCellLocation)
  },
  "insertRight": boolean
}
Pola
tableCellLocation

object (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

boolean

Określa, czy wstawić nową kolumnę po prawej stronie lokalizacji komórki odwołania.

  • True : wstaw po prawej stronie.
  • False : wstaw po lewej.

DeleteTableRowRequest

Usuwa wiersz z tabeli.

Zapis JSON
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Pola
tableCellLocation

object (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 (TableCellLocation)
  }
}
Pola
tableCellLocation

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
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

object (Location)

Wstawia podział strony w określonym indeksie w dokumencie.

Podział strony musi zostać wstawiony w granicach istniejącego Paragraph Nie można go na przykład wstawić na początku indeksu tabeli (np. między tabelą a jej poprzednim akapitem).

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 segment ID to pole musi być puste.

endOfSegmentLocation

object (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 segment ID to pole musi być puste.

DeletePositionedObjectRequest

Usuwa PositionedObject z dokumentu.

Zapis JSON
{
  "objectId": string,
  "tabId": string
}
Pola
objectId

string

Identyfikator umieszczonego obiektu do usunięcia.

tabId

string

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ę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

UpdateTableColumnPropertiesRequest

Aktualizuje TableColumnProperties kolumn w tabeli.

Zapis JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Pola
tableStartLocation

object (Location)

Lokalizacja w dokumencie, w której zaczyna się tabela.

columnIndices[]

integer

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

object (TableColumnProperties)

Właściwości kolumny tabeli do zaktualizowania.

Jeśli wartość zmiennej tableColumnProperties#width jest mniejszy niż 5 punktów (5/72 cala), zwracany jest błąd nieprawidłowego żądania 400.

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny tableColumnProperties jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zaktualizować szerokość kolumny, ustaw fields do "width"

UpdateTableCellStyleRequest

Aktualizuje styl zakresu komórek tabeli.

Zapis JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
Pola
tableCellStyle

object (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:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny tableCellStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zaktualizować kolor tła komórki tabeli, ustaw fields do "backgroundColor"

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

object (TableRange)

Zakres tabeli reprezentujący podzbiór tabeli, do której zastosowano aktualizacje.

tableStartLocation

object (Location)

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 (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Pola
tableCellLocation

object (TableCellLocation)

Lokalizacja komórki, w której zaczyna się zakres tabeli.

rowSpan

integer

Rozpiętość wierszy zakresu tabeli.

columnSpan

integer

Rozpiętość kolumn zakresu tabeli.

UpdateTableRowStyleRequest

Aktualizuje TableRowStyle wierszy w tabeli.

Zapis JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
Pola
tableStartLocation

object (Location)

Lokalizacja w dokumencie, w której zaczyna się tabela.

rowIndices[]

integer

Lista indeksów wierszy od zera, których styl ma zostać zaktualizowany. Jeśli nie określisz indeksów, zaktualizowane zostaną wszystkie wiersze.

tableRowStyle

object (TableRowStyle)

Style do ustawienia w wierszach.

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny tableRowStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zaktualizować minimalną wysokość wiersza, ustaw fields do "minRowHeight"

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 (ImageReplaceMethod),
  "tabId": string
}
Pola
imageObjectId

string

Identyfikator istniejącego obrazu, który zostanie zastąpiony. Identyfikator można pobrać z odpowiedzi na żądanie get.

uri

string

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 ImageProperties.source_uri .

imageReplaceMethod

enum (ImageReplaceMethod)

Metoda zastępowania.

tabId

string

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ę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

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 (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
Pola
documentStyle

object (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ę: DocumentStyle .

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny documentStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zaktualizować tło, ustaw fields do "background"

tabId

string

Karta zawierająca styl do zaktualizowania. W przypadku jego pominięcia żądanie jest stosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli nie zostanie podana, żądanie zostanie zastosowane do pierwszej karty dokumentu.

MergeTableCellsRequest

Scala komórki w Table

Zapis JSON
{
  "tableRange": {
    object (TableRange)
  }
}
Pola
tableRange

object (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 (TableRange)
  }
}
Pola
tableRange

object (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 (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Pola
type

enum (HeaderFooterType)

Typ nagłówka do utworzenia.

sectionBreakLocation

object (Location)

Lokalizacja SectionBreak który rozpoczyna sekcję, do której powinien należeć ten nagłówek. Jeśli „sectionBreakLocation” nie jest ustawiona, a jeśli odnosi się do pierwszego podziału sekcji w treści dokumentu, nagłówek odnosi się do sekcji DocumentStyle

HeaderFooterType

Typy nagłówków i stopek, które można utworzyć.

Wartości w polu enum
DEFAULT Domyślny nagłówek/stopka.

CreateFooterRequest

Tworzy Footer Nowa stopka zostanie zastosowana do SectionStyle w miejscu SectionBreak jeśli został określony. W przeciwnym razie jest stosowany do DocumentStyle

Jeśli stopka określonego typu już istnieje, zwracany jest błąd 400 nieprawidłowego żądania.

Zapis JSON
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Pola
type

enum (HeaderFooterType)

Typ stopki do utworzenia.

sectionBreakLocation

object (Location)

Lokalizacja SectionBreak bezpośrednio poprzedzającym sekcję, której SectionStyle do której powinna należeć ta stopka. Jeśli zasada jest nieskonfigurowana lub odnosi się do pierwszego podziału sekcji w dokumencie, stopka jest stosowana do stylu dokumentu.

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 footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
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

object (Location)

Wstawia odwołanie do przypisu w określonym indeksie w dokumencie.

Odwołanie do przypisu musi zostać wstawione w granicach istniejącego Paragraph Nie można go na przykład wstawić na początku indeksu tabeli (np. między tabelą a jej poprzednim akapitem).

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 segment ID to pole musi być puste.

endOfSegmentLocation

object (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 segment ID to pole musi być puste.

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 (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
Pola
tabsCriteria

object (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ę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli nazwa zostanie pominięta, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli karta zostanie udostępniona, zamiennik zostanie zastosowany do określonych kart.

  • Jeśli pominiesz ten zapis, zastąpimy go na wszystkich kartach.

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

string

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

string

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

string

Nazwa NamedRanges których treść zostanie zastąpiona.

W przypadku wielu named ranges pod daną nazwą, zawartość każdego z nich zostanie zastąpiona. Jeśli nie ma żadnych nazwanych zakresów o podanej nazwie, żądanie będzie no-op.

UpdateSectionStyleRequest

Aktualizuje SectionStyle

Zapis JSON
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
Pola
range

object (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 segment ID to pole musi być puste.

sectionStyle

object (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ę: SectionStyle .

fields

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej jedno pole. Poziom główny sectionStyle jest domniemana i nie należy jej określać. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby np. zaktualizować lewy margines, ustaw fields do "marginLeft"

InsertSectionBreakRequest

Wstawia podział sekcji w podanej lokalizacji.

Przed podziałem sekcji zostanie wstawiony znak nowego wiersza.

Zapis JSON
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Pola
sectionType

enum (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

object (Location)

Wstawia nowy wiersz i podział sekcji w określonym indeksie w dokumencie.

Podział sekcji musi zostać wstawiony w granicach istniejącego Paragraph Nie można go na przykład wstawić na początku indeksu tabeli (np. między tabelą a jej poprzednim akapitem).

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 segment ID to pole musi być puste.

endOfSegmentLocation

object (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 segment ID to pole musi być puste.

DeleteHeaderRequest

Usuwa Header z dokumentu.

Zapis JSON
{
  "headerId": string,
  "tabId": string
}
Pola
headerId

string

Identyfikator nagłówka do usunięcia. Jeśli ten nagłówek jest zdefiniowany na DocumentStyle, odwołanie do tego nagłówka zostanie usunięte, co spowoduje brak nagłówka tego typu w pierwszej sekcji dokumentu. Jeśli ten nagłówek jest zdefiniowany na SectionStyle, odwołanie do tego nagłówka zostanie usunięte, a nagłówek tego typu będzie kontynuowany z poprzedniej sekcji.

tabId

string

Karta zawierająca nagłówek do usunięcia. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

DeleteFooterRequest

Usuwa Footer z dokumentu.

Zapis JSON
{
  "footerId": string,
  "tabId": string
}
Pola
footerId

string

Identyfikator stopki do usunięcia. Jeśli stopka jest zdefiniowana na DocumentStyle, odwołanie do tej stopki zostanie usunięte, co spowoduje, że pierwsza sekcja dokumentu nie będzie miała stopki tego typu. Jeśli stopka jest zdefiniowana na SectionStyle, odwołanie do tej stopki zostanie usunięte, a stopka tego typu będzie kontynuowana z poprzedniej sekcji.

tabId

string

Karta zawierająca stopkę do usunięcia. Jeśli je pominiesz, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

PinTableHeaderRowsRequest

Aktualizuje liczbę przypiętych wierszy z nagłówkami w tabeli.

Zapis JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
Pola
tableStartLocation

object (Location)

Lokalizacja w dokumencie, w której zaczyna się tabela.

pinnedHeaderRowsCount

integer

Liczba wierszy tabeli do przypięcia. Wartość 0 oznacza, że wszystkie wiersze są odpięte.