Requests

{

  // 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.
}

object (ReplaceAllTextRequest)

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

object (InsertTextRequest)

Wstawia tekst w określonym miejscu.

object (UpdateTextStyleRequest)

Aktualizuje styl tekstu w określonym zakresie.

object (CreateParagraphBulletsRequest)

Tworzy punktory akapitów.

object (DeleteParagraphBulletsRequest)

Usuwa punktory z akapitów.

object (CreateNamedRangeRequest)

Tworzy zakres nazwany.

object (DeleteNamedRangeRequest)

Usuwa zakres nazwany.

object (UpdateParagraphStyleRequest)

Aktualizuje styl akapitu w określonym zakresie.

object (DeleteContentRangeRequest)

usuwa treści z dokumentu.

object (InsertInlineImageRequest)

Wstawia obraz w treści w określonym miejscu.

object (InsertTableRequest)

Wstawia tabelę w określonym miejscu.

object (InsertTableRowRequest)

Wstawia pusty wiersz do tabeli.

object (InsertTableColumnRequest)

Wstawia pustą kolumnę do tabeli.

object (DeleteTableRowRequest)

Usuwa wiersz z tabeli.

object (DeleteTableColumnRequest)

Usuwa kolumnę z tabeli.

object (InsertPageBreakRequest)

Wstawia w określonym miejscu przerwę na stronie.

object (DeletePositionedObjectRequest)

Usuwa umieszczony obiekt z dokumentu.

object (UpdateTableColumnPropertiesRequest)

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

object (UpdateTableCellStyleRequest)

Zmienia styl komórek tabeli.

object (UpdateTableRowStyleRequest)

Zmienia styl wiersza w tabeli.

object (ReplaceImageRequest)

Zastępuje obraz w dokumencie.

object (UpdateDocumentStyleRequest)

Zaktualizuje styl dokumentu.

object (MergeTableCellsRequest)

Scala komórki w tabeli.

object (UnmergeTableCellsRequest)

odłącza komórki w tabeli.

object (CreateHeaderRequest)

Tworzy nagłówek.

object (CreateFooterRequest)

Tworzy stopkę.

object (CreateFootnoteRequest)

Tworzy przypis.

object (ReplaceNamedRangeContentRequest)

Zastępuje treść w nazwanym zakresie.

object (UpdateSectionStyleRequest)

Aktualizuje styl sekcji w określonym zakresie.

object (InsertSectionBreakRequest)

Wstawia podział sekcji w określonym miejscu.

object (DeleteHeaderRequest)

Usuwa nagłówek z dokumentu.

object (DeleteFooterRequest)

Usuwa stopkę z dokumentu.

object (PinTableHeaderRowsRequest)

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

{
  "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.
}

string

Tekst, który zastąpi dopasowany tekst.

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 ten argument nie zostanie podany, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli zostanie podana, zamiennik będzie miał zastosowanie do określonych kart.

• Jeśli nie zostanie podany, zastąpienie zostanie zastosowane do wszystkich kart.

object (SubstringMatchCriteria)

Znajduje w dokumencie tekst pasujący do tego podciągu.

{
  "text": string,
  "matchCase": boolean
}

string

Tekst do wyszukania w dokumencie.

boolean

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

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

{
  "tabIds": [
    string
  ]
}

string

Lista identyfikatorów kart, na których ma być wykonywane żądanie.

{
  "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.
}

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.

Styl tekstu w wstawionym tekście zostanie określony automatycznie, zachowując ogólnie styl sąsiadującego tekstu. W większości przypadków styl tekstu wstawionego tekstu będzie taki sam jak tekst bezpośrednio przed indeksem wstawiania.

Z wstawionego tekstu zostaną usunięte niektóre znaki kontrolne (U+0000-U+0008, U+000C-U+001F) oraz znaki z obszaru prywatnego Unicode Basic Multilingual Plane (U+E000-U+F8FF).

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.

object (EndOfSegmentLocation)

Wstawia tekst na końcu nagłówka, stopki, przypisu lub treści dokumentu.

{
  "segmentId": string,
  "index": integer,
  "tabId": string
}

string

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

integer

Indeks oparty na 0 w jednostkach kodu UTF-16.

Indeks zależy od początku segmentu określonego przez segmentId

string

Karta, na której znajduje się lokalizacja. Jeśli nie podasz tej wartości, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

• Jeśli nie zostanie podany, prośba zostanie zastosowana do pierwszej karty w dokumencie.

{
  "segmentId": string,
  "tabId": string
}

string

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

string

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

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

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

{
  "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.
}

object (TextStyle)

Style, które mają być ustawione 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ą powodować inne zmiany, aby odzwierciedlić działanie edytora Dokumentów. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją TextStyle.

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej 1 pole. Poziom główny textStyle jest domniemana i nie należy jej określać. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

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.

object (Range)

Zakres tekstu do stylizacji.

Zakres można rozszerzyć o sąsiednie znaki nowego wiersza.

Jeśli zakres zawiera cały akapit należący do listy, punkt na liście jest również aktualizowany o pasujący styl tekstu.

Nie można wstawiać zakresów wewnątrz względnego UpdateTextStyleRequest.

{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

object (Range)

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

enum (BulletGlyphPreset)

Rodzaje glifów punktowanych, których chcesz użyć.

{
  "range": {
    object (Range)
  }
}

object (Range)

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

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

string

Nazwa zakresu nazwa. Nazwy nie muszą być unikalne.

Nazwa musi mieć co najmniej 1 znak i nie więcej niż 256 znaków (w jednostkach kodu UTF-16).

object (Range)

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

{
  "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.
}

object (TabsCriteria)

Opcjonalnie: Kryteria używane do określania, na których kartach ma nastąpić usunięcie zakresu. Jeśli nie zostanie pominięty, usunięcie zakresu zostanie zastosowane 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 jest podany, usunięcie zakresu dotyczy określonych kart.

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

string

Identyfikator nazwanego zakresu do usunięcia.

string

Nazwy zakresów do usunięcia. Wszystkie nazwane zakresy o podanej nazwie zostaną usunięte.

{
  "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.
}

object (ParagraphStyle)

Style, które mają być 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 .

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej 1 pole. Identyfikator paragraphStyle jest domyślny i nie musi być podany. 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 wartość parametrufieldsna"alignment".

Aby zresetować właściwość do wartości domyślnej, podaj jej nazwę w masce pola, ale pozostaw samo pole nieskonfigurowane.

object (Range)

Zakres obejmujący akapity, które mają być sformatowane.

{
  "range": {
    object (Range)
  }
}

object (Range)

Zakres treści do usunięcia.

Usunięcie tekstu, który przekracza granicę akapitu, może spowodować zmiany stylów akapitów, list, obiektów z pozycjonowaniem i zakładek, ponieważ akapity zostaną połączone.

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:

• Usuwanie 1 jednostki kodu z pary zastępczej.
• Usuwanie ostatniego znaku nowej linii w pliku Body, Header, Footer, Footnote, TableCell lub TableOfContents.
• Usuwanie początku lub końca Table, TableOfContents lub Equation bez usuwania całego elementu.
• Usunięcie znaku nowego wiersza przed znakiem Table, TableOfContents lub SectionBreak bez usuwania elementu.
• Usuwanie pojedynczych wierszy lub komórek tabeli. Usuwanie treści w komórce tabeli jest dozwolone.

{
  "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.
}

string

Identyfikator URI obrazu.

Obraz jest pobierany raz w momencie wstawiania i kopia jest przechowywana na potrzeby wyświetlania w dokumencie. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą 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 .

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 podany jest jeden wymiar, drugi zostanie obliczony w taki sposób, aby zachować współczynnik proporcji obrazu. * Jeśli podano zarówno szerokość, jak i wysokość, obraz zostanie przeskalowany, aby mieścił się w podanych wymiarach przy zachowaniu współczynnika proporcji.

object (Location)

Wstawia obraz w określonym miejscu w dokumencie.

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

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

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.

{
  "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.
}

integer

Liczba wierszy w tabeli.

integer

Liczba kolumn w tabeli.

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 ograniczeniach istniejącej 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ń.

object (EndOfSegmentLocation)

Wstawia tabelę na końcu danego nagłówka, stopki lub treści dokumentu. Przed wstawionym tabelą zostanie wstawiony znak nowego wiersza.

W przypisie nie można wstawiać tabel.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której zostaną wstawione 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.

boolean

Określa, czy nowy wiersz ma zostać wstawiony pod komórką odniesienia.

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

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

object (Location)

Miejsce w dokumencie, w którym zaczyna się tabela.

integer

Indeks wiersza liczony od 0. Na przykład drugi wiersz w tabeli ma indeks 1.

integer

Indeks kolumny liczony od 0. Na przykład druga kolumna w tabeli ma indeks 1.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}

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.

boolean

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

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

{
  "tableCellLocation": {
    object (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, zostaną usunięte wszystkie wiersze, w których znajduje się rozpiętość komórek. Jeśli po usunięciu wierszy w tabeli nie pozostanie w niej żaden wiersz, zostanie usunięta cała tabela.

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której kolumna zostanie usunięta.

Kolumna, na którą się rozciąga ta komórka, 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.

{

  // 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.
}

object (Location)

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

Przerwę strony należy wstawić w obrębie 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. Przerwy strony można wstawiać tylko w treści, więc pole segment ID musi być puste.

object (EndOfSegmentLocation)

Wstawia podział strony na końcu głównej części dokumentu.

Podziałów stron nie można wstawiać w przypisach, nagłówkach ani stopkach. Przerwy strony można wstawiać tylko w treści, więc pole segment ID musi być puste.

{
  "objectId": string,
  "tabId": string
}

string

Identyfikator umieszczonego obiektu do usunięcia.

string

Karta, na której znajduje się umieszczony obiekt do usunięcia. Jeśli je pominiesz, żądanie zostanie zastosowane na pierwszej karcie.

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

• Jeśli nie zostanie podany, prośba zostanie zastosowana do pierwszej karty w dokumencie.

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

object (Location)

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

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.

object (TableColumnProperties)

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

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

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. tableColumnProperties jest domyślnie dołączona i nie musi być podawana. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

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

{
  "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.
}

object (TableCellStyle)

Styl do ustawienia w komórkach tabeli.

Jeśli podczas aktualizowania obramowania komórka ma wspólne obramowanie z sąsiednią komórką, odpowiednia właściwość obramowania sąsiedniej komórki zostanie również zaktualizowana. Granice, które są scalone i niewidoczne, nie są aktualizowane.

Zaktualizowanie obramowania wspólnego 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

string (FieldMask format)

Pola, które wymagają aktualizacji.

Musisz określić co najmniej 1 pole. Poziom główny tableCellStyle jest domniemana i nie należy jej określać. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

Aby na przykład zaktualizować kolor tła komórki tabeli, ustaw wartość fields na "backgroundColor".

Aby zresetować usługę do wartości domyślnej, dodaj jej nazwę w polu maski, ale nie wypełniaj tego pola.

object (TableRange)

Zakres tabeli reprezentujący podzbiór tabeli, do którego mają być stosowane zmiany.

object (Location)

Miejsce w dokumencie, w którym zaczyna się tabela. Jeśli określisz wartość, aktualizacje zostaną zastosowane do wszystkich komórek w tabeli.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

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

integer

Rozpiętość wierszy zakresu tabeli.

integer

Rozpiętość kolumn zakresu tabeli.

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

object (Location)

Miejsce w dokumencie, w którym zaczyna się tabela.

integer

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

object (TableRowStyle)

Style do ustawienia w wierszach.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej jedno pole. Poziom główny tableRowStyle jest domniemana i nie należy jej określać. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

Aby na przykład zmienić minimalną wysokość wiersza, ustaw wartość fields na "minRowHeight".

{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}

string

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

string

Identyfikator URI nowego obrazu.

Obraz jest pobierany raz w momencie wstawiania i kopia jest przechowywana na potrzeby wyświetlania w dokumencie. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą 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 .

enum (ImageReplaceMethod)

Metoda wymiany.

string

Karta, na której znajduje się obraz, który chcesz zastąpić. Jeśli je pominiesz, żądanie zostanie zastosowane na pierwszej karcie.

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

• Jeśli nie zostanie podany, prośba zostanie zastosowana do pierwszej karty w dokumencie.

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}

object (DocumentStyle)

Style, które mają być ustawione 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 .

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej jedno pole. Identyfikator documentStyle jest domyślny i nie musi być podany. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

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

string

Karta zawierająca styl do zaktualizowania. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć 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.

{
  "tableRange": {
    object (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ć w niektórych przypadkach, gdy obejmuje komórki, które są już scalone lub gdy tabela nie jest prostokątna), zwracany jest błąd 400 „Nieprawidłowy żądanie”.

{
  "tableRange": {
    object (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 będzie miało żadnego efektu.

Jeśli któraś ze scalonych komórek zawiera tekst, pozostanie on w obszarze „head” wynikowy blok niescalonych komórek. „Głowa” komórka to lewa górna komórka, gdy kierunek treści jest ułożony od lewej do prawej, a prawy górny w innym przypadku.

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

enum (HeaderFooterType)

Typ nagłówka do utworzenia.

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

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

enum (HeaderFooterType)

Typ stopki do utworzenia.

object (Location)

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

{

  // 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.
}

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).

Odniesień do przypisów nie można wstawiać w równaniu, nagłówku, stopce ani przypisie. Odniesienia do przypisów można wstawiać tylko w treści, więc pole segment ID musi być puste.

object (EndOfSegmentLocation)

Wstawia odwołanie do przypisu na końcu treści dokumentu.

Odniesień do przypisów nie można umieszczać w nagłówku, stopce ani przypisie. Odniesienia do przypisów można wstawiać tylko w treści, więc pole segment ID musi być puste.

{
  "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.
}

object (TabsCriteria)

Opcjonalnie: Kryteria służące do określania, na których kartach ma być zamieniana treść. Jeśli nie zostanie podany, zastąpienie zostanie zastosowane do wszystkich kart.

W dokumencie zawierającym jedną kartę:

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

• Jeśli ten argument nie zostanie podany, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli zostanie podana, zamiennik będzie miał zastosowanie do określonych kart.

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

string

Zastępuje zawartość określonych zakresów nazwanych podanym tekstem.

string

Identyfikator nazwanego zakresu, którego treść zostanie zastąpiona.

Jeśli nie ma zakresu o podanym identyfikatorze, zwracany jest błąd 400 „Zła prośba”.

string

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

Jeśli istnieje wiele elementównamed rangeso tej samej nazwie, ich zawartość zostanie zastąpiona. Jeśli nie ma żadnych nazwanych zakresów o podanej nazwie, żądanie nie zostanie wykonane.

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

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.

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 .

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej jedno pole. Element sectionStyle jest elementem nadrzędnym, którego nie trzeba deklarować. Jeden "*" może służyć jako skrócenie listy wszystkich pól.

Aby na przykład zmienić lewy margines, ustaw wartość parametru fields na "marginLeft".

{
  "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.
}

enum (SectionType)

Typ sekcji do wstawienia.

object (Location)

Wstawia znak nowego wiersza i przerwę sekcji w określonym miejscu w dokumencie.

Przerwę między sekcjami należy wstawić w ramach 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.

object (EndOfSegmentLocation)

Wstawia znak nowego wiersza i przerwę sekcji na końcu głównej częś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.

{
  "headerId": string,
  "tabId": string
}

string

Identyfikator nagłówka do usunięcia. Jeśli nagłówek jest zdefiniowany w DocumentStyle, odniesienie do niego zostaje usunięte, co powoduje, że w pierwszej sekcji dokumentu nie ma nagłówka tego typu. Jeśli nagłówek jest zdefiniowany w sekcji SectionStyle, odniesienie do tego nagłówka zostaje usunięte, a nagłówek tego typu jest kontynuowany z poprzedniej sekcji.

string

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

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

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

{
  "footerId": string,
  "tabId": string
}

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.

string

Karta zawierająca stopkę, którą chcesz usunąć. Jeśli je pominiesz, żądanie zostanie zastosowane na pierwszej karcie.

W dokumencie zawierającym jedną kartę:

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

• Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie z wieloma kartami:

• Jeśli podano, prośba dotyczy określonej karty.

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

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

object (Location)

Miejsce w dokumencie, w którym zaczyna się tabela.

integer

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