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만큼 차이가 있는 경우 두 색상을 동일하게 취급합니다.

예시(자바):

 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;
}
// ...

예시(자바스크립트):

// ...

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)

테마 색상입니다.

ThemeColorType

테마 색상 유형

SpreadsheetProperties는 이러한 테마 색상 유형과 구체적인 색상의 매핑을 정의하는 SpreadsheetTheme를 포함합니다.

열거형
THEME_COLOR_TYPE_UNSPECIFIED 지정되지 않은 테마 색상
TEXT 기본 텍스트 색상을 나타냅니다.
BACKGROUND 기본 배경 색상을 나타냅니다.
ACCENT1 첫 번째 강조 색상을 나타냅니다.
ACCENT2 두 번째 강조 색상을 나타냅니다.
ACCENT3 세 번째 강조 색상을 나타냅니다.
ACCENT4 네 번째 강조 색상을 나타냅니다.
ACCENT5 다섯 번째 강조 색상을 나타냅니다.
ACCENT6 여섯 번째 강조 색상을 나타냅니다.

HorizontalAlign

셀 내 텍스트의 가로 정렬입니다.

열거형
HORIZONTAL_ALIGN_UNSPECIFIED 가로 정렬이 지정되지 않았습니다. 사용하지 마세요.
LEFT 텍스트가 셀의 왼쪽에 명시적으로 정렬됩니다.
CENTER 텍스트가 셀의 가운데에 명시적으로 정렬됩니다.
RIGHT 텍스트는 명시적으로 셀의 오른쪽에 정렬됩니다.

TextFormat

셀의 텍스트 행 형식입니다. 값이 없으면 필드가 지정되지 않았음을 나타냅니다.

JSON 표현
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
필드
foregroundColor
(deprecated)

object (Color)

텍스트의 전경색입니다. 지원 중단됨: foregroundColorStyle를 사용하세요.

foregroundColorStyle

object (ColorStyle)

텍스트의 전경색입니다. foregroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

fontFamily

string

글꼴 모음입니다.

fontSize

integer

글꼴 크기입니다.

bold

boolean

텍스트가 굵게 표시된 경우 true입니다.

italic

boolean

텍스트가 기울임꼴이면 true입니다.

strikethrough

boolean

텍스트에 취소선이 있는 경우 true입니다.

underline

boolean

텍스트에 밑줄이 표시되면 true입니다.

DataSourceColumn

데이터 소스의 열입니다.

JSON 표현
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
필드
reference

object (DataSourceColumnReference)

열 참조입니다.

formula

string

계산된 열의 수식입니다.

DataSourceColumnReference

데이터 소스 열을 참조하는 고유 식별자입니다.

JSON 표현
{
  "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 표현
{

  // 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 값을 나타냅니다. 참고: 날짜, 시간, DateTime은 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

오류에 관한 자세한 정보가 포함된 메시지 (스프레드시트의 언어로 표시됨)

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는 임의 개수의 값을 지원합니다.

ConditionType

조건의 유형입니다.

열거형
CONDITION_TYPE_UNSPECIFIED 기본값이며 사용하지 마세요.
NUMBER_GREATER 셀의 값이 조건의 값보다 커야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
NUMBER_GREATER_THAN_EQ 셀 값이 조건 값보다 크거나 같아야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
NUMBER_LESS 셀 값은 조건 값보다 작아야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
NUMBER_LESS_THAN_EQ 셀 값은 조건 값보다 작거나 같아야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
NUMBER_EQ 셀 값은 조건 값과 같아야 합니다. 데이터 유효성 검사, 조건부 서식, 필터로 지원됩니다. 데이터 유효성 검사, 조건부 형식 지정, 데이터가 아닌 소스 객체에 대한 필터에는 단일 ConditionValue, 데이터 소스 객체 필터에는 ConditionValue 1개 이상이 필요합니다.
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 1개 이상이 필요합니다.
DATE_BEFORE 셀의 값이 조건 값의 날짜보다 이전이어야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. relative date일 수 있는 단일 ConditionValue가 필요합니다.
DATE_AFTER 셀의 값이 조건 값의 날짜 이후여야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. relative date일 수 있는 단일 ConditionValue가 필요합니다.
DATE_ON_OR_BEFORE 셀 값은 조건 값의 날짜 또는 그 이전이어야 합니다. 데이터 유효성 검사로 지원됩니다. relative date일 수 있는 단일 ConditionValue가 필요합니다.
DATE_ON_OR_AFTER 셀 값은 조건 값의 날짜 또는 그 이후여야 합니다. 데이터 검증을 통해 지원됩니다. 단일 ConditionValue(relative date일 수 있음)가 필요합니다.
DATE_BETWEEN 셀 값은 두 조건 값의 날짜 사이여야 합니다. 데이터 검증을 통해 지원됩니다. 정확히 두 개의 ConditionValues가 필요합니다.
DATE_NOT_BETWEEN 셀 값이 두 조건 값의 날짜 범위를 벗어나야 합니다. 데이터 검증을 통해 지원됩니다. 정확히 2개의 ConditionValues가 필요합니다.
DATE_IS_VALID 셀 값은 날짜여야 합니다. 데이터 검증을 통해 지원됩니다. ConditionValues가 필요하지 않습니다.
ONE_OF_RANGE 셀 값은 그리드의 조건 값 범위에 나열되어야 합니다. 데이터 검증을 통해 지원됩니다. 단일 ConditionValue가 필요하며 값은 A1 표기법의 유효한 범위여야 합니다.
ONE_OF_LIST 셀 값은 조건값 목록에 있어야 합니다. 데이터 검증을 통해 지원됩니다. 목록의 항목당 하나씩 여러 condition values를 지원합니다. 값에는 수식이 지원되지 않습니다.
BLANK 셀 값은 비어 있어야 합니다. 조건부 서식 및 필터에서 지원됩니다. ConditionValues가 필요하지 않습니다.
NOT_BLANK 셀 값은 비워 둘 수 없습니다. 조건부 서식 및 필터가 지원됩니다. ConditionValues는 필요하지 않습니다.
CUSTOM_FORMULA 조건의 수식은 true로 평가되어야 합니다. 데이터 검증, 조건부 서식 지정, 필터에서 지원됩니다. 데이터 소스 시트 필터에서 지원되지 않습니다. 단일 ConditionValue가 필요합니다.
BOOLEAN 셀의 값은 TRUE/FALSE이거나 조건 값 목록에 있어야 합니다. 데이터 검증을 통해 지원됩니다. 셀 체크박스로 렌더링됩니다. 0, 1 또는 2개의 ConditionValues를 지원합니다. 값이 없으면 셀이 TRUE 또는 FALSE여야 함을 나타냅니다. 여기서 TRUE는 선택됨으로 렌더링되고 FALSE는 선택 해제됨으로 렌더링됩니다. 하나의 값은 셀에 해당 값이 포함된 경우 선택된 것으로 렌더링되고 비어 있는 경우에는 선택 해제된 것으로 렌더링됨을 나타냅니다. 두 값은 셀이 첫 번째 값을 포함할 때 선택된 것으로 렌더링되고 두 번째 값을 포함할 때 선택 해제된 것으로 렌더링됨을 나타냅니다. 예를 들어 ["Yes","No"]는 셀이 값이 "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)

상대 날짜 (현재 날짜 기준) typeDATE_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 값은 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 표현
{
  "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 표현
{
  "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 표현
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
필드
sortOrder

enum (SortOrder)

순서 데이터를 정렬해야 합니다.

foregroundColor
(deprecated)

object (Color)

정렬할 전경 색상입니다. 이 전경 색상이 있는 셀이 맨 위로 정렬됩니다. backgroundColor와 상호 배타적입니다. 지원 중단됨: foregroundColorStyle를 사용하세요.

foregroundColorStyle

object (ColorStyle)

정렬할 전경 색상입니다. 이 전경 색상이 있는 셀이 맨 위로 정렬됩니다. backgroundColor와 상호 배타적이며 RGB 유형 색상이어야 합니다. foregroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

backgroundColor
(deprecated)

object (Color)

정렬 기준으로 사용할 배경 채우기 색상입니다. 이 채우기 색상을 사용하는 셀은 맨 위에 정렬됩니다. foregroundColor와 상호 배타적입니다. 지원 중단됨: backgroundColorStyle를 사용하세요.

backgroundColorStyle

object (ColorStyle)

정렬할 배경 채우기 색상입니다. 이 채우기 색상이 있는 셀은 상단으로 정렬됩니다. foregroundColor와 상호 배타적이며 RGB 유형 색상이어야 합니다. backgroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

공용체 필드 reference입니다. 정렬된 측정기준에 대한 참조입니다. reference는 다음 중 하나여야 합니다.
dimensionIndex

integer

정렬을 적용할 측정기준입니다.

dataSourceColumnReference

object (DataSourceColumnReference)

데이터 소스 열 참조입니다.

EmbeddedObjectPosition

차트와 같은 삽입된 객체의 위치입니다.

JSON 표현
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
필드
통합 필드 location입니다. 객체의 위치입니다. 값을 정확히 하나만 설정해야 합니다. location는 다음 중 하나여야 합니다.
sheetId

integer

이 항목이 있는 시트입니다. 삽입된 객체가 자체 시트에 있는 경우에만 설정합니다. 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

좌표의 열 색인입니다.