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)

新增區塊範圍
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)

移除儲存格中的空白字元 (例如空格、Tab 或換行符號)。

deleteDuplicates

object (DeleteDuplicatesRequest)

移除儲存格範圍中指定欄內含有重複值的資料列。

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

更新嵌入物件的邊框。
addSlicer

object (AddSlicerRequest)

新增篩選器。
updateSlicerSpec

object (UpdateSlicerSpecRequest)

更新切割器的規格。
addDataSource

object (AddDataSourceRequest)

新增資料來源。
updateDataSource

object (UpdateDataSourceRequest)

更新資料來源。
deleteDataSource

object (DeleteDataSourceRequest)

刪除資料來源。
refreshDataSource

object (RefreshDataSourceRequest)

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

object (CancelDataSourceRefreshRequest)

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

object (AddTableRequest)

新增表格。

updateTable

object (UpdateTableRequest)

更新資料表。
deleteTable

object (DeleteTableRequest)

刪除資料表的要求。

UpdateSpreadsheetPropertiesRequest

更新試算表的屬性。

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

object (SpreadsheetProperties)

要更新的房源屬性。
fields

string (FieldMask format)

應更新的欄位。至少須指定一個欄位。根「屬性」是隱含的，因此不應指定。單一 "*" 可用於列出每個欄位的簡寫。

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」系列產生資料，則為「是」。這會因來源資料的類型和數量而異。
聯集欄位 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。規則運算式和替換項目應遵循 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html 中的 Java 規則運算式規則。替換字串可參照擷取群組。舉例來說，如果一個儲存格有 "Google Sheets" 的內容，另一個儲存格有 "Google Docs"，則搜尋 "o.* (.*)" 並以 "$1 Rocks" 取代，會將儲存格的內容分別變更為 "GSheets Rocks" 和 "GDocs Rocks"。
includeFormulas

boolean

如果搜尋內容應包含含有公式的儲存格，則為 True。為 False 時，系統會略過含有公式的儲存格。
聯集欄位 scope。要尋找/取代的範圍。必須設定一個範圍，且只能設定一個範圍。scope 只能是下列其中一個：
range

object (GridRange)

要尋找/取代的範圍。
sheetId

integer

要進行尋找/取代的試算表。

allSheets

boolean

設為「是」時，系統會在所有工作表中執行尋找/取代作業。

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

以零為基底的起始索引，用於將來源資料移至指定位置，此索引會根據來源資料從格線中移除前的座標計算。現有資料會向下或向右移動 (視維度而定)，為移動的維度騰出空間。系統會從格線中移除來源維度，因此資料可能會出現在指定的不同索引中。

舉例來說，假設 0, 1, 2, 3, 4 的 A1..A5 是 ROWS [1..3)，而您想要將 "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

要使用的分隔符號。只有在 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 資源中提供的值。呼叫端必須在欄位參數中指定要更新的屬性，並指定至少一個與要更新的中繼資料相符的 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 的深度多 1，範圍則是範圍的交集。舉例來說，群組 [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 群組，以及 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

會修剪指定範圍中每個儲存格中的空白字元 (例如空格、tab 或換行符號)。這項要求會移除每個儲存格文字開頭和結尾的所有空格，並將任何剩餘的空白字元子序列縮減為單一空格。如果經過裁剪的文字開頭為「+」或「=」字元，則文字仍會保留為字串值，不會解讀為公式。

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 資料來源，請在要求中額外提供 bigquery.readonly OAuth 範圍。

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

object (DataSource)

要新增的資料來源。

UpdateDataSourceRequest

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

如果您要更新 BigQuery 資料來源，請在要求中額外提供 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 資料來源，請在要求中額外提供 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

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

如果您要取消 BigQuery 資料來源的重新整理作業，請在要求中額外提供 bigquery.readonly OAuth 範圍。

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。