Requests

Żądanie

Pojedyncza aktualizacja do zastosowania w dokumencie.

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)
  },
  "addDocumentTab": {
    object (AddDocumentTabRequest)
  },
  "deleteTab": {
    object (DeleteTabRequest)
  },
  "updateDocumentTabProperties": {
    object (UpdateDocumentTabPropertiesRequest)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  }
  // End of list of possible types for union field request.
}
Pola
Pole zbiorczerequest. Konkretne żądanie, które chcesz zastosować. Wymagane jest dokładnie jedno pole. request może mieć tylko jedną z tych wartości:
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 wypunktowania akapitów.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Usuwa wypunktowania z akapitów.

createNamedRange

object (CreateNamedRangeRequest)

Tworzy zakres z nazwą.

deleteNamedRange

object (DeleteNamedRangeRequest)

Usuwa zakres nazwany.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualizuje styl akapitu w określonym zakresie.

deleteContentRange

object (DeleteContentRangeRequest)

Usuwa zawartość z dokumentu.

insertInlineImage

object (InsertInlineImageRequest)

Wstawia obraz w tekście w określonym miejscu.

insertTable

object (InsertTableRequest)

Wstawia tabelę w określonym miejscu.

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 z dokumentu obiekt umieszczony w określonym miejscu.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

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

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Aktualizuje styl komórek tabeli.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Aktualizuje styl wiersza w tabeli.

replaceImage

object (ReplaceImageRequest)

Zastępuje obraz w dokumencie.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Aktualizuje styl dokumentu.

mergeTableCells

object (MergeTableCellsRequest)

Scala komórki w tabeli.

unmergeTableCells

object (UnmergeTableCellsRequest)

Cofa scalenie komórek w tabeli.

createHeader

object (CreateHeaderRequest)

Tworzy nagłówek.

createFootnote

object (CreateFootnoteRequest)

Tworzy przypis.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Zastępuje zawartość w nazwanym zakresie.

updateSectionStyle

object (UpdateSectionStyleRequest)

Aktualizuje styl sekcji w określonym zakresie.

insertSectionBreak

object (InsertSectionBreakRequest)

Wstawia podział sekcji w określonym miejscu.

deleteHeader

object (DeleteHeaderRequest)

Usuwa nagłówek z dokumentu.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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

addDocumentTab

object (AddDocumentTabRequest)

Dodaje kartę dokumentu.

deleteTab

object (DeleteTabRequest)

Usuwa kartę dokumentu.

updateDocumentTabProperties

object (UpdateDocumentTabPropertiesRequest)

Aktualizuje właściwości karty dokumentu.

insertPerson

object (InsertPersonRequest)

Wstawia wzmiankę o osobie.

ReplaceAllTextRequest

Zastępuje wszystkie wystąpienia tekstu spełniającego kryteria ciągiem 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 używane do określania, na których kartach ma nastąpić zastąpienie.

Jeśli ten parametr zostanie pominięty, zamiana zostanie zastosowana do wszystkich kart.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument zostanie pominięty, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, zamiana dotyczy określonych kart.

  • Jeśli ten parametr zostanie pominięty, zamiana zostanie zastosowana do wszystkich kart.

Pole zbiorczecriteria. Kryteria używane do dopasowania tekstu do zastąpienia. criteria może mieć tylko jedną z tych wartości:
containsText

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

Kryterium, które pasuje do określonego ciągu tekstu w dokumencie.

Zapis JSON 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Pola
text

string

Tekst do wyszukania w dokumencie.

matchCase

boolean

Wskazuje, czy w wyszukiwaniu ma być uwzględniana wielkość liter:

  • True: w wyszukiwaniu jest rozróżniana wielkość liter.
  • False: wyszukiwanie nie uwzględnia wielkości liter.
searchByRegex

boolean

Opcjonalnie. Wartość Prawda, jeśli wartość do znalezienia ma być traktowana jako wyrażenie regularne. Wzorzec nie może zawierać ukośników odwrotnych.

  • True: tekst wyszukiwania jest traktowany jako wyrażenie regularne.
  • False : tekst wyszukiwania jest traktowany jako podciąg do dopasowania.

TabsCriteria

Kryterium określające, na których kartach ma być wykonywane żą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 niejawne utworzenie nowego elementu Paragraph w tym indeksie. Styl akapitu nowego akapitu zostanie skopiowany z akapitu w bieżącym indeksie wstawiania, w tym listy i punktorów.

Style tekstu wstawionego tekstu zostaną określone automatycznie, zwykle z zachowaniem stylu sąsiedniego tekstu. W większości przypadków styl tekstu wstawionego będzie zgodny ze stylem tekstu bezpośrednio przed indeksem wstawienia.

Niektóre znaki kontrolne (U+0000–U+0008, U+000C–U+001F) i znaki z obszaru prywatnego użytku w podstawowej wielojęzycznej płaszczyźnie Unicode (U+E000–U+F8FF) zostaną usunięte z wstawionego tekstu.

Pole zbiorczeinsertion_location. Miejsce, w którym zostanie wstawiony tekst. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia tekst w określonym indeksie w dokumencie.

Tekst musi być wstawiony w obrębie istniejącego elementu Paragraph. Na przykład nie można wstawić tekstu w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem). Tekst musi zostać wstawiony 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 liczony od początku segmentu określonego przez segmentId.

tabId

string

Karta, na której znajduje się lokalizacja. Jeśli ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żądanie będzie dotyczyć pierwszej karty w dokumencie.

EndOfSegmentLocation

Lokalizacja na końcu treści, nagłówka, stopki lub przypisu. Znajduje się on bezpośrednio przed ostatnim znakiem nowego wiersza 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 ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żądanie będzie dotyczyć pierwszej karty w dokumencie.

UpdateTextStyleRequest

Zaktualizuj 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, które mają zostać zastosowane do tekstu.

Jeśli wartość danego stylu jest zgodna z wartością stylu nadrzędnego, styl ten zostanie ustawiony jako dziedziczony.

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny textStyle jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

Pole zbiorczeinsertion_location. Typ zakresu, w którym zostanie zaktualizowany styl tekstu. insertion_location może mieć tylko jedną z tych wartości:
range

object (Range)

Zakres tekstu, do którego ma zostać zastosowany styl.

Zakres można rozszerzyć, aby uwzględnić sąsiednie znaki nowego wiersza.

Jeśli zakres w pełni zawiera akapit należący do listy, punktor akapitu jest również aktualizowany o pasujący styl tekstu.

Nie można wstawiać zakresów w względnym żądaniu UpdateTextStyleRequest.

CreateParagraphBulletsRequest

Tworzy punktor dla wszystkich akapitów, które pokrywają się z podanym zakresem.

Poziom zagnieżdżenia każdego akapitu zostanie określony przez zliczenie początkowych tabulatorów przed każdym akapitem. Aby uniknąć nadmiaru miejsca między punktem a odpowiednim akapitem, te karty wiodące są usuwane przez tę prośbę. Może to zmienić indeksy części tekstu.

Jeśli akapit bezpośrednio poprzedzający aktualizowane akapity znajduje się na liście z pasującymi gotowymi ustawieniami, aktualizowane akapity są dodawane do tej listy.

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

object (Range)

Zakres, do którego chcesz zastosować gotowe ustawienia punktorów.

bulletPreset

enum (BulletGlyphPreset)

Rodzaje symboli punktorów, które mają być używane.

BulletGlyphPreset

Gotowe wzory glifów punktora dla list.

W tych wzorach używane są te 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: pusty okrąg odpowiadający punktowi kodowemu Unicode U+25cb.
  • DIAMOND: pełny romb odpowiadający punktowi kodowemu Unicode U+25c6.
  • DIAMONDX : diament z literą „x” w środku, odpowiadający punktowi kodowemu Unicode U+2756
  • HOLLOWDIAMOND : pusty romb odpowiadający punktowi kodowemu Unicode U+25c7
  • DISC: pełne kółko 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: wielka litera, np. „A”, „B” lub „C”.
  • DECIMAL : liczba, np. „1”, „2” lub „3”.
  • ZERODECIMAL: liczba, w której jednocyfrowe liczby są poprzedzone zerem, np. „01”, „02” lub „03”. Liczby wielocyfrowe nie mają zera na początku.
  • ROMAN : mała cyfra rzymska, np. „i”, „ii” lub „iii”.
  • UPPERROMAN: wielka 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 ustawienia glifu punktorowego są nieokreślone.
BULLET_DISC_CIRCLE_SQUARE Lista punktowana z symbolami punktów DISC, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMONDX_ARROW3D_SQUARE Lista punktowana z symbolami punktów DIAMONDX, ARROW3D i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_CHECKBOX Lista punktowana z CHECKBOX glifami punktów dla wszystkich poziomów zagnieżdżenia listy.
BULLET_ARROW_DIAMOND_DISC Lista punktowana z symbolami punktów ARROW, DIAMOND i DISC dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_STAR_CIRCLE_SQUARE Lista punktowana z symbolami punktów STAR, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_ARROW3D_CIRCLE_SQUARE Lista punktowana z symbolami punktów ARROW3D, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Lista punktowana z symbolami punktów LEFTTRIANGLE, DIAMOND i DISC dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Lista punktowana z symbolami punktów DIAMONDX, HOLLOWDIAMOND i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMOND_CIRCLE_SQUARE Lista punktowana z symbolami punktów DIAMOND, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
NUMBERED_DECIMAL_ALPHA_ROMAN Lista numerowana z glifami numerycznymi DECIMAL, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS Lista numerowana z glifami numerycznymi DECIMAL, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują nawiasy.
NUMBERED_DECIMAL_NESTED Lista numerowana z DECIMAL glifami numerycznymi rozdzielonymi kropkami, w której 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 glifami numerycznymi UPPERALPHA, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL Lista numerowana z glifami numerycznymi UPPERROMAN, UPPERALPHA i DECIMAL dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN Lista numerowana z glifami numerycznymi ZERODECIMAL, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.

DeleteParagraphBulletsRequest

Usuwa punktor z wszystkich akapitów, które pokrywają się z podanym 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ąć punktor.

CreateNamedRangeRequest

Tworzy NamedRange odwołujący się do podanego zakresu.

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

string

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

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

range

object (Range)

Zakres, do którego ma być 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 używane do określania, na których kartach ma nastąpić usunięcie zakresu. Jeśli ten parametr zostanie pominięty, usunięcie zakresu zostanie zastosowane do wszystkich kart.

W dokumencie zawierającym jedną kartę:

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

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

W dokumencie zawierającym wiele kart:

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

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

Pole zbiorczenamed_range_reference. Wartość, która określa zakresy do usunięcia. Musi być ustawiona dokładnie jedna wartość. named_range_reference może mieć tylko jedną z tych wartości:
namedRangeId

string

Identyfikator zakresu nazwanego do usunięcia.

name

string

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

UpdateParagraphStyleRequest

Aktualizuje 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ą być zastosowane do akapitów.

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny paragraphStyle jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

Pole zbiorczeinsertion_location. Typ zakresu, w którym styl akapitu zostanie zaktualizowany. insertion_location może mieć tylko jedną z tych wartości:
range

object (Range)

Zakres nakładający się na akapity, które mają zostać sformatowane.

DeleteContentRangeRequest

Usuwa zawartość z dokumentu.

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

object (Range)

Zakres treści do usunięcia.

Usunięcie tekstu, który przekracza granicę akapitu, może spowodować zmiany w stylach akapitów, listach, obiektach umieszczonych i zakładkach, ponieważ 2 akapity zostaną połączone.

Próba usunięcia niektórych zakresów może spowodować nieprawidłową strukturę dokumentu, w takim przypadku zwracany jest błąd 400 (Nieprawidłowe żądanie).

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

InsertInlineImageRequest

Wstawia element InlineObject zawierający obraz w podanej 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 raz w momencie wstawienia, a jego kopia jest przechowywana do wyświetlania w dokumencie. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym z tych formatów: PNG, JPEG lub GIF.

Podany identyfikator URI musi być dostępny publicznie i mieć długość maksymalnie 2 KB. Identyfikator URI jest zapisywany razem z obrazem i udostępniany w polu ImageProperties.content_uri.

objectSize

object (Size)

Rozmiar, w jakim obraz powinien być wyświetlany w dokumencie. Ta właściwość jest opcjonalna, a ostateczny rozmiar obrazu w dokumencie jest określany na podstawie tych reguł: * Jeśli nie określono szerokości ani wysokości, domyślny rozmiar obrazu jest obliczany na podstawie jego rozdzielczości. * Jeśli podasz jeden wymiar, drugi zostanie obliczony tak, aby zachować współczynnik proporcji obrazu. * Jeśli podano zarówno szerokość, jak i wysokość, obraz jest skalowany tak, aby mieścił się w podanych wymiarach przy zachowaniu współczynnika proporcji.

Pole zbiorczeinsertion_location. Miejsce, w którym zostanie wstawiony obraz. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia obraz w określonym indeksie w dokumencie.

Obraz musi być wstawiony w granicach istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem).

Obrazów w tekście nie można wstawiać w przypisach ani równaniach.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Obrazów w tekście nie można wstawiać w przypisach.

InsertTableRequest

Wstawia tabelę w określonym miejscu.

Przed wstawioną tabelą 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 zbiorczeinsertion_location. Miejsce, w którym zostanie wstawiona tabela. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia tabelę w określonym indeksie modelu.

Przed wstawioną tabelą zostanie wstawiony znak nowego wiersza, więc indeks początku tabeli będzie równy indeksowi określonej lokalizacji + 1.

Tabela musi być wstawiona w granicach istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między istniejącą tabelą a poprzedzającym ją akapitem).

Tabel nie można wstawiać w przypisach ani równaniach.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Nie można wstawiać tabel w przypisach.

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 zostaną wstawione wiersze.

Nowy wiersz zostanie wstawiony powyżej (lub poniżej) wiersza, w którym znajduje się komórka odniesienia. Jeśli komórka odniesienia jest scaloną komórką, nowy wiersz zostanie wstawiony powyżej (lub poniżej) scalonej komórki.

insertBelow

boolean

Określa, czy nowy wiersz ma zostać wstawiony poniżej komórki odniesienia.

  • True : wstaw poniżej komórki.
  • False : wstawia powyżej komórki.

TableCellLocation

Lokalizacja pojedynczej komórki w tabeli.

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

object (Location)

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

rowIndex

integer

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

columnIndex

integer

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

InsertTableColumnRequest

Wstawia pustą kolumnę do tabeli.

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

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.

insertRight

boolean

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

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

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, w którym znajduje się ta komórka, zostanie usunięty. Jeśli jest to scalona komórka obejmująca kilka wierszy, zostaną usunięte wszystkie wiersze, które obejmuje ta komórka. Jeśli po usunięciu w tabeli nie pozostaną żadne wiersze, cała tabela zostanie usunięta.

DeleteTableColumnRequest

Usuwa kolumnę z tabeli.

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

object (TableCellLocation)

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

Kolumna, w której znajduje się ta komórka, zostanie usunięta. Jeśli jest to scalona komórka obejmująca kilka kolumn, zostaną usunięte wszystkie kolumny, które obejmuje komórka. Jeśli po usunięciu kolumn w tabeli nie pozostaną żadne kolumny, cała tabela zostanie usunięta.

InsertPageBreakRequest

Wstawia w określonym miejscu podział strony, a po nim znak nowego wiersza.

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 zbiorczeinsertion_location. Miejsce, w którym zostanie wstawiony podział strony. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

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

Podział strony musi być wstawiony w obrębie istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem).

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Wstawia podział strony na końcu treści dokumentu.

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

DeletePositionedObjectRequest

Usuwa z dokumentu element PositionedObject.

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

string

Identyfikator obiektu umieszczonego w określonym miejscu do usunięcia.

tabId

string

Karta, na której znajduje się obiekt, który chcesz usunąć. Jeśli ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żą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)

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

columnIndices[]

integer

Lista indeksów kolumn (liczonych od zera), których właściwość ma zostać zaktualizowana. Jeśli nie podasz żadnych indeksów, wszystkie kolumny zostaną zaktualizowane.

tableColumnProperties

object (TableColumnProperties)

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

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableColumnProperties jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować szerokość kolumny, ustaw wartość fields na "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 zostać zastosowany do komórek 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 również zostanie zaktualizowana. Scalone i niewidoczne obramowania nie są aktualizowane.

Aktualizowanie obramowania współdzielonego przez sąsiednie komórki w tym samym żądaniu może powodować sprzeczne aktualizacje obramowania, dlatego aktualizacje obramowania są stosowane w tej kolejności:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableCellStyle jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

Pole zbiorczecells. Komórki, które zostaną zaktualizowane. cells może mieć tylko jedną z tych wartości:
tableRange

object (TableRange)

Zakres tabeli reprezentujący podzbiór tabeli, do którego stosowane są aktualizacje.

tableStartLocation

object (Location)

Miejsce, w którym tabela zaczyna się w dokumencie. Jeśli zostanie określony, zmiany zostaną zastosowane do wszystkich komórek w tabeli.

TableRange

Zakres tabeli to odwołanie do podzbioru tabeli.

Pamiętaj, że komórki określone przez zakres tabeli nie muszą tworzyć prostokąta. Załóżmy na przykład, że mamy tabelę 3 x 3, w której wszystkie komórki ostatniego wiersza są połączone. Tabela wygląda tak: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Zakres tabeli z lokalizacją komórki tabeli = (tableStartLocation, wiersz = 0, kolumna = 0), rozpiętość wierszy = 3 i rozpiętość kolumn = 2 określa te 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

Zakres wierszy zakresu tabeli.

columnSpan

integer

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

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

rowIndices[]

integer

Lista indeksów wierszy (liczonych od zera), których styl ma zostać zaktualizowany. Jeśli nie podasz żadnych indeksów, wszystkie wiersze zostaną zaktualizowane.

tableRowStyle

object (TableRowStyle)

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableRowStyle jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

ReplaceImageRequest

Zastępuje istniejący obraz nowym.

Zastąpienie obrazu powoduje usunięcie niektórych elementówimage effectsz 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 raz w momencie wstawienia, a jego kopia jest przechowywana do 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 z obrazem i udostępniany w polu ImageProperties.source_uri.

imageReplaceMethod

enum (ImageReplaceMethod)

Metoda zastępowania.

tabId

string

Karta, na której znajduje się obraz do zastąpienia. Jeśli ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żą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. Nie można użyć tej wartości.
CENTER_CROP Skaluje i wyśrodkowuje obraz, aby wypełnić granice oryginalnego obrazu. Obraz może zostać przycięty, aby wypełnić granice oryginalnego obrazu. Wyrenderowany rozmiar obrazu będzie taki sam jak rozmiar oryginalnego obrazu.

UpdateDocumentStyleRequest

Aktualizuje DocumentStyle.

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

object (DocumentStyle)

Style, które mają zostać zastosowane w dokumencie.

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny documentStyle jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

tabId

string

Karta zawierająca styl, który chcesz zaktualizować. Jeśli ten parametr zostanie pominięty, żądanie będzie dotyczyć pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli nie zostanie podana, żądanie dotyczy pierwszej karty w dokumencie.

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.

Wszystkie teksty w scalanych komórkach zostaną połączone i zapisane w komórce „głównej” zakresu. Jest to lewa górna komórka zakresu, gdy kierunek treści jest od lewej do prawej, a w przeciwnym razie jest to prawa górna komórka zakresu.

Jeśli zakres nie jest prostokątny (co może się zdarzyć w niektórych przypadkach, gdy zakres obejmuje komórki, które są już scalone, lub gdy tabela nie jest prostokątna), zwracany jest błąd 400.

UnmergeTableCellsRequest

Rozdziela 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ć rozdzielone.

Wszystkie scalone komórki w tym zakresie zostaną rozdzielone, a komórki, które są już rozdzielone, pozostaną bez zmian. Jeśli zakres nie zawiera scalonych komórek, żądanie nie zostanie zrealizowane.

Jeśli w którejkolwiek ze scalonych komórek znajduje się tekst, pozostanie on w komórce „głównej” wynikowego bloku niescalonych komórek. Komórka „nagłówka” to lewa górna komórka, gdy kierunek treści jest od lewej do prawej, a w przeciwnym razie prawa górna.

CreateHeaderRequest

Tworzy Header. Nowy nagłówek jest stosowany do elementu SectionStyle w miejscu elementu SectionBreak, jeśli jest on określony. W przeciwnym razie jest stosowany do elementu DocumentStyle.

Jeśli nagłówek określonego typu już istnieje, zwracany jest błąd 400 (nieprawidłowe żądanie).

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

enum (HeaderFooterType)

Typ nagłówka do utworzenia.

sectionBreakLocation

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

HeaderFooterType

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

Wartości w polu enum
DEFAULT domyślny nagłówek lub stopka;

CreateFooterRequest

Tworzy Footer. Nowa stopka jest stosowana do elementu SectionStyle w lokalizacji elementu SectionBreak, jeśli jest on określony. W przeciwnym razie jest stosowana do elementu DocumentStyle.

Jeśli stopka określonego typu już istnieje, zwracany jest błąd 400 (nieprawidłowe żądanie).

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

enum (HeaderFooterType)

Typ stopki, którą chcesz utworzyć.

sectionBreakLocation

object (Location)

Lokalizacja elementu SectionBreak bezpośrednio poprzedzającego sekcję, do której ma należeć ten stopka.SectionStyle Jeśli to pole nie jest ustawione lub odnosi się do pierwszego podziału sekcji w dokumencie, stopka jest stosowana do stylu dokumentu.

CreateFootnoteRequest

Tworzy segment i wstawia do niego nowy element w podanej lokalizacji.FootnoteFootnoteReference

Nowy segment Footnote będzie zawierać spację, a po niej 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 zbiorczefootnote_reference_location. Miejsce wstawienia odwołania do przypisu. footnote_reference_location może mieć tylko jedną z tych wartości:
location

object (Location)

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

Odwołanie do przypisu musi zostać wstawione w obrębie istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem).

Odwołań do przypisów nie można wstawiać w równaniach, nagłówkach, stopkach ani przypisach. Ponieważ odwołania do przypisów można wstawiać tylko w treści, pole segment ID 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. Ponieważ odwołania do przypisów można wstawiać tylko w treści, pole segment ID musi być puste.

ReplaceNamedRangeContentRequest

Zastępuje zawartość określonego elementu NamedRange lub NamedRanges podaną treścią zastępczą.

Pamiętaj, że pojedynczy NamedRange może składać się z wielu nieciągłych ranges. W tym przypadku zastąpiona zostanie tylko treść w pierwszym zakresie. Pozostałe zakresy i ich zawartość zostaną usunięte.

Jeśli zastąpienie lub usunięcie zakresów spowoduje nieprawidłową strukturę dokumentu, zwracany jest błąd 400 (Nieprawidłowe żądanie).

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 używane do określania, na których kartach ma nastąpić zastąpienie. Jeśli ten parametr zostanie pominięty, zamiana zostanie zastosowana do wszystkich kart.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument zostanie pominięty, zastąpienie zostanie zastosowane do pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, zamiana dotyczy określonych kart.

  • Jeśli ten parametr zostanie pominięty, zamiana zostanie zastosowana do wszystkich kart.

Pole zbiorczereplacement_content. Treść, którą chcesz zastąpić istniejącą treść w nazwanym zakresie. replacement_content może mieć tylko jedną z tych wartości:
text

string

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

Pole zbiorczenamed_range_reference. Odwołanie do nazwanych zakresów, których zawartość zostanie zastąpiona. named_range_reference może mieć tylko jedną z tych wartości:
namedRangeId

string

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

Jeśli nie ma nazwanego zakresu o podanym identyfikatorze, zwracany jest błąd 400 (nieprawidłowe żądanie).

namedRangeName

string

Nazwa NamedRanges , której zawartość zostanie zastąpiona.

Jeśli istnieje kilka plikównamed rangeso podanej nazwie, zawartość każdego z nich zostanie zastąpiona. Jeśli nie ma nazwanych zakresów o podanej nazwie, żądanie nie zostanie zrealizowane.

UpdateSectionStyleRequest

Aktualizuje SectionStyle.

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

object (Range)

Zakres nakładający się na sekcje do ostylowania.

Podziały sekcji można wstawiać tylko w treści, więc pole segment ID musi być puste.

sectionStyle

object (SectionStyle)

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

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

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Element główny sectionStyle jest domyślny i nie trzeba go podawać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

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

InsertSectionBreakRequest

Wstawia podział sekcji w danym miejscu.

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 zbiorczeinsertion_location. Miejsce, w którym zostanie wstawiona przerwa. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia znak nowego wiersza i podział sekcji w określonym indeksie w dokumencie.

Podział sekcji musi zostać wstawiony w obrębie istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem).

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Wstawia znak nowego wiersza 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 w treści, więc pole segment ID musi być puste.

DeleteHeaderRequest

Usuwa z dokumentu element Header.

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

string

Identyfikator nagłówka do usunięcia. Jeśli ten nagłówek jest zdefiniowany w DocumentStyle, odwołanie do niego zostanie usunięte, co spowoduje, że w pierwszej sekcji dokumentu nie będzie nagłówka tego typu. Jeśli ten nagłówek jest zdefiniowany w SectionStyle, odwołanie do niego 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 ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żądanie będzie dotyczyć pierwszej karty w dokumencie.

DeleteFooterRequest

Usuwa z dokumentu element Footer.

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

string

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

tabId

string

Karta zawierająca stopkę do usunięcia. Jeśli ten parametr zostanie pominięty, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

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

  • Jeśli ten argument nie zostanie podany, żądanie będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, żądanie dotyczy określonej karty.

  • Jeśli ten parametr zostanie pominięty, żądanie będzie dotyczyć pierwszej karty w dokumencie.

PinTableHeaderRowsRequest

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

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

object (Location)

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

pinnedHeaderRowsCount

integer

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

AddDocumentTabRequest

Dodaje kartę dokumentu. Gdy karta zostanie dodana w danym indeksie, indeksy wszystkich kolejnych kart zostaną zwiększone.

Zapis JSON 
{
  "tabProperties": {
    object (TabProperties)
  }
}
Pola
tabProperties

object (TabProperties)

Właściwości karty do dodania. Wszystkie właściwości są opcjonalne.

DeleteTabRequest

Usuwa kartę. Jeśli karta ma karty podrzędne, one również zostaną usunięte.

Zapis JSON 
{
  "tabId": string
}
Pola
tabId

string

Identyfikator karty do usunięcia.

UpdateDocumentTabPropertiesRequest

Zaktualizuj właściwości karty dokumentu.

Zapis JSON 
{
  "tabProperties": {
    object (TabProperties)
  },
  "fields": string
}
Pola
tabProperties

object (TabProperties)

Właściwości karty do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tabProperties jest domyślny i nie trzeba go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

InsertPersonRequest

Wstawia wzmiankę o osobie.

Zapis JSON 
{
  "personProperties": {
    object (PersonProperties)
  },

  // 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
personProperties

object (PersonProperties)

Właściwości wzmianki o osobie do wstawienia.

Pole zbiorczeinsertion_location. Lokalizacja, w której zostanie wstawiona wzmianka o osobie. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia wzmiankę o osobie w określonym indeksie w dokumencie.

Wzmianka o osobie musi być umieszczona w obrębie istniejącego elementu Paragraph. Nie można go na przykład wstawić w indeksie początkowym tabeli (czyli między tabelą a poprzedzającym ją akapitem).

Wzmianek o osobach nie można wstawiać w równaniach.

endOfSegmentLocation

object (EndOfSegmentLocation)

Wstawia wzmiankę o osobie na końcu nagłówka, stopki, przypisu lub treści dokumentu.