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)

Zmienia styl tekstu w określonym zakresie.

object (CreateParagraphBulletsRequest)

Tworzy punkty dla akapitów.

object (DeleteParagraphBulletsRequest)

usuwa punkty 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 podział strony w określonym miejscu.

object (DeletePositionedObjectRequest)

Usuwa z dokumentu umieszczony obiekt.

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)

Scalenie komórek 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 zawartość w zakresie nazwanym.

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)

Zmienia 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 używane do określania, na których kartach ma nastąpić wymiana.

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

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

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

W dokumencie zawierającym wiele kart:

• Jeśli podano, zastąpienie dotyczy 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, którego szukać w dokumencie.

boolean

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

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

{
  "tabIds": [
    string
  ]
}

string

Lista identyfikatorów kart, na których wykonywane jest żą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, który ma zostać wstawiony.

Wstawienie znaku końca wiersza powoduje dodanie nowego elementu Paragraph w danym indeksie. Styl akapitu nowego akapitu zostanie skopiowany z akapitu w bieżącym indeksie wstawienia, w tym list i wypunktowań.

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 styl tekstu 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 być wstawiany w ramach istniejącego elementu Paragraph. Nie można na przykład wstawiać tekstu na początku indeksu tabeli (czyli między tabelą a poprzednim akapitem). Tekst musi zostać wstawiony 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 jest podany względem początku segmentu określonego przez parametr segmentId.

string

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

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

• Jeśli nie zostanie podany, prośba dotyczy 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 nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

• Jeśli nie zostanie podany, prośba zostanie zastosowana do 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ść danego stylu jest taka sama jak wartość stylu nadrzędnego, ten styl zostanie ustawiony jako dziedziczony.

Niektóre zmiany stylu tekstu mogą powodować inne zmiany, aby odzwierciedlić działanie edytora Dokumentów. Więcej informacji znajdziesz w dokumentacji TextStyle.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator textStyle jest domyślny i nie musi być podany. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

Aby na przykład zmienić styl tekstu na pogrubiony, ustaw wartość fields na "bold".

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

object (Range)

Zakres tekstu do sformatowania.

Zakres może zostać rozszerzony, aby obejmował sąsiednie znaki końca 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 w względnym żądaniu UpdateTextStyleRequest.

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

object (Range)

Zakres, do którego ma zostać zastosowany gotowy punktor.

enum (BulletGlyphPreset)

Rodzaje użytych symboli punktowanych.

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

object (Range)

Zakres, z którego mają zostać usunięte punkty.

{
  "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 być zgodny z identyfikatorem pojedynczej karty.

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

W dokumencie zawierającym wiele kart:

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

• Jeśli nie podasz zakresu, usunięcie zakresu będzie dotyczyć wszystkich kart.

string

Identyfikator zakresu nazwanego, który chcesz usunąć.

string

Nazwa zakresów do usunięcia. Wszystkie nazwane zakresy o danej 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ą powodować inne zmiany, aby odzwierciedlić działanie edytora Dokumentów. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją ParagraphStyle.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator paragraphStyle jest domyślny i nie musi być podany. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

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

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

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 niektórych zakresów może spowodować nieprawidłową strukturę dokumentu, co spowoduje wyświetlenie błędu 400 „Zła prośba”.

Oto przykłady nieprawidłowych żądań usunięcia:

• Usuwanie jednej jednostki kodu pary zastępczej.
• Usunięcie ostatniego znaku nowej linii w pliku Body, Header, Footer, Footnote, TableCell lub TableOfContents.
• usunięcie początku lub końca elementuTable,TableOfContentslubEquation, nie usuwając całego elementu.
• usunięcie znaku końca wiersza przed elementem Table, TableOfContents lub SectionBreak bez usuwania elementu.
• usuwanie poszczególnych 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ć dostępny publicznie i mieć maksymalnie 2 kB długości. Identyfikator URI jest zapisywany razem z obrazem i wyświetlany w poluImageProperties.content_uri.

object (Size)

Rozmiar, w jakim obraz ma się wyświetlać w dokumencie. Ta właściwość jest opcjonalna, a ostateczny rozmiar obrazu w dokumencie jest określany według tych reguł: * Jeśli nie określono ani szerokości, ani wysokości, domyślny rozmiar obrazu jest 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 poprzedzającym ją akapitem).

Obrazów wstawianych w tekście nie można umieszczać w przypisie ani w równaniu.

object (EndOfSegmentLocation)

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

Obrazów wstawianych w tekście nie można umieszczać w przypisie.

{
  "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 wstawianą tabelą zostanie wstawiony znak nowej linii, dlatego indeks początku tabeli będzie wynosił podany indeks lokalizacji + 1.

Tabela musi zostać wstawiona w ograniczeniach istniejącej Paragraph. Nie można go na przykład wstawić na początku indeksu tabeli (czyli między istniejącą tabelą a poprzednim akapitem).

Tabel nie można wstawiać w przypisie ani równaniu.

object (EndOfSegmentLocation)

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

Nie można wstawiać tabel w stopce.

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

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której zostaną wstawione wiersze.

Nowy wiersz zostanie wstawiony nad (lub pod) wierszem, w którym znajduje się komórka odniesienia. Jeśli komórka odniesienia jest komórką scaloną, nowy wiersz zostanie wstawiony nad (lub pod) tą komórką.

boolean

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

• True: wstawianie poniżej komórki.
• 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 odniesienia, z której zostaną wstawione kolumny.

Nowa kolumna zostanie wstawiona po lewej (lub prawej) stronie kolumny, w której znajduje się komórka odniesienia. Jeśli komórka odniesienia jest komórką scaloną, nowa kolumna zostanie wstawiona po lewej (lub prawej) stronie komórki scalonej.

boolean

Określa, czy nowa kolumna ma zostać wstawiona po prawej stronie komórki referencyjnej.

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

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

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której zostanie usunięty wiersz.

Wiersz, na który sięga komórka, zostanie usunięty. Jeśli jest to komórka scalona, która obejmuje kilka wierszy, wszystkie komórki zostaną usunięte. 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, zostaną usunięte wszystkie kolumny, które obejmuje. Jeśli po usunięciu kolumn nie pozostanie w niej żadna kolumna, 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 (czyli między tabelą a poprzedzającym ją akapitem).

Nie można wstawiać podziałów stron w tabeli, równaniu, przypisie, nagłówku ani stopce. 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.

Przerwy stron nie można wstawiać w przypisie, nagłówku ani stopce. 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ę obiekt do usunięcia. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

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

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

object (Location)

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

integer

Lista indeksów kolumn z numeracją od 0, których właściwości należy zaktualizować. Jeśli nie podasz żadnych indeksów, zostaną zaktualizowane wszystkie kolumny.

object (TableColumnProperties)

Właściwości kolumny tabeli, które chcesz zaktualizować.

Jeśli wartość tableColumnProperties#width jest mniejsza niż 5 punktów (5/72 cala), zwracany jest błąd 400 zły wniosek.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator tableColumnProperties jest domyślny i nie musi być podany. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

Aby na przykład zmienić szerokość kolumny, ustaw wartość fields na "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 zastosowania 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. Nie są aktualizowane obramowania, które są scalone i niewidoczne.

Zmiana obramowania wspólnego dla sąsiednich komórek w tym samym żądaniu może spowodować konfliktowe zmiany obramowania, dlatego zmiany te są stosowane w tej kolejności:

• borderRight
• borderLeft
• borderBottom
• borderTop

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator tableCellStyle jest domyślny i nie musi być podany. 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 to konieczne, aktualizacje zostaną zastosowane do wszystkich komórek w tabeli.

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

object (TableCellLocation)

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

integer

Zakres wierszy zakresu tabeli.

integer

Zakres kolumny w zakresie 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 podasz żadnych indeksów, zaktualizowane zostaną wszystkie wiersze.

object (TableRowStyle)

Style, które mają być ustawione w wierszach.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator tableRowStyle jest domyślny i nie musi być podany. 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 mieć długości przekraczającej 2 KB. Identyfikator URI jest zapisywany razem z obrazem i wyświetlany w polu ImageProperties.source_uri.

enum (ImageReplaceMethod)

Metoda wymiany.

string

Karta, na której znajduje się obraz, który chcesz zastąpić. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej 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ą powodować inne zmiany, aby odzwierciedlić działanie edytora Dokumentów. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją DocumentStyle.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Identyfikator documentStyle jest domyślny i nie musi być podany. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

Aby na przykład zaktualizować tło, ustaw fields na "background".

string

Karta zawierająca styl, który chcesz zaktualizować. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

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

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

Zakres tabeli określający, które komórki tabeli mają zostać scalone.

Tekst w komórkach, które są scalane, zostanie złączony i zapisany w komórce „head” zakresu. Jest to komórka w lewym górnym rogu zakresu, jeśli kierunek treści jest od lewej do prawej, a w przeciwnym razie jest to komórka w prawym górnym rogu zakresu.

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ć odscalowane.

Wszystkie scalone komórki w tym zakresie zostaną rozdzielone, a komórki, które są już rozdzielone, nie zostaną zmienione. Jeśli zakres nie zawiera scalonych komórek, żądanie nie będzie miało żadnego efektu.

Jeśli w jakiejś scalonej komórce znajduje się tekst, pozostanie on w komórce „głównej” w bloku utworzonych komórek. Komórka „head” to komórka w lewym górnym rogu, jeśli kierunek treści jest od lewej do prawej, a w przeciwnym razie w prawym górnym rogu.

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

enum (HeaderFooterType)

Typ nagłówka do utworzenia.

object (Location)

Lokalizacja SectionBreak, która rozpoczyna sekcję, do której powinien należeć ten nagłówek. Jeśli parametr „sectionBreakLocation” nie jest ustawiony lub odnosi się do pierwszego podziału sekcji w treści dokumentu, nagłówek jest stosowany do: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.SectionStyle Jeśli to pole jest puste 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 być wstawione w ramach istniejącego elementu Paragraph. Nie można go na przykład wstawić na początku indeksu tabeli (czyli między tabelą a poprzedzającym ją 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 używane do określania, na których kartach ma nastąpić wymiana. Jeśli nie zostanie podany, zastąpienie zostanie zastosowane do wszystkich kart.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

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

W dokumencie zawierającym wiele kart:

• Jeśli podano, zastąpienie dotyczy określonych kart.

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

string

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

string

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

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

string

Nazwa NamedRanges, którego 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ładania się sekcji do stylizacji.

Przerwy między sekcjami można wstawiać tylko w treści, więc pole segment ID musi być puste.

object (SectionStyle)

Style, które mają być ustawione w sekcji.

Niektóre zmiany stylu sekcji mogą powodować inne zmiany, aby odzwierciedlić działanie edytora Dokumentów. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją SectionStyle.

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Element sectionStyle jest elementem nadrzędnym, którego nie trzeba deklarować. Jako skrót do wylistowania wszystkich pól można użyć pojedynczego znaku "*".

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 nowej linii i przerwę sekcyjną 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 (czyli między tabelą a poprzednim akapitem).

Przerwy między sekcjami nie można wstawiać w tabeli, równaniu, przypisie, nagłówku ani stopce. Przerwy między sekcjami można wstawiać tylko w treści, więc pole segment ID musi być puste.

object (EndOfSegmentLocation)

Wstawia znak nowego wiersza i przerwę sekcji na końcu głównej części dokumentu.

Przerwy między sekcjami nie można wstawiać w przypisie, nagłówku ani stopce. Przerwy między sekcjami można wstawiać tylko w treści, więc pole segment ID 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 ten nagłówek jest zdefiniowany w sekcji SectionStyle, odniesienie do tego nagłówka zostanie usunięte, a nagłówek tego typu będzie kontynuowany z poprzedniej sekcji.

string

Karta zawierająca nagłówek, który chcesz usunąć. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

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

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

string

Identyfikator stopki do usunięcia. Jeśli stopka jest zdefiniowana w poziomie DocumentStyle, odwołanie do niej zostaje usunięte, co powoduje, że w pierwszej sekcji dokumentu nie ma stopki tego typu. Jeśli stopka jest zdefiniowana w poziomie SectionStyle, odniesienie do niej zostaje usunięte, a stopka tego typu jest kontynuowana z poprzedniej sekcji.

string

Karta zawierająca stopkę, którą chcesz usunąć. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

• Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

• Jeśli nie zostanie podany, prośba dotyczy pojedynczej karty.

W dokumencie zawierającym wiele kart:

• Jeśli podano, prośba dotyczy wskazanej karty.

• Jeśli nie zostanie podany, prośba zostanie zastosowana do 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.