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)` 主题颜色。

联合字段 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 表示法

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

{
  "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。
`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` 链接标识符。

联合字段 destination。链接目的地。 destination 只能是下列其中一项：

uri

string

链接标识符。

DataSourceColumn

数据源中的列。

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

字段

字段
`reference`	`object (DataSourceColumnReference)` 列引用。
`formula`	`string` 计算列的公式。

reference

object (DataSourceColumnReference)

列引用。

formula

string

计算列的公式。

DataSourceColumnReference

引用数据源列的唯一标识符。

JSON 表示法
{ "name": string }

字段

字段
`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 表示法

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`. }

{

  // 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` 包含有关错误的更多信息的消息（采用电子表格的语言区域设置）。

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 的条件。BooleanCondition 可用于条件格式、数据验证和过滤条件中的条件。

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

字段

字段
`type`	`enum (ConditionType)` 条件的类型。
`values[]`	`object (ConditionValue)` 条件的值。支持的值的数量取决于 `condition type`。有些支持零个值，有些支持一个或两个值，而 `ConditionType.ONE_OF_LIST` 支持任意数量的值。

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`，该 `ConditionValue` 可以是 `relative date`。
`DATE_AFTER`	单元格的值必须晚于条件值中的日期。受数据验证、条件格式和过滤条件支持。需要单个 `ConditionValue`，该 `ConditionValue` 可以是 `relative date`。
`DATE_ON_OR_BEFORE`	相应单元格的值必须不晚于条件值所对应的日期。受数据验证支持。需要单个 `ConditionValue`，该 `ConditionValue` 可以是 `relative date`。
`DATE_ON_OR_AFTER`	单元格的值必须不早于条件值的日期。受数据验证支持。需要单个 `ConditionValue`，该 `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 会呈现为未选中状态。一个值表示当单元格包含该值时，系统会将其呈现为已勾选；当单元格为空时，系统会将其呈现为未勾选。这两个值表示，当单元格包含第一个值时，系统会将其呈现为已选中；当单元格包含第二个值时，系统会将其呈现为未选中。例如，["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` 条件所依据的值。系统会解析该值，就好像用户在单元格中输入了该值一样。支持公式（且必须以 `=` 或“+”开头）。

联合字段 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

起始索引必须始终小于或等于结束索引。如果起始索引与结束索引相同，则范围为空。空范围通常没有意义，在界面中通常会呈现为 #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 表示法

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)
  },

  // 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 表示法

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

{
  "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 表示法

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": {
    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 表示法

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`. }

{

  // 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` 相应坐标的列索引。

sheetId

integer

相应坐标所在的工作表。

rowIndex

integer

相应坐标的行索引。

columnIndex

integer

相应坐标的列索引。

Other 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

颜色

ColorStyle

ThemeColorType

HorizontalAlign

TextFormat

链接

DataSourceColumn

DataSourceColumnReference

DataExecutionStatus

DataExecutionState

DataExecutionErrorCode

ExtendedValue

ErrorValue

ErrorType

BooleanCondition

ConditionType

ConditionValue

RelativeDate

GridRange

SortOrder

FilterSpec

FilterCriteria

SortSpec

EmbeddedObjectPosition

OverlayPosition

GridCoordinate

Other