Other

顏色

代表 RGBA 色域中的顏色。這個樣式旨在簡化，在各種語言中輕鬆轉換各種語言的色彩配置和情況。舉例來說，此表示法的欄位在 Java 中可以輕易地提供給 java.awt.Color 的建構函式；您也可以宣告在 iOS 中傳遞至 UIColor 的 +colorWithRed:green:blue:alpha 方法，而且只要簡單幾個步驟，就能在 JavaScript 中輕鬆轉換成 CSS rgba() 字串。

這個參考頁面未提供應用於解讀 RGB 值的絕對色彩空間相關資訊，例如 sRGB、Adobe RGB、DCI-P3 和 BT.2020。根據預設，應用程式應假設使用 sRGB 色域。

在需要決定顏色等值時，除非除非另有說明，否則實作項目在紅色、綠色、藍色和 Alpha 值方面最多要等於 1e-5，且兩種顏色完全相同。

範例 (Java)：

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

範例 (iOS / Obj-C)：

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

範例 (JavaScript)： 

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON 表示法 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
欄位
red

number

以顏色 [0, 1] 表示的值，在顏色中等於的紅色量。
green

number

以顏色 [0, 1] 為單位的值，在顏色中會以綠色值表示。

blue

number

以顏色 [0, 1] 為單位的值，表示藍色值的數值。
alpha

number

這個顏色應套用至像素的分數。也就是說，最終像素顏色是由方程式定義：

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

也就是說，1.0 的值代表純色，而 0.0 值則對應至完全透明的顏色。這會使用包裝函式訊息，而非簡單的浮點純量，以便區分預設值和未設定的值。省略時，這個顏色物件會以純色表示 (如同 Alpha 值已明確指定為 1.0 的值)。

色彩樣式

顏色值。

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。色彩值的種類。 kind 只能是下列其中一個值：
rgbColor

object (Color)

RGB 顏色。系統不支援 Color 物件中的 alpha 值。
themeColor

enum (ThemeColorType)

主題顏色。

ThemeColorType

主題顏色類型。

SpreadsheetProperties 包含 SpreadsheetTheme，用於定義這些主題顏色類型的對應具體顏色。

列舉
THEME_COLOR_TYPE_UNSPECIFIED 未指定主題顏色
TEXT 代表主要文字顏色
BACKGROUND 代表主要背景顏色
ACCENT1 代表第一個強調色
ACCENT2 代表第二個強調色
ACCENT3 代表第三個強調色
ACCENT4 代表第四個強調色
ACCENT5 代表第五種強調色
ACCENT6 代表六種強調色

HorizontalAlign

儲存格文字的水平對齊。

列舉
HORIZONTAL_ALIGN_UNSPECIFIED 未指定水平對齊。請勿使用。
LEFT 文字與儲存格左側明確對齊。
CENTER 文字已明確對齊儲存格中心。
RIGHT 文字會靠右對齊。

文字格式

儲存格文字執行格式。如果顯示值為「未指定」，表示該欄位並未指定。

JSON 表示法 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
欄位
foregroundColor
(deprecated)

object (Color)

文字的前景顏色。已淘汰：使用 foregroundColorStyle。
foregroundColorStyle

object (ColorStyle)

文字的前景顏色。如果同時設定了 foregroundColor，系統會優先採用這個欄位。
fontFamily

string

字型系列。
fontSize

integer

字型大小。

bold

boolean

如果文字為粗體，則為 True。
italic

boolean

如果文字為斜體，則為 True。

strikethrough

boolean

如果文字包含刪除線，則為 True。

underline

boolean

如果文字加上底線，則為 True。

DataSourceColumn

資料來源中的資料欄。

JSON 表示法 
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
欄位
reference

object (DataSourceColumnReference)

資料欄參照。
formula

string

計算結果欄的公式。

DataSourceColumnReference

參照資料來源欄的專屬 ID。

JSON 表示法 
{
  "name": string
}
欄位
name

string

資料欄的顯示名稱。資料來源中不得重複。

DataExecutionStatus

資料執行狀態。

系統會建立資料執行作業，以便將資料來源物件與 DataSource 中的最新資料同步。工作通常已排定在背景執行，您可以查看其 state，確認執行是否完成

在許多情況下，我們會觸發資料執行作業：

  • Adding a data source 會建立相關聯的資料來源工作表和資料執行作業，將資料從資料來源同步處理至工作表。
  • Updating a data source 會建立資料執行作業，以重新整理類似的資料來源工作表。
  • 您可以傳送 refresh request，明確重新整理一或多個資料來源物件。
JSON 表示法 
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
欄位
state

enum (DataExecutionState)

資料執行狀態。

errorCode

enum (DataExecutionErrorCode)

錯誤代碼。

errorMessage

string

錯誤訊息，可能留空。
lastRefreshTime

string (Timestamp format)

取得資料上次成功重新整理的時間。

DataExecutionState

資料執行狀態的列舉。

列舉
DATA_EXECUTION_STATE_UNSPECIFIED 預設值，請勿使用。
NOT_STARTED 尚未開始執行資料。
RUNNING 資料執行作業已開始且正在執行。
SUCCEEDED 資料執行程序已順利完成。
FAILED 資料執行程序已完成，但發生錯誤。

DataExecutionErrorCode

資料執行錯誤代碼的列舉。

列舉
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED 預設值，請勿使用。
TIMED_OUT 資料執行逾時。
TOO_MANY_ROWS 資料執行結果傳回超過限制資料列。
TOO_MANY_COLUMNS 資料執行結果傳回的資料欄超出限制。
TOO_MANY_CELLS 資料執行結果傳回的儲存格數量超出限制。
ENGINE 從後端資料執行引擎 (例如 BigQuery) 接收錯誤。詳情請參閱 errorMessage。
PARAMETER_INVALID 您提供的部分資料來源參數無效。
UNSUPPORTED_DATA_TYPE 資料執行結果會傳回不支援的資料類型。
DUPLICATE_COLUMN_NAMES 資料執行結果傳回重複的欄名或別名。
INTERRUPTED 資料執行中斷。請稍後再重新整理。
CONCURRENT_QUERY 資料執行中正在進行，但必須等到作業完成後才能重新整理。
OTHER 其他錯誤。
TOO_MANY_CHARS_PER_CELL 資料執行結果含有超過單一儲存格允許字元上限的值。
DATA_NOT_FOUND 找不到這個資料來源參照的資料庫。*/
PERMISSION_DENIED 使用者無法存取資料來源參照的資料庫。
MISSING_COLUMN_ALIAS 資料執行結果會傳回缺少別名的欄。
OBJECT_NOT_FOUND 資料來源物件不存在。
OBJECT_IN_ERROR_STATE 資料來源物件目前處於錯誤狀態。如要強制重新整理，請在 RefreshDataSourceRequest 中設定 force。
OBJECT_SPEC_INVALID 資料來源物件規格無效。

擴充值

試算表中儲存格可包含的值類型。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。儲存格中的值類型。如未設定任何欄位，表示儲存格沒有任何資料。value 只能是下列其中一個值：
numberValue

number

代表雙精度值。注意：日期、時間和日期時間會以 SERIAL_NUMBER 格式顯示兩次。
stringValue

string

代表字串值。但不含單引號。舉例來說，如果使用者在使用者介面中輸入 '123，就會以 "123" 的 stringValue 表示。
boolValue

boolean

代表布林值。

formulaValue

string

代表公式。
errorValue

object (ErrorValue)

代表錯誤。這是唯讀欄位。

ErrorValue

儲存格發生錯誤。

JSON 表示法 
{
  "type": enum (ErrorType),
  "message": string
}
欄位
type

enum (ErrorType)

錯誤類型。

message

string

此錯誤的詳細資訊訊息 (以試算表的語言代碼為準)。

ErrorType

錯誤類型。

列舉
ERROR_TYPE_UNSPECIFIED 預設錯誤類型，請勿使用。
ERROR 對應 #ERROR! 錯誤。
NULL_VALUE 對應 #NULL! 錯誤。
DIVIDE_BY_ZERO 對應 #DIV/0 錯誤。
VALUE 對應 #VALUE! 錯誤。
REF 對應 #REF! 錯誤。
NAME 對應 #NAME? 錯誤。
NUM 對應 #NUM! 錯誤。
N_A 對應 #N/A 錯誤。
LOADING 對應至 Loading... 狀態。

BooleanCondition

可評估為 True 或 False 的條件。條件式格式設定、資料驗證和篩選器中的條件會使用布林值。

JSON 表示法 
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
欄位
type

enum (ConditionType)

條件的類型。

values[]

object (ConditionValue)

條件的值。支援的值數量取決於 condition type。部分值支援零、其他或兩個值，ConditionType.ONE_OF_LIST 則支援任意數量的值。

條件類型

條件的類型。

列舉
CONDITION_TYPE_UNSPECIFIED 預設值，不使用。
NUMBER_GREATER 儲存格的值必須大於條件的值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
NUMBER_GREATER_THAN_EQ 儲存格的值必須大於或等於該條件值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
NUMBER_LESS 儲存格的值必須小於條件值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
NUMBER_LESS_THAN_EQ 儲存格的值必須小於或等於條件值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
NUMBER_EQ 儲存格的值必須等於條件的值。支援資料驗證、條件式格式設定和篩選器。必須提供一個 ConditionValue，分別用於資料驗證、條件式格式設定和非資料來源物件篩選器。另外，如果資料來源物件篩選器使用，則至少須有一個 ConditionValue。
NUMBER_NOT_EQ 儲存格的值不得等於條件值。支援資料驗證、條件式格式設定和篩選器。必須提供一個 ConditionValue，分別用於資料驗證、條件式格式設定和非資料來源物件篩選器。另外，如果資料來源物件篩選器使用，則至少須有一個 ConditionValue。
NUMBER_BETWEEN 儲存格的值必須介於兩個條件值之間。支援資料驗證、條件式格式設定和篩選器。只需要兩個 ConditionValues。
NUMBER_NOT_BETWEEN 儲存格的值不得介於兩個條件值之間。支援資料驗證、條件式格式設定和篩選器。只需要兩個 ConditionValues。
TEXT_CONTAINS 儲存格的值必須包含條件的值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
TEXT_NOT_CONTAINS 儲存格的值不得包含條件的值。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue。
TEXT_STARTS_WITH 儲存格的值開頭必須為條件值。支援條件式格式設定和篩選器。需要單一 ConditionValue。
TEXT_ENDS_WITH 儲存格的值結尾必須是條件的值。支援條件式格式設定和篩選器。需要單一 ConditionValue。
TEXT_EQ 儲存格的值必須與條件的值完全相符。支援資料驗證、條件式格式設定和篩選器。必須提供一個 ConditionValue，分別用於資料驗證、條件式格式設定和非資料來源物件篩選器。另外，如果資料來源物件篩選器使用，則至少須有一個 ConditionValue。
TEXT_IS_EMAIL 儲存格的值必須是有效的電子郵件地址。由資料驗證支援。不需要 ConditionValues。
TEXT_IS_URL 儲存格的值必須是有效的網址。由資料驗證支援。不需要 ConditionValues。
DATE_EQ 儲存格的值必須與條件值相同。支援資料驗證、條件式格式設定和篩選器。必須提供一個 ConditionValue，分別用於資料驗證、條件式格式設定和非資料來源物件篩選器。另外，如果資料來源物件篩選器使用，則至少須有一個 ConditionValue。
DATE_BEFORE 儲存格的值必須早於條件值的日期。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue (可能為 relative date)。
DATE_AFTER 儲存格的值必須位於條件值的日期之後。支援資料驗證、條件式格式設定和篩選器。需要單一 ConditionValue (可能為 relative date)。
DATE_ON_OR_BEFORE 儲存格的值必須等於或早於條件值的日期。由資料驗證支援。需要單一 ConditionValue (可能為 relative date)。
DATE_ON_OR_AFTER 儲存格的值必須位於條件值當天或之後。由資料驗證支援。需要單一 ConditionValue (可能為 relative date)。
DATE_BETWEEN 儲存格的值必須介於兩個條件值的日期之間。由資料驗證支援。只需要兩個 ConditionValues。
DATE_NOT_BETWEEN 儲存格的值必須位於兩個條件值的日期之外。由資料驗證支援。只需要兩個 ConditionValues。
DATE_IS_VALID 儲存格的值必須是日期。由資料驗證支援。不需要 ConditionValues。
ONE_OF_RANGE 儲存格的值必須列在條件值範圍內的格狀中。由資料驗證支援。需要單一 ConditionValue，且值必須是 A1 標記法中的有效範圍。
ONE_OF_LIST 儲存格的值必須列在條件值清單中。由資料驗證支援。支援任何數量的 condition values，清單中的每個項目一個。值不支援公式。
BLANK 儲存格的值必須留空。支援條件式格式設定和篩選器。不需要 ConditionValues。
NOT_BLANK 儲存格的值不得留空。支援條件式格式設定和篩選器。不需要 ConditionValues。
CUSTOM_FORMULA 條件的公式必須評估為 True。支援資料驗證、條件式格式設定和篩選器。資料來源工作表篩選器不支援這項功能。需要單一 ConditionValue。
BOOLEAN 儲存格的值必須為 TRUE/FALSE 或條件值清單中。由資料驗證支援。算繪為儲存格核取方塊。支援零、一或兩個 ConditionValues。沒有任何值表示儲存格必須是 TRUE 或 FALSE，其中 TRUE 處於已勾選狀態，對應 FALSE 則會顯示為未勾選。一個值表示儲存格含有該值時，就會顯示為已勾選；空白時則取消勾選。兩個值代表儲存格含有第一個值時，這個儲存格會顯示為已勾選。如果第二個值含有第二個值，這個儲存格則會取消勾選。例如，[是] 表示「是」時，手機在
TEXT_NOT_EQ 儲存格的值必須與條件的值完全一致。由資料來源物件的篩選器支援。至少須有一項 ConditionValue。
DATE_NOT_EQ 儲存格的值必須與條件的值完全一致。由資料來源物件的篩選器支援。至少須有一項 ConditionValue。
FILTER_EXPRESSION 儲存格的值必須符合指定的模式。需要單一 ConditionValue。

ConditionValue

條件的值。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。必須設定條件的值，而且必須設定一個。value 只能是下列其中一個值：
relativeDate

enum (RelativeDate)

相對日期 (以目前日期為依據)。只有在 type、DATE_BEFORE、DATE_AFTER、DATE_ON_OR_BEFORE 或 DATE_ON_OR_AFTER 時才有效。

資料驗證不支援相對日期。且僅適用於條件式格式設定和條件篩選器。

userEnteredValue

string

條件的值。這個值會剖析成就像在儲存格中輸入值一樣。支援公式 (且必須以 = 或「+」開頭)。

相對日期

控制日期條件的評估方式。

列舉
RELATIVE_DATE_UNSPECIFIED 預設值，請勿使用。
PAST_YEAR 這個值會是今天前一年。
PAST_MONTH 值為今天前一個月。
PAST_WEEK 這個值會是今天前一週。
YESTERDAY 這個值是昨天。
TODAY 今日的值已生效。
TOMORROW 明天的值。

GridRange

工作表上的範圍。所有索引都是以零為計算依據。索引是一半的，也就是說，起始索引包含完整內容，結束索引是獨家的 -- [startIndex, endIndex)。缺少索引表示範圍沒有邊界。

舉例來說，如果 "Sheet1" 為工作表 ID 123456，則：

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

起始索引必須小於或等於結尾索引。如果起始索引等於結束索引，則範圍為空白。空白範圍通常沒有意義，且通常在 UI 中以 #REF! 顯示。

JSON 表示法 
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
欄位
sheetId

integer

已啟用這個範圍的工作表。

startRowIndex

integer

範圍的起始列 (包含)，或在不受限的情況下設定。

endRowIndex

integer

範圍的結束列 (不含)，如未設定則不設定。

startColumnIndex

integer

範圍的起始欄 (包含)，如不受限，則不會設定。

endColumnIndex

integer

範圍的結束欄 (不含)，如未設定時則設定。

排序順序

排列順序。

列舉
SORT_ORDER_UNSPECIFIED 預設值，請勿使用。
ASCENDING 遞增排序。
DESCENDING 遞減排序。

FilterSpec

與特定資料欄相關聯的篩選條件。

JSON 表示法 
{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
欄位
filterCriteria

object (FilterCriteria)

資料欄條件。

聯集欄位 reference。參照已篩選的資料欄。reference 只能是下列其中一個值：
columnIndex

integer

以 0 欄為基礎的索引。

dataSourceColumnReference

object (DataSourceColumnReference)

參照資料來源欄。

FilterFilters

在篩選器或篩選器檢視畫面中顯示/隱藏資料列的條件。

JSON 表示法 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
欄位
hiddenValues[]

string

您應隱藏的值。

condition

object (BooleanCondition)

條件結果為 true，才能顯示值。(這項設定不會覆寫 hiddenValues ... 如果有列出的值，系統仍會隱藏該值。)

visibleBackgroundColor
(deprecated)

object (Color)

要做為篩選條件的背景填滿顏色；系統只會顯示有填滿顏色的儲存格。與 visibleForegroundColor 互斥。已淘汰：使用 visibleBackgroundColorStyle。
visibleBackgroundColorStyle

object (ColorStyle)

要做為篩選條件的背景填滿顏色；系統只會顯示有填滿顏色的儲存格。這個欄位與 visibleForegroundColor 互斥，且必須設為 RGB 類型顏色。如果同時設定了 visibleBackgroundColor，系統會優先採用這個欄位。
visibleForegroundColor
(deprecated)

object (Color)

用於篩選的前景顏色；只會顯示這個前景顏色的儲存格。與 visibleBackgroundColor 互斥。已淘汰：使用 visibleForegroundColorStyle。
visibleForegroundColorStyle

object (ColorStyle)

用於篩選的前景顏色；只會顯示這個前景顏色的儲存格。這個欄位與 visibleBackgroundColor 互斥，且必須設為 RGB 類型顏色。如果同時設定了 visibleForegroundColor，系統會優先採用這個欄位。

SortSpec

與特定資料欄或資料列相關聯的排序順序。

JSON 表示法 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
欄位
sortOrder

enum (SortOrder)

排序資料應排序。

foregroundColor
(deprecated)

object (Color)

要排序的前景顏色；使用這個前景顏色的儲存格會由頂端排序。與 backgroundColor 互斥。已淘汰：使用 foregroundColorStyle。
foregroundColorStyle

object (ColorStyle)

要排序的前景顏色；使用這個前景顏色的儲存格會由頂端排序。與 backgroundColor 互斥，且必須是 RGB 類型顏色。如果同時設定了 foregroundColor，系統會優先採用這個欄位。
backgroundColor
(deprecated)

object (Color)

要用來排序的背景填滿顏色；系統會將這個填滿顏色的儲存格排序至頂端。與 foregroundColor 互斥。已淘汰：使用 backgroundColorStyle。
backgroundColorStyle

object (ColorStyle)

要用來排序的背景填滿顏色；系統會將這個填滿顏色的儲存格排序至頂端。與 foregroundColor 互斥，且必須是 RGB 類型顏色。如果同時設定了 backgroundColor，系統會優先採用這個欄位。
聯集欄位 reference。參照已排序的維度。 reference 只能是下列其中一個值：
dimensionIndex

integer

要套用排序的維度。

dataSourceColumnReference

object (DataSourceColumnReference)

參照資料來源欄。

內嵌物件位置

嵌入物件 (例如圖表) 的位置。

JSON 表示法 
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
欄位
聯集欄位 location。物件的位置。只能設定一個值。 location 只能是下列其中一個值：
sheetId

integer

已開啟此工作表。僅在嵌入物件位於其工作表時設定。必須為非負數。
overlayPosition

object (OverlayPosition)

物件在格線上方重疊的位置。
newSheet

boolean

如為 true，內嵌物件就會放在新的工作表中，且系統會為您選擇 ID。僅用於寫入。

OverlayPosition

物件在格線上方重疊的位置。

JSON 表示法 
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
欄位
anchorCell

object (GridCoordinate)

物件固定所在的儲存格。
offsetXPixels

integer

水平偏移值 (以像素為單位)，表示物件與錨定儲存格偏移。
offsetYPixels

integer

垂直偏移值 (以像素為單位)，表示物件與錨定儲存格偏移。
widthPixels

integer

物件的寬度 (以像素為單位)。預設值為 600。

heightPixels

integer

物件的高度，以像素為單位。預設為 371。

GridCoordinate

工作表中的座標。所有索引都是以零為計算依據。

JSON 表示法 
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
欄位
sheetId

integer

這個座標已開啟的工作表。
rowIndex

integer

座標的資料列索引。

columnIndex

integer

座標的資料欄索引。