Requests

Żądanie

Jeden rodzaj aktualizacji, który zostanie zastosowany w arkuszu kalkulacyjnym.

Zapis JSON
{

  // Union field kind can be only one of the following:
  "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)
  }
  // End of list of possible types for union field kind.
}
Pola
Pole sumy: kind. Rodzaj aktualizacji. Wymagane jest dokładnie jedno pole. kind może być 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)

Usunięcie arkusza.

autoFill

object (AutoFillRequest)

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

cutPaste

object (CutPasteRequest)

Powoduje wycinanie danych z jednego obszaru i wklejanie ich w innym.

copyPaste

object (CopyPasteRequest)

Kopiowanie danych z jednego obszaru i wklejanie ich do innego.

mergeCells

object (MergeCellsRequest)

Scala komórki.

unmergeCells

object (UnmergeCellsRequest)

Rozdziela scalone komórki.

updateBorders

object (UpdateBordersRequest)

Aktualizuje obramowanie w zakresie komórek.

updateCells

object (UpdateCellsRequest)

Aktualizuje wiele komórek jednocześnie.

addFilterView

object (AddFilterViewRequest)

Dodaje widok filtra.

appendCells

object (AppendCellsRequest)

Dodaje komórki po ostatnim wierszu danych w arkuszu.

clearBasicFilter

object (ClearBasicFilterRequest)

Usuwa filtr podstawowy z arkusza.

deleteDimension

object (DeleteDimensionRequest)

Usuwa wiersze lub kolumny z arkusza.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

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

deleteFilterView

object (DeleteFilterViewRequest)

Usuwa widok filtra z arkusza.

duplicateFilterView

object (DuplicateFilterViewRequest)

Zduplikowano widok filtra.

duplicateSheet

object (DuplicateSheetRequest)

Powiela arkusz.

findReplace

object (FindReplaceRequest)

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

insertDimension

object (InsertDimensionRequest)

Wstawia w arkuszu nowe wiersze lub kolumny.

insertRange

object (InsertRangeRequest)

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

moveDimension

object (MoveDimensionRequest)

Przenosi wiersze lub kolumny do innej lokalizacji w arkuszu.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

Aktualizuje położenie umieszczonego obiektu (np. wykresu lub obrazu).

pasteData

object (PasteDataRequest)

Wkleja dane (HTML lub dane rozdzielane znakami) do arkusza.

textToColumns

object (TextToColumnsRequest)

Przekształca kolumnę z tekstem w wiele kolumn tekstu.

updateFilterView

object (UpdateFilterViewRequest)

Aktualizuje właściwości widoku filtra.

deleteRange

object (DeleteRangeRequest)

Usunięcie z komórki zakresu komórek z przesunięciem pozostałych komórek.

appendDimension

object (AppendDimensionRequest)

Dodaje 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 regułę formatowania warunkowego.

sortRange

object (SortRangeRequest)

Sortuje dane w zakresie.

setDataValidation

object (SetDataValidationRequest)

Ustawia sprawdzanie poprawności danych w przypadku co najmniej jednej komórki.

setBasicFilter

object (SetBasicFilterRequest)

Ustawia filtr podstawowy 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 jednego wymiaru na podstawie zawartości komórek w tym wymiarze.

addChart

object (AddChartRequest)

Dodaje wykres.

updateChartSpec

object (UpdateChartSpecRequest)

Aktualizuje specyfikacje wykresu.

updateBanding

object (UpdateBandingRequest)

Aktualizuje zakres pasujący

addBanding

object (AddBandingRequest)

Dodaje nowy zakres pasma

deleteBanding

object (DeleteBandingRequest)

Usuwa zakres pasma

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)

Losowa kolejność wierszy w zakresie.

addDimensionGroup

object (AddDimensionGroupRequest)

Tworzy grupę w określonym zakresie.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Usunięcie grupy powyżej określonego zakresu.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Aktualizuje stan określonej grupy.

trimWhitespace

object (TrimWhitespaceRequest)

Służy do wycinania komórek odstępów (takich jak spacje, karty i nowe wiersze)

deleteDuplicates

object (DeleteDuplicatesRequest)

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

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Aktualizuje obramowanie umieszczonego obiektu.

addSlicer

object (AddSlicerRequest)

Dodaj fragmentator.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Aktualizuje ustawienia fragmentatora.

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 jedno lub wiele źródeł danych i powiązane z nimi obiekty dbobject.

Żądanie RequestProperties

Aktualizuje właściwości arkusza kalkulacyjnego.

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

object (SpreadsheetProperties)

Właściwości do aktualizacji.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Główna kategoria „właściwości” jest określona i nie powinna być określona. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie UpdateSheetProperties

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

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

object (SheetProperties)

Właściwości do aktualizacji.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek properties jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie UpdatePropertiesProperties

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

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

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
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 jedno pole. Pierwiastek properties jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Pole sumy: dimension_range. Zakres wymiarów. dimension_range może być 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 chcesz zaktualizować.

Zakreswymiaru DataSourceSheet

Zakres na pojedynczym wymiarze w arkuszu DATA_SOURCE.

Zapis JSON
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
Pola
sheetId

integer

Identyfikator arkusza źródła danych, do którego należy zakres.

columnReferences[]

object (DataSourceColumnReference)

Kolumny w arkuszu źródła danych.

Żądanie UpdateNamedRange

Aktualizuje właściwości nazwanego zakresu o określony namedRangeId.

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

object (NamedRange)

Zakres nazwany aktualizowany o nowe właściwości.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek namedRange jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie powtórnej komórki

Aktualizuje wszystkie komórki w zakresie do wartości w danym obiekcie Cell. Zaktualizowane zostaną tylko pola wymienione w polu fields. Inne pola pozostaną bez zmian.

W przypadku pisania komórki z formułą jej zakres będzie automatycznie zwiększany dla każdego pola w zakresie. Jeśli na przykład komórka z formułą (=A1) zostanie zapisana w zakresie B2:C4, B2 to =A1, B3 to =A2, B4 to =A3, C2 to =B1, C3 to =B2, a C4 to =B3.

Aby zachować statyczne zakresy formuły, użyj wskaźnika $. Możesz na przykład użyć formuły =$A$1, aby uniknąć przyrostu wartości zarówno wiersza, jak i kolumny.

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

object (GridRange)

Zakres, w którym ma się powtarzać komórka.

cell

object (CellData)

Dane do zapisania.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek cell jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie AddNamedRange

Dodaje do arkusza kalkulacyjnego nazwany zakres.

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

object (NamedRange)

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

Żądanie deleteNamedRange

Usuwa z arkusza kalkulacyjnego zakres nazwany o podanym identyfikatorze.

Zapis JSON
{
  "namedRangeId": string
}
Pola
namedRangeId

string

Identyfikator zakresu nazwanego do usunięcia.

Żądanie AddSheet

Dodaje nowy arkusz. Gdy arkusz dodaje się do danego indeksu, indeksy wszystkich kolejnych arkuszy są zwiększane. Aby dodać arkusz obiektów, użyj 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 ustawisz wartości, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora arkusza, który już istnieje, jest błędem).

Żądanie deleteSheet

Usuwa żądany arkusz.

Zapis JSON
{
  "sheetId": integer
}
Pola
sheetId

integer

Identyfikator arkusza do usunięcia.

Jeśli arkusz jest typu DATA_SOURCE, powiązany DataSource też zostanie usunięty.

Autouzupełnianie

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

Zapis JSON
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
Pola
useAlternateSeries

boolean

Wartość to „true”, jeśli powinniśmy generować dane za pomocą serii „alternate”. Różni się to w zależności od typu i liczby danych źródłowych.

Pole sumy: area. Obszar do autouzupełniania. area może być tylko jedną z tych wartości:
range

object (GridRange)

Zakres autouzupełniania. Sprawdza ono zakres i wykrywa lokalizację, w której znajdują się dane, i automatycznie uzupełnia je w pozostałych obszarach.

sourceAndDestination

object (SourceAndDestination)

Obszar źródłowy i docelowy do autouzupełniania. Wskazuje ono źródło autouzupełniania oraz wskazuje, gdzie można je uzupełnić.

Źródło i miejsce docelowe

Kombinacja zakresu źródłowego i 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, w którym powinny zostać wypełnione dane.

fillLength

integer

Liczba wierszy lub kolumn, w których powinny zostać wypełnione dane. Wartości dodatnie rozwijają się poza ostatni wiersz lub ostatnią kolumnę źródła. Liczby ujemne są wyświetlane przed pierwszym wierszem lub pierwszą kolumną źródła.

Żądanie wklejenia

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ędny lewy górny, do którego należy wkleić dane.

pasteType

enum (PasteType)

Jakiego rodzaju dane należy wkleić. Wszystkie dane źródłowe zostaną ucięte, niezależnie od tego, co zostanie wklejone.

Wklej

Jakiego rodzaju dane należy wkleić.

Wartości w polu enum
PASTE_NORMAL Wklej wartości, formuły, formaty i scalania.
PASTE_VALUES Wklej wartości TYLKO bez formatów, formuł ani scaleń.
PASTE_FORMAT Wklej tylko format i weryfikację danych.
PASTE_NO_BORDERS Podobne do: PASTE_NORMAL, ale bez obramowania.
PASTE_FORMULA Wklej tylko formuły.
PASTE_DATA_VALIDATION Wklej tylko weryfikację danych.
PASTE_CONDITIONAL_FORMATTING Wklej tylko reguły formatowania warunkowego.

Kopiuj żądanie wklejania

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)

Lokalizacja, do której chcesz wkleić elementy. Jeśli zakres obejmuje pętlę, która jest wielokrotnością wysokości źródła lub szerokości, dane będą powtarzane w celu wypełnienia zakresu docelowego. Jeśli zakres jest mniejszy niż zakres źródłowy, po zakończeniu zakresu docelowego skopiowane zostaną wszystkie dane źródłowe.

pasteType

enum (PasteType)

Jakiego rodzaju dane należy wkleić.

pasteOrientation

enum (PasteOrientation)

Jak należy porządkować dane podczas wklejania.

Wklej

Sposób wykonywania wklejania.

Wartości w polu enum
NORMAL Wklej normalnie.
TRANSPOSE Wklej dane transponowane, w których wszystkie wiersze stają się kolumnami i odwrotnie.

Prośba o scalanie komórek

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

Typ scalania

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 scalenie dla każdego wiersza w zakresie

Żądanie wyodrębnienia komórek

Rozdziela komórki w podanym zakresie.

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

object (GridRange)

Zakres, w którym wszystkie komórki mają zostać rozdzielone. Jeśli zakres obejmuje kilka scalonych komórek, wszystkie zostaną rozłączone. Zakres nie może częściowo obejmować żadnego scalania.

Żądanie aktualizacji obramowania

Aktualizuje granice zakresu. Jeśli w żądaniu brak pola, oznacza to, że obramowanie pozostaje bez zmian. Na przykład w przypadku dwóch kolejnych poleceń UpdateBordersRequest:

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

Efektem będzie wówczas, że obramowanie A1:A5 ma obramowanie o wartości { top: RED, bottom: WHITE, left: BLUE }. Jeśli chcesz usunąć obramowanie, ustaw wyraźnie 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, w którym należy zaktualizować granice.

top

object (Border)

Obramowanie, które ma zostać umieszczone na początku zakresu.

bottom

object (Border)

Obramowanie dolnego zakresu.

left

object (Border)

Obramowanie, które znajduje się po lewej stronie zakresu.

right

object (Border)

Obramowanie znajdujące się po prawej stronie zakresu.

innerHorizontal

object (Border)

Pozioma granica, która ma zostać umieszczona w zakresie.

innerVertical

object (Border)

Pionowa ramka, która ma zostać umieszczona w zakresie.

Żądanie UpdateCells

Aktualizuje wszystkie komórki w zakresie o nowe dane.

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

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
Pola
rows[]

object (RowData)

Dane do zapisania.

fields

string (FieldMask format)

Pola obiektu CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej jedno pole. Pierwiastek to CellData.Nie należy podawać „row.values”. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

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

object (GridCoordinate)

Współrzędna, od której należy rozpocząć pisanie danych. Można zapisać dowolną liczbę wierszy i kolumn (łącznie z inną liczbą kolumn w wierszu).

range

object (GridRange)

Zakres, w którym mają być zapisywane dane.

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

AddViewViewRequest

Dodaje widok filtra.

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

object (FilterView)

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

Dołączone żądanie

Dodaje nowe komórki po ostatnim wierszu z danymi w arkuszu, wstawiając w nim nowe wiersze w razie potrzeby.

Zapis JSON
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": 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 obiektu CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej jedno pole. Pierwiastek to CellData.Nie należy podawać „row.values”. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Wyczyść żądanie podstawowego filtra

Usuwa filtr podstawowy, jeśli istnieje w arkuszu.

Zapis JSON
{
  "sheetId": integer
}
Pola
sheetId

integer

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

Żądanie usunięcia wymiaru

Usuwa wymiary z arkusza.

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

object (DimensionRange)

Wymiary, które chcesz usunąć z arkusza.

Żądanie deleteObjectObject

Usuwa umieszczony obiekt o podanym identyfikatorze.

Zapis JSON
{
  "objectId": integer
}
Pola
objectId

integer

Identyfikator umieszczonego obiektu do usunięcia.

Prośba o usunięcie filtra

Usuwa konkretny widok filtra.

Zapis JSON
{
  "filterId": integer
}
Pola
filterId

integer

Identyfikator filtra, który chcesz usunąć.

Duplikat żądania widoku filtra

Zduplikowany konkretny widok filtra.

Zapis JSON
{
  "filterId": integer
}
Pola
filterId

integer

Identyfikator duplikatu filtra.

Zduplikowane żądanie arkusza

Powiela zawartość arkusza.

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

integer

Arkusz do duplikowania.

Jeśli arkusz źródłowy ma typ DATA_SOURCE, jego kopia zapasowa DataSource jest też zduplikowana i powiązana z nową kopią arkusza. Nie jest wykonywane żadne dane. Dane siatki tego arkusza są również kopiowane, ale są dostępne dopiero po zakończeniu żądania zbiorczego.

insertSheetIndex

integer

Indeks oparty na wartości zero, w której należy wstawić nowy arkusz. Zwiększenie liczby indeksów wszystkich arkuszy po tym ustawieniu.

newSheetId

integer

Jeśli jest ustawiony, identyfikator nowego arkusza. Jeśli zasada nie jest skonfigurowana, wybierany jest identyfikator. Jeśli jest ustawiony, identyfikator nie może kolidować z żadnym istniejącym identyfikatorem arkusza. Jeśli jest skonfigurowana, wartość nie może być liczbą ujemną.

newSheetName

string

Nazwa nowego arkusza. Jeśli to pole jest puste, wybierana jest nowa nazwa.

Prośba o zamianę

Wyszukiwanie i zastępowanie danych w komórkach mieszczących się w zakresie, arkuszu lub wszystkich arkuszach

Zapis JSON
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
Pola
find

string

Wartość do wyszukania.

replacement

string

Wartość do zastąpienia.

matchCase

boolean

Wartość true, jeśli wielkość liter w wyszukiwaniu ma znaczenie.

matchEntireCell

boolean

Wartość „prawda”, jeśli wartość Znajdź powinna pasować do całej komórki.

searchByRegex

boolean

Wartość true, jeśli wartość Znajdź jest wyrażeniem regularnym. Wyrażenie regularne i zastępowanie powinny być zgodne z regułami wyrażenia regularnego Java dostępnymi na https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. Zastępczy ciąg znaków może odnosić się do grup przechwytywania. Jeśli na przykład 1 komórka zawiera treść "Google Sheets", a druga "Google Docs", wyszukiwanie "o.* (.*)" za pomocą symbolu "$1 Rocks" spowoduje zmianę zawartości komórek na odpowiednio "GSheets Rocks" i "GDocs Rocks".

includeFormulas

boolean

Wartość to „prawda”, jeśli wyszukiwanie powinno zawierać komórki z formułami. False (fałsz), aby pominąć komórki z formułami.

Pole sumy: scope. Zakres, w jakim znajduje/zamienia dany element – należy ustawić tylko jeden. scope może być tylko jedną z tych wartości:
range

object (GridRange)

Zakres do znalezienia/zastąpenia.

sheetId

integer

Arkusz do znalezienia lub zastąpienia.

allSheets

boolean

Wartość „prawda”, aby znaleźć lub zastąpić wszystkie arkusze.

Żądanie żądania wymiaru

Wstawia wiersze lub kolumny w określonym arkuszu.

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

object (DimensionRange)

Wymiary do wstawienia. Indeksy zarówno początkowe, jak i końcowe muszą być ograniczone.

inheritFromBefore

boolean

Określa, czy właściwości wymiarów powinny być rozszerzane względem wymiarów przed nowo dodanymi wymiarami czy po nich. Wartość prawda powoduje dziedziczenie z poprzednich wymiarów (w takim przypadku indeks początkowy musi być większy niż 0), a fałsz – dziedziczenie z wymiarów po nim.

Jeśli na przykład indeks wiersza 0 ma czerwone tło, a indeks wiersza 1 ma zielone tło, wstawienie 2 wierszy w indeksie 1 może dziedziczyć zielone lub czerwone tło. Jeśli inheritFromBefore ma wartość Prawda, te 2 nowe wiersze są czerwone (ponieważ wiersz poprzedzający punkt wstawiania jest czerwony), a jeśli inheritFromBefore ma wartość false, te 2 nowe wiersze są zielone (ponieważ wiersz po punkcie wstawiania jest zielony).

Żądanie RequestRange

Wstawia komórki do zakresu, przesuwając istniejące komórki w górę 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.

shiftDimension

enum (Dimension)

Wymiar, który będzie przesuwany 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.

Żądanie żądania wymiaru

Przenosi jeden lub więcej wierszy lub kolumn.

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

object (DimensionRange)

Wymiary źródłowe do przeniesienia.

destinationIndex

integer

Indeks początkowy na podstawie zera, do którego należy przenieść dane źródłowe, określony 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 są usuwane z siatki, więc dane mogą się znaleźć w innym indeksie niż określono.

Biorąc pod uwagę 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 indeks docelowy to "4" (indeks o wartości 0 w wierszu 0). Wynik to A1..A5 z 0, 3, 1, 2, 4.

Żądanie żądania pozycji obiektu umieszczonego

Zaktualizuj położenie umieszczonego obiektu (np. przenoszenie lub zmianę rozmiaru wykresu albo obrazu).

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

integer

Identyfikator obiektu do przeniesienia.

newPosition

object (EmbeddedObjectPosition)

Jednoznaczna pozycja, na którą ma zostać przeniesiony umieszczony obiekt. Jeśli ustawiono newPosition.sheetId, zostanie utworzony nowy arkusz o tym identyfikatorze. Jeśli newPosition.newSheet ma wartość Prawda, zostanie utworzony nowy arkusz z identyfikatorem, który zostanie wybrany za Ciebie.

fields

string (FieldMask format)

Pola właściwości OverlayPosition, które należy zaktualizować podczas ustawiania nowej pozycji. Używany tylko wtedy, gdy określono newPosition.overlayPosition. W takim przypadku trzeba podać co najmniej 1 pole. Pierwiastek newPosition.overlayPosition jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie WklejData

Wstawia dane do arkusza kalkulacyjnego od określonej współrzędnych.

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

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
Pola
coordinate

object (GridCoordinate)

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

data

string

Dane do wstawienia.

type

enum (PasteType)

Sposób wklejania danych.

Pole sumy: kind. Jak interpretować dane: musisz ustawić dokładnie 1 wartość. kind może być tylko jedną z tych wartości:
delimiter

string

Separator w danych.

html

boolean

Wartość to „prawda”, jeśli dane są w formacie HTML.

Żądanie tekstu do kolumn

Dzieli kolumnę tekstu na wiele kolumn na podstawie separatora w każdej komórce.

Zapis JSON
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Pola
source

object (GridRange)

Zakres źródłowych danych. Musi to być dokładnie jedna kolumna.

delimiter

string

Separator do użycia. Używany tylko wtedy, gdy separatorem jest CUSTOM.

delimiterType

enum (DelimiterType)

Typ separatora, którego należy użyć.

Typ separatora

Separator do podziału.

Wartości w polu enum
DELIMITER_TYPE_UNSPECIFIED Wartość domyślna. Tej wartości nie można używać.
COMMA „,”
SEMICOLON „;”
PERIOD „.”
SPACE „ ”
CUSTOM Wartość niestandardowa zdefiniowana w separatorze.
AUTODETECT Automatycznie wykrywaj kolumny.

UpdateRequestViewRequest

Aktualizuje właściwości widoku filtra.

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

object (FilterView)

Nowe właściwości widoku filtra.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek filter jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Prośba o usunięcie zakresu

Usuwa zakres komórek przez przenoszenie innych komórek do usuniętego obszaru.

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

object (GridRange)

Zakres komórek do usunięcia.

shiftDimension

enum (Dimension)

Wymiar, z którego usunięte komórki zostaną zastąpione. 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.

Dołącz żądanie wymiaru

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 wiersze lub kolumny mają być dołączane.

length

integer

Liczba wierszy lub kolumn do dołączenia.

AddRequestalFormatRuleRequest

Dodaje nową regułę formatowania warunkowego w danym indeksie. Indeksy wszystkich kolejnych reguł są zwiększane.

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

object (ConditionalFormatRule)

Reguła, którą chcesz dodać.

index

integer

Indeks zerowy, w którym należy wstawić regułę.

Żądanie warunkowego formatowania reguł

Aktualizuje regułę formatowania warunkowego w danym indeksie lub przenosi regułę formatowania warunkowego do innego indeksu.

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

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
Pola
index

integer

Indeks zerowy dotyczący reguły, którą należy zastąpić lub przenieść.

sheetId

integer

Arkusz reguły do przeniesienia. Wymagany, jeśli typ newIndex jest ustawiony. W przeciwnym razie nie jest używany.

Pole sumy: instruction. Rodzaj aktualizacji, która powinna się wydarzyć. instruction może być tylko jedną z tych wartości:
rule

object (ConditionalFormatRule)

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

newIndex

integer

Nowy indeks liczony od zera.

Prośba o usunięcie warunku

Usuwa regułę formatowania warunkowego w danym indeksie. Indeksy wszystkich kolejnych reguł są zmniejszane.

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

integer

Indeks zerowy wobec wartości do usunięcia.

sheetId

integer

Arkusz, z którego usuwana jest reguła.

Żądanie sortowania zakresu

Sortuje dane w wierszach na podstawie kolejności sortowania na kolumnę.

Zapis JSON
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Pola
range

object (GridRange)

Zakres do sortowania.

sortSpecs[]

object (SortSpec)

Kolejność sortowania na kolumnę. Specyfikacje te są używane później, gdy wartości są takie same we wcześniejszych specyfikacjach.

Żądanie setDataValidation

Ustawia regułę sprawdzania poprawności danych na każdą komórkę w zakresie. Aby wyczyścić weryfikację w zakresie, wywołaj ją bez określonej reguły.

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

object (GridRange)

Zakres, w którym powinna obowiązywać reguła sprawdzania danych.

rule

object (DataValidationRule)

Reguła sprawdzania poprawności danych, którą można ustawić dla każdej komórki w zakresie, lub pusta, aby wyczyścić funkcję sprawdzania poprawności danych w zakresie.

Ustaw żądanie podstawowego filtra

Ustawia podstawowy filtr powiązany z arkuszem.

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

object (BasicFilter)

Filtr do ustawienia.

Żądanie AddProtectedRange

Dodaje nowy zakres chroniony.

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

object (ProtectedRange)

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

Żądanie UpdateProtectedRangeRequest

Aktualizuje istniejący zakres chroniony o określony protectedRangeId.

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

object (ProtectedRange)

Zakres chroniony do aktualizacji z nowymi właściwościami.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek protectedRange jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie deleteProtectedRange

Usuwa zakres chroniony z podanym identyfikatorem.

Zapis JSON
{
  "protectedRangeId": integer
}
Pola
protectedRangeId

integer

Identyfikator chronionego zakresu do usunięcia.

Automatyczne zmienianie wymiarów

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

Zapis JSON
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
Pola
Pole sumy: dimension_range. Zakres wymiarów. dimension_range może być tylko jedną z tych wartości:
dimensions

object (DimensionRange)

Wymiary, które mają automatycznie zmieniać rozmiar.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

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

Dodaj żądanie do wykresu

Dodaje wykres do arkusza w arkuszu kalkulacyjnym.

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

object (EmbeddedChart)

Wykres, który należy dodać do arkusza kalkulacyjnego, w tym miejsce jego umieszczenia. Pole chartId jest opcjonalne. Jeśli nie ustawisz wartości, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora umieszczonego obiektu, który już istnieje, jest błędem).

Żądanie aktualizacji specyfikacji wykresu

Aktualizuje specyfikacje wykresu. Wykres nie zostanie przeniesiony ani zmieniony. 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 ma zostać zastosowana do wykresu.

Żądanie żądania aktualizacji

Aktualizuje właściwości podanego zakresu pasma.

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

object (BandedRange)

Pasmo zakresu do zaktualizowania z nowymi właściwościami.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek bandedRange jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Prośba o dodanie

Dodaje do arkusza kalkulacyjnego nowy zakres pasma.

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

object (BandedRange)

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

Prośba o usunięcie

Usunięcie z arkusza kalkulacyjnego zakresu pasowanego z podanym identyfikatorem.

Zapis JSON
{
  "bandedRangeId": integer
}
Pola
bandedRangeId

integer

Identyfikator zakresu pasma do usunięcia.

Utwórz żądanie metadanych dewelopera

Żądanie utworzenia metadanych dewelopera.

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

object (DeveloperMetadata)

Metadane dewelopera.

ŻądanieRequestMetadataMetadata

Żądanie zaktualizowania właściwości metadanych dewelopera. Aktualizuje właściwości metadanych programisty wybranych przez filtry na wartości podane w zasobie DeveloperMetadata. Rozmówcy muszą podać w polach właściwości, które chcą zaktualizować, a także co najmniej 1 element DataFilter zgodny z metadanymi, które chcą zaktualizować.

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

object (DataFilter)

Filtry pasujące do wpisów dotyczących 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 jedno pole. Pierwiastek developerMetadata jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Prośba o usunięcie metadanych dewelopera

Żądanie usunięcia metadanych dewelopera.

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

object (DataFilter)

Filtr danych opisujący kryteria służące do wybierania wpisu metadanych dewelopera, który chcesz usunąć.

Żądanie losowego zakresu

Losowa kolejność wierszy w zakresie.

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

object (GridRange)

Zakres do wyboru.

Dodaj żądanie grupy wymiarów

Tworzy grupę w określonym zakresie.

Jeśli żądany zakres jest nadrzędnym zakresem istniejącej grupy G, głębokość G jest zwiększana, a nowa grupa G ma głębokość tej grupy. Na przykład grupa [C:D, głębokość 1] + [B:E] powoduje powstanie grup [B:E, głębokość 1] i [C:D, głębokość 2]. Jeśli żądany zakres jest podzbiorem istniejącej grupy G, głębokość nowej grupy G jest większa o głębokość G. Na przykład grupa [B:E, głębokość 1] + [C:D] prowadzi do grup [B:E, głębokość 1] i [C:D, głębokość 2]. Jeśli żądany zakres rozpoczyna się przed lub kończy w zakresie albo rozpoczyna się i kończy na zakresie istniejącej grupy G, zakres istniejącej grupy G staje się sumą zakresów, a nowa grupa G ma głębokość większą niż głębokość G i zakres jako przecięcie zakresów. Na przykład grupa [B:D, głębokość 1] + [C:E] prowadzi do grup [B:E, głębokość 1] i [C:D, głębokość 2].

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

object (DimensionRange)

Zakres, w którym zostanie utworzona grupa.

Żądanie usunięcia wymiaru

Usunięcie grupy w określonym zakresie dzięki zmniejszeniu głębokości wymiarów w zakresie.

Załóżmy na przykład, że arkusz zawiera grupę głębokość-1 zamiast B:E, a grupa głębokość-2 – C:D. Usunięcie grupy obejmującej dni D:E powoduje opuszczenie arkusza z grupą głębokość 1 w zakresie B:D i grupę depth-2 dla grupy C:C.

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

object (DimensionRange)

Zakres grupy do usunięcia.

Aktualizuj żądanie grupy wymiarów

Aktualizuje stan określonej grupy.

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

object (DimensionGroup)

Grupa, której stan należy zaktualizować. Zakres i głębokość grupy powinny określać prawidłową grupę w arkuszu, a wszystkie pozostałe pola zostały zaktualizowane.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek dimensionGroup jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Przytnij – brak spacji

Służy do wycinania odstępów (np. spacji, kart lub nowych wierszy) w każdej komórce określonego zakresu. To żądanie powoduje usunięcie spacji na początku i na końcu tekstu w każdej komórce oraz ograniczenie dalszych znaków pozostałych po odstępach do jednej spacji. Jeśli skrócony tekst rozpoczyna się znakiem „+” lub „=”, tekst pozostaje w postaci ciągu znaków i nie jest interpretowany jako formuła.

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

object (GridRange)

Zakres komórek, które mają zostać przycięte.

Prośba o usunięcie duplikatów

Usuwa wiersze z tego zakresu, które zawierają wartości ze wskazanych kolumn 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.

To żądanie powoduje też usunięcie zduplikowanych wierszy ukrytych (takich jak filtr) w widoku. W przypadku usuwania duplikatów pierwsze wystąpienie każdego zduplikowanego wiersza skanowania od góry w dół znajduje się w wynikowym zakresie. Treści spoza określonego zakresu nie są usuwane, a wiersze uważane za duplikaty nie muszą znajdować się obok siebie 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 do analizy duplikatów wartości. Jeśli nie wybierzesz żadnej kolumny, wszystkie kolumny zostaną przeanalizowane pod kątem duplikatów.

Zaktualizuj żądanie dotyczące obiektu osadzonego

Aktualizuje właściwość obramowania obiektu umieszczonego.

Zapis JSON
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
Pola
objectId

integer

Identyfikator umieszczonego obiektu do zaktualizowania.

border

object (EmbeddedObjectBorder)

Obramowanie umieszczonego obiektu.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek border jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Dodaj żądanie fragmentatora

Dodaj fragmentator do arkusza w arkuszu kalkulacyjnym.

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

object (Slicer)

fragmentator, który należy dodać do arkusza kalkulacyjnego, w tym miejsce, w którym się on znajduje; Pole slicerId jest opcjonalne. Jeśli nie ustawisz wartości, identyfikator zostanie wygenerowany losowo. (Określenie identyfikatora fragmentatora, który już istnieje, jest błędem).

Żądanie UpdateSlicerSpecSpec

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

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

integer

Identyfikator fragmentatora do zaktualizowania.

spec

object (SlicerSpec)

Specyfikacja, która ma być stosowana do fragmentatora.

fields

string (FieldMask format)

Pola, które należy zaktualizować. Musisz określić co najmniej jedno pole. Pierwiastek SlicerSpec jest domniemany i nie powinien być określony. Pojedynczy znak „*” może służyć jako krótka lista wszystkich pól.

Żądanie AddDataSource

Dodaje źródło danych. Po dodaniu źródła danych zostanie utworzony powiązany arkusz DATA_SOURCE, który zostanie wywołany, aby odświeżyć arkusz i odczytać dane ze źródła danych. Żądanie wymaga dodatkowego zakresu OAuth bigquery.readonly.

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

object (DataSource)

Źródło danych do dodania.

Żądanieaktualizowania źródła danych

Aktualizuje źródło danych. Po zaktualizowaniu źródła danych zostanie uruchomione wykonanie odświeżenia powiązanego arkusza DATA_SOURCE, aby odczytać dane ze zaktualizowanego źródła danych. Żądanie wymaga dodatkowego zakresu OAuth bigquery.readonly.

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 jedno pole. Pierwiastek dataSource jest domniemany i nie powinien być określony. Pojedyncza właściwość "*" może służyć jako krótka lista usług.

Żądanie usunięcia danych

Usuwa źródło danych. Żądanie usuwa też powiązany arkusz źródła danych i rozłącza wszystkie powiązane obiekty źródła danych.

Zapis JSON
{
  "dataSourceId": string
}
Pola
dataSourceId

string

Identyfikator źródła danych do usunięcia.

Żądanie odświeżenia danych

Odświeża co najmniej 1 obiekt źródła danych w arkuszu kalkulacyjnym według określonych odwołań. Żądanie wymaga dodatkowego zakresu OAuth bigquery.readonly.

Jeśli w jednej grupie jest wiele żądań odświeżania 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 otrzymują tę samą odpowiedź.

Zapis JSON
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
Pola
force

boolean

Odświeża obiekty źródła danych niezależnie od bieżącego stanu. Jeśli jej nie skonfigurujesz, a obiekt obiektu danych, do którego się odwołuje, będzie w stanie błędu, odświeżenie zakończy się natychmiast.

Pole sumy: target. Określa, co ma być odświeżane. target może być tylko jedną z tych wartości:
references

object (DataSourceObjectReferences)

Odwołania do obiektów źródła danych, które mają zostać odświeżone.

dataSourceId

string

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

isAll

boolean

Odświeża wszystkie istniejące obiekty źródeł danych w arkuszu kalkulacyjnym.

Odwołania do DataSourceObject

Lista odwołań do obiektów źródła danych.

Zapis JSON
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
Pola
references[]

object (DataSourceObjectReference)

Odwołania.

Odniesienie do obiektu DataSource

Odwołanie do obiektu źródła danych.

Zapis JSON
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
Pola
Pole sumy: value. Typ pliku referencyjnego. value może być tylko jedną z tych wartości:
sheetId

string

Odwołania do arkusza DATA_SOURCE.

chartId

integer

Odwołania do wykresu źródła danych.

dataSourceTableAnchorCell

object (GridCoordinate)

Odwołanie do: DataSourceTable zakotwiczonego w komórce.

dataSourcePivotTableAnchorCell

object (GridCoordinate)

Odwołania do źródła danych PivotTable zakotwiczone w komórce.

dataSourceFormulaCell

object (GridCoordinate)

Odwołania do komórki zawierającej: DataSourceFormula.