要求
要套用至試算表的單一更新類型。
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
|
裁剪空白字元 (例如空格、Tab 字元或換行符號) 的儲存格。 |
deleteDuplicates
|
在儲存格範圍的指定資料欄中,移除含有重複值的資料列。 |
updateEmbeddedObjectBorder
|
更新嵌入物件的框線。 |
addSlicer
|
新增篩選器控制項。 |
updateSlicerSpec
|
更新篩選器控制項的規格。 |
addDataSource
|
新增資料來源。 |
updateDataSource
|
更新資料來源。 |
deleteDataSource
|
刪除資料來源。 |
refreshDataSource
|
重新整理一或多個資料來源和相關資料庫物件。 |
cancelDataSourceRefresh
|
取消重新整理一或多個資料來源,以及相關聯的資料庫物件。 |
UpdateSpreadsheetPropertiesRequest
更新試算表的屬性。
JSON 表示法 |
---|
{
"properties": {
object (
|
欄位 | |
---|---|
properties
|
要更新的屬性。 |
fields
|
要更新的欄位。至少須指定一個欄位。根「屬性」為默示,且不應該指定。單一
|
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
|
如果我們必須使用「替代」方法產生資料,則傳回「是」這是 Gemini 版 Google Workspace 系列課程之一這取決於來源資料的類型和數量。 |
聯集欄位
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
|
如果尋找值是規則運算式,則為「是」。規則運算式和替換內容應遵循以下 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
|
要使用的分隔符號。僅適用於 分隔符號 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 的深淺 1 來得多。舉例來說,[B:E, depth 1] + [C:D] 會產生 [B:E, depth 1] 和 [C:D, depth 2]。如果要求的範圍介於現有群組 G 之前和結束之間,或是在此後結束,則現有群組 G 的範圍會成為範圍聯集,新群組 G深度 1 大於 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 群組,並將 C:C 的深度 2 群組刪除。
JSON 表示法 |
---|
{
"range": {
object (
|
欄位 | |
---|---|
range
|
要刪除的群組範圍。 |
UpdateDimensionGroupRequest
更新指定群組的狀態。
JSON 表示法 |
---|
{
"dimensionGroup": {
object (
|
欄位 | |
---|---|
dimensionGroup
|
應更新其狀態的群組。群組的範圍和深度應在工作表中指定有效的群組,並更新所有其他欄位。 |
fields
|
要更新的欄位。至少須指定一個欄位。根目錄
|
TrimWhitespaceRequest
在指定範圍的每個儲存格中裁剪空白字元 (例如空格、Tab 字元或換行字元)。這項要求會移除每個儲存格文字開頭和結尾的所有空白字元,並減少所有剩餘空白字元的子序列至單一空格。如果產生的修剪文字開頭為「+」或「=」字元,文字仍會為字串值,且不會解讀為公式。
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
如果您要更新 BigQuery 資料來源,則使用 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[]
|
參照。 |
CancelDataSourceRefreshRequest
以指定的參照取消一或多項試算表中資料來源物件的重新整理作業。
這項要求需要額外的
bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位
target 。指定要取消的項目。
target
只能為下列其中一項:
|
|
references
|
參照要取消重新整理的資料來源物件參照。 |
dataSourceId
|
參照
|
isAll
|
取消試算表中所有資料來源的現有資料來源物件重新整理作業。 |