要求
要套用至試算表的單一更新類型。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。更新的類型。必須指定一個欄位。
kind 只能是下列其中一個: |
|
update
|
更新試算表的屬性。 |
update
|
更新工作表的屬性。 |
update
|
更新維度的屬性。 |
update
|
更新已命名範圍。 |
repeat
|
在範圍內重複單一儲存格。 |
add
|
新增命名範圍。 |
delete
|
刪除已命名範圍。 |
add
|
新增工作表。 |
delete
|
刪除工作表。 |
auto
|
根據現有資料自動填入更多資料。 |
cut
|
將資料從一個區域剪下,並貼到另一個區域。 |
copy
|
將資料從一個區域複製並貼到另一個區域。 |
merge
|
合併儲存格。 |
unmerge
|
取消合併儲存格。 |
update
|
更新儲存格範圍中的邊框。 |
update
|
一次更新多個儲存格。 |
add
|
新增篩選器檢視畫面。 |
append
|
在工作表中,將儲存格附加至含有資料的最後一列之後。 |
clear
|
清除工作表上的基本篩選器。 |
delete
|
刪除工作表中的列或欄。 |
delete
|
刪除工作表中的嵌入物件 (例如圖表、圖片)。 |
delete
|
從工作表中刪除篩選器檢視畫面。 |
duplicate
|
複製篩選器檢視畫面。 |
duplicate
|
複製工作表。 |
find
|
尋找並取代某些文字的出現情形。 |
insert
|
在工作表中插入新列或新欄。 |
insert
|
在試算表中插入新儲存格,並移動現有儲存格。 |
move
|
將資料列或資料欄移至工作表中的其他位置。 |
update
|
更新嵌入物件 (例如圖表、圖片) 的位置。 |
paste
|
將資料 (HTML 或分隔資料) 貼到試算表中。 |
text
|
將一欄文字轉換為多欄文字。 |
update
|
更新篩選器檢視畫面的屬性。 |
delete
|
刪除試算表中的儲存格範圍,並將剩餘的儲存格往右移。 |
append
|
將維度附加至工作表結尾。 |
add
|
新增條件式格式規則。 |
update
|
更新現有的條件式格式規則。 |
delete
|
刪除現有的條件式格式規則。 |
sort
|
排序特定範圍的資料。 |
set
|
為一或多個儲存格設定資料驗證。 |
set
|
設定工作表的基本篩選器。 |
add
|
新增受保護的範圍。 |
update
|
更新受保護的範圍。 |
delete
|
刪除受保護的範圍。 |
auto
|
根據該維度中儲存格的內容,自動調整一或多個維度的大小。 |
add
|
新增圖表。 |
update
|
更新圖表的規格。 |
update
|
更新帶狀範圍 |
add
|
新增區塊範圍 |
delete
|
移除帶狀範圍 |
create
|
建立新的開發人員中繼資料 |
update
|
更新現有的開發人員中繼資料項目 |
delete
|
刪除開發人員中繼資料 |
randomize
|
隨機排列範圍內的資料列。 |
add
|
在指定範圍內建立群組。 |
delete
|
刪除指定範圍內的群組。 |
update
|
更新指定群組的狀態。 |
trim
|
移除儲存格中的空白字元 (例如空格、Tab 或換行符號)。 |
delete
|
移除儲存格範圍中指定欄內含有重複值的資料列。 |
update
|
更新嵌入物件的邊框。 |
add
|
新增篩選器。 |
update
|
更新切割器的規格。 |
add
|
新增資料來源。 |
update
|
更新資料來源。 |
delete
|
刪除資料來源。 |
refresh
|
重新整理一或多個資料來源和相關的 dbobjects。 |
cancel
|
取消一或多個資料來源和相關 dbobjects 的重新整理作業。 |
UpdateSpreadsheetPropertiesRequest
更新試算表的屬性。
JSON 表示法 |
---|
{
"properties": {
object ( |
欄位 | |
---|---|
properties
|
要更新的屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根「屬性」是隱含的,因此不應指定。單一 |
UpdateSheetPropertiesRequest
使用指定的 sheetId
更新工作表屬性。
JSON 表示法 |
---|
{
"properties": {
object ( |
欄位 | |
---|---|
properties
|
要更新的屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
UpdateDimensionPropertiesRequest
更新指定範圍內的維度屬性。
JSON 表示法 |
---|
{ "properties": { object ( |
欄位 | |
---|---|
properties
|
要更新的資源。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
聯集欄位 dimension_range 。維度範圍。dimension_range 只能是下列其中一個: |
|
range
|
要更新的資料列或欄。 |
data
|
要更新的資料來源工作表資料欄。 |
DataSourceSheetDimensionRange
DATA_SOURCE
工作表中沿著單一維度的範圍。
JSON 表示法 |
---|
{
"sheetId": integer,
"columnReferences": [
{
object ( |
欄位 | |
---|---|
sheet
|
範圍所在資料來源工作表的 ID。 |
column
|
資料來源工作表上的資料欄。 |
UpdateNamedRangeRequest
使用指定的 namedRangeId
更新命名範圍的屬性。
JSON 表示法 |
---|
{
"namedRange": {
object ( |
欄位 | |
---|---|
named
|
要使用新屬性更新的命名範圍。 |
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 ( |
欄位 | |
---|---|
named
|
要新增的已命名範圍。 |
DeleteNamedRangeRequest
從試算表中移除具有指定 ID 的命名範圍。
JSON 表示法 |
---|
{ "namedRangeId": string } |
欄位 | |
---|---|
named
|
要刪除的已命名範圍 ID。 |
AddSheetRequest
新增工作表。在特定索引新增工作表時,後續所有工作表的索引都會遞增。如要新增物件工作表,請改用 AddChartRequest
,並指定 EmbeddedObjectPosition.sheetId
或 EmbeddedObjectPosition.newSheet
。
JSON 表示法 |
---|
{
"properties": {
object ( |
欄位 | |
---|---|
properties
|
新工作表應具備的屬性。所有屬性均為選填屬性。 |
DeleteSheetRequest
刪除要求的試算表。
JSON 表示法 |
---|
{ "sheetId": integer } |
欄位 | |
---|---|
sheet
|
要刪除的工作表 ID。
如果工作表為 |
AutoFillRequest
根據現有資料填入更多資料。
JSON 表示法 |
---|
{ "useAlternateSeries": boolean, // Union field |
欄位 | |
---|---|
use
|
如果我們應使用「alternate」系列產生資料,則為「是」。這會因來源資料的類型和數量而異。 |
聯集欄位 area 。自動填入的區域。area 只能是下列其中一個: |
|
range
|
自動填入的範圍。這項功能會檢查範圍,偵測有資料的位置,並自動將該資料填入範圍的其餘部分。 |
source
|
自動填入的來源和目的地。這會明確列出自動填入的來源,以及該資料的擴充位置。 |
SourceAndDestination
來源範圍和擴充來源的方式組合。
JSON 表示法 |
---|
{ "source": { object ( |
欄位 | |
---|---|
source
|
用於做為自動填入來源的資料位置。 |
dimension
|
資料應填入的維度。 |
fill
|
資料要填入的資料列或資料欄數量。正數會擴展至來源的最後一列或最後一欄。負數會在來源的第一列或第一欄之前展開。 |
CutPasteRequest
將資料從來源移至目的地。
JSON 表示法 |
---|
{ "source": { object ( |
欄位 | |
---|---|
source
|
要裁剪的來源資料。 |
destination
|
資料應貼上的左上方座標。 |
paste
|
要貼上哪種資料。無論貼上什麼內容,所有來源資料都會被剪下。 |
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
|
要貼上的位置。如果範圍涵蓋的跨距是來源高度或寬度的倍數,系統就會重複資料,以填入目標範圍。如果範圍小於來源範圍,系統仍會複製整個來源資料 (超出目的地範圍結尾)。 |
paste
|
要貼上哪種資料。 |
paste
|
貼上資料時的方向。 |
PasteOrientation
貼上作業的執行方式。
列舉 | |
---|---|
NORMAL
|
照常貼上。 |
TRANSPOSE
|
貼上轉置後的資料,其中所有資料列會變成資料欄,反之亦然。 |
MergeCellsRequest
合併指定範圍內的所有儲存格。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
要合併的儲存格範圍。 |
merge
|
儲存格應如何合併。 |
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
|
要放在範圍右側的邊框。 |
inner
|
要放入範圍內的水平邊框。 |
inner
|
要放入範圍內的垂直邊框。 |
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 ( |
欄位 | |
---|---|
sheet
|
要附加資料的試算表 ID。 |
rows[]
|
要附加的資料。 |
fields
|
應更新的 CellData 欄位。至少須指定一個欄位。根層級為 CellData,不應指定「row.values」。單一 |
ClearBasicFilterRequest
清除工作表中的基本篩選器 (如果有的話)。
JSON 表示法 |
---|
{ "sheetId": integer } |
欄位 | |
---|---|
sheet
|
應清除基本篩選器的試算表 ID。 |
DeleteDimensionRequest
從工作表中刪除維度。
JSON 表示法 |
---|
{
"range": {
object ( |
欄位 | |
---|---|
range
|
要從工作表中刪除的維度。 |
DeleteEmbeddedObjectRequest
刪除具有指定 ID 的嵌入物件。
JSON 表示法 |
---|
{ "objectId": integer } |
欄位 | |
---|---|
object
|
要刪除的嵌入物件 ID。 |
DeleteFilterViewRequest
刪除特定篩選器檢視畫面。
JSON 表示法 |
---|
{ "filterId": integer } |
欄位 | |
---|---|
filter
|
要刪除的篩選器 ID。 |
DuplicateFilterViewRequest
複製特定篩選器檢視畫面。
JSON 表示法 |
---|
{ "filterId": integer } |
欄位 | |
---|---|
filter
|
重複的篩選器 ID。 |
DuplicateSheetRequest
複製試算表的內容。
JSON 表示法 |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
欄位 | |
---|---|
source
|
要複製的工作表。
如果來源工作表是 |
insert
|
要插入新工作表的零起算索引。之後,所有工作表的索引都會遞增。 |
new
|
如果已設定,則為新工作表的 ID。如未設定,系統會選擇 ID。如果已設定,ID 不得與任何現有的工作表 ID 衝突。如果已設定,則不得為負數。 |
new
|
新工作表的名稱。如果留空,系統會為您選擇新名稱。 |
FindReplaceRequest
尋找並取代指定範圍、試算表或所有試算表中的儲存格資料。
JSON 表示法 |
---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
欄位 | |
---|---|
find
|
要搜尋的值。 |
replacement
|
要用來替換的值。 |
match
|
如果搜尋區分大小寫,則為 True。 |
match
|
如果要尋找的值應與整個儲存格相符,則為 True。 |
search
|
如果找到的值是規則運算式,則為 true。規則運算式和替換項目應遵循 Java 規則運算式規則,網址為 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html。替換字串可參照擷取群組。舉例來說,如果一個儲存格含有 |
include
|
如果搜尋內容應包含含有公式的儲存格,則為 True。設為 False 可略過含有公式的儲存格。 |
聯集欄位 scope 。要進行尋找/取代的範圍。必須設定一個範圍,且只能設定一個範圍。scope 只能是下列其中一個: |
|
range
|
要尋找/取代的範圍。 |
sheet
|
要進行尋找/取代的試算表。 |
all
|
設為「是」時,系統會在所有工作表中執行尋找/取代作業。 |
InsertDimensionRequest
在工作表中插入特定索引的列或欄。
JSON 表示法 |
---|
{
"range": {
object ( |
欄位 | |
---|---|
range
|
要插入的維度。起始索引和結束索引都必須有界限。 |
inherit
|
是否應從新插入的維度前或後,擴展維度屬性。如果為 true,則會從前面的維度繼承 (此時開始索引必須大於 0),如果為 false,則會從後面的維度繼承。
舉例來說,如果第 0 列的索引有紅色背景,而第 1 列的索引有綠色背景,則在索引 1 插入 2 列時,可以繼承綠色或紅色背景。如果 |
InsertRangeRequest
在範圍中插入儲存格,並將現有儲存格往右或下方移。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
要插入新儲存格的範圍。範圍會受限於目前工作表的邊界。 |
shift
|
|
MoveDimensionRequest
移動一或多個資料列或資料欄。
JSON 表示法 |
---|
{
"source": {
object ( |
欄位 | |
---|---|
source
|
要移動的來源維度。 |
destination
|
以零為基底的起始索引,用於將來源資料移至指定位置,此索引會根據來源資料從格線中移除前的座標計算。現有資料會向下或向右移動 (視維度而定),為移動的維度騰出空間。來源維度會從資料格中移除,因此資料可能會出現在指定的不同索引中。
舉例來說,假設 |
UpdateEmbeddedObjectPositionRequest
更新嵌入物件的位置 (例如移動或調整圖表或圖片的大小)。
JSON 表示法 |
---|
{
"objectId": integer,
"newPosition": {
object ( |
欄位 | |
---|---|
object
|
要移動的物件 ID。 |
new
|
要將嵌入物件移至的位置。如果已設定 |
fields
|
設定新位置時,應更新的 |
PasteDataRequest
從指定座標開始,將資料插入試算表。
JSON 表示法 |
---|
{ "coordinate": { object ( |
欄位 | |
---|---|
coordinate
|
資料應開始插入的座標。 |
data
|
要插入的資料。 |
type
|
資料的貼上方式。 |
聯集欄位 kind 。如何解讀資料,必須設定單一值。kind 只能是下列其中一個: |
|
delimiter
|
資料中的分隔符號。 |
html
|
如果資料為 HTML,則為 True。 |
TextToColumnsRequest
根據每個儲存格中的分隔符號,將一欄文字分割為多個資料欄。
JSON 表示法 |
---|
{ "source": { object ( |
欄位 | |
---|---|
source
|
來源資料範圍。這必須橫跨單一資料欄。 |
delimiter
|
要使用的分隔符號。只有在 delimiterType 為 |
delimiter
|
要使用的分隔符號類型。 |
DelimiterType
要用來分割的符號。
列舉 | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
預設值。請勿使用這個值。 |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
"." |
SPACE
|
" " |
CUSTOM
|
根據分隔符定義的自訂值。 |
AUTODETECT
|
自動偵測資料欄。 |
UpdateFilterViewRequest
更新篩選器檢視畫面的屬性。
JSON 表示法 |
---|
{
"filter": {
object ( |
欄位 | |
---|---|
filter
|
篩選器檢視畫面的新屬性。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
DeleteRangeRequest
刪除儲存格範圍,並將其他儲存格移至刪除的區域。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
要刪除的儲存格範圍。 |
shift
|
系統會使用這個維度取代已刪除的儲存格。如果是 |
AppendDimensionRequest
將資料列或資料欄附加到工作表的結尾。
JSON 表示法 |
---|
{
"sheetId": integer,
"dimension": enum ( |
欄位 | |
---|---|
sheet
|
要附加資料列或資料欄的工作表。 |
dimension
|
是否要附加資料列或資料欄。 |
length
|
要附加的資料列或資料欄數量。 |
AddConditionalFormatRuleRequest
在指定索引處新增條件式格式規則。所有後續規則的索引都會增加。
JSON 表示法 |
---|
{
"rule": {
object ( |
欄位 | |
---|---|
rule
|
要新增的規則。 |
index
|
要插入規則的索引,以零為基準。 |
UpdateConditionalFormatRuleRequest
更新指定索引的條件式格式規則,或將條件式格式規則移至其他索引。
JSON 表示法 |
---|
{ "index": integer, "sheetId": integer, // Union field |
欄位 | |
---|---|
index
|
應取代或移動的規則,其索引從零開始。 |
sheet
|
要移動的規則工作表。如果已設定 |
聯集欄位 instruction 。應執行的更新類型。instruction 只能是下列其中一個: |
|
rule
|
應取代指定索引的規則。 |
new
|
規則應結束於的以零為基的新索引。 |
DeleteConditionalFormatRuleRequest
刪除指定索引的條件式格式規則。所有後續規則的索引都會遞減。
JSON 表示法 |
---|
{ "index": integer, "sheetId": integer } |
欄位 | |
---|---|
index
|
要刪除的規則,索引從零開始。 |
sheet
|
要刪除規則的試算表。 |
SortRangeRequest
根據每個資料欄的排序順序,排序列中的資料。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
要排序的範圍。 |
sort
|
每個資料欄的排序順序。如果較早的規格中值相等,則會使用較新的規格。 |
SetDataValidationRequest
為範圍中的每個儲存格設定資料驗證規則。如要清除範圍內的驗證,請在未指定規則的情況下呼叫此方法。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
資料驗證規則應套用的範圍。 |
rule
|
要為範圍中每個儲存格設定的資料驗證規則,如果為空白,則會清除範圍內的資料驗證。 |
filtered
|
選用設定。如果為 true,資料驗證規則也會套用至篩除的資料列。 |
SetBasicFilterRequest
設定與工作表相關的基本篩選器。
JSON 表示法 |
---|
{
"filter": {
object ( |
欄位 | |
---|---|
filter
|
要設定的篩選器。 |
AddProtectedRangeRequest
新增受保護的範圍。
JSON 表示法 |
---|
{
"protectedRange": {
object ( |
欄位 | |
---|---|
protected
|
要新增的受保護範圍。 |
UpdateProtectedRangeRequest
使用指定的 protectedRangeId
更新現有的受保護範圍。
JSON 表示法 |
---|
{
"protectedRange": {
object ( |
欄位 | |
---|---|
protected
|
要使用新屬性更新的受保護範圍。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
DeleteProtectedRangeRequest
刪除具有指定 ID 的受保護範圍。
JSON 表示法 |
---|
{ "protectedRangeId": integer } |
欄位 | |
---|---|
protected
|
要刪除的受保護範圍 ID。 |
AutoResizeDimensionsRequest
根據該維度中儲存格的內容,自動調整一或多個維度的大小。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 dimension_range 。維度範圍。dimension_range 只能是下列其中一個: |
|
dimensions
|
要自動調整大小的尺寸。 |
data
|
資料來源工作表的維度,可自動調整大小。 |
AddChartRequest
在試算表中的工作表中新增圖表。
JSON 表示法 |
---|
{
"chart": {
object ( |
欄位 | |
---|---|
chart
|
應加入試算表的圖表,包括應放置的位置。 |
UpdateChartSpecRequest
更新圖表的規格。(這不會移動或調整圖表大小。如要移動或調整圖表大小,請使用 UpdateEmbeddedObjectPositionRequest
。)
JSON 表示法 |
---|
{
"chartId": integer,
"spec": {
object ( |
欄位 | |
---|---|
chart
|
要更新的圖表 ID。 |
spec
|
要套用至圖表的規格。 |
UpdateBandingRequest
更新所提供的帶狀範圍屬性。
JSON 表示法 |
---|
{
"bandedRange": {
object ( |
欄位 | |
---|---|
banded
|
要使用新屬性更新的區間。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
AddBandingRequest
在試算表中新增區塊範圍。
JSON 表示法 |
---|
{
"bandedRange": {
object ( |
欄位 | |
---|---|
banded
|
要新增的帶狀範圍。 |
DeleteBandingRequest
從試算表中移除具有指定 ID 的帶狀範圍。
JSON 表示法 |
---|
{ "bandedRangeId": integer } |
欄位 | |
---|---|
banded
|
要刪除的帶狀範圍 ID。 |
CreateDeveloperMetadataRequest
建立開發人員中繼資料的要求。
JSON 表示法 |
---|
{
"developerMetadata": {
object ( |
欄位 | |
---|---|
developer
|
要建立的開發人員中繼資料。 |
UpdateDeveloperMetadataRequest
要求更新開發人員中繼資料的屬性。將篩選器選取的開發人員中繼資料屬性更新為 DeveloperMetadata
資源中提供的值。呼叫端必須在欄位參數中指定要更新的屬性,並指定至少一個與要更新的中繼資料相符的 DataFilter
。
JSON 表示法 |
---|
{ "dataFilters": [ { object ( |
欄位 | |
---|---|
data
|
符合要更新的開發人員中繼資料項目的篩選條件。 |
developer
|
系統會將所有符合資料篩選條件的中繼資料更新為這個值。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
DeleteDeveloperMetadataRequest
要求刪除開發人員中繼資料。
JSON 表示法 |
---|
{
"dataFilter": {
object ( |
欄位 | |
---|---|
data
|
資料篩選器,說明用來選取要刪除的開發人員中繼資料項目的條件。 |
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 的深度多 1,範圍則是範圍的交集。舉例來說,群組 [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 ( |
欄位 | |
---|---|
dimension
|
應更新狀態的群組。群組的範圍和深度應指定工作表中的有效群組,並更新所有其他欄位。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
TrimWhitespaceRequest
會修剪指定範圍中每個儲存格中的空白字元 (例如空格、tab 或換行符號)。這項要求會移除每個儲存格文字開頭和結尾的所有空格,並將任何剩餘的空白字元子序列縮減為單一空格。如果經過裁剪的文字開頭為「+」或「=」字元,則文字仍會保留為字串值,不會解讀為公式。
JSON 表示法 |
---|
{
"range": {
object ( |
欄位 | |
---|---|
range
|
要裁剪儲存格範圍。 |
DeleteDuplicatesRequest
移除指定範圍內,包含指定欄中值的重複值 (與任何先前資料列的值重複) 的資料列。只要資料列中的值相同,系統就會視其為重複項目,即使字母大小寫、格式或公式不同亦然。
這項要求也會移除隱藏的資料列 (例如因篩選條件而隱藏)。移除重複資料時,從上到下掃描每個重複資料列的第一次出現,會保留在產生的範圍中。系統不會移除指定範圍以外的內容,且視為重複的資料列不必在範圍內彼此相鄰。
JSON 表示法 |
---|
{ "range": { object ( |
欄位 | |
---|---|
range
|
要移除重複資料列的範圍。 |
comparison
|
要分析重複值的範圍內資料欄。如果未選取任何資料欄,系統會分析所有資料欄,找出重複項目。 |
UpdateEmbeddedObjectBorderRequest
更新嵌入物件的邊框屬性。
JSON 表示法 |
---|
{
"objectId": integer,
"border": {
object ( |
欄位 | |
---|---|
object
|
要更新的嵌入物件 ID。 |
border
|
套用至內嵌物件的邊框。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
AddSlicerRequest
在試算表中的工作表中新增切片器。
JSON 表示法 |
---|
{
"slicer": {
object ( |
欄位 | |
---|---|
slicer
|
應新增至試算表的切片器,包括應放置的位置。 |
UpdateSlicerSpecRequest
更新切割器的規格。(這不會移動或調整切片器大小。如要移動或調整切片器大小,請使用 UpdateEmbeddedObjectPositionRequest
。
JSON 表示法 |
---|
{
"slicerId": integer,
"spec": {
object ( |
欄位 | |
---|---|
slicer
|
要更新的切片器 ID。 |
spec
|
要套用至切片器的規格。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
AddDataSourceRequest
新增資料來源。資料來源成功新增後,系統會建立相關聯的 DATA_SOURCE
工作表,並觸發執行作業,以便重新整理工作表,讀取資料來源中的資料。
如果您要新增 BigQuery 資料來源,請在要求中額外提供 bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{
"dataSource": {
object ( |
欄位 | |
---|---|
data
|
要新增的資料來源。 |
UpdateDataSourceRequest
更新資料來源。資料來源成功更新後,系統會觸發執行作業,重新整理相關聯的 DATA_SOURCE
工作表,以便從更新的資料來源讀取資料。
如果您要更新 BigQuery 資料來源,請在要求中額外提供 bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{
"dataSource": {
object ( |
欄位 | |
---|---|
data
|
要更新的資料來源。 |
fields
|
應更新的欄位。至少須指定一個欄位。根 |
DeleteDataSourceRequest
刪除資料來源。這項要求也會刪除相關聯的資料來源工作表,並取消連結所有相關聯的資料來源物件。
JSON 表示法 |
---|
{ "dataSourceId": string } |
欄位 | |
---|---|
data
|
要刪除的資料來源 ID。 |
RefreshDataSourceRequest
根據指定參照,重新整理試算表中一或多個資料來源物件。
如果要重新整理 BigQuery 資料來源,請在要求中額外提供 bigquery.readonly
OAuth 範圍。
如果單一批次中有多個參照相同資料來源物件的重新整理要求,系統只會處理最後一個重新整理要求,而所有要求都會收到相同的回應。
JSON 表示法 |
---|
{ "force": boolean, // Union field |
欄位 | |
---|---|
force
|
無論目前狀態為何,都會重新整理資料來源物件。如果未設定,且參照的資料來源物件處於錯誤狀態,重新整理作業會立即失敗。 |
聯集欄位 target 。指定要重新整理的項目。target 只能是下列其中一個: |
|
references
|
要重新整理的資料來源物件參照。 |
data
|
對 |
is
|
重新整理試算表中所有現有的資料來源物件。 |
DataSourceObjectReferences
資料來源物件參照清單。
JSON 表示法 |
---|
{
"references": [
{
object ( |
欄位 | |
---|---|
references[]
|
參考資料。 |
CancelDataSourceRefreshRequest
根據指定的參照,取消試算表中一或多個資料來源物件的重新整理作業。
如果您要取消 BigQuery 資料來源的重新整理作業,請在要求中額外提供 bigquery.readonly
OAuth 範圍。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 target 。指定要取消的項目。target 只能是下列其中一個: |
|
references
|
要取消重新整理的資料來源物件參照。 |
data
|
對 |
is
|
取消重新整理試算表中所有資料來源的所有現有資料來源物件。 |