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)
  }
  // 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)

加入新的頻帶範圍
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)

重新整理一或多個資料來源和相關 db 物件。
cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

取消一或多個資料來源和相關 db 物件的重新整理作業。

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 欄位中列出的欄位，其他欄位則維持不變。

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

如要讓公式的範圍保持靜態，請使用 $ 指標。舉例來說，使用公式 =$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.sheetId 或 EmbeddedObjectPosition.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

如果應使用「alternate」序列產生資料，則為 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
}
欄位
sheetId

integer

要附加資料的工作表 ID。

rows[]

object (RowData)

要附加的資料。

fields

string (FieldMask format)

要更新的 CellData 欄位。至少須指定一個欄位。根為 CellData；不應指定「row.values.」。您可以使用單一 "*" 做為列出所有欄位的簡短訊息。

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。規則運算式和取代項目應遵循位於 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html 的 Java 規則運算式規則。取代字串可以參照擷取群組。舉例來說，如果某個儲存格含有 "Google Sheets" 內容，而另一個儲存格含有 "Google Docs"，則使用 "$1 Rocks" 取代搜尋 "o.* (.*)" 就會將儲存格的內容分別變更為 "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 為紅色，則兩個新的資料列會變成綠色 (因為插入點之後的列會顯示為綠色)。

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

來源資料移動位置 (從 0 開始) 索引 (以「先」表示來源資料從格線中移除)。現有資料會向下或向右移 (視維度而定)，以騰出空間來容納移動的維度。來源維度會從網格中移除，因此資料可能會放入與指定的索引不同的索引。

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

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

要使用的分隔符號。只有在 分隔符號 Type 為 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)
  }
}
欄位
range

object (GridRange)

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

object (DataValidationRule)

要為範圍中每個儲存格設定的資料驗證規則，留空則表示清除範圍中每個儲存格的資料驗證作業。

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 資源中提供的值。呼叫端必須在欄位參數中指定想更新的屬性，以及至少指定一個與要更新的中繼資料相符的 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 深度一。舉例來說，[B:E, depth 1] + [C:D] 會得到群組 [B:E, depth 1] 和 [C:D, depth 2]。如果要求的範圍是從現有群組 G 的前後開始，或是結束於某個範圍後結束，那麼現有群組 G 的範圍就會成為範圍的聯集，新群組 G 的深度就大於 G 的深度，而範圍則是介於範圍的交集處。舉例來說，群組 [B:D, depth 1] + [C:E] 會產生 [B:E, depth 1] 和 [C:D, depth 2]。

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

object (DimensionRange)

建立群組的範圍。

DeleteDimensionGroupRequest

減少範圍內的維度深度，藉此刪除指定範圍內的群組。

舉例來說，假設工作表包含 B:E 的 深度-1 群組，以及 C:D 的深度-2 群組。刪除一個 D:E 的群組後，便離開工作表 (B:D 深度-1 群組)，深度 2 組則位於 C:C。

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。(指定現有的篩選器控制項 ID 會發生錯誤。)

UpdateSlicerSpecRequest

更新篩選器控制項的規格。(這項操作不會移動篩選器控制項或調整其大小。如要移動篩選器控制項或調整其大小，請使用 UpdateEmbeddedObjectPositionRequest。

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

integer

要更新的篩選器控制項 ID。
spec

object (SlicerSpec)

要套用至篩選器控制項的規格。
fields

string (FieldMask format)

要更新的欄位。至少須指定一個欄位。根層級 SlicerSpec 以隱含方式表示，不應指定。單一「*」可用來簡寫，列出每個欄位。

AddDataSourceRequest

新增資料來源。成功新增資料來源後，系統會建立相關聯的 DATA_SOURCE 工作表，並觸發執行作業來重新整理工作表，以便讀取資料來源中的資料。這項要求需要額外的 bigquery.readonly OAuth 範圍。

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

object (DataSource)

要新增的資料來源。

UpdateDataSourceRequest

更新資料來源。成功更新資料來源後，系統會觸發執行作業來重新整理相關聯的 DATA_SOURCE 工作表，以讀取更新過的資料來源資料。這項要求需要額外的 bigquery.readonly OAuth 範圍。

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

object (DataSource)

要更新的資料來源。
fields

string (FieldMask format)

要更新的欄位。至少須指定一個欄位。根層級 dataSource 以隱含方式表示，不應指定。您可以使用單一 "*" 做為列出所有欄位的簡短訊息。

DeleteDataSourceRequest

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

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

string

要刪除的資料來源 ID。

RefreshDataSourceRequest

依據指定的參照重新整理試算表中的一或多個資料來源物件。這項要求需要額外的 bigquery.readonly OAuth 範圍。

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

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

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

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

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