Żądanie
Pojedynczy rodzaj aktualizacji, którą można zastosować w arkuszu kalkulacyjnym.
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorczekind. Rodzaj aktualizacji. Wymagane jest dokładnie jedno pole.
kind
może mieć tylko jedną z tych wartości:
|
|
updateSpreadsheetProperties
|
Aktualizuje właściwości arkusza kalkulacyjnego. |
updateSheetProperties
|
Aktualizuje właściwości arkusza. |
updateDimensionProperties
|
Aktualizuje właściwości wymiarów. |
updateNamedRange
|
Aktualizuje zakres nazwany. |
repeatCell
|
Powtarza pojedynczą komórkę w zakresie. |
addNamedRange
|
Dodaje zakres nazwany. |
deleteNamedRange
|
Usuwa zakres nazwany. |
addSheet
|
Dodaje arkusz. |
deleteSheet
|
Usuwa arkusz. |
autoFill
|
Automatycznie wypełnia więcej danych na podstawie istniejących danych. |
cutPaste
|
Wycina dane z jednego obszaru i wkleja je w innym. |
copyPaste
|
Kopiuje dane z jednego obszaru i wkleja je w innym. |
mergeCells
|
Scala komórki. |
unmergeCells
|
Rozdziela scalone komórki. |
updateBorders
|
Aktualizuje obramowania w zakresie komórek. |
updateCells
|
Aktualizuje wiele komórek jednocześnie. |
addFilterView
|
Dodaje widok filtra. |
appendCells
|
Dołącza komórki po ostatnim wierszu z danymi w arkuszu. |
clearBasicFilter
|
Usuwa podstawowy filtr z arkusza. |
deleteDimension
|
Usuwa wiersze lub kolumny w arkuszu. |
deleteEmbeddedObject
|
Usuwa umieszczony obiekt (np.wykres lub obraz) w arkuszu. |
deleteFilterView
|
Usuwa widok filtra z arkusza. |
duplicateFilterView
|
Duplikuje widok filtra. |
duplicateSheet
|
Duplikuje arkusz. |
findReplace
|
Wyszukuje i zastępuje wystąpienia tekstu innym tekstem. |
insertDimension
|
Wstawia nowe wiersze lub kolumny w arkuszu. |
insertRange
|
Wstawia nowe komórki w arkuszu, przesuwając istniejące komórki. |
moveDimension
|
Przenosi wiersze lub kolumny w inne miejsce w arkuszu. |
updateEmbeddedObjectPosition
|
Aktualizuje pozycję obiektu osadzonego (np. wykresu lub obrazu). |
pasteData
|
Wkleja dane (HTML lub rozdzielone) do arkusza. |
textToColumns
|
Przekształca kolumnę tekstu w wiele kolumn tekstu. |
updateFilterView
|
Aktualizuje właściwości widoku filtra. |
deleteRange
|
Usuwa zakres komórek z arkusza, przesuwając pozostałe komórki. |
appendDimension
|
Dodaje wymiary na końcu arkusza. |
addConditionalFormatRule
|
Dodaje nową regułę formatowania warunkowego. |
updateConditionalFormatRule
|
Aktualizuje istniejącą regułę formatowania warunkowego. |
deleteConditionalFormatRule
|
Usuwa istniejącą regułę formatowania warunkowego. |
sortRange
|
Sortuje dane w zakresie. |
setDataValidation
|
Ustawia sprawdzanie poprawności danych w co najmniej 1 komórce. |
setBasicFilter
|
Ustawia podstawowy filtr w arkuszu. |
addProtectedRange
|
Dodaje zakres chroniony. |
updateProtectedRange
|
Aktualizuje zakres chroniony. |
deleteProtectedRange
|
Usuwa zakres chroniony. |
autoResizeDimensions
|
Automatycznie zmienia rozmiar co najmniej 1 wymiaru na podstawie zawartości komórek w tym wymiarze. |
addChart
|
Dodaje wykres. |
updateChartSpec
|
Aktualizuje specyfikacje wykresu. |
updateBanding
|
Aktualizowanie zakresu pasmowego |
addBanding
|
Dodaje nowy zakres pasmowy. |
deleteBanding
|
Usuwa zakres z pasmami |
createDeveloperMetadata
|
Tworzy nowe metadane dewelopera. |
updateDeveloperMetadata
|
Aktualizuje istniejący wpis metadanych dewelopera. |
deleteDeveloperMetadata
|
Usuwa metadane dewelopera. |
randomizeRange
|
Losuje kolejność wierszy w zakresie. |
addDimensionGroup
|
Tworzy grupę w określonym zakresie. |
deleteDimensionGroup
|
Usuwa grupę w określonym zakresie. |
updateDimensionGroup
|
Aktualizuje stan określonej grupy. |
trimWhitespace
|
Usuwa z komórek białe znaki (takie jak spacje, tabulatory lub znaki nowego wiersza). |
deleteDuplicates
|
Usuwa wiersze zawierające zduplikowane wartości w określonych kolumnach zakresu komórek. |
updateEmbeddedObjectBorder
|
Aktualizuje obramowanie obiektu osadzonego. |
addSlicer
|
Dodaje fragmentator. |
updateSlicerSpec
|
Aktualizuje specyfikacje fragmentatora. |
addDataSource
|
Dodaje źródło danych. |
updateDataSource
|
Aktualizuje źródło danych. |
deleteDataSource
|
Usuwa źródło danych. |
refreshDataSource
|
Odświeża co najmniej jedno źródło danych i powiązane z nim obiekty bazy danych. |
cancelDataSourceRefresh
|
Anuluje odświeżanie co najmniej 1 źródła danych i powiązanych obiektów bazy danych. |
addTable
|
Dodaje tabelę. |
updateTable
|
Aktualizuje tabelę. |
deleteTable
|
Żądanie usunięcia tabeli. |
UpdateSpreadsheetPropertiesRequest
Aktualizuje właściwości arkusza kalkulacyjnego.
| Zapis JSON |
|---|
{
"properties": {
object ( |
| Pola | |
|---|---|
properties
|
Właściwości do zaktualizowania. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Główny element „properties” jest domyślny i nie należy go określać. Pojedynczy znak |
UpdateSheetPropertiesRequest
Aktualizuje właściwości arkusza o podanym identyfikatorze sheetId.
| Zapis JSON |
|---|
{
"properties": {
object ( |
| Pola | |
|---|---|
properties
|
Właściwości do zaktualizowania. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
UpdateDimensionPropertiesRequest
Aktualizuje właściwości wymiarów w określonym zakresie.
| Zapis JSON |
|---|
{ "properties": { object ( |
| Pola | |
|---|---|
properties
|
Właściwości do zaktualizowania. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
Pole zbiorczedimension_range. Zakres wymiarów.
dimension_range
może mieć tylko jedną z tych wartości:
|
|
range
|
Wiersze lub kolumny do zaktualizowania. |
dataSourceSheetRange
|
Kolumny w arkuszu źródła danych, które mają zostać zaktualizowane. |
DataSourceSheetDimensionRange
Zakres wzdłuż jednego wymiaru w arkuszu DATA_SOURCE.
| Zapis JSON |
|---|
{
"sheetId": integer,
"columnReferences": [
{
object ( |
| Pola | |
|---|---|
sheetId
|
Identyfikator arkusza źródła danych, w którym znajduje się zakres. |
columnReferences[]
|
Kolumny w arkuszu źródła danych. |
UpdateNamedRangeRequest
Aktualizuje właściwości zakresu nazwanego za pomocą określonego namedRangeId.
| Zapis JSON |
|---|
{
"namedRange": {
object ( |
| Pola | |
|---|---|
namedRange
|
Nazwany zakres, który ma zostać zaktualizowany o nowe właściwości. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
RepeatCellRequest
Aktualizuje wszystkie komórki w zakresie do wartości w podanym obiekcie Cell. Zaktualizowane zostaną tylko pola wymienione w polu fields. Pozostałe pola pozostaną bez zmian.
Jeśli zapisujesz komórkę z formułą, zakresy formuły będą automatycznie zwiększane dla każdego pola w zakresie. Jeśli na przykład zapisujesz komórkę z formułą=A1
=A1
w zakresie B2:C4, komórka B2 będzie mieć wartość=A1, komórka B3 –=A2, komórka B4 –=A3, komórka C2 –=B1, komórka C3 –=B2, a komórka C4 –=B3.
Aby zakresy formuły były statyczne, użyj wskaźnika $. Aby zapobiec zwiększaniu wartości wiersza i kolumny, użyj na przykład formuły:=$A$1
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres, w którym ma być powtarzana komórka. |
cell
|
Dane do zapisania. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
AddNamedRangeRequest
Dodaje do arkusza kalkulacyjnego nazwany zakres.
| Zapis JSON |
|---|
{
"namedRange": {
object ( |
| Pola | |
|---|---|
namedRange
|
Nazwany zakres do dodania. Pole |
DeleteNamedRangeRequest
Usuwa z arkusza kalkulacyjnego nazwany zakres o podanym identyfikatorze.
| Zapis JSON |
|---|
{ "namedRangeId": string } |
| Pola | |
|---|---|
namedRangeId
|
Identyfikator zakresu nazwanego do usunięcia. |
AddSheetRequest
Dodaje nowy arkusz. Gdy arkusz zostanie dodany w danym indeksie, indeksy wszystkich kolejnych arkuszy zostaną zwiększone. Aby dodać arkusz obiektu, użyj
AddChartRequest
i określ
EmbeddedObjectPosition.sheetId
lub
EmbeddedObjectPosition.newSheet.
| Zapis JSON |
|---|
{
"properties": {
object ( |
| Pola | |
|---|---|
properties
|
Właściwości, które powinien mieć nowy arkusz. Wszystkie właściwości są opcjonalne. Pole |
DeleteSheetRequest
Usuwa żądany arkusz.
| Zapis JSON |
|---|
{ "sheetId": integer } |
| Pola | |
|---|---|
sheetId
|
Identyfikator arkusza do usunięcia.
Jeśli arkusz jest typu |
AutoFillRequest
uzupełnia więcej danych na podstawie danych już istniejących,
| Zapis JSON |
|---|
{ "useAlternateSeries": boolean, // Union field |
| Pola | |
|---|---|
useAlternateSeries
|
Wartość „true”, jeśli mamy generować dane z serii „alternate”. Zależy to od rodzaju i ilości danych źródłowych. |
Pole zbiorczearea. Obszar do automatycznego uzupełnienia.
area
może mieć tylko jedną z tych wartości:
|
|
range
|
Zakres do automatycznego uzupełniania. Sprawdzi zakres, wykryje lokalizację, która zawiera dane, i automatycznie wypełni nimi pozostałą część zakresu. |
sourceAndDestination
|
obszary źródłowe i docelowe do autouzupełniania; Wyraźnie wskazuje źródło autouzupełniania i miejsce, w którym można rozszerzyć te dane. |
SourceAndDestination
Kombinacja zakresu źródłowego i sposobu jego rozszerzenia.
| Zapis JSON |
|---|
{ "source": { object ( |
| Pola | |
|---|---|
source
|
Lokalizacja danych, które mają być używane jako źródło autouzupełniania. |
dimension
|
Wymiar, do którego mają zostać wypełnione dane. |
fillLength
|
Liczba wierszy lub kolumn, w których mają zostać wypełnione dane. Liczby dodatnie rozszerzają się poza ostatni wiersz lub ostatnią kolumnę źródła. Liczby ujemne rozszerzają się przed pierwszym wierszem lub pierwszą kolumną źródła. |
CutPasteRequest
Przenosi dane ze źródła do miejsca docelowego.
| Zapis JSON |
|---|
{ "source": { object ( |
| Pola | |
|---|---|
source
|
Dane źródłowe do wycięcia. |
destination
|
Współrzędne lewego górnego rogu, w którym mają zostać wklejone dane. |
pasteType
|
Rodzaj danych do wklejenia. Wszystkie dane źródłowe zostaną wycięte, niezależnie od tego, co zostanie wklejone. |
PasteType
Rodzaj danych, które mają zostać wklejone.
| Wartości w polu enum | |
|---|---|
PASTE_NORMAL
|
Wklejanie wartości, formuł, formatów i scalonych komórek. |
PASTE_VALUES
|
Wklej TYLKO wartości bez formatów, formuł i scalania. |
PASTE_FORMAT
|
Wklej tylko format i reguły sprawdzania poprawności danych. |
PASTE_NO_BORDERS
|
Podobnie jak
PASTE_NORMAL
ale bez obramowań.
|
PASTE_FORMULA
|
Wklej tylko formuły. |
PASTE_DATA_VALIDATION
|
Wklej tylko reguły sprawdzania poprawności danych. |
PASTE_CONDITIONAL_FORMATTING
|
Wklej tylko reguły formatowania warunkowego. |
CopyPasteRequest
Kopiuje dane ze źródła do miejsca docelowego.
| Zapis JSON |
|---|
{ "source": { object ( |
| Pola | |
|---|---|
source
|
Zakres źródłowy do skopiowania. |
destination
|
Miejsce, w którym chcesz wkleić treść. Jeśli zakres obejmuje obszar, którego wysokość lub szerokość jest wielokrotnością wysokości lub szerokości źródła, dane zostaną powtórzone, aby wypełnić zakres docelowy. Jeśli zakres jest mniejszy niż zakres źródłowy, całe źródło danych zostanie skopiowane (poza koniec zakresu docelowego). |
pasteType
|
Rodzaj danych do wklejenia. |
pasteOrientation
|
Jak dane powinny być zorientowane podczas wklejania. |
PasteOrientation
Określa sposób wklejania.
| Wartości w polu enum | |
|---|---|
NORMAL
|
Wklej w normalny sposób. |
TRANSPOSE
|
Wklej transponowane, gdzie wszystkie wiersze stają się kolumnami i odwrotnie. |
MergeCellsRequest
Łączy wszystkie komórki w zakresie.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres komórek do scalenia. |
mergeType
|
Sposób scalania komórek. |
MergeType
Typ scalania do utworzenia.
| Wartości w polu enum | |
|---|---|
MERGE_ALL
|
Utwórz pojedyncze scalanie z zakresu |
MERGE_COLUMNS
|
Utwórz scalenie dla każdej kolumny w zakresie. |
MERGE_ROWS
|
Utwórz scalanie dla każdego wiersza w zakresie |
UnmergeCellsRequest
Rozdziela komórki w danym zakresie.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Zakres, w którym wszystkie komórki powinny zostać rozdzielone. Jeśli zakres obejmuje kilka scalonych komórek, wszystkie zostaną rozdzielone. Zakres nie może częściowo obejmować żadnego scalenia. |
UpdateBordersRequest
Aktualizuje obramowanie zakresu. Jeśli pole nie jest ustawione w żądaniu, oznacza to, że obramowanie pozostaje bez zmian. Na przykład w przypadku 2 kolejnych żądań UpdateBordersRequest:
-
zakres: A1:A5
{ top: RED, bottom: WHITE } -
zakres: A1:A5
{ left: BLUE }
W rezultacie komórki A1:A5 będą miały obramowanie { top: RED, bottom: WHITE, left: BLUE }. Jeśli chcesz usunąć obramowanie, ustaw styl na NONE.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres, którego obramowanie ma zostać zaktualizowane. |
top
|
Granica, która ma się znajdować na górze zakresu. |
bottom
|
Obramowanie, które ma się znajdować u dołu zakresu. |
left
|
Obramowanie, które ma się znajdować po lewej stronie zakresu. |
right
|
Obramowanie, które ma się znajdować po prawej stronie zakresu. |
innerHorizontal
|
Obramowanie poziome, które ma się znaleźć w zakresie. |
innerVertical
|
Obramowanie pionowe, które ma się znajdować w zakresie. |
UpdateCellsRequest
Aktualizuje wszystkie komórki w zakresie nowymi danymi.
| Zapis JSON |
|---|
{ "rows": [ { object ( |
| Pola | |
|---|---|
rows[]
|
Dane do zapisania. |
fields
|
Pola CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej 1 pole. Elementem głównym jest CellData. Nie należy określać „row.values.”. Pojedynczy znak |
Pole zbiorczearea. Dane o lokalizacji powinny być zapisane. Musisz ustawić dokładnie jedną wartość.
area
może mieć tylko jedną z tych wartości:
|
|
start
|
Współrzędna, od której ma się rozpocząć zapisywanie danych. Możesz wpisać dowolną liczbę wierszy i kolumn (w tym różną liczbę kolumn w poszczególnych wierszach). |
range
|
Zakres, do którego chcesz zapisać dane.
Jeśli dane w wierszach nie obejmują całego zakresu, pola pasujące do tych ustawionych w |
AddFilterViewRequest
Dodaje widok filtra.
| Zapis JSON |
|---|
{
"filter": {
object ( |
| Pola | |
|---|---|
filter
|
Filtr do dodania. Pole |
AppendCellsRequest
Dodaje nowe komórki po ostatnim wierszu z danymi w arkuszu, wstawiając w razie potrzeby nowe wiersze.
| Zapis JSON |
|---|
{ "sheetId": integer, "rows": [ { object ( |
| Pola | |
|---|---|
sheetId
|
Identyfikator arkusza, do którego mają zostać dołączone dane. |
rows[]
|
Dane do dołączenia. |
fields
|
Pola CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej 1 pole. Elementem głównym jest CellData. Nie należy określać „row.values.”. Pojedynczy znak |
Pole zbiorczearea. Dane o lokalizacji powinny być zapisane.
area
może mieć tylko jedną z tych wartości:
|
|
tableId
|
Identyfikator tabeli, do której chcesz dodać dane. Dane zostaną tylko dołączone do treści tabeli.
To pole ma też pierwszeństwo przed polem |
ClearBasicFilterRequest
Usuwa filtr podstawowy, jeśli taki istnieje w arkuszu.
| Zapis JSON |
|---|
{ "sheetId": integer } |
| Pola | |
|---|---|
sheetId
|
Identyfikator arkusza, w którym należy wyczyścić filtr podstawowy. |
DeleteDimensionRequest
Usuwa wymiary z arkusza.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Wymiary do usunięcia z arkusza. |
DeleteEmbeddedObjectRequest
Usuwa obiekt osadzony o podanym identyfikatorze.
| Zapis JSON |
|---|
{ "objectId": integer } |
| Pola | |
|---|---|
objectId
|
Identyfikator obiektu osadzonego do usunięcia. |
DeleteFilterViewRequest
Usuwa określony widok filtra.
| Zapis JSON |
|---|
{ "filterId": integer } |
| Pola | |
|---|---|
filterId
|
Identyfikator filtra do usunięcia. |
DuplicateFilterViewRequest
Duplikuje określony widok filtra.
| Zapis JSON |
|---|
{ "filterId": integer } |
| Pola | |
|---|---|
filterId
|
Identyfikator filtra, który jest duplikowany. |
DuplicateSheetRequest
Duplikuje zawartość arkusza.
| Zapis JSON |
|---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
| Pola | |
|---|---|
sourceSheetId
|
Arkusza do zduplikowania.
Jeśli arkusz źródłowy jest typu |
insertSheetIndex
|
Indeks rozpoczynający się od 0, w którym ma zostać wstawiony nowy arkusz. Indeks wszystkich arkuszy po tym arkuszu zostanie zwiększony. |
newSheetId
|
Jeśli jest ustawiony, identyfikator nowego arkusza. Jeśli nie zostanie ustawiony, zostanie wybrany identyfikator. Jeśli jest ustawiony, identyfikator nie może być sprzeczny z żadnym istniejącym identyfikatorem arkusza. Jeśli jest ustawiona, nie może być ujemna. |
newSheetName
|
Nazwa nowego arkusza. Jeśli pole jest puste, wybierzemy nową nazwę. |
FindReplaceRequest
Wyszukuje i zastępuje dane w komórkach w zakresie, arkuszu lub wszystkich arkuszach.
| Zapis JSON |
|---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
| Pola | |
|---|---|
find
|
Wartość do wyszukania. |
replacement
|
Wartość, która ma zastąpić poprzednią. |
matchCase
|
Wartość true, jeśli w wyszukiwaniu jest rozróżniana wielkość liter. |
matchEntireCell
|
Wartość PRAWDA, jeśli szukana wartość ma być zgodna z całą komórką. |
searchByRegex
|
Wartość „prawda”, jeśli wartość do znalezienia jest wyrażeniem regularnym. Wyrażenie regularne i zamiana powinny być zgodne z zasadami wyrażeń regularnych w Javie, które znajdziesz na stronie https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. Ciąg zastępujący może odwoływać się do grup przechwytywania. Jeśli na przykład jedna komórka zawiera ciąg |
includeFormulas
|
Wartość PRAWDA, jeśli wyszukiwanie ma obejmować komórki z formułami. Fałsz, aby pominąć komórki z formułami. |
Pole zbiorczescope. Zakres, w którym ma nastąpić wyszukanie lub zamiana – musi być ustawiony tylko jeden z tych zakresów.
scope
może mieć tylko jedną z tych wartości:
|
|
range
|
Zakres, w którym ma nastąpić wyszukiwanie i zamiana. |
sheetId
|
Arkusz, w którym ma nastąpić wyszukiwanie i zamiana. |
allSheets
|
Wartość PRAWDA, jeśli chcesz wyszukać i zamienić tekst we wszystkich arkuszach. |
InsertDimensionRequest
Wstawia wiersze lub kolumny w arkuszu w określonym indeksie.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Wymiary do wstawienia. Indeksy początkowy i końcowy muszą być ograniczone. |
inheritFromBefore
|
Określa, czy właściwości wymiaru mają być rozszerzane z wymiarów przed nowo wstawionymi wymiarami czy po nich. Wartość „true” oznacza dziedziczenie z wymiarów poprzedzających (w takim przypadku indeks początkowy musi być większy od 0), a wartość „false” – dziedziczenie z wymiarów następujących.
Jeśli na przykład wiersz o indeksie 0 ma czerwone tło, a wiersz o indeksie 1 ma zielone tło, wstawienie 2 wierszy o indeksie 1 może spowodować odziedziczenie zielonego lub czerwonego tła. Jeśli
|
InsertRangeRequest
Wstawia komórki do zakresu, przesuwając istniejące komórki w prawo lub w dół.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres, w którym mają zostać wstawione nowe komórki. Zakres jest ograniczony do granic bieżącego arkusza. |
shiftDimension
|
Wymiar, który zostanie przesunięty podczas wstawiania komórek. Jeśli
|
MoveDimensionRequest
Przenosi co najmniej 1 wiersz lub kolumnę.
| Zapis JSON |
|---|
{
"source": {
object ( |
| Pola | |
|---|---|
source
|
Wymiary źródłowe do przeniesienia. |
destinationIndex
|
Indeks początkowy (od zera) miejsca, do którego mają zostać przeniesione dane źródłowe, na podstawie współrzędnych przed usunięciem danych źródłowych z siatki. Istniejące dane zostaną przesunięte w dół lub w prawo (w zależności od wymiaru), aby zrobić miejsce na przeniesione wymiary. Wymiary źródłowe zostaną usunięte z siatki, więc dane mogą się znaleźć w innym indeksie niż określony.
Na przykład, jeśli masz
|
UpdateEmbeddedObjectPositionRequest
zaktualizować położenie osadzonego obiektu (np. przesunąć lub zmienić rozmiar wykresu lub obrazu);
| Zapis JSON |
|---|
{
"objectId": integer,
"newPosition": {
object ( |
| Pola | |
|---|---|
objectId
|
Identyfikator obiektu do przeniesienia. |
newPosition
|
Jawna pozycja, do której ma zostać przeniesiony umieszczony obiekt. Jeśli ustawisz wartość |
fields
|
Pola
|
PasteDataRequest
Wstawia dane do arkusza kalkulacyjnego, zaczynając od określonych współrzędnych.
| Zapis JSON |
|---|
{ "coordinate": { object ( |
| Pola | |
|---|---|
coordinate
|
Współrzędna, od której należy rozpocząć wstawianie danych. |
data
|
Dane do wstawienia. |
type
|
Sposób wklejania danych. |
Pole zbiorczekind. Jak interpretować dane – musi być ustawiona dokładnie jedna wartość.
kind
może mieć tylko jedną z tych wartości:
|
|
delimiter
|
Separator w danych. |
html
|
Prawda, jeśli dane są w formacie HTML. |
TextToColumnsRequest
Dzieli kolumnę tekstu na kilka kolumn na podstawie separatora w każdej komórce.
| Zapis JSON |
|---|
{ "source": { object ( |
| Pola | |
|---|---|
source
|
Zakres danych źródłowych. Musi obejmować dokładnie 1 kolumnę. |
delimiter
|
Separator do użycia. Używane tylko wtedy, gdy delimiterType ma wartość |
delimiterType
|
Typ separatora, którego chcesz użyć. |
DelimiterType
Ogranicznik, według którego ma nastąpić podział.
| Wartości w polu enum | |
|---|---|
DELIMITER_TYPE_UNSPECIFIED
|
Wartość domyślna. Nie można użyć tej wartości. |
COMMA
|
„,” |
SEMICOLON
|
";" |
PERIOD
|
„.” |
SPACE
|
„ ” |
CUSTOM
|
Wartość niestandardowa zdefiniowana w separatorze. |
AUTODETECT
|
Automatycznie wykrywaj kolumny. |
UpdateFilterViewRequest
Aktualizuje właściwości widoku filtra.
| Zapis JSON |
|---|
{
"filter": {
object ( |
| Pola | |
|---|---|
filter
|
Nowe właściwości widoku filtra. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
DeleteRangeRequest
Usuwa zakres komórek, przesuwając inne komórki w usunięty obszar.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres komórek do usunięcia. |
shiftDimension
|
Wymiar, którym zostaną zastąpione usunięte komórki. Jeśli
|
AppendDimensionRequest
Dodaje wiersze lub kolumny na końcu arkusza.
| Zapis JSON |
|---|
{
"sheetId": integer,
"dimension": enum ( |
| Pola | |
|---|---|
sheetId
|
Arkusz, do którego chcesz dołączyć wiersze lub kolumny. |
dimension
|
Określa, czy mają być dołączane wiersze czy kolumny. |
length
|
Liczba wierszy lub kolumn do dołączenia. |
AddConditionalFormatRuleRequest
Dodaje nową regułę formatowania warunkowego w podanym indeksie. Indeksy wszystkich kolejnych reguł są zwiększane.
| Zapis JSON |
|---|
{
"rule": {
object ( |
| Pola | |
|---|---|
rule
|
Reguła do dodania. |
index
|
Indeks rozpoczynający się od 0, w którym ma zostać wstawiona reguła. |
UpdateConditionalFormatRuleRequest
Aktualizuje regułę formatowania warunkowego pod podanym indeksem lub przenosi ją na inny indeks.
| Zapis JSON |
|---|
{ "index": integer, "sheetId": integer, // Union field |
| Pola | |
|---|---|
index
|
Indeks reguły (liczony od zera), która ma zostać zastąpiona lub przeniesiona. |
sheetId
|
Arkusz reguły do przeniesienia. Wymagane, jeśli ustawiona jest wartość |
Pole zbiorczeinstruction. Rodzaj aktualizacji, która powinna nastąpić.
instruction
może mieć tylko jedną z tych wartości:
|
|
rule
|
Reguła, która ma zastąpić regułę na danym indeksie. |
newIndex
|
Nowy indeks (liczony od zera), w którym powinna się znaleźć reguła. |
DeleteConditionalFormatRuleRequest
Usuwa regułę formatowania warunkowego o podanym indeksie. Indeksy wszystkich kolejnych reguł są zmniejszane.
| Zapis JSON |
|---|
{ "index": integer, "sheetId": integer } |
| Pola | |
|---|---|
index
|
Indeks reguły do usunięcia rozpoczynający się od 0. |
sheetId
|
Arkusz, z którego usuwana jest reguła. |
SortRangeRequest
Sortuje dane w wierszach na podstawie kolejności sortowania w poszczególnych kolumnach.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres do posortowania. |
sortSpecs[]
|
Kolejność sortowania w poszczególnych kolumnach. Późniejsze specyfikacje są używane, gdy wartości w wcześniejszych specyfikacjach są równe. |
SetDataValidationRequest
Ustawia regułę sprawdzania poprawności danych w każdej komórce w zakresie. Aby usunąć weryfikację w zakresie, wywołaj tę funkcję bez podawania reguły.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres, do którego ma zastosowanie reguła sprawdzania poprawności danych. |
rule
|
Reguła sprawdzania poprawności danych, która ma być ustawiona w każdej komórce w zakresie, lub pusta, aby wyczyścić sprawdzanie poprawności danych w zakresie. |
filteredRowsIncluded
|
Opcjonalnie. Jeśli ma wartość „true”, reguła sprawdzania poprawności danych zostanie zastosowana również do odfiltrowanych wierszy. |
SetBasicFilterRequest
Ustawia podstawowy filtr powiązany z arkuszem.
| Zapis JSON |
|---|
{
"filter": {
object ( |
| Pola | |
|---|---|
filter
|
Filtr do ustawienia. |
AddProtectedRangeRequest
Dodaje nowy zakres chroniony.
| Zapis JSON |
|---|
{
"protectedRange": {
object ( |
| Pola | |
|---|---|
protectedRange
|
Zakres chroniony do dodania. Pole |
UpdateProtectedRangeRequest
Aktualizuje istniejący zakres chroniony za pomocą określonego protectedRangeId.
| Zapis JSON |
|---|
{
"protectedRange": {
object ( |
| Pola | |
|---|---|
protectedRange
|
Zakres chroniony, który ma zostać zaktualizowany o nowe właściwości. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
DeleteProtectedRangeRequest
Usuwa zakres chroniony o podanym identyfikatorze.
| Zapis JSON |
|---|
{ "protectedRangeId": integer } |
| Pola | |
|---|---|
protectedRangeId
|
Identyfikator zakresu chronionego do usunięcia. |
AutoResizeDimensionsRequest
Automatycznie zmienia rozmiar co najmniej 1 wymiaru na podstawie zawartości komórek w tym wymiarze.
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorczedimension_range. Zakres wymiarów.
dimension_range
może mieć tylko jedną z tych wartości:
|
|
dimensions
|
Wymiary, które mają być automatycznie zmieniane. |
dataSourceSheetDimensions
|
Wymiary w arkuszu źródła danych, które mają być automatycznie zmieniane. |
AddChartRequest
Dodaje wykres do arkusza w arkuszu kalkulacyjnym.
| Zapis JSON |
|---|
{
"chart": {
object ( |
| Pola | |
|---|---|
chart
|
Wykres, który ma zostać dodany do arkusza kalkulacyjnego, wraz z informacją o miejscu, w którym ma się on znajdować. Pole |
UpdateChartSpecRequest
Aktualizuje specyfikacje wykresu. (Nie spowoduje to przeniesienia ani zmiany rozmiaru wykresu. Aby przenieść wykres lub zmienić jego rozmiar, użyj UpdateEmbeddedObjectPositionRequest.
| Zapis JSON |
|---|
{
"chartId": integer,
"spec": {
object ( |
| Pola | |
|---|---|
chartId
|
Identyfikator wykresu do zaktualizowania. |
spec
|
Specyfikacja, która zostanie zastosowana do wykresu. |
UpdateBandingRequest
Aktualizuje właściwości podanego zakresu pasmowego.
| Zapis JSON |
|---|
{
"bandedRange": {
object ( |
| Pola | |
|---|---|
bandedRange
|
Zakres pasmowy, który ma zostać zaktualizowany o nowe właściwości. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
AddBandingRequest
Dodaje do arkusza nowy zakres z naprzemiennymi kolorami.
| Zapis JSON |
|---|
{
"bandedRange": {
object ( |
| Pola | |
|---|---|
bandedRange
|
Zakres z naprzemiennymi kolorami do dodania. Pole |
DeleteBandingRequest
Usuwa z arkusza kalkulacyjnego zakres z podziałem na pasma o podanym identyfikatorze.
| Zapis JSON |
|---|
{ "bandedRangeId": integer } |
| Pola | |
|---|---|
bandedRangeId
|
Identyfikator zakresu pasmowego do usunięcia. |
CreateDeveloperMetadataRequest
Żądanie utworzenia metadanych dewelopera.
| Zapis JSON |
|---|
{
"developerMetadata": {
object ( |
| Pola | |
|---|---|
developerMetadata
|
Metadane dewelopera do utworzenia. |
UpdateDeveloperMetadataRequest
Prośba o zaktualizowanie właściwości metadanych dewelopera. Aktualizuje właściwości metadanych dewelopera wybranych przez filtry do wartości podanych w zasobie DeveloperMetadata. Osoby dzwoniące muszą określić właściwości, które chcą zaktualizować, w parametrze fields, a także podać co najmniej 1 DataFilter, który pasuje do metadanych, które chcą zaktualizować.
| Zapis JSON |
|---|
{ "dataFilters": [ { object ( |
| Pola | |
|---|---|
dataFilters[]
|
Filtry dopasowujące wpisy metadanych dewelopera do zaktualizowania. |
developerMetadata
|
Wartość, do której zostaną zaktualizowane wszystkie metadane pasujące do filtrów danych. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
DeleteDeveloperMetadataRequest
Prośba o usunięcie metadanych dewelopera.
| Zapis JSON |
|---|
{
"dataFilter": {
object ( |
| Pola | |
|---|---|
dataFilter
|
Filtr danych opisujący kryteria użyte do wybrania wpisu metadanych dewelopera do usunięcia. |
RandomizeRangeRequest
Losuje kolejność wierszy w zakresie.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Zakres do losowania. |
AddDimensionGroupRequest
Tworzy grupę w określonym zakresie.
Jeśli żądany zakres jest nadzbiorem zakresu istniejącej grupy G, głębokość grupy G jest zwiększana, a nowa grupa G' ma głębokość tej grupy. Na przykład grupa [C:D, głębokość 1] + [B:E] daje grupy [B:E, głębokość 1] i [C:D, głębokość 2]. Jeśli żądany zakres jest podzbiorem zakresu istniejącej grupy G, głębokość nowej grupy G' zwiększa się o 1 w stosunku do głębokości grupy G. Na przykład grupa [B:E, głębokość 1] + [C:D] daje grupy [B:E, głębokość 1] i [C:D, głębokość 2]. Jeśli żądany zakres zaczyna się przed zakresem istniejącej grupy G i kończy w jego obrębie lub zaczyna się w obrębie zakresu istniejącej grupy G i kończy po jego zakończeniu, zakres istniejącej grupy G staje się sumą zakresów, a nowa grupa G' ma głębokość o 1 większą niż głębokość grupy G i zakres będący przecięciem zakresów. Na przykład połączenie grup [B:D, głębokość 1] + [C:E] daje grupy [B:E, głębokość 1] i [C:D, głębokość 2].
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Zakres, w którym ma zostać utworzona grupa. |
DeleteDimensionGroupRequest
Usuwa grupę w określonym zakresie, zmniejszając głębokość wymiarów w tym zakresie.
Załóżmy na przykład, że arkusz zawiera grupę poziomu 1 w zakresie B:E i grupę poziomu 2 w zakresie C:D. Usunięcie grupy obejmującej zakres D:E spowoduje, że arkusz będzie zawierać grupę poziomu 1 obejmującą zakres B:D i grupę poziomu 2 obejmującą zakres C:C.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Zakres grupy do usunięcia. |
UpdateDimensionGroupRequest
Aktualizuje stan określonej grupy.
| Zapis JSON |
|---|
{
"dimensionGroup": {
object ( |
| Pola | |
|---|---|
dimensionGroup
|
Grupa, której stan ma zostać zaktualizowany. Zakres i głębokość grupy powinny określać prawidłową grupę w arkuszu, a wszystkie inne pola powinny być zaktualizowane. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
TrimWhitespaceRequest
Usuwa białe znaki (np. spacje, tabulatory lub nowe wiersze) z każdej komórki w określonym zakresie. To żądanie usuwa wszystkie odstępy na początku i na końcu tekstu w każdej komórce oraz redukuje wszystkie kolejne znaki odstępu do pojedynczej spacji. Jeśli wynikowy przycięty tekst zaczyna się od znaku „+” lub „=”, pozostaje on wartością tekstową i nie jest interpretowany jako formuła.
| Zapis JSON |
|---|
{
"range": {
object ( |
| Pola | |
|---|---|
range
|
Zakres, z którego komórek chcesz usunąć spacje. |
DeleteDuplicatesRequest
Usuwa wiersze w tym zakresie, które zawierają w określonych kolumnach wartości będące duplikatami wartości z dowolnego poprzedniego wiersza. Wiersze z identycznymi wartościami, które różnią się wielkością liter, formatowaniem lub formułami, są uznawane za duplikaty.
Ta prośba usuwa też zduplikowane wiersze ukryte w widoku (np. z powodu filtra). Podczas usuwania duplikatów w zakresie wynikowym zachowywane jest pierwsze wystąpienie każdego zduplikowanego wiersza (skanowanie od góry do dołu). Treści spoza określonego zakresu nie zostaną usunięte, a wiersze uznane za duplikaty nie muszą sąsiadować ze sobą w zakresie.
| Zapis JSON |
|---|
{ "range": { object ( |
| Pola | |
|---|---|
range
|
Zakres, z którego chcesz usunąć zduplikowane wiersze. |
comparisonColumns[]
|
Kolumny w zakresie, w których chcesz przeanalizować zduplikowane wartości. Jeśli nie wybierzesz żadnych kolumn, wszystkie kolumny zostaną przeanalizowane pod kątem duplikatów. |
UpdateEmbeddedObjectBorderRequest
Aktualizuje właściwość obramowania obiektu osadzonego.
| Zapis JSON |
|---|
{
"objectId": integer,
"border": {
object ( |
| Pola | |
|---|---|
objectId
|
Identyfikator obiektu osadzonego do zaktualizowania. |
border
|
Obramowanie zastosowane do obiektu osadzonego. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
AddSlicerRequest
Dodaje do arkusza w arkuszu kalkulacyjnym selektor.
| Zapis JSON |
|---|
{
"slicer": {
object ( |
| Pola | |
|---|---|
slicer
|
Slicer, który ma zostać dodany do arkusza kalkulacyjnego, wraz z informacją o miejscu, w którym ma się znajdować. Pole |
UpdateSlicerSpecRequest
Aktualizuje specyfikacje fragmentatora. (Nie powoduje to przeniesienia ani zmiany rozmiaru selektora. Aby przenieść lub zmienić rozmiar selektora, użyj ikony
UpdateEmbeddedObjectPositionRequest.
| Zapis JSON |
|---|
{
"slicerId": integer,
"spec": {
object ( |
| Pola | |
|---|---|
slicerId
|
Identyfikator fragmentu do zaktualizowania. |
spec
|
Specyfikacja, która ma zostać zastosowana do narzędzia do cięcia. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
AddDataSourceRequest
Dodaje źródło danych. Po dodaniu źródła danych zostanie utworzony powiązany arkusz DATA_SOURCE i uruchomione odświeżanie arkusza w celu odczytania danych ze źródła.
Jeśli dodajesz źródło danych BigQuery, żądanie wymaga dodatkowego zakresu OAuth:bigquery.readonly
| Zapis JSON |
|---|
{
"dataSource": {
object ( |
| Pola | |
|---|---|
dataSource
|
Źródło danych do dodania. |
UpdateDataSourceRequest
Aktualizuje źródło danych. Po pomyślnym zaktualizowaniu źródła danych uruchamiane jest wykonanie, które odświeża powiązany arkuszDATA_SOURCE, aby odczytać dane ze zaktualizowanego źródła danych.
W przypadku aktualizowania źródła danych BigQuery żądanie wymaga dodatkowego zakresu OAuth:bigquery.readonly
| Zapis JSON |
|---|
{
"dataSource": {
object ( |
| Pola | |
|---|---|
dataSource
|
Źródło danych do zaktualizowania. |
fields
|
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
DeleteDataSourceRequest
Usuwa źródło danych. Żądanie spowoduje też usunięcie powiązanego arkusza źródła danych i odłączenie wszystkich powiązanych obiektów źródła danych.
| Zapis JSON |
|---|
{ "dataSourceId": string } |
| Pola | |
|---|---|
dataSourceId
|
Identyfikator źródła danych do usunięcia. |
RefreshDataSourceRequest
Odświeża jeden lub kilka obiektów źródła danych w arkuszu kalkulacyjnym na podstawie określonych odwołań.
W przypadku odświeżania źródła danych BigQuery wymagany jest dodatkowy zakres OAuth:bigquery.readonly
Jeśli w jednej partii znajduje się kilka żądań odświeżenia odwołujących się do tych samych obiektów źródła danych, przetwarzane jest tylko ostatnie żądanie odświeżenia, a wszystkie te żądania będą miały odpowiednio tę samą odpowiedź.
| Zapis JSON |
|---|
{ "force": boolean, // Union field |
| Pola | |
|---|---|
force
|
Odświeża obiekty źródła danych niezależnie od ich bieżącego stanu. Jeśli nie jest ustawiona, a odwoływany obiekt źródła danych był w stanie błędu, odświeżanie natychmiast się nie powiedzie. |
Pole zbiorczetarget. Określa, co ma zostać odświeżone.
target
może mieć tylko jedną z tych wartości:
|
|
references
|
Odwołania do obiektów źródła danych do odświeżenia. |
dataSourceId
|
Odwołanie do |
isAll
|
Odświeża wszystkie istniejące obiekty źródła danych w arkuszu kalkulacyjnym. |
DataSourceObjectReferences
Lista odwołań do obiektów źródła danych.
| Zapis JSON |
|---|
{
"references": [
{
object ( |
| Pola | |
|---|---|
references[]
|
Odsyłacze. |
DataSourceObjectReference
Odwołanie do obiektu źródła danych.
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorczevalue. Typ pliku referencyjnego.
value
może mieć tylko jedną z tych wartości:
|
|
sheetId
|
Odwołania do arkusza |
chartId
|
Odwołania do wykresu źródła danych. |
dataSourceTableAnchorCell
|
Odwołania do elementu |
dataSourcePivotTableAnchorCell
|
Odwołania do źródła danych
|
dataSourceFormulaCell
|
Odwołania do komórki zawierającej |
CancelDataSourceRefreshRequest
Anuluje jedno lub kilka odświeżeń obiektów źródła danych w arkuszu kalkulacyjnym według określonych odwołań.
W przypadku anulowania odświeżania źródła danych BigQuery wymagany jest dodatkowy zakres OAuth:bigquery.readonly
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorczetarget. Określa, co ma zostać anulowane.
target
może mieć tylko jedną z tych wartości:
|
|
references
|
Odniesienia do obiektów źródła danych, których odświeżanie ma zostać anulowane. |
dataSourceId
|
Odwołanie do |
isAll
|
Anuluje wszystkie odświeżania obiektów źródła danych we wszystkich źródłach danych w arkuszu kalkulacyjnym. |
AddTableRequest
Dodaje do arkusza nową tabelę.
| Zapis JSON |
|---|
{
"table": {
object ( |
| Pola | |
|---|---|
table
|
Wymagane. Tabela do dodania. |
UpdateTableRequest
Aktualizuje tabelę w arkuszu kalkulacyjnym.
| Zapis JSON |
|---|
{
"table": {
object ( |
| Pola | |
|---|---|
table
|
Wymagane. Tabela do zaktualizowania. |
fields
|
Wymagane. Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny |
DeleteTableRequest
Usuwa z arkusza kalkulacyjnego tabelę o podanym identyfikatorze.
| Zapis JSON |
|---|
{ "tableId": string } |
| Pola | |
|---|---|
tableId
|
Identyfikator tabeli do usunięcia. |