Requests

Żądanie

Pojedynczy rodzaj aktualizacji, którą można zastosować 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)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // End of list of possible types for union field kind.
}
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 wypeł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 filtra.

appendCells

object (AppendCellsRequest)

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

clearBasicFilter

object (ClearBasicFilterRequest)

Usuwa podstawowy filtr 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 filtra z arkusza.

duplicateFilterView

object (DuplicateFilterViewRequest)

Duplikuje widok filtra.

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

deleteRange

object (DeleteRangeRequest)

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

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 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 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 co najmniej jedno źródło danych i powiązane z nim obiekty bazy danych.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

Anuluje odświeżanie co najmniej 1 ź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 podawać. 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,

  // 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 1 pole. Katalog główny properties jest domyślny i nie należy go podawać. 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)

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

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

Zapis JSON
{
  "range": {
    object (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 podawać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

AddNamedRangeRequest

Dodaje do arkusza kalkulacyjnego nazwany zakres.

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

object (NamedRange)

Nazwany zakres 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 nazwany zakres 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 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ż 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ść „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, wykryje lokalizację, która zawiera dane, i automatycznie wypełni nimi pozostałą część 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 i reguły sprawdzania poprawności danych.
PASTE_NO_BORDERS Podobnie jak PASTE_NORMAL ale bez obramowań.
PASTE_FORMULA Wklej tylko formuły.
PASTE_DATA_VALIDATION Wklej tylko reguły sprawdzania poprawności danych.
PASTE_CONDITIONAL_FORMATTING Wklej tylko reguły formatowania warunkowego.

CopyPasteRequest

Kopiuje dane ze źródła do miejsca docelowego.

Zapis JSON
{
  "source": {
    object (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 scalanie z zakresu
MERGE_COLUMNS Utwórz scalenie dla każdej kolumny w zakresie.
MERGE_ROWS Utwórz scalanie dla każdego wiersza w zakresie

UnmergeCellsRequest

Rozdziela komórki w danym zakresie.

Zapis JSON
{
  "range": {
    object (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 }

W rezultacie komórki A1:A5 będą miały obramowanie { top: RED, bottom: WHITE, left: BLUE }. Jeśli chcesz usunąć obramowanie, ustaw styl na NONE.

Zapis JSON
{
  "range": {
    object (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ę znajdować w zakresie.

UpdateCellsRequest

Aktualizuje wszystkie komórki w zakresie nowymi danymi.

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 CellData, które powinny zostać zaktualizowane. Musisz określić co najmniej 1 pole. Elementem głównym jest CellData. Nie należy określać „row.values.”. Pojedynczy znak "*" 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 jedną 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 wpisać 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 filtra.

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,

  // Union field area can be only one of the following:
  "tableId": string
  // End of list of possible types for union field area.
}
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. Nie należy określać „row.values.”. 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 filtra.

Zapis JSON
{
  "filterId": integer
}
Pola
filterId

integer

Identyfikator filtra do usunięcia.

DuplicateFilterViewRequest

Duplikuje określony widok filtra.

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ązywana 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 wsadowego.

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, nie może być ujemna.

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,

  // 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ść, która ma zastąpić poprzednią.

matchCase

boolean

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

matchEntireCell

boolean

Wartość PRAWDA, jeśli szukana wartość ma być zgodna z całą komórką.

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

includeFormulas

boolean

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

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

object (GridRange)

Zakres, w którym ma nastąpić wyszukiwanie i zamiana.

sheetId

integer

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

allSheets

boolean

Wartość PRAWDA, jeśli chcesz wyszukać i zamienić tekst we wszystkich arkuszach.

InsertDimensionRequest

Wstawia wiersze lub kolumny w arkuszu w określonym indeksie.

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

object (DimensionRange)

Wymiary do wstawienia. Indeksy początkowy 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” – 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, utworzony zostanie nowy arkusz z tym identyfikatorem. Jeśli parametr newPosition.newSheet ma wartość „true”, zostanie utworzony nowy arkusz z wybranym 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 podawać. 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),

  // 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, 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 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 1 pole. Katalog główny filter jest domyślny i nie należy go podawać. 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 pod podanym indeksem lub przenosi ją na inny indeks.

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 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), w którym powinna się znaleźć reguła.

DeleteConditionalFormatRuleRequest

Usuwa regułę formatowania warunkowego o podanym indeksie. Indeksy wszystkich kolejnych reguł są zmniejszane.

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

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 podawania 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 odfiltrowanych 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 podawać. 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
{

  // 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 zbiorczedimension_range. Zakres wymiarów. dimension_range może mieć tylko jedną z tych wartości:
dimensions

object (DimensionRange)

Wymiary, które mają być automatycznie zmieniane.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Wymiary w arkuszu źródła danych, które mają być automatycznie zmieniane.

AddChartRequest

Dodaje wykres do arkusza w arkuszu kalkulacyjnym.

Zapis JSON
{
  "chart": {
    object (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 spowoduje 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 pasmowego.

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 podawać. 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 pasmowego 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, który pasuje 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 podawać. 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 zakresie B:E i grupę poziomu 2 w zakresie C:D. Usunięcie grupy obejmującej zakres D:E spowoduje, że arkusz będzie zawierać grupę poziomu 1 obejmującą zakres B:D i grupę poziomu 2 obejmującą zakres C:C.

Zapis JSON
{
  "range": {
    object (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 podawać. 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 redukuje wszystkie kolejne znaki odstępu do pojedynczej spacji. Jeśli wynikowy przycięty tekst zaczyna się od znaku „+” lub „=”, pozostaje on wartością tekstową i nie jest interpretowany jako formuła.

Zapis JSON
{
  "range": {
    object (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 z dowolnego poprzedniego wiersza. Wiersze z identycznymi wartościami, które różnią się wielkością liter, formatowaniem lub formułami, są uznawane za duplikaty.

Ta prośba usuwa też zduplikowane wiersze ukryte w widoku (np. z powodu filtra). Podczas usuwania duplikatów w zakresie wynikowym zachowywane jest pierwsze wystąpienie każdego zduplikowanego wiersza (skanowanie od góry do dołu). Treści spoza określonego zakresu nie zostaną usunięte, a wiersze uznane za duplikaty nie muszą sąsiadować ze sobą w zakresie.

Zapis JSON
{
  "range": {
    object (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 podawać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

AddSlicerRequest

Dodaje do arkusza w arkuszu kalkulacyjnym selektor.

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

object (Slicer)

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

UpdateSlicerSpecRequest

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

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

integer

Identyfikator fragmentu do zaktualizowania.

spec

object (SlicerSpec)

Specyfikacja, która ma zostać zastosowana do narzędzia do cięcia.

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 podawać. 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 odświeżanie arkusza w celu odczytania danych ze źródła.

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

Zapis JSON
{
  "dataSource": {
    object (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 arkuszDATA_SOURCE, aby odczytać dane ze zaktualizowanego źródła danych.

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

Zapis JSON
{
  "dataSource": {
    object (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 podawać. 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 wymagany jest dodatkowy zakres OAuth:bigquery.readonly

Jeśli w jednej partii znajduje się kilka żądań odświeżenia odwołujących się do tych samych obiektów źródła danych, przetwarzane jest tylko ostatnie żądanie odświeżenia, a wszystkie te żądania będą miały odpowiednio tę samą odpowiedź.

Zapis JSON
{
  "force": boolean,

  // Union field 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 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.

DataSourceObjectReference

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 zbiorczevalue. Typ pliku referencyjnego. value może mieć 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łania do elementu 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.

CancelDataSourceRefreshRequest

Anuluje jedno lub kilka odświeżeń obiektów źródła danych w arkuszu kalkulacyjnym według określonych odwołań.

W przypadku anulowania odświeżania źródła danych BigQuery wymagany jest dodatkowy zakres OAuth:bigquery.readonly

Zapis JSON
{

  // Union field 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
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 zostanie określony, 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 podawać. 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.