색상
RGBA 색상 공간의 색상을 나타냅니다. 이 표현은 다양한 언어에서 간결하게 여러 언어로 된 색상 표현으로 간편하게 변환할 수 있도록 설계되었습니다. 예를 들어 이 표현의 필드는 자바에서 java.awt.Color
의 생성자에 쉽게 제공할 수 있습니다. 또한 iOS에서 UIColor의 +colorWithRed:green:blue:alpha
메서드에 쉽게 제공할 수 있으며 약간의 작업만으로 자바스크립트에서 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
|
[0, 1] 간격의 값으로 표시되는 색상의 빨간색 양입니다. |
green
|
[0, 1] 간격의 값으로 표시되는 색상의 녹색 양입니다. |
blue
|
[0, 1] 간격의 값으로 표시되는 색상의 파란색 양입니다. |
alpha
|
픽셀에 적용해야 하는 이 색상의 비율입니다. 즉, 최종 픽셀 색상은 등식으로 정의됩니다.
즉, 1.0 값은 단색에 해당하는 반면 0.0 값은 완전히 투명한 색상에 해당합니다. 이 옵션은 단순한 부동 소수점 스칼라 대신 래퍼 메시지를 사용하므로 기본값과 설정되지 않은 값을 구분할 수 있습니다. 생략하면 이 색상 객체가 단색으로 렌더링됩니다 (알파 값에 1.0 값이 명시적으로 부여된 것처럼). |
색상 스타일(ColorStyle)
색상 값입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 kind 는 색상 값의 종류입니다.
kind 는 다음 중 하나여야 합니다.
|
|
rgbColor
|
|
themeColor
|
테마 색상 |
테마색상 유형
테마 색상 유형
SpreadsheetProperties
에는 이러한 테마 색상 유형을 구체적인 색상으로 매핑하는 SpreadsheetTheme
를 포함합니다.
열거형 | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
지정되지 않은 테마 색상 |
TEXT
|
기본 텍스트 색상을 나타냅니다. |
BACKGROUND
|
기본 배경색을 나타냅니다. |
ACCENT1
|
첫 번째 강조 색상을 나타냅니다. |
ACCENT2
|
두 번째 강조 색상을 나타냅니다. |
ACCENT3
|
세 번째 강조 색상을 나타냅니다. |
ACCENT4
|
네 번째 강조 색상을 나타냅니다. |
ACCENT5
|
다섯 번째 강조 색상을 나타냅니다. |
ACCENT6
|
6번째 강조 색상을 나타냅니다. |
LINK
|
하이퍼링크에 사용할 색상을 나타냅니다. |
가로 맞춤
셀 내 텍스트의 가로 정렬입니다.
열거형 | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
가로 정렬은 지정되지 않았습니다. 사용하지 마세요. |
LEFT
|
텍스트가 셀 왼쪽에 명시적으로 정렬됩니다. |
CENTER
|
텍스트가 셀 가운데에 명시적으로 정렬됩니다. |
RIGHT
|
텍스트가 셀 오른쪽에 명시적으로 정렬됩니다. |
텍스트 형식
셀의 텍스트 런 형식입니다. 값이 없는 경우 필드가 지정되지 않았음을 나타냅니다.
JSON 표현 |
---|
{ "foregroundColor": { object ( |
필드 | |
---|---|
foregroundColor
|
텍스트의 전경색입니다. 지원 중단됨: |
foregroundColorStyle
|
텍스트의 전경색입니다. |
fontFamily
|
글꼴 모음 |
fontSize
|
글꼴 크기 |
bold
|
텍스트가 굵게 표시되면 true입니다. |
italic
|
텍스트에 기울임꼴이 있으면 true입니다. |
strikethrough
|
텍스트에 취소선이 있는 경우 true입니다. |
underline
|
텍스트에 밑줄이 그어 있으면 참입니다. |
link
|
텍스트의 링크 대상입니다(있는 경우). |
링크
외부 또는 로컬 참조
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 destination 는 링크 대상입니다.
destination 는 다음 중 하나여야 합니다.
|
|
uri
|
링크 식별자입니다. |
데이터 소스 열
데이터 소스의 열
JSON 표현 |
---|
{
"reference": {
object (
|
필드 | |
---|---|
reference
|
열 참조입니다. |
formula
|
계산된 열의 수식입니다. |
데이터 소스 열 참조
데이터 소스 열을 참조하는 고유 식별자입니다.
JSON 표현 |
---|
{ "name": string } |
필드 | |
---|---|
name
|
열의 표시 이름입니다. 데이터 소스 내에서 고유해야 합니다. |
데이터 실행 상태
데이터 실행 상태입니다.
데이터 소스 객체를 DataSource
의 최신 데이터와 동기화하기 위해 데이터 실행이 생성됩니다. 일반적으로 백그라운드에서 실행되도록 예약됩니다. state
를 확인하여 실행이 완료되었는지 확인할 수 있습니다.
데이터 실행이 트리거되도록 하는 시나리오에는 몇 가지가 있습니다.
-
Adding a data source
은 연결된 데이터 소스 시트와 데이터 실행을 만들어 데이터 소스의 데이터를 시트로 동기화합니다. -
Updating a data source
는 데이터 실행을 생성하여 연결된 데이터 소스 시트를 유사하게 새로고침합니다. -
refresh request
를 전송하여 하나 이상의 데이터 소스 객체를 명시적으로 새로고침할 수 있습니다.
JSON 표현 |
---|
{ "state": enum ( |
필드 | |
---|---|
state
|
데이터 실행 상태입니다. |
errorCode
|
오류 코드입니다. |
errorMessage
|
오류 메시지입니다. 비어 있을 수 있습니다. |
lastRefreshTime
|
데이터가 마지막으로 새로고침된 시간을 가져옵니다. |
DataExecutionState 클래스의 생성자
데이터 실행 상태의 열거형입니다.
열거형 | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
NOT_STARTED
|
데이터 실행이 시작되지 않았습니다. |
RUNNING
|
데이터 실행이 시작되어 실행 중입니다. |
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
|
데이터 소스 객체가 현재 오류 상태입니다. 강제로 새로고침하려면 RefreshDataSourceRequest 에서 force 를 설정하세요.
|
OBJECT_SPEC_INVALID
|
데이터 소스 객체 사양이 잘못되었습니다. |
확장 값
스프레드시트의 셀에 포함할 수 있는 값의 종류입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 value 는 셀의 값 유형입니다. 필드를 설정하지 않으면 셀에 데이터가 없는 것입니다.
value 는 다음 중 하나여야 합니다.
|
|
numberValue
|
double 값을 나타냅니다. 참고: Date, Times, DateTime은 |
stringValue
|
문자열 값을 나타냅니다. 선행하는 작은따옴표는 포함되지 않습니다. 예를 들어 사용자가 UI에 |
boolValue
|
불리언 값을 나타냅니다. |
formulaValue
|
수식을 나타냅니다. |
errorValue
|
오류를 나타냅니다. 읽기 전용 필드입니다. |
오류 값
셀에 오류가 있습니다.
JSON 표현 |
---|
{
"type": enum (
|
필드 | |
---|---|
type
|
오류 유형입니다. |
message
|
오류에 대한 자세한 정보가 포함된 메시지 (스프레드시트 언어) |
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... 상태에 해당합니다.
|
부울 조건
참 또는 거짓으로 평가할 수 있는 조건입니다. booleanConditions는 조건부 서식, 데이터 유효성 검사, 필터의 기준으로 사용됩니다.
JSON 표현 |
---|
{ "type": enum ( |
필드 | |
---|---|
type
|
조건 유형입니다. |
values[]
|
조건의 값입니다. 지원되는 값 수는 |
조건 유형
조건 유형입니다.
열거형 | |
---|---|
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
|
셀의 값은 두 조건 값 사이에 있어야 합니다. 데이터 유효성 검사, 조건부 서식 및 필터에서 지원됩니다. 정확히 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 가 필요하고 데이터 소스 객체의 필터에는 하나 이상의 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
|
셀의 값은 두 조건값의 날짜 사이에 있어야 합니다. 데이터 검증에서 지원됩니다. 정확히 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이거나 조건값 목록에 있어야 합니다. 데이터 검증에서 지원됩니다. 셀로 렌더링 체크박스를 선택합니다. ConditionValues 0개, 1개 또는 2개를 지원합니다. 어떤 값도 셀이 TRUE 또는 FALSE여야 함을 나타냅니다. 여기서 TRUE는 선택된 대로 렌더링하고 FALSE는 선택 해제된 상태로 렌더링합니다. 한 값은 셀이 해당 값을 포함하는 경우 선택된 대로 렌더링하고 비어 있는 경우에는 선택 해제된 것을 나타냅니다. 두 값은 셀이 첫 번째 값을 포함할 때 선택된 것으로 렌더링되고 두 번째 값을 포함할 때 선택 해제된 상태로 렌더링됨을 나타냅니다. 예를 들어 ["Yes","No"] 는 셀에서 값이 'Yes'일 때 선택된 체크박스를 렌더링하고 값이 'No'일 때 선택된 체크박스를 렌더링합니다.
|
TEXT_NOT_EQ
|
셀의 값은 조건의 값이 아니어야 합니다. 데이터 소스 객체의 필터에서 지원됩니다. ConditionValue 가 1개 이상 필요합니다.
|
DATE_NOT_EQ
|
셀의 값은 조건의 값이 아니어야 합니다. 데이터 소스 객체의 필터에서 지원됩니다. ConditionValue 가 1개 이상 필요합니다.
|
FILTER_EXPRESSION
|
셀의 값은 지정된 패턴을 따라야 합니다. 단일 ConditionValue 가 필요합니다.
|
조건값
조건의 값입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 value 는 조건 값으로, 정확히 한 개를 설정해야 합니다.
value 는 다음 중 하나여야 합니다.
|
|
relativeDate
|
상대 날짜 (현재 날짜 기준) 상대적 날짜는 데이터 검증에서 지원되지 않습니다. 조건부 서식 및 조건부 필터에서만 지원됩니다. |
userEnteredValue
|
조건의 기준이 되는 값입니다. 값은 사용자가 셀에 입력한 것처럼 파싱됩니다. 수식이 지원되며 |
상대적 날짜
날짜 조건을 평가하는 방법을 제어합니다.
열거형 | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
PAST_YEAR
|
오늘로부터 1년 전의 값입니다. |
PAST_MONTH
|
오늘로부터 1개월 전에 해당하는 값입니다. |
PAST_WEEK
|
오늘로부터 일주일 전의 값입니다. |
YESTERDAY
|
이 값은 어제입니다. |
TODAY
|
값이 오늘입니다. |
TOMORROW
|
값이 내일입니다. |
그리드 범위
시트의 범위입니다. 모든 색인은 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
|
이 범위가 사용 중인 시트입니다. |
startRowIndex
|
범위의 시작 행 (포함)이며, 제한되지 않은 경우 설정되지 않습니다. |
endRowIndex
|
범위의 끝 행 (제외)이며, 제한되지 않은 경우 설정되지 않습니다. |
startColumnIndex
|
범위의 시작 열 (포함)이거나 제한되지 않은 경우 설정되지 않습니다. |
endColumnIndex
|
범위의 종료 열 (제외)이거나 제한되지 않은 경우 설정되지 않습니다. |
SortOrder
정렬 순서입니다.
열거형 | |
---|---|
SORT_ORDER_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
ASCENDING
|
오름차순으로 정렬 |
DESCENDING
|
내림차순으로 정렬합니다. |
FilterSpec
특정 열과 연결된 필터 기준입니다.
JSON 표현 |
---|
{ "filterCriteria": { object ( |
필드 | |
---|---|
filterCriteria
|
열의 기준입니다. |
공용체 필드 reference 는 필터링된 열에 대한 참조입니다.
reference 는 다음 중 하나여야 합니다.
|
|
columnIndex
|
0부터 시작하는 열 색인입니다. |
dataSourceColumnReference
|
데이터 소스 열에 대한 참조입니다. |
필터 기준
필터 또는 필터 보기에서 행을 표시하거나 숨기는 기준입니다.
JSON 표현 |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
필드 | |
---|---|
condition
|
값을 표시하려면 true여야 하는 조건입니다. ( |
visibleBackgroundColor
|
필터링할 배경 채우기 색상입니다. 이 채우기 색상을 가진 셀만 표시됩니다. |
visibleBackgroundColorStyle
|
필터링할 배경 채우기 색상입니다. 이 채우기 색상을 가진 셀만 표시됩니다. 이 필드는 |
visibleForegroundColor
|
필터링할 포그라운드 색상입니다. 이 포그라운드 색상의 셀만 표시됩니다. |
visibleForegroundColorStyle
|
필터링할 포그라운드 색상입니다. 이 포그라운드 색상의 셀만 표시됩니다. 이 필드는 |
정렬 사양
특정 열 또는 행과 관련된 정렬 순서입니다.
JSON 표현 |
---|
{ "sortOrder": enum ( |
필드 | |
---|---|
sortOrder
|
주문 데이터가 정렬되어야 합니다. |
foregroundColor
|
정렬할 전경 색상입니다. 이 전경 색상이 있는 셀은 맨 위에 정렬됩니다. |
foregroundColorStyle
|
정렬할 전경 색상입니다. 이 전경 색상이 있는 셀은 맨 위에 정렬됩니다. |
backgroundColor
|
정렬할 배경 채우기 색상입니다. 이 채우기 색상이 있는 셀은 맨 위에 정렬됩니다. |
backgroundColorStyle
|
정렬할 배경 채우기 색상입니다. 이 채우기 색상이 있는 셀은 맨 위에 정렬됩니다. |
공용체 필드 reference 는 정렬된 측정기준에 대한 참조입니다.
reference 는 다음 중 하나여야 합니다.
|
|
dimensionIndex
|
정렬을 적용해야 하는 측정기준입니다. |
dataSourceColumnReference
|
데이터 소스 열에 대한 참조입니다. |
삽입된 객체 위치
차트와 같이 삽입된 객체의 위치입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 location 는 객체의 위치입니다. 정확히 1개의 값을 설정해야 합니다.
location 는 다음 중 하나여야 합니다.
|
|
sheetId
|
이 설정이 사용 중인 시트입니다. 삽입된 객체가 해당 시트에 있는 경우에만 설정합니다. Must be non-negative. |
overlayPosition
|
객체가 그리드 위에 오버레이되는 위치입니다. |
newSheet
|
true인 경우 삽입된 객체는 ID가 선택된 새 시트에 배치됩니다. 쓰기 전용입니다. |
오버레이 위치
객체가 그리드 위에 오버레이되는 위치입니다.
JSON 표현 |
---|
{
"anchorCell": {
object (
|
필드 | |
---|---|
anchorCell
|
객체가 고정되어 있는 셀입니다. |
offsetXPixels
|
객체가 앵커 셀로부터 오프셋되는 수평 오프셋(픽셀)입니다. |
offsetYPixels
|
객체가 앵커 셀로부터 오프셋되는 세로 오프셋(픽셀)입니다. |
widthPixels
|
객체의 너비(픽셀)입니다. 기본값은 600입니다. |
heightPixels
|
객체의 높이(픽셀)입니다. 기본값은 371입니다. |
그리드 좌표
시트의 좌표입니다. 모든 색인은 0부터 시작됩니다.
JSON 표현 |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
필드 | |
---|---|
sheetId
|
이 좌표가 있는 시트입니다. |
rowIndex
|
좌표의 행 색인입니다. |
columnIndex
|
좌표의 열 색인입니다. |