Other

彩色

此屬性代表 RGBA 色域中的顏色。這種呈現方式是為了簡化與不同語言的色彩表示法之間相互轉換的設計。例如,此表示式的欄位可以輕鬆提供給 java.awt.Color Java;也可以經常提供給 UIColor 的 +colorWithRed:green:blue:alpha 方法;你只要稍加工作,即可輕鬆將範本轉換為 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 顏色。 alpha敬上 值 Color 系統通常不支援此物件

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

如果文字是斜體,則為「是」。

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

資料欄的顯示名稱。在資料來源中,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 資料來源物件目前處於錯誤狀態。如要強制重新整理,請設定 force 英吋 RefreshDataSourceRequest
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

代表字串值。且不含開頭單引號。例如,如果使用者輸入 '123 這就代表 stringValue / "123"

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。某些類型支援零值、其他 1 或 2 個值,以及 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,或是條件值清單中的儲存格。受資料驗證支援。顯示為儲存格核取方塊。支援 0、1 或 2 ConditionValues。沒有值表示儲存格必須是 TRUE 或 FALSE;也就是說,TRUE 會顯示為勾選,而 FALSE 會顯示為未勾選。單一值代表儲存格含有該值時會顯示為已勾選,為空白時,則會處於未勾選狀態。兩個值表示儲存格含有第一個值時,會顯示為已勾選;如果儲存格含有第二個值,則會處於未勾選狀態。例如,["Yes","No"] 表示儲存格的值為已勾選的方塊,如果值為「是」值為「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)

相對日期 (以目前日期為準)。本優惠僅適用於 typeDATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFOREDATE_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)

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

工作表中的座標。所有索引都從零開始。

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

integer

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

rowIndex

integer

座標的列索引。

columnIndex

integer

座標的欄索引。