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

참 또는 거짓으로 평가할 수 있는 조건입니다. BooleanCondition은 조건부 서식, 데이터 유효성 검사, 필터의 기준에 사용됩니다.

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가, 데이터 소스 객체의 필터에는 1개 이상의 ConditionValue가 필요합니다.
NUMBER_NOT_EQ 셀 값이 조건 값과 같아서는 안 됩니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 데이터 유효성 검사, 조건부 형식 지정, 데이터가 아닌 소스 객체의 필터에는 단일 ConditionValue가, 데이터 소스 객체의 필터에는 1개 이상의 ConditionValue가 필요합니다.
NUMBER_BETWEEN 셀 값은 두 조건값 사이에 있어야 합니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 정확히 2개의 ConditionValues가 필요합니다.
NUMBER_NOT_BETWEEN 셀 값이 두 조건값 사이에 있지 않아야 합니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 정확히 2개의 ConditionValues가 필요합니다.
TEXT_CONTAINS 셀 값에는 조건 값이 포함되어야 합니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 단일 ConditionValue가 필요합니다.
TEXT_NOT_CONTAINS 셀 값에 조건 값이 포함되면 안 됩니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 단일 ConditionValue가 필요합니다.
TEXT_STARTS_WITH 셀 값은 조건 값으로 시작해야 합니다. 조건부 서식 및 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
TEXT_ENDS_WITH 셀 값은 조건 값으로 끝나야 합니다. 조건부 서식 및 필터에서 지원됩니다. 단일 ConditionValue가 필요합니다.
TEXT_EQ 셀 값은 정확히 조건 값과 일치해야 합니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 데이터 유효성 검사, 조건부 형식 지정, 데이터가 아닌 소스 객체의 필터에는 단일 ConditionValue가, 데이터 소스 객체의 필터에는 1개 이상의 ConditionValue가 필요합니다.
TEXT_IS_EMAIL 셀 값은 유효한 이메일 주소여야 합니다. 데이터 유효성 검사에서 지원됩니다. ConditionValues가 필요하지 않습니다.
TEXT_IS_URL 셀 값은 유효한 URL이어야 합니다. 데이터 유효성 검사에서 지원됩니다. ConditionValues가 필요하지 않습니다.
DATE_EQ 셀 값은 조건 값과 동일한 날짜여야 합니다. 데이터 유효성 검사, 조건부 형식 지정, 필터로 지원됩니다. 데이터 유효성 검사, 조건부 형식 지정, 데이터가 아닌 소스 객체의 필터에는 단일 ConditionValue가, 데이터 소스 객체의 필터에는 1개 이상의 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 셀 값은 두 조건 값의 날짜 사이에 있어야 합니다. 데이터 유효성 검사에서 지원됩니다. 정확히 2개의 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가 1개 이상 필요합니다.
DATE_NOT_EQ 셀 값은 조건 값과 정확히 달라야 합니다. 데이터 소스 객체의 필터에서 지원됩니다. ConditionValue가 1개 이상 필요합니다.
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. 조건 값으로 정확히 1을 설정해야 합니다. 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 값은 오늘 1개월 전입니다.
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 표현
{
  "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)

값이 표시되려면 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 표현
{
  "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

좌표의 열 색인입니다.