Other

Color

代表 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 值指定為 1.0)。

ColorStyle

顏色值。

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	代表第六個強調色
LINK	代表超連結所使用的顏色

HorizontalAlign

儲存格內文字的水平對齊方式。

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

TextFormat

儲存格內文字的執行格式。如果缺少值，表示該欄位未指定。

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 如果文字加上底線，則為「是」。
link	object (Link) 文字的連結目的地 (如果有的話)。在 TextFormatRun 中設定連結欄位會清除儲存格的現有連結，或相同要求中設定的儲存格層級連結。設定連結後，系統會將文字前景顏色設為預設連結顏色，文字也會加上底線。如果在同一項要求中修改這些欄位，系統就會採用這些值，而非連結預設值。

連結

外部或本機參照。

JSON 表示法
{ // Union field destination can be only one of the following: "uri": string // End of list of possible types for union field destination. }

欄位
聯集欄位 destination。連結目的地。 destination 只能採用下列其中一種設定：
uri	string 連結 ID。

DataSourceColumn

資料來源中的資料欄。

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

欄位
reference	object (DataSourceColumnReference) 資料欄參照。
formula	string 計算結果欄的公式。

DataSourceColumnReference

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

JSON 表示法
{ "name": string }

欄位
name	string 資料欄的顯示名稱。在資料來源中，此 ID 不得重複。

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	資料執行程序已開始且正在執行。
CANCELLING	資料執行作業目前正在取消。
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	資料來源物件規格無效。
DATA_EXECUTION_CANCELLED	資料執行作業已取消。

ExtendedValue

試算表的儲存格可擁有的值類型。

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 代表字串值。不包括開頭單引號。舉例來說，如果使用者在 UI 中輸入 '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 的條件。BooleanConditions 可用於條件式格式、資料驗證和篩選器中的條件。

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

欄位
type	enum (ConditionType) 條件的類型。
values[]	object (ConditionValue) 條件的值。支援值的數量取決於 condition type。部分支援零值，其他部分支援一或兩個值，而 ConditionType.ONE_OF_LIST 支援任意數量的值。

ConditionType

條件的類型。

列舉
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	儲存格的值必須早於條件值的日期。支援資料驗證、條件式格式設定和篩選器。需要一個可以是 relative date 的 ConditionValue。
DATE_AFTER	儲存格的值必須晚於條件值的日期。支援資料驗證、條件式格式設定和篩選器。需要一個可以是 relative date 的 ConditionValue。
DATE_ON_OR_BEFORE	儲存格的值必須等於或早於條件值的日期。支援資料驗證。需要一個可以是 relative date 的 ConditionValue。
DATE_ON_OR_AFTER	儲存格的值必須等於或晚於條件值的日期。支援資料驗證。需要一個可以是 relative date 的 ConditionValue。
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 會顯示為未勾選。其中一個值表示儲存格含有該儲存格的值時，會顯示為勾選狀態，空白時則顯示為未勾選。兩個值表示儲存格若包含第一個值，則會顯示為勾選狀態，若包含第二個值，則顯示為未勾選。舉例來說，輸入 ["Yes","No"]，表示儲存格會在值為「Yes」的情況下顯示勾選方塊，且當儲存格值為「No」時則顯示未勾選的方塊。
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 條件的基礎值。系統會將這個值剖析為使用者在儲存格中輸入的內容。系統支援公式，且開頭須為 = 或「+」。

RelativeDate

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

列舉
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 範圍的結束欄 (不含範圍)；如果未設界限，則不設定。

SortOrder

排列順序。

列舉
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 從零開始的資料欄索引。
dataSourceColumnReference	object (DataSourceColumnReference) 參照資料來源資料欄。

FilterCriteria

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

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

欄位
hiddenValues[]	string 應隱藏的值。
condition	object (BooleanCondition) 值必須符合條件才會顯示。(這不會覆寫 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) 參照資料來源資料欄。

EmbeddedObjectPosition

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

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 座標的資料欄索引。