Requests

要求

要套用至試算表的單一更新類型。

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.
}
欄位
聯集欄位 kind。更新類型。必須只填寫一個欄位。 kind 只能是下列其中一項:
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)

將資料 (HTML 或分隔符號) 貼到試算表中。

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)

Adds a new banded range

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)

更新 Slicer 的規格。

addDataSource

object (AddDataSourceRequest)

新增資料來源。

updateDataSource

object (UpdateDataSourceRequest)

更新資料來源。

deleteDataSource

object (DeleteDataSourceRequest)

刪除資料來源。

refreshDataSource

object (RefreshDataSourceRequest)

重新整理一或多個資料來源和相關聯的 dbobject。

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

取消一或多個資料來源和相關聯 dbobject 的重新整理。

addTable

object (AddTableRequest)

新增表格。

updateTable

object (UpdateTableRequest)

更新資料表。

deleteTable

object (DeleteTableRequest)

要求刪除資料表。

UpdateSpreadsheetPropertiesRequest

更新試算表的屬性。

JSON 表示法
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
欄位
properties

object (SpreadsheetProperties)

要更新的屬性。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。系統會隱含根層級的「properties」,因此不應指定。單一 "*" 可做為列出每個欄位的簡寫。

UpdateSheetPropertiesRequest

使用指定的 sheetId 更新工作表的屬性。

JSON 表示法
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
欄位
properties

object (SheetProperties)

要更新的屬性。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 properties 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

UpdateDimensionPropertiesRequest

更新指定範圍內維度的屬性。

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.
}
欄位
properties

object (DimensionProperties)

要更新的屬性。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 properties 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

聯集欄位 dimension_range。維度範圍。 dimension_range 只能是下列其中一項:
range

object (DimensionRange)

要更新的列或欄。

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

要更新的資料來源工作表欄。

DataSourceSheetDimensionRange

工作表上單一維度的範圍。DATA_SOURCE

JSON 表示法
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
欄位
sheetId

integer

範圍所在的資料來源工作表 ID。

columnReferences[]

object (DataSourceColumnReference)

資料來源工作表中的資料欄。

UpdateNamedRangeRequest

使用指定屬性更新已命名範圍的屬性。namedRangeId

JSON 表示法
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
欄位
namedRange

object (NamedRange)

要使用新屬性更新的具名範圍。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 namedRange 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

RepeatCellRequest

將範圍內的所有儲存格更新為指定 Cell 物件中的值。系統只會更新 fields 欄位中列出的欄位,其他欄位則維持不變。

如果使用公式寫入儲存格,公式的範圍會自動遞增,適用於範圍內的每個欄位。舉例來說,如果將含有公式的儲存格寫入 B2:C4 範圍,B2 會是 =A1,B3 會是 =A2,B4 會是 =A3,C2 會是 =B1,C3 會是 =B2,C4 會是 =B3=A1

如要讓公式的範圍保持靜態,請使用 $ 指標。舉例來說,使用 =$A$1 公式可避免遞增列和欄。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
欄位
range

object (GridRange)

要重複儲存格的範圍。

cell

object (CellData)

要寫入的資料。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 cell 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

AddNamedRangeRequest

在試算表中新增具名範圍。

JSON 表示法
{
  "namedRange": {
    object (NamedRange)
  }
}
欄位
namedRange

object (NamedRange)

要新增的已命名範圍。namedRangeId 欄位為選填,如未設定,系統會隨機產生 ID。(指定已存在範圍的 ID 會發生錯誤)。

DeleteNamedRangeRequest

從試算表中移除具有指定 ID 的具名範圍。

JSON 表示法
{
  "namedRangeId": string
}
欄位
namedRangeId

string

要刪除的已命名範圍 ID。

AddSheetRequest

新增工作表。在特定索引位置新增工作表時,後續所有工作表的索引都會遞增。如要新增物件工作表,請改用 AddChartRequest,並指定 EmbeddedObjectPosition.sheetIdEmbeddedObjectPosition.newSheet

JSON 表示法
{
  "properties": {
    object (SheetProperties)
  }
}
欄位
properties

object (SheetProperties)

新工作表應具備的屬性。所有屬性皆為選填。sheetId 欄位為選填,如未設定,系統會隨機產生 ID。(指定現有工作表的 ID 會導致錯誤)。

DeleteSheetRequest

刪除要求的工作表。

JSON 表示法
{
  "sheetId": integer
}
欄位
sheetId

integer

要刪除的工作表 ID。

如果工作表屬於 DATA_SOURCE 類型,系統也會一併刪除相關的 DataSource

AutoFillRequest

根據現有資料填入更多資料。

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.
}
欄位
useAlternateSeries

boolean

如果應使用「替代」系列產生資料,則為 True。這會因來源資料的類型和數量而異。

聯集欄位 area。要自動填入的區域。 area 只能是下列其中一項:
range

object (GridRange)

要自動填入的範圍。這項功能會檢查範圍並偵測有資料的位置,然後自動將資料填入範圍中的其餘位置。

sourceAndDestination

object (SourceAndDestination)

要自動填入的來源和目的地區域。這會明確列出自動填入的來源,以及要擴充該資料的位置。

SourceAndDestination

來源範圍和擴充來源的方式組合。

JSON 表示法
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
欄位
source

object (GridRange)

做為自動填入來源的資料位置。

dimension

enum (Dimension)

要填入資料的維度。

fillLength

integer

要填入資料的列數或欄數。正數會超出來源的最後一列或最後一欄。負數會擴展到來源的第一列或第一欄之前。

CutPasteRequest

將資料從來源移至目的地。

JSON 表示法
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
欄位
source

object (GridRange)

要剪下的來源資料。

destination

object (GridCoordinate)

要貼上資料的左上角座標。

pasteType

enum (PasteType)

要貼上的資料類型。無論貼上什麼內容,系統都會剪下所有來源資料。

PasteType

要貼上哪種資料。

列舉
PASTE_NORMAL 貼上值、公式、格式和合併儲存格。
PASTE_VALUES 僅貼上值,不貼上格式、公式或合併。
PASTE_FORMAT 僅貼上格式和資料驗證規則。
PASTE_NO_BORDERS 類似 PASTE_NORMAL ,但沒有邊框。
PASTE_FORMULA 僅貼上公式。
PASTE_DATA_VALIDATION 僅貼上資料驗證規則。
PASTE_CONDITIONAL_FORMATTING 僅貼上條件式格式設定規則。

CopyPasteRequest

將資料從來源複製到目的地。

JSON 表示法
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
欄位
source

object (GridRange)

要複製的來源範圍。

destination

object (GridRange)

要貼上的位置。如果範圍涵蓋的跨度是來源高度或寬度的倍數,系統就會重複資料來填滿目的地範圍。如果範圍小於來源範圍,系統仍會複製整個來源資料 (超出目的地範圍的結尾)。

pasteType

enum (PasteType)

要貼上的資料類型。

pasteOrientation

enum (PasteOrientation)

貼上時資料的顯示方向。

PasteOrientation

貼上作業的執行方式。

列舉
NORMAL 照常貼上。
TRANSPOSE 貼上轉置資料,所有列會變成欄,反之亦然。

MergeCellsRequest

合併範圍內的所有儲存格。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
欄位
range

object (GridRange)

要合併的儲存格範圍。

mergeType

enum (MergeType)

儲存格的合併方式。

MergeType

要建立的合併類型。

列舉
MERGE_ALL 從範圍建立單一合併
MERGE_COLUMNS 為範圍中的每個資料欄建立合併
MERGE_ROWS 為範圍中的每個資料列建立合併

UnmergeCellsRequest

取消合併指定範圍內的儲存格。

JSON 表示法
{
  "range": {
    object (GridRange)
  }
}
欄位
range

object (GridRange)

所有儲存格應取消合併的範圍。如果範圍涵蓋多個合併作業,系統會取消合併所有作業。範圍不得部分跨越任何合併儲存格。

UpdateBordersRequest

更新範圍的邊界。如果要求中未設定欄位,表示邊框維持不變。舉例來說,如果連續發出兩項 UpdateBordersRequest:

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

這樣一來,A1:A5 的邊框就會變成 { top: RED, bottom: WHITE, left: BLUE }。如要清除邊框,請明確將樣式設為 NONE

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
欄位
range

object (GridRange)

要更新框線的範圍。

top

object (Border)

要放在範圍頂端的邊框。

bottom

object (Border)

要放在範圍底部的邊框。

left

object (Border)

要放在範圍左側的框線。

right

object (Border)

要放在範圍右側的邊框。

innerHorizontal

object (Border)

要放在範圍內的水平邊界。

innerVertical

object (Border)

要放在範圍內的垂直邊界。

UpdateCellsRequest

使用新資料更新範圍內的所有儲存格。

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.
}
欄位
rows[]

object (RowData)

要寫入的資料。

fields

string (FieldMask format)

應更新的 CellData 欄位。至少須指定一個欄位。根目錄是 CellData,不應指定「row.values.」。單一 "*" 可做為列出每個欄位的簡寫。

聯集欄位 area。位置資料應寫入。必須設定一個值。 area 只能是下列其中一項:
start

object (GridCoordinate)

開始寫入資料的座標。可寫入任意數量的列和欄 (包括每列的欄數不同)。

range

object (GridRange)

要寫入資料的範圍。

如果資料列未涵蓋整個要求範圍,系統會清除與 fields 中設定相符的欄位。

AddFilterViewRequest

新增篩選器檢視畫面。

JSON 表示法
{
  "filter": {
    object (FilterView)
  }
}
欄位
filter

object (FilterView)

要新增的篩選器。filterViewId 為選填欄位。如未設定,系統會隨機產生 ID。(指定現有篩選器的 ID 會導致錯誤)。

AppendCellsRequest

在試算表最後一個有資料的資料列後方新增儲存格,並視需要在試算表中插入新資料列。

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.
}
欄位
sheetId

integer

要附加資料的工作表 ID。

rows[]

object (RowData)

要附加的資料。

fields

string (FieldMask format)

應更新的 CellData 欄位。至少須指定一個欄位。根目錄是 CellData,不應指定「row.values.」。單一 "*" 可做為列出每個欄位的簡寫。

聯集欄位 area。應寫入位置資料。 area 只能是下列其中一項:
tableId

string

要附加資料的資料表 ID。資料只會附加至表格主體。

這個欄位的優先順序也高於 sheetId 欄位。

ClearBasicFilterRequest

清除工作表上的基本篩選器 (如有)。

JSON 表示法
{
  "sheetId": integer
}
欄位
sheetId

integer

要清除基本篩選器的試算表 ID。

DeleteDimensionRequest

從工作表刪除維度。

JSON 表示法
{
  "range": {
    object (DimensionRange)
  }
}
欄位
range

object (DimensionRange)

要從工作表刪除的維度。

DeleteEmbeddedObjectRequest

刪除具有指定 ID 的內嵌物件。

JSON 表示法
{
  "objectId": integer
}
欄位
objectId

integer

要刪除的內嵌物件 ID。

DeleteFilterViewRequest

刪除特定篩選器檢視畫面。

JSON 表示法
{
  "filterId": integer
}
欄位
filterId

integer

要刪除的篩選器 ID。

DuplicateFilterViewRequest

複製特定篩選器檢視畫面。

JSON 表示法
{
  "filterId": integer
}
欄位
filterId

integer

要複製的篩選器 ID。

DuplicateSheetRequest

複製工作表內容。

JSON 表示法
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
欄位
sourceSheetId

integer

要複製的工作表。

如果來源工作表是 DATA_SOURCE 類型,系統也會複製其支援 DataSource,並與新的工作表副本建立關聯。系統不會觸發任何資料執行作業,也會複製這個工作表的格線資料,但只有在批次要求完成後才能使用。

insertSheetIndex

integer

新工作表的插入位置,從零開始。之後所有工作表的索引都會遞增。

newSheetId

integer

如果已設定,則為新工作表的 ID。如未設定,系統會選擇 ID。如果設定了 ID,就不得與任何現有工作表 ID 衝突。如果設定,則不得為負值。

newSheetName

string

新工作表的名稱,如果留空,系統會為你選擇新名稱。

FindReplaceRequest

在範圍、工作表或所有工作表中尋找及取代儲存格中的資料。

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.
}
欄位
find

string

要搜尋的值。

replacement

string

要用來做為替代的值。

matchCase

boolean

如果搜尋區分大小寫,則為 True。

matchEntireCell

boolean

如果尋找值應與整個儲存格相符,則為 True。

searchByRegex

boolean

如果搜尋值是規則運算式,則為 True。規則運算式和取代項目應遵循 Java 規則運算式規則,詳情請參閱 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html。取代字串可參照擷取群組。舉例來說,如果一個儲存格的內容為 "Google Sheets" ,另一個儲存格的內容為 "Google Docs",則搜尋 "o.* (.*)" 並將其取代為 "$1 Rocks" 後,儲存格內容會分別變更為 "GSheets Rocks""GDocs Rocks"

includeFormulas

boolean

如果搜尋範圍應包含含有公式的儲存格,則為 True。如果為 False,則會略過內含公式的儲存格。

聯集欄位 scope。要尋找/取代的範圍,必須設定一個且只能設定一個。 scope 只能是下列其中一項:
range

object (GridRange)

要尋找/取代的範圍。

sheetId

integer

要尋找/取代的試算表。

allSheets

boolean

True:在所有工作表中尋找/取代。

InsertDimensionRequest

在工作表的特定索引處插入列或欄。

JSON 表示法
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
欄位
range

object (DimensionRange)

要插入的維度。起始和結束索引都必須有界限。

inheritFromBefore

boolean

是否應從新插入維度前後的維度擴充維度屬性。如要從先前的維度繼承,請設為 True (在這種情況下,起始索引必須大於 0);如要從後續維度繼承,請設為 False。

舉例來說,如果列索引 0 的背景為紅色,列索引 1 的背景為綠色,則在索引 1 插入 2 列時,可能會沿用綠色或紅色背景。如果 inheritFromBefore 為 true,則兩個新資料列會是紅色 (因為插入點前的資料列為紅色);如果 inheritFromBefore 為 false,則兩個新資料列會是綠色 (因為插入點後的資料列為綠色)。

InsertRangeRequest

在範圍中插入儲存格,並將現有儲存格往右或往下移動。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
欄位
range

object (GridRange)

要插入新儲存格的範圍。範圍會限制在目前工作表邊界內。

shiftDimension

enum (Dimension)

插入儲存格時要移動的維度。如果 ROWS,現有儲存格會向下移動。如果 COLUMNS,現有儲存格會向右移動。

MoveDimensionRequest

移動一或多個資料列或資料欄。

JSON 表示法
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
欄位
source

object (DimensionRange)

要移動的來源維度。

destinationIndex

integer

以零為基準的起始索引,表示要將來源資料移至何處,以來源資料從格線中移除「之前」的座標為準。現有資料會向下或向右移動 (視維度而定),為移動的維度騰出空間。來源維度會從格線中移除,因此資料可能會出現在指定的索引以外。

舉例來說,假設有 A1..A5,且想要將 "1""2" 移至 "3""4" 之間,則來源會是 ROWS [1..3),目的地索引會是 "4" (第 5 列的從零開始索引)。0, 1, 2, 3, 4最終結果會是 A1..A50, 3, 1, 2, 4

UpdateEmbeddedObjectPositionRequest

更新內嵌物件的位置 (例如移動或調整圖表或圖片大小)。

JSON 表示法
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
欄位
objectId

integer

要移動的物件 ID。

newPosition

object (EmbeddedObjectPosition)

要將嵌入物件移至的明確位置。如果設定了 newPosition.sheetId,系統會建立具有該 ID 的新工作表。如果 newPosition.newSheet 設為 true,系統會建立新工作表,並為您選擇 ID。

fields

string (FieldMask format)

設定新位置時應更新的欄位。OverlayPosition只有在設定 newPosition.overlayPosition 時才會使用,且至少須指定一個欄位。根目錄 newPosition.overlayPosition 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

PasteDataRequest

將資料插入試算表,從指定座標開始。

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.
}
欄位
coordinate

object (GridCoordinate)

資料應開始插入的座標。

data

string

要插入的資料。

type

enum (PasteType)

資料的貼上方式。

聯集欄位 kind。如何解讀資料,必須設定一個值。 kind 只能是下列其中一項:
delimiter

string

資料中的分隔符號。

html

boolean

如果資料是 HTML,則為 True。

TextToColumnsRequest

根據每個儲存格中的分隔符號,將文字資料欄分割為多個資料欄。

JSON 表示法
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
欄位
source

object (GridRange)

來源資料範圍。這個範圍必須只跨越一個資料欄。

delimiter

string

要使用的分隔符號。只有在 delimiterType 為 CUSTOM 時才能使用。

delimiterType

enum (DelimiterType)

要使用的分隔符號類型。

DelimiterType

用來分割字串的分隔符號。

列舉
DELIMITER_TYPE_UNSPECIFIED 預設值。不得使用這個值。
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM 以分隔符號定義的自訂值。
AUTODETECT 自動偵測欄。

UpdateFilterViewRequest

更新篩選器檢視畫面的屬性。

JSON 表示法
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
欄位
filter

object (FilterView)

篩選器檢視畫面的新屬性。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 filter 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

DeleteRangeRequest

刪除儲存格範圍,並將其他儲存格移至已刪除的區域。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
欄位
range

object (GridRange)

要刪除的儲存格範圍。

shiftDimension

enum (Dimension)

系統會以這個維度取代已刪除的儲存格。如果 ROWS,現有儲存格會向上移動,取代已刪除的儲存格。如果 COLUMNS,現有儲存格會向左移動,取代已刪除的儲存格。

AppendDimensionRequest

在工作表結尾附加資料列或資料欄。

JSON 表示法
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
欄位
sheetId

integer

要附加資料列或資料欄的工作表。

dimension

enum (Dimension)

是否要附加列或欄。

length

integer

要附加的列數或欄數。

AddConditionalFormatRuleRequest

在指定索引處新增條件式格式規則。後續所有規則的索引都會遞增。

JSON 表示法
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
欄位
rule

object (ConditionalFormatRule)

要新增的規則。

index

integer

規則的插入位置,索引從零開始。

UpdateConditionalFormatRuleRequest

更新指定索引的條件式格式規則,或將條件式格式規則移至其他索引。

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.
}
欄位
index

integer

要取代或移動的規則索引,從零開始。

sheetId

integer

要移動的規則工作表。如果設定 newIndex,則為必要欄位;否則不使用。

聯集欄位 instruction。應執行的更新類型。 instruction 只能是下列其中一項:
rule

object (ConditionalFormatRule)

應取代指定索引處規則的規則。

newIndex

integer

規則應結束的索引,從零開始。

DeleteConditionalFormatRuleRequest

刪除指定索引的條件式格式規則。後續所有規則的索引都會遞減。

JSON 表示法
{
  "index": integer,
  "sheetId": integer
}
欄位
index

integer

要刪除的規則索引,從零開始。

sheetId

integer

要從中刪除規則的工作表。

SortRangeRequest

根據每個資料欄的排序順序,將資料列排序。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
欄位
range

object (GridRange)

要排序的範圍。

sortSpecs[]

object (SortSpec)

每個資料欄的排序順序。如果先前規格中的值相同,系統會使用後續規格。

SetDataValidationRequest

為範圍內的每個儲存格設定資料驗證規則。如要清除範圍內的驗證,請呼叫此函式,但不要指定任何規則。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
欄位
range

object (GridRange)

資料驗證規則應套用的範圍。

rule

object (DataValidationRule)

要在範圍內每個儲存格中設定的資料驗證規則,或空白 (清除範圍內的資料驗證)。

filteredRowsIncluded

boolean

(選用步驟) 如果為 true,資料驗證規則也會套用至經過篩選的資料列。

SetBasicFilterRequest

設定與工作表相關聯的基本篩選條件。

JSON 表示法
{
  "filter": {
    object (BasicFilter)
  }
}
欄位
filter

object (BasicFilter)

要設定的篩選器。

AddProtectedRangeRequest

新增受保護的範圍。

JSON 表示法
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
欄位
protectedRange

object (ProtectedRange)

要新增的受保護範圍。protectedRangeId 欄位為選填,如未設定,系統會隨機產生 ID。(指定已存在範圍的 ID 會發生錯誤)。

UpdateProtectedRangeRequest

使用指定的 protectedRangeId 更新現有的受保護範圍。

JSON 表示法
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
欄位
protectedRange

object (ProtectedRange)

要以新屬性更新的受保護範圍。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 protectedRange 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

DeleteProtectedRangeRequest

刪除具有指定 ID 的受保護範圍。

JSON 表示法
{
  "protectedRangeId": integer
}
欄位
protectedRangeId

integer

要刪除的受保護範圍 ID。

AutoResizeDimensionsRequest

根據該維度中儲存格的內容,自動調整一或多個維度的大小。

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.
}
欄位
聯集欄位 dimension_range。維度範圍。 dimension_range 只能是下列其中一項:
dimensions

object (DimensionRange)

要自動調整大小的維度。

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

資料來源工作表上的維度,可自動調整大小。

AddChartRequest

在試算表的工作表中新增圖表。

JSON 表示法
{
  "chart": {
    object (EmbeddedChart)
  }
}
欄位
chart

object (EmbeddedChart)

要新增至試算表的圖表,包括放置位置。chartId 欄位為選填,如未設定,系統會隨機產生 ID。(指定已存在的內嵌物件 ID 會導致錯誤)。

UpdateChartSpecRequest

更新圖表的規格。(這不會移動圖表或調整圖表大小。如要移動或調整圖表大小,請使用 UpdateEmbeddedObjectPositionRequest

JSON 表示法
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
欄位
chartId

integer

要更新的圖表 ID。

spec

object (ChartSpec)

要套用至圖表的規格。

UpdateBandingRequest

更新所提供帶狀範圍的屬性。

JSON 表示法
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
欄位
bandedRange

object (BandedRange)

要以新屬性更新的帶狀範圍。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 bandedRange 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

AddBandingRequest

在試算表中新增帶狀範圍。

JSON 表示法
{
  "bandedRange": {
    object (BandedRange)
  }
}
欄位
bandedRange

object (BandedRange)

要新增的帶狀範圍。bandedRangeId 欄位為選填,如未設定,系統會隨機產生 ID。(指定已存在範圍的 ID 會發生錯誤)。

DeleteBandingRequest

從試算表中移除具有指定 ID 的帶狀範圍。

JSON 表示法
{
  "bandedRangeId": integer
}
欄位
bandedRangeId

integer

要刪除的帶狀範圍 ID。

CreateDeveloperMetadataRequest

建立開發人員中繼資料的要求。

JSON 表示法
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
欄位
developerMetadata

object (DeveloperMetadata)

要建立的開發人員中繼資料。

UpdateDeveloperMetadataRequest

要求更新開發人員中繼資料的屬性。根據篩選條件選取開發人員中繼資料,並將屬性更新為 DeveloperMetadata 資源中提供的值。呼叫端必須在 fields 參數中指定要更新的屬性,並指定至少一個DataFilter,與要更新的中繼資料相符。

JSON 表示法
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
欄位
dataFilters[]

object (DataFilter)

要更新的開發人員中繼資料項目所符合的篩選條件。

developerMetadata

object (DeveloperMetadata)

系統會將符合資料篩選條件的所有中繼資料值更新為這個值。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 developerMetadata 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

DeleteDeveloperMetadataRequest

要求刪除開發人員中繼資料。

JSON 表示法
{
  "dataFilter": {
    object (DataFilter)
  }
}
欄位
dataFilter

object (DataFilter)

資料篩選器,說明用於選取要刪除的開發人員中繼資料項目的條件。

RandomizeRangeRequest

隨機排列範圍內的資料列。

JSON 表示法
{
  "range": {
    object (GridRange)
  }
}
欄位
range

object (GridRange)

要隨機排序的範圍。

AddDimensionGroupRequest

在指定範圍內建立群組。

如果要求的範圍是現有群組 G 範圍的超集,則 G 的深度會遞增,而這個新群組 G' 的深度與該群組相同。舉例來說,群組 [C:D, depth 1] + [B:E] 會產生群組 [B:E, depth 1] 和 [C:D, depth 2]。如果要求的範圍是現有群組 G 範圍的子集,則新群組 G' 的深度會比 G 的深度多 1。舉例來說,群組 [B:E,深度 1] + [C:D] 會產生群組 [B:E,深度 1] 和 [C:D,深度 2]。如果要求的範圍在現有群組 G 的範圍之前開始,並在範圍內結束,或在範圍內開始並在範圍後結束,則現有群組 G 的範圍會成為範圍的聯集,而新群組 G' 的深度會比 G 的深度大一,範圍則為範圍的交集。舉例來說,群組 [B:D,深度 1] + [C:E] 會產生群組 [B:E,深度 1] 和 [C:D,深度 2]。

JSON 表示法
{
  "range": {
    object (DimensionRange)
  }
}
欄位
range

object (DimensionRange)

要建立群組的範圍。

DeleteDimensionGroupRequest

刪除指定範圍內的群組,方法是遞減範圍內維度的深度。

舉例來說,假設工作表在 B:E 範圍內有深度 1 的群組,在 C:D 範圍內有深度 2 的群組。如果刪除 D:E 上的群組,工作表會保留 B:D 上的深度 1 群組,以及 C:C 上的深度 2 群組。

JSON 表示法
{
  "range": {
    object (DimensionRange)
  }
}
欄位
range

object (DimensionRange)

要刪除的群組範圍。

UpdateDimensionGroupRequest

更新指定群組的狀態。

JSON 表示法
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
欄位
dimensionGroup

object (DimensionGroup)

要更新狀態的群組。群組的範圍和深度應指定試算表中的有效群組,並更新所有其他欄位。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 dimensionGroup 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

TrimWhitespaceRequest

會修剪指定範圍內每個儲存格的空白字元 (例如空格、定位點或換行符號)。這項要求會移除每個儲存格文字開頭和結尾的所有空格,並將所有後續的剩餘空格字元縮減為單一空格。如果修剪後的文字開頭是「+」或「=」字元,文字仍會是字串值,不會解讀為公式。

JSON 表示法
{
  "range": {
    object (GridRange)
  }
}
欄位
range

object (GridRange)

要修剪儲存格的範圍。

DeleteDuplicatesRequest

移除這個範圍內的資料列,這些資料列在指定資料欄中包含的值,與先前任何資料列中的值重複。只要資料列中的值相同,系統就會視其為重複項目,即使字母大小寫、格式或公式不同亦然。

這項要求也會移除檢視畫面中隱藏的重複資料列 (例如因篩選條件而隱藏的資料列)。移除重複項目時,系統會從上到下掃描,並將每個重複資料列的第一個例項保留在結果範圍中。指定範圍外的內容不會遭到移除,且系統不一定會移除範圍內相鄰的重複資料列。

JSON 表示法
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
欄位
range

object (GridRange)

要移除重複資料列的範圍。

comparisonColumns[]

object (DimensionRange)

要分析重複值的範圍內資料欄。如未選取資料欄,系統會分析所有資料欄是否有重複項目。

UpdateEmbeddedObjectBorderRequest

更新內嵌物件的邊框屬性。

JSON 表示法
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
欄位
objectId

integer

要更新的內嵌物件 ID。

border

object (EmbeddedObjectBorder)

套用至內嵌物件的邊框。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 border 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

AddSlicerRequest

在試算表的工作表中新增篩選器。

JSON 表示法
{
  "slicer": {
    object (Slicer)
  }
}
欄位
slicer

object (Slicer)

應新增至試算表的篩選器,包括篩選器的放置位置。slicerId 欄位為選填,如未設定,系統會隨機產生 ID。(指定現有 Slicer 的 ID 會導致錯誤)。

UpdateSlicerSpecRequest

更新 Slicer 的規格。(這不會移動或調整 Slicer 大小。如要移動或調整交叉分析篩選器大小,請使用 UpdateEmbeddedObjectPositionRequest

JSON 表示法
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
欄位
slicerId

integer

要更新的篩選器 ID。

spec

object (SlicerSpec)

要套用至切片器的規格。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 SlicerSpec 為隱含值,不應指定。單一「*」`可用於列出每個欄位。

AddDataSourceRequest

新增資料來源。成功新增資料來源後,系統會建立相關聯的 DATA_SOURCE 試算表,並觸發執行作業來重新整理試算表,從資料來源讀取資料。

如果您要新增 BigQuery 資料來源,要求需要額外的 bigquery.readonly OAuth 範圍。

JSON 表示法
{
  "dataSource": {
    object (DataSource)
  }
}
欄位
dataSource

object (DataSource)

要新增的資料來源。

UpdateDataSourceRequest

更新資料來源。資料來源更新成功後,系統會觸發執行作業,重新整理相關聯的 DATA_SOURCE 試算表,從更新後的資料來源讀取資料。

如果您要更新 BigQuery 資料來源,要求需要額外的 OAuth 範圍。bigquery.readonly

JSON 表示法
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
欄位
dataSource

object (DataSource)

要更新的資料來源。

fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根目錄 dataSource 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

DeleteDataSourceRequest

刪除資料來源。這項要求也會刪除相關聯的資料來源工作表,並取消連結所有相關聯的資料來源物件。

JSON 表示法
{
  "dataSourceId": string
}
欄位
dataSourceId

string

要刪除的資料來源 ID。

RefreshDataSourceRequest

根據指定參照,重新整理試算表中的一或多個資料來源物件。

如果您要重新整理 BigQuery 資料來源,要求需要額外的 OAuth 範圍。bigquery.readonly

如果一個批次中有多個參照相同資料來源物件的重新整理要求,系統只會處理最後一個要求,且所有要求都會收到相同的回應。

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.
}
欄位
force

boolean

無論目前狀態為何,都會重新整理資料來源物件。如果未設定,且參照的資料來源物件處於錯誤狀態,系統會立即停止重新整理。

聯集欄位 target。指定要重新整理的內容。 target 只能是下列其中一項:
references

object (DataSourceObjectReferences)

要重新整理的資料來源物件參考資料。

dataSourceId

string

參照 DataSource。如果指定,則會重新整理資料來源的所有相關聯資料來源物件。

isAll

boolean

重新整理試算表中所有現有的資料來源物件。

DataSourceObjectReferences

資料來源物件的參照清單。

JSON 表示法
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
欄位
references[]

object (DataSourceObjectReference)

參考資料。

DataSourceObjectReference

資料來源物件的參照。

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.
}
欄位
聯集欄位 value。參考類型。 value 只能是下列其中一項:
sheetId

string

參照工作表。DATA_SOURCE

chartId

integer

資料來源圖表的參照。

dataSourceTableAnchorCell

object (GridCoordinate)

參照錨定於儲存格的 DataSourceTable

dataSourcePivotTableAnchorCell

object (GridCoordinate)

參照資料來源 PivotTable 錨定於儲存格。

dataSourceFormulaCell

object (GridCoordinate)

參照包含 DataSourceFormula 的儲存格。

CancelDataSourceRefreshRequest

透過指定參照,取消試算表中一或多個資料來源物件的重新整理作業。

如要取消 BigQuery 資料來源的重新整理作業,要求必須具備額外的 OAuth 範圍。bigquery.readonly

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.
}
欄位
聯集欄位 target。指定要取消的項目。 target 只能是下列其中一項:
references

object (DataSourceObjectReferences)

要取消重新整理的資料來源物件參照。

dataSourceId

string

參照 DataSource。如果指定,則取消這個資料來源的所有相關資料來源物件重新整理。

isAll

boolean

取消試算表中所有資料來源的所有現有資料來源物件重新整理作業。

AddTableRequest

在試算表中新增表格。

JSON 表示法
{
  "table": {
    object (Table)
  }
}
欄位
table

object (Table)

必填。要新增的資料表。

UpdateTableRequest

更新試算表中的表格。

JSON 表示法
{
  "table": {
    object (Table)
  },
  "fields": string
}
欄位
table

object (Table)

必填。要更新的表格。

fields

string (FieldMask format)

必填。應更新的欄位。至少須指定一個欄位。根目錄 table 為隱含值,不應指定。單一 "*" 可做為列出每個欄位的簡寫。

DeleteTableRequest

從試算表中移除具有指定 ID 的表格。

JSON 表示法
{
  "tableId": string
}
欄位
tableId

string

要刪除的資料表 ID。