Requests

Żądanie

Pojedynczy rodzaj aktualizacji, który ma zostać zastosowany w arkuszu kalkulacyjnym.

Zapis JSON 
{

  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
}
Pola
Pole zbiorczekind. Rodzaj aktualizacji. Wymagane jest dokładnie jedno pole. kind może mieć tylko jedną z tych wartości:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

Aktualizuje właściwości arkusza kalkulacyjnego.

updateSheetProperties

object (UpdateSheetPropertiesRequest)

Aktualizuje właściwości arkusza.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

Aktualizuje właściwości wymiarów.

updateNamedRange

object (UpdateNamedRangeRequest)

Aktualizuje zakres nazwany.

repeatCell

object (RepeatCellRequest)

Powtarza pojedynczą komórkę w zakresie.

addNamedRange

object (AddNamedRangeRequest)

Dodaje zakres nazwany.

deleteNamedRange

object (DeleteNamedRangeRequest)

Usuwa zakres nazwany.

addSheet

object (AddSheetRequest)

Dodaje arkusz.

deleteSheet

object (DeleteSheetRequest)

Usuwa arkusz.

autoFill

object (AutoFillRequest)

Automatycznie uzupełnia więcej danych na podstawie istniejących danych.

cutPaste

object (CutPasteRequest)

Wycina dane z jednego obszaru i wkleja je w innym.

copyPaste

object (CopyPasteRequest)

Kopiuje dane z jednego obszaru i wkleja je w innym.

mergeCells

object (MergeCellsRequest)

Scala komórki.

unmergeCells

object (UnmergeCellsRequest)

Rozdziela scalone komórki.

updateBorders

object (UpdateBordersRequest)

Aktualizuje obramowania w zakresie komórek.

updateCells

object (UpdateCellsRequest)

Aktualizuje wiele komórek jednocześnie.

addFilterView

object (AddFilterViewRequest)

Dodaje widok przefiltrowany.
appendCells

object (AppendCellsRequest)

Dołącza komórki po ostatnim wierszu z danymi w arkuszu.

clearBasicFilter

object (ClearBasicFilterRequest)

Usuwa filtr podstawowy z arkusza.

deleteDimension

object (DeleteDimensionRequest)

Usuwa wiersze lub kolumny w arkuszu.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

Usuwa umieszczony obiekt (np.wykres lub obraz) w arkuszu.

deleteFilterView

object (DeleteFilterViewRequest)

Usuwa widok przefiltrowany z arkusza.
duplicateFilterView

object (DuplicateFilterViewRequest)

Duplikuje widok przefiltrowany.
duplicateSheet

object (DuplicateSheetRequest)

Duplikuje arkusz.

findReplace

object (FindReplaceRequest)

Wyszukuje i zastępuje wystąpienia tekstu innym tekstem.

insertDimension

object (InsertDimensionRequest)

Wstawia nowe wiersze lub kolumny w arkuszu.

insertRange

object (InsertRangeRequest)

Wstawia nowe komórki w arkuszu, przesuwając istniejące komórki.

moveDimension

object (MoveDimensionRequest)

Przenosi wiersze lub kolumny w inne miejsce w arkuszu.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

Aktualizuje pozycję obiektu osadzonego (np. wykresu lub obrazu).

pasteData

object (PasteDataRequest)

Wkleja dane (HTML lub rozdzielone) do arkusza.

textToColumns

object (TextToColumnsRequest)

Przekształca kolumnę tekstu w wiele kolumn tekstu.

updateFilterView

object (UpdateFilterViewRequest)

Aktualizuje właściwości widoku przefiltrowanego.
deleteRange

object (DeleteRangeRequest)

Usuwa zakres komórek z arkusza, przesuwając pozostałe komórki.

appendDimension

object (AppendDimensionRequest)

Dołącza wymiary na końcu arkusza.

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

Dodaje nową regułę formatowania warunkowego.

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

Aktualizuje istniejącą regułę formatowania warunkowego.

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

Usuwa istniejącą regułę formatowania warunkowego.

sortRange

object (SortRangeRequest)

Sortuje dane w zakresie.

setDataValidation

object (SetDataValidationRequest)

Ustawia sprawdzanie poprawności danych w co najmniej 1 komórce.

setBasicFilter

object (SetBasicFilterRequest)

Ustawia podstawowy filtr w arkuszu.

addProtectedRange

object (AddProtectedRangeRequest)

Dodaje zakres chroniony.

updateProtectedRange

object (UpdateProtectedRangeRequest)

Aktualizuje zakres chroniony.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

Usuwa zakres chroniony.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

Automatycznie zmienia rozmiar co najmniej 1 wymiaru na podstawie zawartości komórek w tym wymiarze.

addChart

object (AddChartRequest)

Dodaje wykres.

updateChartSpec

object (UpdateChartSpecRequest)

Aktualizuje specyfikacje wykresu.

updateBanding

object (UpdateBandingRequest)

Aktualizowanie zakresu pasmowego

addBanding

object (AddBandingRequest)

Dodaje nowy zakres pasmowy

deleteBanding

object (DeleteBandingRequest)

Usuwa zakres z pasmami

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

Tworzy nowe metadane dewelopera.

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

Aktualizuje istniejący wpis metadanych dewelopera.

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Usuwa metadane dewelopera.

randomizeRange

object (RandomizeRangeRequest)

Losuje kolejność wierszy w zakresie.

addDimensionGroup

object (AddDimensionGroupRequest)

Tworzy grupę w określonym zakresie.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Usuwa grupę w określonym zakresie.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Aktualizuje stan określonej grupy.

trimWhitespace

object (TrimWhitespaceRequest)

Usuwa z komórek białe znaki (takie jak spacje, tabulatory lub znaki nowego wiersza).

deleteDuplicates

object (DeleteDuplicatesRequest)

Usuwa wiersze zawierające zduplikowane wartości w określonych kolumnach zakresu komórek.

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Aktualizuje obramowanie obiektu osadzonego.

addSlicer

object (AddSlicerRequest)

Dodaje fragmentator.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Aktualizuje specyfikacje selektora.

addDataSource

object (AddDataSourceRequest)

Dodaje źródło danych.

updateDataSource

object (UpdateDataSourceRequest)

Aktualizuje źródło danych.

deleteDataSource

object (DeleteDataSourceRequest)

Usuwa źródło danych.

refreshDataSource

object (RefreshDataSourceRequest)

Odświeża co najmniej jedno źródło danych i powiązane obiekty bazy danych.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

Anuluje odświeżanie co najmniej jednego źródła danych i powiązanych obiektów bazy danych.

addTable

object (AddTableRequest)

Dodaje tabelę.

updateTable

object (UpdateTableRequest)

Aktualizuje tabelę.

deleteTable

object (DeleteTableRequest)

Żądanie usunięcia tabeli.

UpdateSpreadsheetPropertiesRequest

Aktualizuje właściwości arkusza kalkulacyjnego.

Zapis JSON 
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
Pola
properties

object (SpreadsheetProperties)

Właściwości do zaktualizowania.

fields

string (FieldMask format)

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 "*" może być używany jako skrót do wyświetlania wszystkich pól.

UpdateSheetPropertiesRequest

Aktualizuje właściwości arkusza o podanym identyfikatorze sheetId.

Zapis JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Pola
properties

object (SheetProperties)

Właściwości do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny properties 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.

UpdateDimensionPropertiesRequest

Aktualizuje właściwości wymiarów w określonym zakresie.

Zapis JSON 
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
}
Pola
properties

object (DimensionProperties)

Właściwości do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny properties 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.

Pole zbiorczedimension_range. Zakres wymiarów. dimension_range może mieć tylko jedną z tych wartości:
range

object (DimensionRange)

Wiersze lub kolumny do zaktualizowania.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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 (DataSourceColumnReference)
    }
  ]
}
Pola
sheetId

integer

Identyfikator arkusza źródła danych, w którym znajduje się zakres.

columnReferences[]

object (DataSourceColumnReference)

Kolumny w arkuszu źródła danych.

UpdateNamedRangeRequest

Aktualizuje właściwości zakresu nazwanego za pomocą określonego namedRangeId.

Zapis JSON 
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
Pola
namedRange

object (NamedRange)

Zakres nazwany, który ma zostać zaktualizowany o nowe właściwości.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny namedRange 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.

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 w zakresie B2:C4, komórka B2 będzie mieć wartość =A1, komórka B3 będzie mieć wartość =A2, komórka B4 będzie mieć wartość =A3, komórka C2 będzie mieć wartość =B1, komórka C3 będzie mieć wartość =B2, a komórka C4 będzie mieć wartość =B3.

Aby zakresy formuły były statyczne, użyj wskaźnika $. Aby zapobiec zwiększaniu wartości zarówno wiersza, jak i kolumny, użyj na przykład formuły:=$A$1

Zapis JSON 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Pola
range

object (GridRange)

Zakres, w którym ma być powtarzana komórka.

cell

object (CellData)

Dane do zapisania.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny cell 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.

AddNamedRangeRequest

Dodaje do arkusza kalkulacyjnego zakres nazwany.

Zapis JSON 
{
  "namedRange": {
    object (NamedRange)
  }
}
Pola
namedRange

object (NamedRange)

Zakres nazwany do dodania. Pole namedRangeId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora zakresu, który już istnieje, jest błędem).

DeleteNamedRangeRequest

Usuwa z arkusza kalkulacyjnego zakres nazwany o podanym identyfikatorze.

Zapis JSON 
{
  "namedRangeId": string
}
Pola
namedRangeId

string

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 zamiast tego elementu AddChartRequest i określ EmbeddedObjectPosition.sheetId lub EmbeddedObjectPosition.newSheet.

Zapis JSON 
{
  "properties": {
    object (SheetProperties)
  }
}
Pola
properties

object (SheetProperties)

Właściwości, które powinien mieć nowy arkusz. Wszystkie właściwości są opcjonalne. Pole sheetId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora arkusza, który już istnieje, jest błędem).

DeleteSheetRequest

Usuwa żądany arkusz.

Zapis JSON 
{
  "sheetId": integer
}
Pola
sheetId

integer

Identyfikator arkusza do usunięcia.

Jeśli arkusz jest typu DATA_SOURCE, powiązany z nim DataSource również zostanie usunięty.

AutoFillRequest

uzupełnia więcej danych na podstawie danych już dostępnych,

Zapis JSON 
{
  "useAlternateSeries": boolean,

  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
}
Pola
useAlternateSeries

boolean

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

object (GridRange)

Zakres do automatycznego uzupełniania. Sprawdzi zakres i wykryje lokalizację, która zawiera dane, a następnie automatycznie wypełni te dane w pozostałej części zakresu.

sourceAndDestination

object (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 (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
Pola
source

object (GridRange)

Lokalizacja danych, które mają być używane jako źródło autouzupełniania.

dimension

enum (Dimension)

Wymiar, do którego mają zostać wypełnione dane.

fillLength

integer

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 (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
Pola
source

object (GridRange)

Dane źródłowe do wycięcia.

destination

object (GridCoordinate)

Współrzędne lewego górnego rogu, w którym mają zostać wklejone dane.

pasteType

enum (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, bez sprawdzania poprawności danych.
PASTE_NO_BORDERS Podobnie jak PASTE_NORMAL ale bez obramowania.
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 (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
Pola
source

object (GridRange)

Zakres źródłowy do skopiowania.

destination

object (GridRange)

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

enum (PasteType)

Rodzaj danych do wklejenia.

pasteOrientation

enum (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 (GridRange)
  },
  "mergeType": enum (MergeType)
}
Pola
range

object (GridRange)

Zakres komórek do scalenia.

mergeType

enum (MergeType)

Sposób scalania komórek.

MergeType

Typ scalania do utworzenia.

Wartości w polu enum
MERGE_ALL Utwórz pojedyncze scalenie 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 (GridRange)
  }
}
Pola
range

object (GridRange)

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:

  1. zakres: A1:A5 { top: RED, bottom: WHITE }
  2. zakres: A1:A5 { left: BLUE }

Spowoduje to, że zakres A1:A5 będzie miał obramowanie { top: RED, bottom: WHITE, left: BLUE }. Jeśli chcesz usunąć obramowanie, ustaw styl na NONE.

Zapis JSON 
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
Pola
range

object (GridRange)

Zakres, którego obramowanie ma zostać zaktualizowane.

top

object (Border)

Granica, która ma się znajdować na górze zakresu.

bottom

object (Border)

Obramowanie, które ma się znajdować u dołu zakresu.

left

object (Border)

Obramowanie, które ma się znajdować po lewej stronie zakresu.

right

object (Border)

Obramowanie, które ma się znajdować po prawej stronie zakresu.

innerHorizontal

object (Border)

Obramowanie poziome, które ma się znaleźć w zakresie.

innerVertical

object (Border)

Obramowanie pionowe, które ma się znaleźć w zakresie.

UpdateCellsRequest

Aktualizuje wszystkie komórki w zakresie nowymi danymi.

Zapis JSON 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
}
Pola
rows[]

object (RowData)

Dane do zapisania.

fields

string (FieldMask format)

Pola CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej 1 pole. Elementem głównym jest CellData, a wartości „row.values.” nie należy określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Pole zbiorczearea. Dane o lokalizacji powinny być zapisane. Musisz ustawić dokładnie 1 wartość. area może mieć tylko jedną z tych wartości:
start

object (GridCoordinate)

Współrzędna, od której ma się rozpocząć zapisywanie danych. Możesz zapisać dowolną liczbę wierszy i kolumn (w tym różną liczbę kolumn w poszczególnych wierszach).

range

object (GridRange)

Zakres, do którego chcesz zapisać dane.

Jeśli dane w wierszach nie obejmują całego zakresu, pola pasujące do tych ustawionych w fields zostaną wyczyszczone.

AddFilterViewRequest

Dodaje widok przefiltrowany.

Zapis JSON 
{
  "filter": {
    object (FilterView)
  }
}
Pola
filter

object (FilterView)

Filtr do dodania. Pole filterViewId jest opcjonalne. Jeśli nie jest ustawiony, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora filtra, który już istnieje, jest błędem).

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 (RowData)
    }
  ],
  "fields": string,

  "tableId": string
}
Pola
sheetId

integer

Identyfikator arkusza, do którego mają zostać dołączone dane.

rows[]

object (RowData)

Dane do dołączenia.

fields

string (FieldMask format)

Pola CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej 1 pole. Elementem głównym jest CellData, a wartości „row.values.” nie należy określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Pole zbiorczearea. Dane o lokalizacji powinny być zapisane. area może mieć tylko jedną z tych wartości:
tableId

string

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

ClearBasicFilterRequest

Usuwa filtr podstawowy, jeśli taki istnieje w arkuszu.

Zapis JSON 
{
  "sheetId": integer
}
Pola
sheetId

integer

Identyfikator arkusza, w którym należy wyczyścić filtr podstawowy.

DeleteDimensionRequest

Usuwa wymiary z arkusza.

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

object (DimensionRange)

Wymiary do usunięcia z arkusza.

DeleteEmbeddedObjectRequest

Usuwa obiekt osadzony o podanym identyfikatorze.

Zapis JSON 
{
  "objectId": integer
}
Pola
objectId

integer

Identyfikator obiektu osadzonego do usunięcia.

DeleteFilterViewRequest

Usuwa określony widok przefiltrowany.

Zapis JSON 
{
  "filterId": integer
}
Pola
filterId

integer

Identyfikator filtra do usunięcia.

DuplicateFilterViewRequest

Duplikuje określony widok przefiltrowany.

Zapis JSON 
{
  "filterId": integer
}
Pola
filterId

integer

Identyfikator filtra, który jest duplikowany.

DuplicateSheetRequest

Duplikuje zawartość arkusza.

Zapis JSON 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Pola
sourceSheetId

integer

Arkusza do zduplikowania.

Jeśli arkusz źródłowy jest typu DATA_SOURCE, jego kopia zapasowa DataSource jest również duplikowana i powiązana z nową kopią arkusza. Nie jest wywoływane żadne wykonanie danych. Dane siatki tego arkusza są również kopiowane, ale są dostępne dopiero po zakończeniu żądania zbiorczego.

insertSheetIndex

integer

Indeks rozpoczynający się od 0, w którym ma zostać wstawiony nowy arkusz. Indeks wszystkich arkuszy po tym arkuszu zostanie zwiększony.

newSheetId

integer

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, musi być nieujemna.

newSheetName

string

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,

  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
}
Pola
find

string

Wartość do wyszukania.

replacement

string

Wartość, która ma zastąpić poprzednią.

matchCase

boolean

Wartość „prawda”, jeśli w wyszukiwaniu jest rozróżniana wielkość liter.

matchEntireCell

boolean

Wartość PRAWDA, jeśli szukana wartość ma odpowiadać całej komórce.

searchByRegex

boolean

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 znaków "Google Sheets" a druga "Google Docs", to wyszukanie ciągu "o.* (.*)" i zastąpienie go ciągiem "$1 Rocks" spowoduje zmianę zawartości komórek na "GSheets Rocks" i "GDocs Rocks" odpowiednio.

includeFormulas

boolean

Wartość PRAWDA, jeśli wyszukiwanie ma obejmować komórki z formułami. Wartość False, aby pominąć komórki z formułami.

Pole zbiorczescope. Zakres, w którym ma nastąpić wyszukanie i zamiana – musi być ustawiony tylko jeden z nich. scope może mieć tylko jedną z tych wartości:
range

object (GridRange)

Zakres, w którym nastąpi wyszukanie i zamiana.

sheetId

integer

Arkusz, w którym ma nastąpić wyszukanie i zamiana.

allSheets

boolean

Wartość true, 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 (DimensionRange)
  },
  "inheritFromBefore": boolean
}
Pola
range

object (DimensionRange)

Wymiary do wstawienia. Zarówno indeks początkowy, jak i końcowy muszą być ograniczone.

inheritFromBefore

boolean

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” oznacza 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 inheritFromBefore ma wartość prawda, 2 nowe wiersze będą czerwone (ponieważ wiersz przed punktem wstawienia był czerwony), a jeśli inheritFromBefore ma wartość fałsz, 2 nowe wiersze będą zielone (ponieważ wiersz po punkcie wstawienia był zielony).

InsertRangeRequest

Wstawia komórki do zakresu, przesuwając istniejące komórki w prawo lub w dół.

Zapis JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Pola
range

object (GridRange)

Zakres, w którym mają zostać wstawione nowe komórki. Zakres jest ograniczony do granic bieżącego arkusza.

shiftDimension

enum (Dimension)

Wymiar, który zostanie przesunięty podczas wstawiania komórek. Jeśli ROWS, istniejące komórki zostaną przesunięte w dół. Jeśli COLUMNS, istniejące komórki zostaną przesunięte w prawo.

MoveDimensionRequest

Przenosi co najmniej 1 wiersz lub kolumnę.

Zapis JSON 
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
Pola
source

object (DimensionRange)

Wymiary źródłowe do przeniesienia.

destinationIndex

integer

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 A1..A5 z 0, 1, 2, 3, 4 i chcesz przenieść "1" i "2" między "3" a "4", źródłem będzie ROWS [1..3),a docelowy indeks to "4" (indeks wiersza 5 liczony od zera). Wynik to:A1..A50, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

zaktualizować położenie osadzonego obiektu (np. przesunąć lub zmienić rozmiar wykresu lub obrazu);

Zapis JSON 
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
Pola
objectId

integer

Identyfikator obiektu do przeniesienia.
newPosition

object (EmbeddedObjectPosition)

Jawna pozycja, do której ma zostać przeniesiony umieszczony obiekt. Jeśli ustawisz wartość newPosition.sheetId, utworzymy nowy arkusz z tym identyfikatorem. Jeśli wartość parametru newPosition.newSheet to „true”, zostanie utworzony nowy arkusz z wybranym przez nas identyfikatorem.

fields

string (FieldMask format)

Pola OverlayPosition , które powinny zostać zaktualizowane podczas ustawiania nowej pozycji. Używane tylko wtedy, gdy ustawione jest pole newPosition.overlayPosition. W takim przypadku musisz określić co najmniej 1 pole. Katalog główny newPosition.overlayPosition 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.

PasteDataRequest

Wstawia dane do arkusza kalkulacyjnego, zaczynając od określonych współrzędnych.

Zapis JSON 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  "delimiter": string,
  "html": boolean
}
Pola
coordinate

object (GridCoordinate)

Współrzędna, od której należy rozpocząć wstawianie danych.

data

string

Dane do wstawienia.

type

enum (PasteType)

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

string

Separator w danych.

html

boolean

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 (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Pola
source

object (GridRange)

Zakres danych źródłowych. Musi obejmować dokładnie 1 kolumnę.

delimiter

string

Separator do użycia. Używane tylko wtedy, gdy delimiterType ma wartość CUSTOM.

delimiterType

enum (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 przefiltrowanego.

Zapis JSON 
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
Pola
filter

object (FilterView)

Nowe właściwości widoku przefiltrowanego.
fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny filter 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.

DeleteRangeRequest

Usuwa zakres komórek, przesuwając inne komórki w usunięty obszar.

Zapis JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Pola
range

object (GridRange)

Zakres komórek do usunięcia.

shiftDimension

enum (Dimension)

Wymiar, którym zostaną zastąpione usunięte komórki. Jeśli ROWS, istniejące komórki zostaną przesunięte w górę, aby zastąpić usunięte komórki. Jeśli COLUMNS, istniejące komórki zostaną przesunięte w lewo, aby zastąpić usunięte komórki.

AppendDimensionRequest

Dodaje wiersze lub kolumny na końcu arkusza.

Zapis JSON 
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
Pola
sheetId

integer

Arkusz, do którego chcesz dołączyć wiersze lub kolumny.

dimension

enum (Dimension)

Określa, czy mają być dołączane wiersze czy kolumny.

length

integer

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 (ConditionalFormatRule)
  },
  "index": integer
}
Pola
rule

object (ConditionalFormatRule)

Reguła do dodania.

index

integer

Indeks rozpoczynający się od 0, w którym ma zostać wstawiona reguła.

UpdateConditionalFormatRuleRequest

Aktualizuje regułę formatowania warunkowego na podanym indeksie lub przenosi ją na inny indeks.

Zapis JSON 
{
  "index": integer,
  "sheetId": integer,

  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
}
Pola
index

integer

Indeks reguły (liczony od zera), która ma zostać zastąpiona lub przeniesiona.

sheetId

integer

Arkusz reguły do przeniesienia. Wymagane, jeśli ustawiona jest wartość newIndex. W przeciwnym razie nieużywane.

Pole zbiorczeinstruction. Rodzaj aktualizacji, która powinna nastąpić. instruction może mieć tylko jedną z tych wartości:
rule

object (ConditionalFormatRule)

Reguła, która ma zastąpić regułę na danym indeksie.

newIndex

integer

Nowy indeks (liczony od zera), na 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

integer

Indeks reguły do usunięcia rozpoczynający się od 0.

sheetId

integer

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 (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Pola
range

object (GridRange)

Zakres do posortowania.

sortSpecs[]

object (SortSpec)

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 określania reguły.

Zapis JSON 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
Pola
range

object (GridRange)

Zakres, do którego ma zastosowanie reguła sprawdzania poprawności danych.

rule

object (DataValidationRule)

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

boolean

Opcjonalnie. Jeśli ma wartość „true”, reguła sprawdzania poprawności danych zostanie zastosowana również do filtrowanych wierszy.

SetBasicFilterRequest

Ustawia podstawowy filtr powiązany z arkuszem.

Zapis JSON 
{
  "filter": {
    object (BasicFilter)
  }
}
Pola
filter

object (BasicFilter)

Filtr do ustawienia.

AddProtectedRangeRequest

Dodaje nowy zakres chroniony.

Zapis JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
Pola
protectedRange

object (ProtectedRange)

Zakres chroniony do dodania. Pole protectedRangeId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora zakresu, który już istnieje, jest błędem).

UpdateProtectedRangeRequest

Aktualizuje istniejący zakres chroniony za pomocą określonego protectedRangeId.

Zapis JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
Pola
protectedRange

object (ProtectedRange)

Zakres chroniony, który ma zostać zaktualizowany o nowe właściwości.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny protectedRange 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.

DeleteProtectedRangeRequest

Usuwa zakres chroniony o podanym identyfikatorze.

Zapis JSON 
{
  "protectedRangeId": integer
}
Pola
protectedRangeId

integer

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 
{

  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
}
Pola
Pole zbiorczedimension_range. Zakres wymiarów. dimension_range może mieć tylko jedną z tych wartości:
dimensions

object (DimensionRange)

Wymiary do automatycznego zmieniania rozmiaru.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Wymiary w arkuszu źródła danych, aby automatycznie zmieniać ich rozmiar.

AddChartRequest

Dodaje wykres do arkusza w arkuszu kalkulacyjnym.

Zapis JSON 
{
  "chart": {
    object (EmbeddedChart)
  }
}
Pola
chart

object (EmbeddedChart)

Wykres, który ma zostać dodany do arkusza kalkulacyjnego, wraz z informacją o miejscu, w którym ma się on znajdować. Pole chartId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora obiektu osadzonego, który już istnieje, jest błędem).

UpdateChartSpecRequest

Aktualizuje specyfikacje wykresu. (Nie powoduje to przeniesienia ani zmiany rozmiaru wykresu. Aby przenieść wykres lub zmienić jego rozmiar, użyj UpdateEmbeddedObjectPositionRequest.

Zapis JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
Pola
chartId

integer

Identyfikator wykresu do zaktualizowania.

spec

object (ChartSpec)

Specyfikacja, która zostanie zastosowana do wykresu.

UpdateBandingRequest

Aktualizuje właściwości podanego zakresu z paskami.

Zapis JSON 
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
Pola
bandedRange

object (BandedRange)

Zakres pasmowy, który ma zostać zaktualizowany o nowe właściwości.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny bandedRange 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.

AddBandingRequest

Dodaje do arkusza nowy zakres z naprzemiennymi kolorami.

Zapis JSON 
{
  "bandedRange": {
    object (BandedRange)
  }
}
Pola
bandedRange

object (BandedRange)

Zakres z naprzemiennymi kolorami do dodania. Pole bandedRangeId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora zakresu, który już istnieje, jest błędem).

DeleteBandingRequest

Usuwa z arkusza kalkulacyjnego zakres z podziałem na pasma o podanym identyfikatorze.

Zapis JSON 
{
  "bandedRangeId": integer
}
Pola
bandedRangeId

integer

Identyfikator zakresu z paskami do usunięcia.

CreateDeveloperMetadataRequest

Żądanie utworzenia metadanych dewelopera.

Zapis JSON 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
Pola
developerMetadata

object (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 pasujący do metadanych, które chcą zaktualizować.

Zapis JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
Pola
dataFilters[]

object (DataFilter)

Filtry dopasowujące wpisy metadanych dewelopera do zaktualizowania.

developerMetadata

object (DeveloperMetadata)

Wartość, do której zostaną zaktualizowane wszystkie metadane pasujące do filtrów danych.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny developerMetadata 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.

DeleteDeveloperMetadataRequest

Prośba o usunięcie metadanych dewelopera.

Zapis JSON 
{
  "dataFilter": {
    object (DataFilter)
  }
}
Pola
dataFilter

object (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 (GridRange)
  }
}
Pola
range

object (GridRange)

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 (DimensionRange)
  }
}
Pola
range

object (DimensionRange)

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 kolumnach B:E i grupę poziomu 2 w kolumnach C:D. Usunięcie grupy obejmującej kolumny D:E spowoduje, że arkusz będzie zawierać grupę poziomu 1 obejmującą kolumny B:D i grupę poziomu 2 obejmującą kolumnę C:C.

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

object (DimensionRange)

Zakres grupy do usunięcia.

UpdateDimensionGroupRequest

Aktualizuje stan określonej grupy.

Zapis JSON 
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
Pola
dimensionGroup

object (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

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny dimensionGroup 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.

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 zmniejsza każdą kolejną sekwencję pozostałych znaków 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 (GridRange)
  }
}
Pola
range

object (GridRange)

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 w dowolnym poprzednim wierszu. 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 (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
Pola
range

object (GridRange)

Zakres, z którego chcesz usunąć zduplikowane wiersze.

comparisonColumns[]

object (DimensionRange)

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 (EmbeddedObjectBorder)
  },
  "fields": string
}
Pola
objectId

integer

Identyfikator obiektu osadzonego do zaktualizowania.

border

object (EmbeddedObjectBorder)

Obramowanie zastosowane do obiektu osadzonego.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny border 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.

AddSlicerRequest

Dodaje fragmentator do arkusza w arkuszu kalkulacyjnym.

Zapis JSON 
{
  "slicer": {
    object (Slicer)
  }
}
Pola
slicer

object (Slicer)

Slicer, który ma zostać dodany do arkusza kalkulacyjnego, wraz z informacją o tym, gdzie ma się znajdować. Pole slicerId jest opcjonalne. Jeśli nie zostanie ustawione, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora fragmentatora, który już istnieje, jest błędem).

UpdateSlicerSpecRequest

Aktualizuje specyfikacje selektora. (Nie powoduje to przeniesienia ani zmiany rozmiaru selektora. Aby przenieść lub zmienić rozmiar fragmentatora, użyj ikonyUpdateEmbeddedObjectPositionRequest.

Zapis JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
Pola
slicerId

integer

Identyfikator fragmentu do zaktualizowania.

spec

object (SlicerSpec)

Specyfikacja, która ma zostać zastosowana do fragmentatora.
fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny SlicerSpec jest domyślny i nie należy go określać. Pojedyncza gwiazdka „*” może być używana jako skrót do wyświetlania wszystkich pól.

AddDataSourceRequest

Dodaje źródło danych. Po dodaniu źródła danych zostanie utworzony powiązany arkusz DATA_SOURCE i uruchomione zostanie wykonanie, aby odświeżyć arkusz i odczytać dane ze źródła danych.

Jeśli dodajesz źródło danych BigQuery, żądanie wymaga dodatkowego zakresu OAuth.bigquery.readonly

Zapis JSON 
{
  "dataSource": {
    object (DataSource)
  }
}
Pola
dataSource

object (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 arkusz DATA_SOURCE, aby odczytać dane ze zaktualizowanego źródła danych.

W przypadku aktualizowania źródła danych BigQuery żądanie wymaga dodatkowego bigquery.readonlyzakresu OAuth.

Zapis JSON 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Pola
dataSource

object (DataSource)

Źródło danych do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny dataSource 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.

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

string

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 żądanie wymaga dodatkowego zakresu 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,

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Pola
force

boolean

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

object (DataSourceObjectReferences)

Odwołania do obiektów źródła danych do odświeżenia.

dataSourceId

string

Odwołanie do DataSource. Jeśli jest określony, odświeża wszystkie powiązane obiekty źródła danych.

isAll

boolean

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 (DataSourceObjectReference)
    }
  ]
}
Pola
references[]

object (DataSourceObjectReference)

Odsyłacze.

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 
{

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Pola
Pole zbiorczetarget. Określa, co ma zostać anulowane. target może mieć tylko jedną z tych wartości:
references

object (DataSourceObjectReferences)

Odniesienia do obiektów źródła danych, których odświeżanie ma zostać anulowane.

dataSourceId

string

Odwołanie do DataSource. Jeśli ta opcja jest określona, anuluje wszystkie powiązane odświeżenia obiektów źródła danych dla tego źródła danych.

isAll

boolean

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 (Table)
  }
}
Pola
table

object (Table)

Wymagane. Tabela do dodania.

UpdateTableRequest

Aktualizuje tabelę w arkuszu kalkulacyjnym.

Zapis JSON 
{
  "table": {
    object (Table)
  },
  "fields": string
}
Pola
table

object (Table)

Wymagane. Tabela do zaktualizowania.

fields

string (FieldMask format)

Wymagane. Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny table 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.

DeleteTableRequest

Usuwa z arkusza kalkulacyjnego tabelę o podanym identyfikatorze.

Zapis JSON 
{
  "tableId": string
}
Pola
tableId

string

Identyfikator tabeli do usunięcia.