Requests

Żądanie

Pojedyncza aktualizacja do zastosowania w dokumencie.

Zapis JSON 
{

  "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)
  },
  "updateNamedStyle": {
    object (UpdateNamedStyleRequest)
  },
  "insertRichLink": {
    object (InsertRichLinkRequest)
  },
  "insertDate": {
    object (InsertDateRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  },
  "acceptSuggestion": {
    object (AcceptSuggestionRequest)
  },
  "rejectSuggestion": {
    object (RejectSuggestionRequest)
  },
  "deleteSuggestion": {
    object (DeleteSuggestionRequest)
  }
}
Pola
Pole zbiorczerequest. Konkretne żądanie do zastosowania. 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 treść 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.

updateNamedStyle

object (UpdateNamedStyleRequest)

Aktualizuje styl nazwany.

insertDate

object (InsertDateRequest)

Wstawia datę.

insertComment

object (InsertCommentRequest)

Wstawia do dokumentu znak CommentThread.

addCommentReply

object (AddCommentReplyRequest)

Dodaje odpowiedź do elementu CommentThread lub SuggestionThread.

updateCommentPost

object (UpdateCommentPostRequest)

Aktualizuje istniejącego posta (posta głównego lub odpowiedź) w CommentThread lub SuggestionThread.

deleteComment

object (DeleteCommentRequest)

Usuwa CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Usuwa odpowiedź Post z CommentThread lub SuggestionThread.

acceptSuggestion

object (AcceptSuggestionRequest)

Akceptuje sugestię.

rejectSuggestion

object (RejectSuggestionRequest)

Odrzuca sugestię.

deleteSuggestion

object (DeleteSuggestionRequest)

Usuwa sugestię.

ReplaceAllTextRequest

Zastępuje wszystkie wystąpienia tekstu spełniającego kryteria znakiem replace text.

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
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ć zamiana.

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: w wyszukiwaniu nie jest rozróżniana wielkość 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,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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 wypunktowania.

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 sterujące (U+0000–U+0008, U+000C–U+001F) i znaki z obszaru prywatnego użytku w Unicode Basic Multilingual Plane (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 zostanie zastosowane do 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 zostanie zastosowane do pierwszej karty w dokumencie.

UpdateTextStyleRequest

Zaktualizuj styl tekstu.

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

  "range": {
    object (Range)
  }
}
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. Element główny textStyle jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Jeśli na przykład chcesz 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ąć nadmiernego odstępu 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 glifów 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 symbolami punktów na wszystkich poziomach zagnieżdżenia.
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)
  },

  "namedRangeId": string,
  "name": string
}
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ść określająca 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

Zaktualizuj styl wszystkich akapitów, które pokrywają się z podanym zakresem.

Zapis JSON 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  "range": {
    object (Range)
  }
}
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. Element główny paragraphStyle jest domyślny i nie należy 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 zostanie zaktualizowany styl akapitu. 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 treść 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)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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ą mieć więcej niż 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. Sam identyfikator URI jest zapisywany 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. Lokalizacja, w której 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,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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: wstawia wiersz 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 kolumny 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 scaloną komórką, nowa kolumna zostanie wstawiona po lewej (lub prawej) stronie scalonej komórki.

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 referencyjnej, 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 referencyjnej, 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 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Pola
Pole zbiorczeinsertion_location. Lokalizacja, w której 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, 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 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 zostanie zastosowane do 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ści mają zostać zaktualizowane. 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. Element główny tableColumnProperties jest domyślny i nie należy 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,

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
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ólnego dla sąsiednich komórek 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. Element główny tableCellStyle jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Na przykład aby 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ą scalone. 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 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. Element główny tableRowStyle jest domyślny i nie należy 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ą mieć więcej niż 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 zostanie zastosowane do 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. Renderowany 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. Element główny documentStyle jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Na przykład aby 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 będzie dotyczyć pierwszej karty w dokumencie.

MergeTableCellsRequest

Scala komórki w zakresie Table.

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

object (TableRange)

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

Tekst w scalanych komórkach zostanie połączony i zapisany 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 prawa górna komórka zakresu.

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

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 spowoduje żadnych zmian.

Jeśli w którejkolwiek ze scalonych komórek znajduje się tekst, pozostanie on w komórce „głównej” w powstałym 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 lokalizacji elementu SectionBreak, jeśli jest 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 elementu SectionBreak , który 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 stopkę;

CreateFooterRequest

Tworzy Footer. Nowy stopka jest stosowana do elementu SectionStyle w miejscu 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 do utworzenia.

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 segmentFootnoteFootnoteReferencei wstawia do niego nowyFootnoteFootnoteReferencew podanej lokalizacji.

Nowy segment Footnote będzie zawierać spację, a po niej znak nowego wiersza.

Zapis JSON 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Pola
Pole zbiorczefootnote_reference_location. Miejsce, w którym ma zostać wstawione odwołanie 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 być 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 jakichkolwiek zakresów spowoduje nieprawidłową strukturę dokumentu, zwracany jest błąd 400 (Nieprawidłowe żądanie).

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

  "text": string

  "namedRangeId": string,
  "namedRangeName": string
}
Pola
tabsCriteria

object (TabsCriteria)

Opcjonalnie. Kryteria używane do określania, na których kartach ma nastąpić zamiana. 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 treść zostanie zastąpiona.

Jeśli istnieje wiele 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, które mają zostać ostylowane.

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ą zostać zastosowane 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),

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Pola
sectionType

enum (SectionType)

Typ sekcji do wstawienia.

Pole zbiorczeinsertion_location. Lokalizacja, w której 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 dolnym, 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 zostanie zastosowane do 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 zostanie zastosowane do pierwszej karty w dokumencie.

PinTableHeaderRowsRequest

Aktualizuje liczbę przypiętych wierszy nagłówka tabeli w 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 (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. Element główny tabProperties jest domyślny i nie należy 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)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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.

UpdateNamedStyleRequest

Aktualizuje styl nazwany.

Zapis JSON 
{
  "namedStyle": {
    object (NamedStyle)
  },
  "fields": string,
  "tabId": string
}
Pola
namedStyle

object (NamedStyle)

Styl dokumentu do zaktualizowania.

fields

string (FieldMask format)

Pola NamedStyle, które mają zostać zaktualizowane.

Musisz określić co najmniej namedStyleType. Element główny namedStyle jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Jeśli na przykład chcesz zmienić styl tekstu na pogrubiony, ustaw fields tak, aby zawierał "textStyle" i "textStyle.bold". Aby zaktualizować właściwość wyrównania stylu akapitu, ustaw fields tak, aby zawierała "paragraphStyle" i "paragraphStyle.alignment".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione. Określenie "textStyle" lub "paragraphStyle" z pustym stylem tekstu lub stylem akapitu spowoduje zresetowanie wszystkich zagnieżdżonych pól.

tabId

string

Karta dokumentu do zaktualizowania. Domyślnie aktualizacja jest stosowana do pierwszej karty.

InsertRichLinkRequest

Wstawia znak RichLink w określonym miejscu.

Zapis JSON 
{
  "richLinkProperties": {
    object (RichLinkProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Pola
Pole zbiorczeinsertion_location. Lokalizacja, w której zostanie wstawiony link z elementami multimedialnymi. insertion_location może mieć tylko jedną z tych wartości:
location

object (Location)

Wstawia link z elementami rozszerzonymi w określonym indeksie w dokumencie.

Link z elementami rozszerzonymi 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).

Multimedialnego linku nie można wstawić w równaniu.

endOfSegmentLocation

object (EndOfSegmentLocation)

Wstawia link z elementami multimedialnymi na końcu nagłówka, stopki, przypisu lub treści dokumentu.

InsertDateRequest

Wstawia datę w określonym miejscu.

Zapis JSON 
{
  "dateElementProperties": {
    object (DateElementProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Pola
dateElementProperties

object (DateElementProperties)

Właściwości daty do wstawienia.

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

object (Location)

Wstawia datę w określonym indeksie w dokumencie.

Datę należy wstawić w obrębie 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).

endOfSegmentLocation

object (EndOfSegmentLocation)

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

InsertCommentRequest

Wstawia do dokumentu znak CommentThread.

Zapis JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

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

string

Tekst komentarza w formie zwykłego tekstu.

Ten tekst będzie traktowany podobnie jak komentarze utworzone w edytorze Dokumentów. Będzie działać podobnie w przypadku formatowania, powiadomień itp.

To pole nie może być puste i nie może przekraczać 2048 jednostek kodu UTF-8.

assigneeEmailAddress

string

Opcjonalnie. Adres e-mail osoby przypisanej do komentarza.

Aby dodać nieprzypisany komentarz, zostaw to pole puste.

Nie może przekraczać 2048 jednostek kodu UTF-8.

Pole zbiorczeanchor. Miejsce w dokumencie powiązane z tym komentarzem. anchor może mieć tylko jedną z tych wartości:
range

object (Range)

Range w dokumencie, która jest powiązana z tym komentarzem.

AddCommentReplyRequest

Wstawia odpowiedź Post do elementu CommentThread lub SuggestionThread.

Zapis JSON 
{
  "post": {
    object (Post)
  },

  "commentId": string,
  "suggestionId": string
}
Pola
post

object (Post)

Post reprezentujący odpowiedź.

Pole zbiorczethread_id. Identyfikator wątku, do którego chcesz dodać odpowiedź. thread_id może mieć tylko jedną z tych wartości:
commentId

string

Identyfikator CommentThread , do którego chcesz dodać odpowiedź.

suggestionId

string

Identyfikator SuggestionThread , do którego chcesz dodać odpowiedź.

UpdateCommentPostRequest

Aktualizuje element Post w obiekcie CommentThread lub SuggestionThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli:

  • Post jest headPost wątku SuggestionThread.

  • Użytkownik przesyłający prośbę nie jest autorem posta.

  • W tym samym BatchUpdateDocumentRequest znajduje się wiele elementów UpdateCommentPostRequest dotyczących tego samego postId.

Zapis JSON 
{
  "postId": string,
  "content": string,

  "commentId": string,
  "suggestionId": string
}
Pola
postId

string

Identyfikator aktualizowanego posta.

content

string

Nowy tekst komentarza w formie zwykłego tekstu.

Ten tekst będzie traktowany podobnie jak komentarze utworzone w edytorze Dokumentów. Będzie działać podobnie w przypadku formatowania, powiadomień itp.

To pole nie może być puste i nie może przekraczać 2048 jednostek kodu UTF-8.

Pole zbiorczethread_id. Identyfikator wątku, do którego należy post. thread_id może mieć tylko jedną z tych wartości:
commentId

string

Identyfikator CommentThread, do którego należy post.

suggestionId

string

Identyfikator SuggestionThread, do którego należy post.

DeleteCommentRequest

Usuwa CommentThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli użytkownik wysyłający żądanie nie jest autorem headPost.

Zapis JSON 
{
  "commentId": string
}
Pola
commentId

string

Identyfikator CommentThread, który jest usuwany.

DeleteCommentReplyRequest

Usuwa odpowiedź Post z CommentThread lub SuggestionThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli:

Zapis JSON 
{
  "postId": string,

  "commentId": string,
  "suggestionId": string
}
Pola
postId

string

Identyfikator odpowiedziPost, która ma zostać usunięta.

Pole zbiorczethread_id. Identyfikator wątku, do którego należy post. thread_id może mieć tylko jedną z tych wartości:
commentId

string

Identyfikator CommentThread, do którego należy post.

suggestionId

string

Identyfikator SuggestionThread, do którego należy post.

AcceptSuggestionRequest

Akceptuje sugestię.

Zwraca błąd 403 (zabroniony), jeśli użytkownik wysyłający żądanie nie ma uprawnień do edycji dokumentu.

Zapis JSON 
{
  "suggestionId": string
}
Pola
suggestionId

string

Identyfikator sugestii.

RejectSuggestionRequest

Odrzuca sugestię.

Zwraca błąd 403 Forbidden, jeśli użytkownik wysyłający żądanie nie ma dostępu do edycji dokumentu i nie jest autorem sugestii.

Zapis JSON 
{
  "suggestionId": string
}
Pola
suggestionId

string

Identyfikator sugestii.

DeleteSuggestionRequest

Usuwa sugestię.

Zwraca błąd 403 Forbidden, jeśli użytkownik wysyłający żądanie nie jest autorem sugestii.

Zapis JSON 
{
  "suggestionId": string
}
Pola
suggestionId

string

Identyfikator sugestii.