Эта страница переведена с помощью Cloud Translation API.

Other

Цвет

Представляет цвет в цветовом пространстве RGBA. Это представление разработано для простоты преобразования в и из цветовых представлений в различных языках в пользу компактности. Например, поля этого представления могут быть тривиально предоставлены конструктору java.awt.Color в Java; его также можно тривиально предоставить методу +colorWithRed:green:blue:alpha UIColor в iOS; и, приложив немного усилий, его можно легко отформатировать в строку CSS rgba() в JavaScript.

На этой странице справки нет информации об абсолютном цветовом пространстве, которое следует использовать для интерпретации значения RGB, например, sRGB, Adobe RGB, DCI-P3 и BT.2020. По умолчанию приложения должны предполагать цветовое пространство sRGB.

Когда необходимо определить равенство цветов, реализации, если иное не указано в документации, считают два цвета равными, если все их значения красного, зеленого, синего и альфа отличаются не более чем на 1e-5 .

Пример (Ява):

 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 соответствует полностью прозрачному цвету. Это использует сообщение-оболочку, а не простой скаляр с плавающей точкой, так что можно различать значение по умолчанию и значение, которое не задано. Если пропущено, этот цветовой объект отображается как сплошной цвет (как если бы альфа-значению было явно присвоено значение 1,0).

ЦветСтиль

Цветовое значение.

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 )` Цвет темы.

Поле объединения kind . Вид значения цвета. kind может быть только одним из следующих:

rgbColor

object ( Color )

Цвет RGB. alpha значение в объекте Color обычно не поддерживается.

themeColor

enum ( ThemeColorType )

Цвет темы.

ТемаЦветТип

Типы цветов темы.

SpreadsheetProperties содержит SpreadsheetTheme , который определяет сопоставление этих типов цветов темы с конкретными цветами.

Перечисления
`THEME_COLOR_TYPE_UNSPECIFIED`	Неуказанный цвет темы
`TEXT`	Представляет основной цвет текста.
`BACKGROUND`	Представляет основной цвет фона.
`ACCENT1`	Представляет первый акцентный цвет.
`ACCENT2`	Представляет второй акцентный цвет.
`ACCENT3`	Представляет третий акцентный цвет.
`ACCENT4`	Представляет четвертый акцентный цвет.
`ACCENT5`	Представляет пятый акцентный цвет.
`ACCENT6`	Представляет шестой акцентный цвет.
`LINK`	Представляет цвет, используемый для гиперссылок.

ГоризонтальноеВыравнивание

Горизонтальное выравнивание текста в ячейке.

Перечисления
`HORIZONTAL_ALIGN_UNSPECIFIED`	Горизонтальное выравнивание не указано. Не используйте это.
`LEFT`	Текст явно выровнен по левому краю ячейки.
`CENTER`	Текст явно выровнен по центру ячейки.
`RIGHT`	Текст явно выровнен по правому краю ячейки.

ТекстовыйФормат

Формат текста в ячейке. Отсутствующие значения указывают на то, что поле не указано.

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. `destination` может быть только одним из следующих:
`uri`	`string` Идентификатор ссылки.

Поле объединения destination . Ссылка destination. destination может быть только одним из следующих:

uri

string

Идентификатор ссылки.

ИсточникДанныеСтолбец

Столбец в источнике данных.

JSON-представление
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

Поля

Поля
`reference`	`object ( DataSourceColumnReference )` Ссылка на столбец.
`formula`	`string` Формула расчетного столбца.

reference

object ( DataSourceColumnReference )

Ссылка на столбец.

formula

string

Формула расчетного столбца.

ИсточникДанныеСсылкаНаСтолбец

Уникальный идентификатор, ссылающийся на столбец источника данных.

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`	Выполнение данных завершено с ошибками.

Код ошибки выполнения данных

Перечисление кодов ошибок выполнения данных.

Перечисления
`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`	Выполнение данных отменено.

РасширенноеЗначение

Виды значений, которые может иметь ячейка в электронной таблице.

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` Представляет значение типа double. Примечание: Даты, время и DateTimes представлены как значения типа double в формате `SERIAL_NUMBER` .
`stringValue`	`string` Представляет строковое значение. Начальные одинарные кавычки не включаются. Например, если пользователь ввел `'123` в UI, это будет представлено как `stringValue` `"123"` .
`boolValue`	`boolean` Представляет логическое значение.
`formulaValue`	`string` Представляет собой формулу.
`errorValue`	`object ( ErrorValue )` Представляет ошибку. Это поле доступно только для чтения.

ЗначениеОшибки

Ошибка в ячейке.

JSON-представление
{ "type": enum (`ErrorType`), "message": string }

Поля

Поля
`type`	`enum ( ErrorType )` Тип ошибки.
`message`	`string` Сообщение с дополнительной информацией об ошибке (в локали электронной таблицы).

type

enum ( ErrorType )

Тип ошибки.

message

string

Сообщение с дополнительной информацией об ошибке (в локали электронной таблицы).

Тип ошибки

Тип ошибки.

Перечисления
`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...`

БулевоеУсловие

Условие, которое может быть оценено как истинное или ложное. Булевы условия используются условным форматированием, проверкой данных и критериями в фильтрах.

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 поддерживает произвольное количество значений.

ТипСостояния

Тип состояния.

Перечисления
`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`	Значение ячейки должно быть допустимым 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`	Формула условия должна быть оценена как истинная. Поддерживается проверкой данных, условным форматированием и фильтрами. Не поддерживается фильтрами листа источника данных. Требуется один `ConditionValue` .
`BOOLEAN`	Значение ячейки должно быть TRUE/FALSE или находиться в списке значений условия. Поддерживается проверкой данных. Отображается как флажок ячейки. Поддерживает ноль, один или два `ConditionValues` . Отсутствие значений указывает, что ячейка должна иметь значение TRUE или FALSE, где TRUE отображается как отмеченный, а FALSE отображается как неотмеченный. Одно значение указывает, что ячейка будет отображаться как отмеченный, если она содержит это значение, и как неотмеченный, если она пустая. Два значения указывают, что ячейка будет отображаться как отмеченный, если она содержит первое значение, и как неотмеченный, если она содержит второе значение. Например, ["Да","Нет"] указывает, что ячейка будет отображаться как отмеченный, если она имеет значение "Да", и как неотмеченный, если она имеет значение "Нет".
`TEXT_NOT_EQ`	Значение ячейки должно быть точно не значением условия. Поддерживается фильтрами в объектах источника данных. Требуется по крайней мере одно `ConditionValue` .
`DATE_NOT_EQ`	Значение ячейки должно быть точно не значением условия. Поддерживается фильтрами в объектах источника данных. Требуется по крайней мере одно `ConditionValue` .
`FILTER_EXPRESSION`	Значение ячейки должно соответствовать указанному шаблону. Требуется один `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

Значение, на котором основано условие. Значение анализируется так, как если бы пользователь ввел его в ячейку. Формулы поддерживаются (и должны начинаться с = или '+').

ОтносительнаяДата

Управляет тем, как оценивается условие даты.

Перечисления
`RELATIVE_DATE_UNSPECIFIED`	Значение по умолчанию, не использовать.
`PAST_YEAR`	Значение указано на год раньше сегодняшнего дня.
`PAST_MONTH`	Значение указано за месяц до сегодняшнего дня.
`PAST_WEEK`	Значение указано на одну неделю раньше сегодняшнего дня.
`YESTERDAY`	Значение вчерашнее.
`TODAY`	Ценность сегодняшняя.
`TOMORROW`	Значение имеет завтрашний день.

GridRange

Диапазон на листе. Все индексы отсчитываются от нуля. Индексы полуоткрыты, т. е. начальный индекс является включающим, а конечный индекс является исключающим — [startIndex, endIndex). Отсутствующие индексы указывают на то, что диапазон не ограничен с этой стороны.

Например, если "Sheet1" — это идентификатор листа 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` Конечный столбец (исключая) диапазона или не задан, если диапазон не ограничен.

СортироватьПорядок

Порядок сортировки.

Перечисления
`SORT_ORDER_UNSPECIFIED`	Значение по умолчанию, не используйте его.
`ASCENDING`	Сортировать по возрастанию.
`DESCENDING`	Сортировать по убыванию.

ФильтрСпецификации

Критерии фильтра, связанные с определенным столбцом.

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 )` Ссылка на столбец источника данных.

ФильтрКритерии

Критерии отображения/скрытия строк в фильтре или представлении фильтра.

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 )` Условие, которое должно быть истинным для отображения значений. (Это не переопределяет `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 )` Ссылка на столбец источника данных.

ВстроенноеПоложениеОбъекта

Положение встроенного объекта, например диаграммы.

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, то внедренный объект помещается на новый лист, идентификатор которого выбирается за вас. Используется только при записи.

НаложениеПозиция

Местоположение объекта, наложенного поверх сетки.

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.

Координатная сетка

Координата в листе. Все индексы отсчитываются от нуля.

JSON-представление
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

Поля

Поля
`sheetId`	`integer` Лист, на котором находится эта координата.
`rowIndex`	`integer` Индекс строки координаты.
`columnIndex`	`integer` Индекс столбца координаты.

sheetId

integer

Лист, на котором находится эта координата.

rowIndex

integer

Индекс строки координаты.

columnIndex

integer

Индекс столбца координаты.

Other Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Цвет

ЦветСтиль

ТемаЦветТип

ГоризонтальноеВыравнивание

ТекстовыйФормат

Связь

ИсточникДанныеСтолбец

ИсточникДанныеСсылкаНаСтолбец

DataExecutionStatus

DataExecutionState

Код ошибки выполнения данных

РасширенноеЗначение

ЗначениеОшибки

Тип ошибки

БулевоеУсловие

ТипСостояния

СостояниеЗначение

ОтносительнаяДата

GridRange

СортироватьПорядок

ФильтрСпецификации

ФильтрКритерии

SortSpec

ВстроенноеПоложениеОбъекта

НаложениеПозиция

Координатная сетка

Other