要求
套用至試算表的一種更新。
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
|
加入新的頻帶範圍 |
deleteBanding
|
移除條紋範圍 |
createDeveloperMetadata
|
建立新的開發人員中繼資料 |
updateDeveloperMetadata
|
更新現有的開發人員中繼資料項目 |
deleteDeveloperMetadata
|
刪除開發人員中繼資料 |
randomizeRange
|
隨機排序範圍內的資料列順序。 |
addDimensionGroup
|
在指定範圍內建立群組。 |
deleteDimensionGroup
|
刪除指定範圍內的群組。 |
updateDimensionGroup
|
更新指定群組的狀態。 |
trimWhitespace
|
移除空白的儲存格 (例如空格、定位點或換行字元)。 |
deleteDuplicates
|
移除某個儲存格範圍的指定資料欄內,含有重複值的資料列。 |
updateEmbeddedObjectBorder
|
更新嵌入物件的邊框。 |
addSlicer
|
新增篩選器控制項。 |
updateSlicerSpec
|
更新篩選器控制項的規格。 |
addDataSource
|
新增資料來源。 |
updateDataSource
|
更新資料來源。 |
deleteDataSource
|
刪除資料來源。 |
refreshDataSource
|
重新整理一或多個資料來源和相關 db 物件。 |
cancelDataSourceRefresh
|
取消一或多個資料來源和相關 db 物件的重新整理作業。 |
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
欄位中列出的欄位,其他欄位則維持不變。
如果使用公式寫入儲存格,公式的範圍會自動依範圍中每個欄位遞增。舉例來說,如果將含有公式 =A1
的儲存格寫入 B2:C4 範圍,B2 應為 =A1
、B3 為 =A2
、B4 為 =A3
、C2 為 =B1
、C3 為 =B2
,C4 則會是 =B3
。
如要讓公式的範圍保持靜態,請使用 $
指標。舉例來說,使用公式 =$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
|
如果應使用「alternate」序列產生資料,則為 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.」。您可以使用單一 |
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。規則運算式和取代項目應遵循位於 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html 的 Java 規則運算式規則。取代字串可以參照擷取群組。舉例來說,如果某個儲存格含有 |
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
|
來源資料移動位置 (從 0 開始) 索引 (以「先」表示來源資料從格線中移除)。現有資料會向下或向右移 (視維度而定),以騰出空間來容納移動的維度。來源維度會從網格中移除,因此資料可能會放入與指定的索引不同的索引。
舉例來說,假設 |
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
|
要使用的分隔符號。只有在 分隔符號 Type 為 |
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
|
要為範圍中每個儲存格設定的資料驗證規則,留空則表示清除範圍中每個儲存格的資料驗證作業。 |
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
資源中提供的值。呼叫端必須在欄位參數中指定想更新的屬性,以及至少指定一個與要更新的中繼資料相符的 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 深度一。舉例來說,[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 (
|
欄位 | |
---|---|
range
|
建立群組的範圍。 |
DeleteDimensionGroupRequest
減少範圍內的維度深度,藉此刪除指定範圍內的群組。
舉例來說,假設工作表包含 B:E 的 深度-1 群組,以及 C:D 的深度-2 群組。刪除一個 D:E 的群組後,便離開工作表 (B:D 深度-1 群組),深度 2 組則位於 C:C。
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
更新篩選器控制項的規格。(這項操作不會移動篩選器控制項或調整其大小。如要移動篩選器控制項或調整其大小,請使用 UpdateEmbeddedObjectPositionRequest
。
JSON 表示法 |
---|
{
"slicerId": integer,
"spec": {
object (
|
欄位 | |
---|---|
slicerId
|
要更新的篩選器控制項 ID。 |
spec
|
要套用至篩選器控制項的規格。 |
fields
|
要更新的欄位。至少須指定一個欄位。根層級 |
AddDataSourceRequest
新增資料來源。成功新增資料來源後,系統會建立相關聯的 DATA_SOURCE
工作表,並觸發執行作業來重新整理工作表,以便讀取資料來源中的資料。這項要求需要額外的 bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{
"dataSource": {
object (
|
欄位 | |
---|---|
dataSource
|
要新增的資料來源。 |
UpdateDataSourceRequest
更新資料來源。成功更新資料來源後,系統會觸發執行作業來重新整理相關聯的 DATA_SOURCE
工作表,以讀取更新過的資料來源資料。這項要求需要額外的 bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{
"dataSource": {
object (
|
欄位 | |
---|---|
dataSource
|
要更新的資料來源。 |
fields
|
要更新的欄位。至少須指定一個欄位。根層級 |
DeleteDataSourceRequest
刪除資料來源。這項要求也會刪除相關聯的資料來源工作表,並取消連結所有相關聯的資料來源物件。
JSON 表示法 |
---|
{ "dataSourceId": string } |
欄位 | |
---|---|
dataSourceId
|
要刪除的資料來源 ID。 |
RefreshDataSourceRequest
依據指定的參照重新整理試算表中的一或多個資料來源物件。這項要求需要額外的 bigquery.readonly
OAuth 範圍。
如果有多個重新整理要求,一批次參照同一個資料來源物件,系統只會處理最後一個重新整理要求,所有要求都會收到相同的回應。
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
依據指定的參照取消試算表中的一或多個資料來源物件重新整理作業。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 target 。指定要取消的內容。target 只能採用下列其中一種設定: |
|
references
|
對要取消重新整理的資料來源物件參照。 |
dataSourceId
|
對 |
isAll
|
取消重新整理試算表中所有資料來源的現有資料來源物件。 |