此页面由 Cloud Translation API 翻译。

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

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`	单元格的值必须早于条件值的日期。受数据验证、条件格式和过滤条件支持。需要一个可能为 `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 会呈现为未选中。一个值表示当单元格包含该值时，将呈现为勾选状态；当单元格为空时，将呈现为未勾选状态。两个值表示，当单元格包含第一个值时，将呈现为勾选状态；当单元格包含第二个值时，将呈现为未勾选状态。例如，[“是”“否”] 表示当单元格值为“是”时，系统会呈现选中复选框，当单元格值为“否”时，系统会呈现未选中复选框。
`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

工作表中的坐标。所有索引均从 0 开始。

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