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 值)。

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 代表第六個強調色

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

如果文字加上底線，則為 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 資料執行作業已開始並正在執行。
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 儲存格的值必須早於條件值的日期。資料驗證、條件式格式設定和篩選器皆支援此功能。需要單一 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

條件依據的值。系統會將值解析為使用者輸入儲存格時的值。支援公式 (且開頭必須是 = 或「+」)。

RelativeDate

控制日期條件評估方式。

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

GridRange

工作表上的範圍。所有索引都是從 0 開始。索引為一半開放，也就是說，起始索引已包含在內，且結尾索引不包含在內 ([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)

此條件必須為 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)

參照資料來源欄。

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

試算表中的座標。所有索引都是從 0 開始計算。

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

integer

這個座標所在的工作表。
rowIndex

integer

座標的列索引。
columnIndex

integer

座標的資料欄索引。