Other

색상

RGBA 색상 공간의 색상을 나타냅니다. 이 표현은 간결성보다 다양한 언어의 색상 표현으로의 변환을 간소화하기 위해 설계되었습니다. 예를 들어 이 표현의 필드는 Java에서 java.awt.Color의 생성자에 쉽게 제공될 수 있습니다. 또한 iOS에서 UIColor의 +colorWithRed:green:blue:alpha 메서드에 쉽게 제공될 수 있으며, 약간의 작업만으로 JavaScript에서 CSS rgba() 문자열로 쉽게 포맷될 수 있습니다.

이 참조 페이지에는 RGB 값(예: sRGB, Adobe RGB, DCI-P3, BT.2020)을 해석하는 데 사용해야 하는 절대 색상 공간에 대한 정보가 없습니다. 기본적으로 애플리케이션은 sRGB 색상 공간을 가정해야 합니다.

색상 동등성을 결정해야 하는 경우 구현은 달리 문서화되지 않는 한 빨간색, 녹색, 파란색, 알파 값이 각각 최대 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 값은 완전히 투명한 색상에 해당합니다. 이 옵션은 단순한 부동 소수점 스칼라 대신 래퍼 메시지를 사용하므로 기본값과 설정되지 않은 값을 구분할 수 있습니다. 생략하면 이 색상 객체는 단색으로 렌더링됩니다 (알파 값이 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` double 값을 나타냅니다. 참고: 날짜, 시간, 날짜 및 시간은 `SERIAL_NUMBER` 형식으로 double로 표현됩니다.
`stringValue`	`string` 문자열 값을 나타냅니다. 앞에 오는 작은따옴표는 포함되지 않습니다. 예를 들어 사용자가 UI에 `'123`를 입력한 경우 이는 `"123"`의 `stringValue`로 표시됩니다.
`boolValue`	`boolean` 불리언 값을 나타냅니다.
`formulaValue`	`string` 수식을 나타냅니다.
`errorValue`	`object (ErrorValue)` 오류를 나타냅니다. 이 필드는 읽기 전용입니다.

ErrorValue

셀의 오류입니다.

JSON 표현
{ "type": enum (`ErrorType`), "message": string }

필드

필드
`type`	`enum (ErrorType)` 오류 유형입니다.
`message`	`string` 오류에 관한 자세한 정보가 포함된 메시지입니다 (스프레드시트의 언어).

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`에 따라 다릅니다. 일부는 0 값을 지원하고, 다른 일부는 1~2개의 값을 지원하며, `ConditionType.ONE_OF_LIST`는 임의의 개수의 값을 지원합니다.

type

enum (ConditionType)

조건 유형입니다.

values[]

object (ConditionValue)

조건의 값입니다. 지원되는 값의 수는 condition type에 따라 다릅니다. 일부는 0 값을 지원하고, 다른 일부는 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`	셀의 값은 유효한 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`를 0개, 1개 또는 2개 지원합니다. 값이 없으면 셀이 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`	값은 오늘로부터 1년 전입니다.
`PAST_MONTH`	값이 오늘로부터 한 달 전입니다.
`PAST_WEEK`	값은 오늘로부터 1주일 전입니다.
`YESTERDAY`	값은 어제입니다.
`TODAY`	값은 오늘입니다.
`TOMORROW`	값이 내일입니다.

GridRange

시트의 범위입니다. 모든 색인은 0부터 시작합니다. 색인은 절반 개방입니다. 즉, 시작 색인은 포함되고 종료 색인은 제외됩니다([startIndex, endIndex)). 색인이 누락되면 해당 측면에서 범위가 무한함을 나타냅니다.

예를 들어 "Sheet1"이 시트 ID 123456인 경우 다음이 적용됩니다.

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

시작 색인은 항상 종료 색인보다 작거나 같아야 합니다. 시작 색인이 종료 색인과 같으면 범위가 비어 있습니다. 빈 범위는 일반적으로 의미가 없으며 UI에서 #REF!로 렌더링됩니다.

JSON 표현
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer }

필드
`sheetId`	`integer` 이 범위가 있는 시트입니다.
`startRowIndex`	`integer` 범위의 시작 행 (포함)입니다. 무한대인 경우 설정되지 않습니다.
`endRowIndex`	`integer` 범위의 끝 행 (해당 값 제외)입니다. 무한대인 경우 설정되지 않습니다.
`startColumnIndex`	`integer` 범위의 시작 열 (포함)입니다. 경계가 없는 경우 설정되지 않습니다.
`endColumnIndex`	`integer` 범위의 끝 열 (해당 값 제외)입니다. 무한대인 경우 설정되지 않습니다.

SortOrder

정렬 순서입니다.

열거형
`SORT_ORDER_UNSPECIFIED`	기본값이며 사용하지 마세요.
`ASCENDING`	오름차순으로 정렬합니다.
`DESCENDING`	내림차순으로 정렬합니다.

FilterSpec

특정 열과 연결된 필터 기준입니다.

JSON 표현

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` 0부터 시작하는 열 색인입니다.
`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` 이 값이 있는 시트입니다. 삽입된 객체가 자체 시트에 있는 경우에만 설정합니다. Must be non-negative.
`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