要求
要套用至試算表的單一更新類型。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位
kind。更新類型。必須只填寫一個欄位。
kind
只能是下列其中一項:
|
|
updateSpreadsheetProperties
|
更新試算表的屬性。 |
updateSheetProperties
|
更新工作表的屬性。 |
updateDimensionProperties
|
更新維度的屬性。 |
updateNamedRange
|
更新已命名範圍。 |
repeatCell
|
在範圍內重複單一儲存格。 |
addNamedRange
|
新增具名範圍。 |
deleteNamedRange
|
刪除已命名範圍。 |
addSheet
|
新增工作表。 |
deleteSheet
|
刪除工作表。 |
autoFill
|
根據現有資料自動填入更多資料。 |
cutPaste
|
將資料從一個區域剪下並貼到另一個區域。 |
copyPaste
|
從一個區域複製資料,然後貼到另一個區域。 |
mergeCells
|
合併儲存格。 |
unmergeCells
|
取消合併儲存格。 |
updateBorders
|
更新儲存格範圍內的框線。 |
updateCells
|
一次更新多個儲存格。 |
addFilterView
|
新增篩選器檢視畫面。 |
appendCells
|
在工作表最後一列資料後附加儲存格。 |
clearBasicFilter
|
清除工作表的基本篩選器。 |
deleteDimension
|
刪除試算表中的列或欄。 |
deleteEmbeddedObject
|
刪除試算表中的嵌入物件 (例如圖表、圖片)。 |
deleteFilterView
|
從工作表中刪除篩選器檢視畫面。 |
duplicateFilterView
|
複製篩選器檢視畫面。 |
duplicateSheet
|
複製工作表。 |
findReplace
|
尋找並將某些文字取代為其他文字。 |
insertDimension
|
在試算表中插入新列或欄。 |
insertRange
|
在工作表中插入新儲存格,並移動現有儲存格。 |
moveDimension
|
將資料列或資料欄移至試算表中的其他位置。 |
updateEmbeddedObjectPosition
|
更新內嵌物件 (例如圖表、圖片) 的位置。 |
pasteData
|
將資料 (HTML 或分隔符號) 貼到試算表中。 |
textToColumns
|
將文字欄轉換成多個文字欄。 |
updateFilterView
|
更新篩選器檢視畫面的屬性。 |
deleteRange
|
從工作表中刪除儲存格範圍,並移動其餘儲存格。 |
appendDimension
|
在工作表結尾附加維度。 |
addConditionalFormatRule
|
新增條件式格式規則。 |
updateConditionalFormatRule
|
更新現有的條件式格式規則。 |
deleteConditionalFormatRule
|
刪除現有的條件式格式規則。 |
sortRange
|
排序範圍中的資料。 |
setDataValidation
|
為一或多個儲存格設定資料驗證。 |
setBasicFilter
|
在工作表上設定基本篩選器。 |
addProtectedRange
|
新增受保護的範圍。 |
updateProtectedRange
|
更新受保護的範圍。 |
deleteProtectedRange
|
刪除受保護的範圍。 |
autoResizeDimensions
|
根據該維度中儲存格的內容,自動調整一或多個維度的大小。 |
addChart
|
新增圖表。 |
updateChartSpec
|
更新圖表的規格。 |
updateBanding
|
更新帶狀範圍 |
addBanding
|
Adds a new banded range |
deleteBanding
|
移除帶狀範圍 |
createDeveloperMetadata
|
建立新的開發人員中繼資料 |
updateDeveloperMetadata
|
更新現有的開發人員中繼資料項目 |
deleteDeveloperMetadata
|
刪除開發人員中繼資料 |
randomizeRange
|
隨機排列範圍內的資料列。 |
addDimensionGroup
|
在指定範圍內建立群組。 |
deleteDimensionGroup
|
刪除指定範圍內的群組。 |
updateDimensionGroup
|
更新指定群組的狀態。 |
trimWhitespace
|
移除儲存格中的空白字元 (例如空格、定位點或換行符號)。 |
deleteDuplicates
|
移除儲存格範圍中指定資料欄含有重複值的資料列。 |
updateEmbeddedObjectBorder
|
更新內嵌物件的邊框。 |
addSlicer
|
新增篩選器。 |
updateSlicerSpec
|
更新 Slicer 的規格。 |
addDataSource
|
新增資料來源。 |
updateDataSource
|
更新資料來源。 |
deleteDataSource
|
刪除資料來源。 |
refreshDataSource
|
重新整理一或多個資料來源和相關聯的 dbobject。 |
cancelDataSourceRefresh
|
取消一或多個資料來源和相關聯 dbobject 的重新整理。 |
addTable
|
新增表格。 |
updateTable
|
更新資料表。 |
deleteTable
|
要求刪除資料表。 |
UpdateSpreadsheetPropertiesRequest
更新試算表的屬性。
| JSON 表示法 |
|---|
{
"properties": {
object ( |
| 欄位 | |
|---|---|
properties
|
要更新的屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。系統會隱含根層級的「properties」,因此不應指定。單一 |
UpdateSheetPropertiesRequest
使用指定的 sheetId 更新工作表的屬性。
| JSON 表示法 |
|---|
{
"properties": {
object ( |
| 欄位 | |
|---|---|
properties
|
要更新的屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
UpdateDimensionPropertiesRequest
更新指定範圍內維度的屬性。
| JSON 表示法 |
|---|
{ "properties": { object ( |
| 欄位 | |
|---|---|
properties
|
要更新的屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
聯集欄位
dimension_range。維度範圍。
dimension_range
只能是下列其中一項:
|
|
range
|
要更新的列或欄。 |
dataSourceSheetRange
|
要更新的資料來源工作表欄。 |
DataSourceSheetDimensionRange
工作表上單一維度的範圍。DATA_SOURCE
| JSON 表示法 |
|---|
{
"sheetId": integer,
"columnReferences": [
{
object ( |
| 欄位 | |
|---|---|
sheetId
|
範圍所在的資料來源工作表 ID。 |
columnReferences[]
|
資料來源工作表中的資料欄。 |
UpdateNamedRangeRequest
使用指定屬性更新已命名範圍的屬性。namedRangeId
| JSON 表示法 |
|---|
{
"namedRange": {
object ( |
| 欄位 | |
|---|---|
namedRange
|
要使用新屬性更新的具名範圍。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
RepeatCellRequest
將範圍內的所有儲存格更新為指定 Cell 物件中的值。系統只會更新 fields 欄位中列出的欄位,其他欄位則維持不變。
如果使用公式寫入儲存格,公式的範圍會自動遞增,適用於範圍內的每個欄位。舉例來說,如果將含有公式的儲存格寫入 B2:C4 範圍,B2 會是 =A1,B3 會是 =A2,B4 會是 =A3,C2 會是 =B1,C3 會是 =B2,C4 會是 =B3。
=A1
如要讓公式的範圍保持靜態,請使用 $ 指標。舉例來說,使用 =$A$1 公式可避免遞增列和欄。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要重複儲存格的範圍。 |
cell
|
要寫入的資料。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
AddNamedRangeRequest
在試算表中新增具名範圍。
| JSON 表示法 |
|---|
{
"namedRange": {
object ( |
| 欄位 | |
|---|---|
namedRange
|
要新增的已命名範圍。 |
DeleteNamedRangeRequest
從試算表中移除具有指定 ID 的具名範圍。
| JSON 表示法 |
|---|
{ "namedRangeId": string } |
| 欄位 | |
|---|---|
namedRangeId
|
要刪除的已命名範圍 ID。 |
AddSheetRequest
新增工作表。在特定索引位置新增工作表時,後續所有工作表的索引都會遞增。如要新增物件工作表,請改用 AddChartRequest,並指定 EmbeddedObjectPosition.sheetId 或 EmbeddedObjectPosition.newSheet。
| JSON 表示法 |
|---|
{
"properties": {
object ( |
| 欄位 | |
|---|---|
properties
|
新工作表應具備的屬性。所有屬性皆為選填。 |
DeleteSheetRequest
刪除要求的工作表。
| JSON 表示法 |
|---|
{ "sheetId": integer } |
| 欄位 | |
|---|---|
sheetId
|
要刪除的工作表 ID。
如果工作表屬於 |
AutoFillRequest
根據現有資料填入更多資料。
| JSON 表示法 |
|---|
{ "useAlternateSeries": boolean, // Union field |
| 欄位 | |
|---|---|
useAlternateSeries
|
如果應使用「替代」系列產生資料,則為 True。這會因來源資料的類型和數量而異。 |
聯集欄位
area。要自動填入的區域。
area
只能是下列其中一項:
|
|
range
|
要自動填入的範圍。這項功能會檢查範圍並偵測有資料的位置,然後自動將資料填入範圍中的其餘位置。 |
sourceAndDestination
|
要自動填入的來源和目的地區域。這會明確列出自動填入的來源,以及要擴充該資料的位置。 |
SourceAndDestination
來源範圍和擴充來源的方式組合。
| JSON 表示法 |
|---|
{ "source": { object ( |
| 欄位 | |
|---|---|
source
|
做為自動填入來源的資料位置。 |
dimension
|
要填入資料的維度。 |
fillLength
|
要填入資料的列數或欄數。正數會超出來源的最後一列或最後一欄。負數會擴展到來源的第一列或第一欄之前。 |
CutPasteRequest
將資料從來源移至目的地。
| JSON 表示法 |
|---|
{ "source": { object ( |
| 欄位 | |
|---|---|
source
|
要剪下的來源資料。 |
destination
|
要貼上資料的左上角座標。 |
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 ( |
| 欄位 | |
|---|---|
source
|
要複製的來源範圍。 |
destination
|
要貼上的位置。如果範圍涵蓋的跨度是來源高度或寬度的倍數,系統就會重複資料來填滿目的地範圍。如果範圍小於來源範圍,系統仍會複製整個來源資料 (超出目的地範圍的結尾)。 |
pasteType
|
要貼上的資料類型。 |
pasteOrientation
|
貼上時資料的顯示方向。 |
PasteOrientation
貼上作業的執行方式。
| 列舉 | |
|---|---|
NORMAL
|
照常貼上。 |
TRANSPOSE
|
貼上轉置資料,所有列會變成欄,反之亦然。 |
MergeCellsRequest
合併範圍內的所有儲存格。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要合併的儲存格範圍。 |
mergeType
|
儲存格的合併方式。 |
MergeType
要建立的合併類型。
| 列舉 | |
|---|---|
MERGE_ALL
|
從範圍建立單一合併 |
MERGE_COLUMNS
|
為範圍中的每個資料欄建立合併 |
MERGE_ROWS
|
為範圍中的每個資料列建立合併 |
UnmergeCellsRequest
取消合併指定範圍內的儲存格。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
所有儲存格應取消合併的範圍。如果範圍涵蓋多個合併作業,系統會取消合併所有作業。範圍不得部分跨越任何合併儲存格。 |
UpdateBordersRequest
更新範圍的邊界。如果要求中未設定欄位,表示邊框維持不變。舉例來說,如果連續發出兩項 UpdateBordersRequest:
-
範圍:A1:A5
{ top: RED, bottom: WHITE } -
範圍:A1:A5
{ left: BLUE }
這樣一來,A1:A5 的邊框就會變成 { top: RED, bottom: WHITE, left: BLUE }。如要清除邊框,請明確將樣式設為 NONE。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要更新框線的範圍。 |
top
|
要放在範圍頂端的邊框。 |
bottom
|
要放在範圍底部的邊框。 |
left
|
要放在範圍左側的框線。 |
right
|
要放在範圍右側的邊框。 |
innerHorizontal
|
要放在範圍內的水平邊界。 |
innerVertical
|
要放在範圍內的垂直邊界。 |
UpdateCellsRequest
使用新資料更新範圍內的所有儲存格。
| JSON 表示法 |
|---|
{ "rows": [ { object ( |
| 欄位 | |
|---|---|
rows[]
|
要寫入的資料。 |
fields
|
應更新的 CellData 欄位。至少須指定一個欄位。根目錄是 CellData,不應指定「row.values.」。單一 |
聯集欄位
area。位置資料應寫入。必須設定一個值。
area
只能是下列其中一項:
|
|
start
|
開始寫入資料的座標。可寫入任意數量的列和欄 (包括每列的欄數不同)。 |
range
|
要寫入資料的範圍。
如果資料列未涵蓋整個要求範圍,系統會清除與 |
AddFilterViewRequest
新增篩選器檢視畫面。
| JSON 表示法 |
|---|
{
"filter": {
object ( |
| 欄位 | |
|---|---|
filter
|
要新增的篩選器。 |
AppendCellsRequest
在試算表最後一個有資料的資料列後方新增儲存格,並視需要在試算表中插入新資料列。
| JSON 表示法 |
|---|
{ "sheetId": integer, "rows": [ { object ( |
| 欄位 | |
|---|---|
sheetId
|
要附加資料的工作表 ID。 |
rows[]
|
要附加的資料。 |
fields
|
應更新的 CellData 欄位。至少須指定一個欄位。根目錄是 CellData,不應指定「row.values.」。單一 |
聯集欄位
area。應寫入位置資料。
area
只能是下列其中一項:
|
|
tableId
|
要附加資料的資料表 ID。資料只會附加至表格主體。
這個欄位的優先順序也高於
|
ClearBasicFilterRequest
清除工作表上的基本篩選器 (如有)。
| JSON 表示法 |
|---|
{ "sheetId": integer } |
| 欄位 | |
|---|---|
sheetId
|
要清除基本篩選器的試算表 ID。 |
DeleteDimensionRequest
從工作表刪除維度。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
要從工作表刪除的維度。 |
DeleteEmbeddedObjectRequest
刪除具有指定 ID 的內嵌物件。
| JSON 表示法 |
|---|
{ "objectId": integer } |
| 欄位 | |
|---|---|
objectId
|
要刪除的內嵌物件 ID。 |
DeleteFilterViewRequest
刪除特定篩選器檢視畫面。
| JSON 表示法 |
|---|
{ "filterId": integer } |
| 欄位 | |
|---|---|
filterId
|
要刪除的篩選器 ID。 |
DuplicateFilterViewRequest
複製特定篩選器檢視畫面。
| JSON 表示法 |
|---|
{ "filterId": integer } |
| 欄位 | |
|---|---|
filterId
|
要複製的篩選器 ID。 |
DuplicateSheetRequest
複製工作表內容。
| JSON 表示法 |
|---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
| 欄位 | |
|---|---|
sourceSheetId
|
要複製的工作表。
如果來源工作表是 |
insertSheetIndex
|
新工作表的插入位置,從零開始。之後所有工作表的索引都會遞增。 |
newSheetId
|
如果已設定,則為新工作表的 ID。如未設定,系統會選擇 ID。如果設定了 ID,就不得與任何現有工作表 ID 衝突。如果設定,則不得為負值。 |
newSheetName
|
新工作表的名稱,如果留空,系統會為你選擇新名稱。 |
FindReplaceRequest
在範圍、工作表或所有工作表中尋找及取代儲存格中的資料。
| JSON 表示法 |
|---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
| 欄位 | |
|---|---|
find
|
要搜尋的值。 |
replacement
|
要用來做為替代的值。 |
matchCase
|
如果搜尋區分大小寫,則為 True。 |
matchEntireCell
|
如果尋找值應與整個儲存格相符,則為 True。 |
searchByRegex
|
如果搜尋值是規則運算式,則為 True。規則運算式和取代項目應遵循 Java 規則運算式規則,詳情請參閱 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html。取代字串可參照擷取群組。舉例來說,如果一個儲存格的內容為
|
includeFormulas
|
如果搜尋範圍應包含含有公式的儲存格,則為 True。如果為 False,則會略過內含公式的儲存格。 |
聯集欄位
scope。要尋找/取代的範圍,必須設定一個且只能設定一個。
scope
只能是下列其中一項:
|
|
range
|
要尋找/取代的範圍。 |
sheetId
|
要尋找/取代的試算表。 |
allSheets
|
True:在所有工作表中尋找/取代。 |
InsertDimensionRequest
在工作表的特定索引處插入列或欄。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
要插入的維度。起始和結束索引都必須有界限。 |
inheritFromBefore
|
是否應從新插入維度前後的維度擴充維度屬性。如要從先前的維度繼承,請設為 True (在這種情況下,起始索引必須大於 0);如要從後續維度繼承,請設為 False。
舉例來說,如果列索引 0 的背景為紅色,列索引 1 的背景為綠色,則在索引 1 插入 2 列時,可能會沿用綠色或紅色背景。如果
|
InsertRangeRequest
在範圍中插入儲存格,並將現有儲存格往右或往下移動。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要插入新儲存格的範圍。範圍會限制在目前工作表邊界內。 |
shiftDimension
|
|
MoveDimensionRequest
移動一或多個資料列或資料欄。
| JSON 表示法 |
|---|
{
"source": {
object ( |
| 欄位 | |
|---|---|
source
|
要移動的來源維度。 |
destinationIndex
|
以零為基準的起始索引,表示要將來源資料移至何處,以來源資料從格線中移除「之前」的座標為準。現有資料會向下或向右移動 (視維度而定),為移動的維度騰出空間。來源維度會從格線中移除,因此資料可能會出現在指定的索引以外。
舉例來說,假設有 |
UpdateEmbeddedObjectPositionRequest
更新內嵌物件的位置 (例如移動或調整圖表或圖片大小)。
| JSON 表示法 |
|---|
{
"objectId": integer,
"newPosition": {
object ( |
| 欄位 | |
|---|---|
objectId
|
要移動的物件 ID。 |
newPosition
|
要將嵌入物件移至的明確位置。如果設定了 |
fields
|
設定新位置時應更新的欄位。 |
PasteDataRequest
將資料插入試算表,從指定座標開始。
| JSON 表示法 |
|---|
{ "coordinate": { object ( |
| 欄位 | |
|---|---|
coordinate
|
資料應開始插入的座標。 |
data
|
要插入的資料。 |
type
|
資料的貼上方式。 |
聯集欄位
kind。如何解讀資料,必須設定一個值。
kind
只能是下列其中一項:
|
|
delimiter
|
資料中的分隔符號。 |
html
|
如果資料是 HTML,則為 True。 |
TextToColumnsRequest
根據每個儲存格中的分隔符號,將文字資料欄分割為多個資料欄。
| JSON 表示法 |
|---|
{ "source": { object ( |
| 欄位 | |
|---|---|
source
|
來源資料範圍。這個範圍必須只跨越一個資料欄。 |
delimiter
|
要使用的分隔符號。只有在 delimiterType 為 |
delimiterType
|
要使用的分隔符號類型。 |
DelimiterType
用來分割字串的分隔符號。
| 列舉 | |
|---|---|
DELIMITER_TYPE_UNSPECIFIED
|
預設值。不得使用這個值。 |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
"." |
SPACE
|
" " |
CUSTOM
|
以分隔符號定義的自訂值。 |
AUTODETECT
|
自動偵測欄。 |
UpdateFilterViewRequest
更新篩選器檢視畫面的屬性。
| JSON 表示法 |
|---|
{
"filter": {
object ( |
| 欄位 | |
|---|---|
filter
|
篩選器檢視畫面的新屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
DeleteRangeRequest
刪除儲存格範圍,並將其他儲存格移至已刪除的區域。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要刪除的儲存格範圍。 |
shiftDimension
|
系統會以這個維度取代已刪除的儲存格。如果
|
AppendDimensionRequest
在工作表結尾附加資料列或資料欄。
| JSON 表示法 |
|---|
{
"sheetId": integer,
"dimension": enum ( |
| 欄位 | |
|---|---|
sheetId
|
要附加資料列或資料欄的工作表。 |
dimension
|
是否要附加列或欄。 |
length
|
要附加的列數或欄數。 |
AddConditionalFormatRuleRequest
在指定索引處新增條件式格式規則。後續所有規則的索引都會遞增。
| JSON 表示法 |
|---|
{
"rule": {
object ( |
| 欄位 | |
|---|---|
rule
|
要新增的規則。 |
index
|
規則的插入位置,索引從零開始。 |
UpdateConditionalFormatRuleRequest
更新指定索引的條件式格式規則,或將條件式格式規則移至其他索引。
| JSON 表示法 |
|---|
{ "index": integer, "sheetId": integer, // Union field |
| 欄位 | |
|---|---|
index
|
要取代或移動的規則索引,從零開始。 |
sheetId
|
要移動的規則工作表。如果設定 |
聯集欄位
instruction。應執行的更新類型。
instruction
只能是下列其中一項:
|
|
rule
|
應取代指定索引處規則的規則。 |
newIndex
|
規則應結束的索引,從零開始。 |
DeleteConditionalFormatRuleRequest
刪除指定索引的條件式格式規則。後續所有規則的索引都會遞減。
| JSON 表示法 |
|---|
{ "index": integer, "sheetId": integer } |
| 欄位 | |
|---|---|
index
|
要刪除的規則索引,從零開始。 |
sheetId
|
要從中刪除規則的工作表。 |
SortRangeRequest
根據每個資料欄的排序順序,將資料列排序。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要排序的範圍。 |
sortSpecs[]
|
每個資料欄的排序順序。如果先前規格中的值相同,系統會使用後續規格。 |
SetDataValidationRequest
為範圍內的每個儲存格設定資料驗證規則。如要清除範圍內的驗證,請呼叫此函式,但不要指定任何規則。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
資料驗證規則應套用的範圍。 |
rule
|
要在範圍內每個儲存格中設定的資料驗證規則,或空白 (清除範圍內的資料驗證)。 |
filteredRowsIncluded
|
(選用步驟) 如果為 true,資料驗證規則也會套用至經過篩選的資料列。 |
SetBasicFilterRequest
設定與工作表相關聯的基本篩選條件。
| JSON 表示法 |
|---|
{
"filter": {
object ( |
| 欄位 | |
|---|---|
filter
|
要設定的篩選器。 |
AddProtectedRangeRequest
新增受保護的範圍。
| JSON 表示法 |
|---|
{
"protectedRange": {
object ( |
| 欄位 | |
|---|---|
protectedRange
|
要新增的受保護範圍。 |
UpdateProtectedRangeRequest
使用指定的 protectedRangeId 更新現有的受保護範圍。
| JSON 表示法 |
|---|
{
"protectedRange": {
object ( |
| 欄位 | |
|---|---|
protectedRange
|
要以新屬性更新的受保護範圍。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
DeleteProtectedRangeRequest
刪除具有指定 ID 的受保護範圍。
| JSON 表示法 |
|---|
{ "protectedRangeId": integer } |
| 欄位 | |
|---|---|
protectedRangeId
|
要刪除的受保護範圍 ID。 |
AutoResizeDimensionsRequest
根據該維度中儲存格的內容,自動調整一或多個維度的大小。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位
dimension_range。維度範圍。
dimension_range
只能是下列其中一項:
|
|
dimensions
|
要自動調整大小的維度。 |
dataSourceSheetDimensions
|
資料來源工作表上的維度,可自動調整大小。 |
AddChartRequest
在試算表的工作表中新增圖表。
| JSON 表示法 |
|---|
{
"chart": {
object ( |
| 欄位 | |
|---|---|
chart
|
要新增至試算表的圖表,包括放置位置。 |
UpdateChartSpecRequest
更新圖表的規格。(這不會移動圖表或調整圖表大小。如要移動或調整圖表大小,請使用 UpdateEmbeddedObjectPositionRequest。
| JSON 表示法 |
|---|
{
"chartId": integer,
"spec": {
object ( |
| 欄位 | |
|---|---|
chartId
|
要更新的圖表 ID。 |
spec
|
要套用至圖表的規格。 |
UpdateBandingRequest
更新所提供帶狀範圍的屬性。
| JSON 表示法 |
|---|
{
"bandedRange": {
object ( |
| 欄位 | |
|---|---|
bandedRange
|
要以新屬性更新的帶狀範圍。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
AddBandingRequest
在試算表中新增帶狀範圍。
| JSON 表示法 |
|---|
{
"bandedRange": {
object ( |
| 欄位 | |
|---|---|
bandedRange
|
要新增的帶狀範圍。 |
DeleteBandingRequest
從試算表中移除具有指定 ID 的帶狀範圍。
| JSON 表示法 |
|---|
{ "bandedRangeId": integer } |
| 欄位 | |
|---|---|
bandedRangeId
|
要刪除的帶狀範圍 ID。 |
CreateDeveloperMetadataRequest
建立開發人員中繼資料的要求。
| JSON 表示法 |
|---|
{
"developerMetadata": {
object ( |
| 欄位 | |
|---|---|
developerMetadata
|
要建立的開發人員中繼資料。 |
UpdateDeveloperMetadataRequest
要求更新開發人員中繼資料的屬性。根據篩選條件選取開發人員中繼資料,並將屬性更新為 DeveloperMetadata 資源中提供的值。呼叫端必須在 fields 參數中指定要更新的屬性,並指定至少一個DataFilter,與要更新的中繼資料相符。
| JSON 表示法 |
|---|
{ "dataFilters": [ { object ( |
| 欄位 | |
|---|---|
dataFilters[]
|
要更新的開發人員中繼資料項目所符合的篩選條件。 |
developerMetadata
|
系統會將符合資料篩選條件的所有中繼資料值更新為這個值。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
DeleteDeveloperMetadataRequest
要求刪除開發人員中繼資料。
| JSON 表示法 |
|---|
{
"dataFilter": {
object ( |
| 欄位 | |
|---|---|
dataFilter
|
資料篩選器,說明用於選取要刪除的開發人員中繼資料項目的條件。 |
RandomizeRangeRequest
隨機排列範圍內的資料列。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
要隨機排序的範圍。 |
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 ( |
| 欄位 | |
|---|---|
range
|
要建立群組的範圍。 |
DeleteDimensionGroupRequest
刪除指定範圍內的群組,方法是遞減範圍內維度的深度。
舉例來說,假設工作表在 B:E 範圍內有深度 1 的群組,在 C:D 範圍內有深度 2 的群組。如果刪除 D:E 上的群組,工作表會保留 B:D 上的深度 1 群組,以及 C:C 上的深度 2 群組。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
要刪除的群組範圍。 |
UpdateDimensionGroupRequest
更新指定群組的狀態。
| JSON 表示法 |
|---|
{
"dimensionGroup": {
object ( |
| 欄位 | |
|---|---|
dimensionGroup
|
要更新狀態的群組。群組的範圍和深度應指定試算表中的有效群組,並更新所有其他欄位。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
TrimWhitespaceRequest
會修剪指定範圍內每個儲存格的空白字元 (例如空格、定位點或換行符號)。這項要求會移除每個儲存格文字開頭和結尾的所有空格,並將所有後續的剩餘空格字元縮減為單一空格。如果修剪後的文字開頭是「+」或「=」字元,文字仍會是字串值,不會解讀為公式。
| JSON 表示法 |
|---|
{
"range": {
object ( |
| 欄位 | |
|---|---|
range
|
要修剪儲存格的範圍。 |
DeleteDuplicatesRequest
移除這個範圍內的資料列,這些資料列在指定資料欄中包含的值,與先前任何資料列中的值重複。只要資料列中的值相同,系統就會視其為重複項目,即使字母大小寫、格式或公式不同亦然。
這項要求也會移除檢視畫面中隱藏的重複資料列 (例如因篩選條件而隱藏的資料列)。移除重複項目時,系統會從上到下掃描,並將每個重複資料列的第一個例項保留在結果範圍中。指定範圍外的內容不會遭到移除,且系統不一定會移除範圍內相鄰的重複資料列。
| JSON 表示法 |
|---|
{ "range": { object ( |
| 欄位 | |
|---|---|
range
|
要移除重複資料列的範圍。 |
comparisonColumns[]
|
要分析重複值的範圍內資料欄。如未選取資料欄,系統會分析所有資料欄是否有重複項目。 |
UpdateEmbeddedObjectBorderRequest
更新內嵌物件的邊框屬性。
| JSON 表示法 |
|---|
{
"objectId": integer,
"border": {
object ( |
| 欄位 | |
|---|---|
objectId
|
要更新的內嵌物件 ID。 |
border
|
套用至內嵌物件的邊框。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
AddSlicerRequest
在試算表的工作表中新增篩選器。
| JSON 表示法 |
|---|
{
"slicer": {
object ( |
| 欄位 | |
|---|---|
slicer
|
應新增至試算表的篩選器,包括篩選器的放置位置。 |
UpdateSlicerSpecRequest
更新 Slicer 的規格。(這不會移動或調整 Slicer 大小。如要移動或調整交叉分析篩選器大小,請使用 UpdateEmbeddedObjectPositionRequest。
| JSON 表示法 |
|---|
{
"slicerId": integer,
"spec": {
object ( |
| 欄位 | |
|---|---|
slicerId
|
要更新的篩選器 ID。 |
spec
|
要套用至切片器的規格。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
AddDataSourceRequest
新增資料來源。成功新增資料來源後,系統會建立相關聯的 DATA_SOURCE 試算表,並觸發執行作業來重新整理試算表,從資料來源讀取資料。
如果您要新增 BigQuery 資料來源,要求需要額外的 bigquery.readonly OAuth 範圍。
| JSON 表示法 |
|---|
{
"dataSource": {
object ( |
| 欄位 | |
|---|---|
dataSource
|
要新增的資料來源。 |
UpdateDataSourceRequest
更新資料來源。資料來源更新成功後,系統會觸發執行作業,重新整理相關聯的
DATA_SOURCE
試算表,從更新後的資料來源讀取資料。
如果您要更新 BigQuery 資料來源,要求需要額外的 OAuth 範圍。bigquery.readonly
| JSON 表示法 |
|---|
{
"dataSource": {
object ( |
| 欄位 | |
|---|---|
dataSource
|
要更新的資料來源。 |
fields
|
應更新的欄位。至少須指定一個欄位。根目錄 |
DeleteDataSourceRequest
刪除資料來源。這項要求也會刪除相關聯的資料來源工作表,並取消連結所有相關聯的資料來源物件。
| JSON 表示法 |
|---|
{ "dataSourceId": string } |
| 欄位 | |
|---|---|
dataSourceId
|
要刪除的資料來源 ID。 |
RefreshDataSourceRequest
根據指定參照,重新整理試算表中的一或多個資料來源物件。
如果您要重新整理 BigQuery 資料來源,要求需要額外的 OAuth 範圍。bigquery.readonly
如果一個批次中有多個參照相同資料來源物件的重新整理要求,系統只會處理最後一個要求,且所有要求都會收到相同的回應。
| JSON 表示法 |
|---|
{ "force": boolean, // Union field |
| 欄位 | |
|---|---|
force
|
無論目前狀態為何,都會重新整理資料來源物件。如果未設定,且參照的資料來源物件處於錯誤狀態,系統會立即停止重新整理。 |
聯集欄位
target。指定要重新整理的內容。
target
只能是下列其中一項:
|
|
references
|
要重新整理的資料來源物件參考資料。 |
dataSourceId
|
參照 |
isAll
|
重新整理試算表中所有現有的資料來源物件。 |
DataSourceObjectReferences
資料來源物件的參照清單。
| JSON 表示法 |
|---|
{
"references": [
{
object ( |
| 欄位 | |
|---|---|
references[]
|
參考資料。 |
DataSourceObjectReference
資料來源物件的參照。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位
value。參考類型。
value
只能是下列其中一項:
|
|
sheetId
|
參照工作表。 |
chartId
|
資料來源圖表的參照。 |
dataSourceTableAnchorCell
|
參照錨定於儲存格的
|
dataSourcePivotTableAnchorCell
|
參照資料來源
|
dataSourceFormulaCell
|
參照包含 |
CancelDataSourceRefreshRequest
透過指定參照,取消試算表中一或多個資料來源物件的重新整理作業。
如要取消 BigQuery 資料來源的重新整理作業,要求必須具備額外的 OAuth 範圍。bigquery.readonly
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位
target。指定要取消的項目。
target
只能是下列其中一項:
|
|
references
|
要取消重新整理的資料來源物件參照。 |
dataSourceId
|
參照 |
isAll
|
取消試算表中所有資料來源的所有現有資料來源物件重新整理作業。 |
AddTableRequest
在試算表中新增表格。
| JSON 表示法 |
|---|
{
"table": {
object ( |
| 欄位 | |
|---|---|
table
|
必填。要新增的資料表。 |
UpdateTableRequest
更新試算表中的表格。
| JSON 表示法 |
|---|
{
"table": {
object ( |
| 欄位 | |
|---|---|
table
|
必填。要更新的表格。 |
fields
|
必填。應更新的欄位。至少須指定一個欄位。根目錄 |
DeleteTableRequest
從試算表中移除具有指定 ID 的表格。
| JSON 表示法 |
|---|
{ "tableId": string } |
| 欄位 | |
|---|---|
tableId
|
要刪除的資料表 ID。 |