시트
스프레드시트의 시트
JSON 표현 |
---|
{ "properties": { object ( |
필드 | |
---|---|
properties
|
시트의 속성입니다. |
data[]
|
그리드의 데이터(그리드 시트인 경우)입니다.
반환되는 GridData 객체의 수는 이 시트에서 요청된 범위 수에 따라 다릅니다. 예를 들어 이것이
|
merges[]
|
함께 병합되는 범위입니다. |
conditionalFormats[]
|
이 시트의 조건부 서식 규칙입니다. |
filterViews[]
|
이 시트의 필터 보기입니다. |
protectedRanges[]
|
이 시트의 보호된 범위입니다. |
basicFilter
|
이 시트의 필터입니다(있는 경우). |
charts[]
|
이 시트에 있는 모든 차트의 사양입니다. |
bandedRanges[]
|
이 시트의 줄무늬 (교번 색상) 범위입니다. |
developerMetadata[]
|
시트와 연결된 개발자 메타데이터입니다. |
rowGroups[]
|
이 시트의 모든 행 그룹이며 범위 시작 색인을 증가시킨 다음 그룹 깊이를 기준으로 정렬됩니다. |
columnGroups[]
|
이 시트의 모든 열 그룹으로, 범위 시작 색인을 증가시킨 다음 그룹 깊이를 기준으로 정렬됩니다. |
slicers[]
|
이 시트의 슬라이서입니다. |
SheetProperties
시트의 속성입니다.
JSON 표현 |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
필드 | |
---|---|
sheetId
|
시트의 ID입니다. Must be non-negative. 이 필드는 한 번 설정되면 변경할 수 없습니다. |
title
|
시트의 이름입니다. |
index
|
스프레드시트 내 시트의 색인입니다. 시트 속성을 추가하거나 업데이트할 때 이 필드를 제외하면 시트가 추가되거나 시트 목록의 끝으로 이동됩니다. 시트 색인을 업데이트하거나 시트를 삽입할 때 이동은 '이동 전'에서 이동함으로 간주됩니다. 색인 예를 들어 세 개의 시트 (S1, S2, S3)가 있는 경우 S1을 S2보다 먼저 이동하려면 색인을 2로 설정해야 합니다. 요청된 색인이 시트의 현재 색인과 동일하거나 요청된 새 색인이 현재 시트 색인 + 1과 같은 경우 시트 색인 업데이트 요청이 무시됩니다. |
sheetType
|
시트 유형입니다. 기본값은
|
gridProperties
|
이 시트가 그리드인 경우 시트의 추가 속성입니다. (시트가 차트나 이미지가 포함된 객체 시트인 경우 이 필드는 표시되지 않습니다.) 작성할 때 그리드가 아닌 시트에 그리드 속성을 설정하면 오류가 발생합니다.
이 시트가
|
tabColor
|
UI의 탭 색상입니다. 지원 중단됨: 다음을 사용하세요.
|
tabColorStyle
|
UI의 탭 색상입니다. 만약
|
rightToLeft
|
시트가 LTR 시트가 아닌 RTL 시트인 경우 true입니다. |
dataSourceSheetProperties
|
출력 전용입니다. 있는 경우 이 필드에는
|
SheetType
시트의 종류입니다.
열거형 | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
GRID
|
시트는 그리드입니다. |
OBJECT
|
시트에는 그리드가 없으며 대신 차트 또는 이미지와 같은 객체가 있습니다. |
DATA_SOURCE
|
시트는 외부 IP 주소
DataSource
데이터의 미리보기를 표시합니다
|
GridProperties
그리드의 속성
JSON 표현 |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
필드 | |
---|---|
rowCount
|
그리드의 행 수입니다. |
columnCount
|
그리드의 열 수입니다. |
frozenRowCount
|
그리드에서 고정된 행 수입니다. |
frozenColumnCount
|
그리드에서 고정된 열의 수입니다. |
hideGridlines
|
UI에서 그리드에 격자선이 표시되지 않으면 true입니다. |
rowGroupControlAfter
|
그룹 뒤에 행 그룹화 컨트롤 전환 버튼이 표시되면 참입니다. |
columnGroupControlAfter
|
그룹 뒤에 열 그룹화 컨트롤 전환 버튼이 표시되면 참입니다. |
DataSourceSheetProperties
추가 속성
DATA_SOURCE
시트입니다.
JSON 표현 |
---|
{ "dataSourceId": string, "columns": [ { object ( |
필드 | |
---|---|
dataSourceId
|
ID
|
columns[]
|
시트에 표시되는 열은
|
dataExecutionStatus
|
데이터 실행 상태입니다. |
GridData
그리드의 데이터 및 측정기준에 대한 메타데이터입니다.
JSON 표현 |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
필드 | |
---|---|
startRow
|
이 GridData가 참조하는 첫 번째 행은 0부터 시작합니다. |
startColumn
|
이 GridData가 참조하는 첫 번째 열은 0부터 시작합니다. |
rowData[]
|
그리드의 데이터로, startRow의 행부터 시작하여 행당 항목 하나씩입니다. RowData의 값은
|
rowMetadata[]
|
그리드의 요청된 행에 대한 메타데이터로,
|
columnMetadata[]
|
그리드의 요청된 열에 대한 메타데이터로,
|
RowData
행의 각 셀에 관한 데이터입니다.
JSON 표현 |
---|
{
"values": [
{
object (
|
필드 | |
---|---|
values[]
|
행의 값(열당 하나씩)입니다. |
DimensionProperties
측정기준에 대한 속성입니다.
JSON 표현 |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
필드 | |
---|---|
pixelSize
|
크기의 높이(행인 경우) 또는 너비(열인 경우)입니다(단위: 픽셀). |
developerMetadata[]
|
단일 행 또는 열과 연결된 개발자 메타데이터입니다. |
dataSourceColumnReference
|
출력 전용입니다. 설정되면 데이터 소스 시트의 열입니다. |
ConditionalFormatRule
조건부 서식을 설명하는 규칙입니다.
JSON 표현 |
---|
{ "ranges": [ { object ( |
필드 | |
---|---|
ranges[]
|
조건이 true인 경우 형식이 지정되는 범위입니다. 모든 범위는 동일한 그리드에 있어야 합니다. |
공용체 필드
rule 이 조건부 서식을 제어하는 규칙입니다. 하나만 설정해야 합니다.
rule
다음 중 하나여야 합니다.
|
|
booleanRule
|
형식이 '사용'으로 설정되어 있는지 확인합니다. 또는 'off' 할 수 있습니다. |
gradientRule
|
형식은 규칙의 그라데이션에 따라 달라집니다. |
BooleanRule
조건에 따라 일치하거나 일치하지 않을 수 있는 규칙입니다.
JSON 표현 |
---|
{ "condition": { object ( |
필드 | |
---|---|
condition
|
규칙의 조건입니다. 조건이 true로 평가되면 형식이 적용됩니다. |
format
|
적용할 형식입니다. 조건부 서식은 서식의 하위 집합만 적용할 수 있습니다.
|
GradientRule
나열된 보간점을 기준으로 그라데이션 색상 스케일 형식을 적용하는 규칙입니다. 셀 형식은 보간점의 값과 비교한 내용에 따라 달라집니다.
JSON 표현 |
---|
{ "minpoint": { object ( |
필드 | |
---|---|
minpoint
|
시작 보간 지점입니다. |
midpoint
|
선택사항인 중간 보간점입니다. |
maxpoint
|
최종 보간 지점입니다. |
InterpolationPoint
그라데이션 조건부 형식의 단일 보간점입니다. 이렇게 하면 선택한 색상, 유형, 값에 따라 그라데이션 색상 스케일을 고정할 수 있습니다.
JSON 표현 |
---|
{ "color": { object ( |
필드 | |
---|---|
color
|
이 보간점에서 사용할 색상입니다. 지원 중단됨: 다음을 사용하세요.
|
colorStyle
|
이 보간점에서 사용할 색상입니다. 만약
|
type
|
값이 해석되는 방식입니다. |
value
|
이 보간점에서 사용하는 값입니다. 수식일 수 있습니다. 사용되지 않는 경우
|
InterpolationPointType
보간점의 유형입니다.
열거형 | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
MIN
|
보간점은 조건부 서식 범위에서 셀의 최솟값을 사용합니다. |
MAX
|
보간점은 조건부 서식 범위에서 셀의 최댓값을 사용합니다. |
NUMBER
|
보간점은
InterpolationPoint.value
|
PERCENT
|
보간점은 조건부 서식 범위의 모든 셀에 대해 지정된 백분율입니다. 이는 다음과 동일합니다.
|
PERCENTILE
|
보간점은 조건부 서식 범위의 모든 셀에 대해 지정된 백분위수입니다. 이는 다음과 동일합니다.
NUMBER
값이 다음과 같은 경우:
=PERCENTILE(FLATTEN(range), value / 100)
병합 시 범위의 오류는 무시됩니다.
|
FilterView
필터 보기
JSON 표현 |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
필드 | |
---|---|
filterViewId
|
필터 보기의 ID입니다. |
title
|
필터 보기의 이름입니다. |
range
|
이 필터 보기에서 다루는 범위입니다.
작성할 때는
|
namedRangeId
|
이 필터 보기에서 지원하는 이름이 지정된 범위입니다(있는 경우).
작성할 때는
|
sortSpecs[]
|
열당 정렬 순서입니다. 이전 사양과 값이 같을 때 이후 사양이 사용됩니다. |
criteria
|
열당 값을 표시하거나 숨기는 기준입니다. 맵의 키는 열 색인이고 값은 해당 열의 기준입니다.
이 필드는 다음 용도로 지원 중단되었습니다.
|
filterSpecs[]
|
열당 값을 표시하거나 숨기기 위한 필터링 기준입니다.
모두
|
ProtectedRange
보호된 범위입니다.
JSON 표현 |
---|
{ "protectedRangeId": integer, "range": { object ( |
필드 | |
---|---|
protectedRangeId
|
보호된 범위의 ID입니다. 이 필드는 읽기 전용입니다. |
range
|
보호할 범위입니다. 범위가 완전히 제한되지 않을 수도 있으며, 이 경우 보호된 시트로 간주됩니다.
작성할 때는
|
namedRangeId
|
이 보호된 범위의 지원되는 이름이 지정된 범위(있는 경우)
작성할 때는
|
description
|
이 보호된 범위의 설명입니다. |
warningOnly
|
이 보호된 범위를 편집할 때 경고를 표시하는 경우 참입니다. 경고 기반 보호에서는 모든 사용자가 보호된 범위의 데이터를 수정할 수 있습니다. 단, 수정할 경우 사용자에게 수정사항을 확인하라는 경고 메시지가 표시됩니다.
작성 시: 이 필드가 true인 경우
|
requestingUserCanEdit
|
이 보호된 범위를 요청한 사용자가 보호된 영역을 수정할 수 있는 경우 true입니다. 이 필드는 읽기 전용입니다. |
unprotectedRanges[]
|
보호된 시트 내의 보호되지 않은 범위 목록입니다. 보호되지 않은 범위는 보호된 시트에서만 지원됩니다. |
editors
|
보호된 범위에 대한 수정 액세스 권한이 있는 사용자 및 그룹 이 입력란은 보호된 범위와 문서에 대한 수정 권한이 있는 사용자에게만 표시됩니다. 다음에서는 편집기가 지원되지 않습니다.
|
편집자
보호된 범위의 편집기입니다.
JSON 표현 |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
필드 | |
---|---|
users[]
|
보호된 범위에 대한 수정 액세스 권한이 있는 사용자의 이메일 주소입니다. |
groups[]
|
보호된 범위에 대한 수정 액세스 권한이 있는 그룹의 이메일 주소입니다. |
domainUsersCanEdit
|
문서 도메인의 모든 사용자가 보호된 범위에 대한 수정 액세스 권한을 가진 경우 true입니다. 도메인 보호는 도메인 내의 문서에서만 지원됩니다. |
BasicFilter
시트와 연결된 기본 필터입니다.
JSON 표현 |
---|
{ "range": { object ( |
필드 | |
---|---|
range
|
필터에 포함되는 범위입니다. |
sortSpecs[]
|
열당 정렬 순서입니다. 이전 사양과 값이 같을 때 이후 사양이 사용됩니다. |
criteria
|
열당 값을 표시하거나 숨기는 기준입니다. 맵의 키는 열 색인이고 값은 해당 열의 기준입니다.
이 필드는 다음 용도로 지원 중단되었습니다.
|
filterSpecs[]
|
열당 필터링 기준입니다.
모두
|
BandedRange
시트의 줄무늬 (교번 색상) 범위입니다.
JSON 표현 |
---|
{ "bandedRangeId": integer, "range": { object ( |
필드 | |
---|---|
bandedRangeId
|
밴딩이 적용된 범위의 ID입니다. |
range
|
이러한 속성이 적용되는 범위입니다. |
rowProperties
|
행 밴드의 속성입니다. 이러한 속성은 범위의 모든 행에서 행별로 적용됩니다. 다음 중 하나 이상
|
columnProperties
|
열 밴드의 속성입니다. 이러한 속성은 범위의 모든 열에서 열별로 적용됩니다. 다음 중 하나 이상
|
BandingProperties
단일 측정기준 (행 또는 열)을 참조하는 속성입니다. 두 가지 모두
BandedRange.row_properties
및
BandedRange.column_properties
가 설정되면 다음 규칙에 따라 채우기 색상이 셀에 적용됩니다.
-
headerColor
및footerColor
대역 색상보다 우선 적용됩니다. -
firstBandColor
우선순위가 보다 높음secondBandColor
-
rowProperties
우선순위가 보다 높음columnProperties
예를 들어 첫 번째 행 색상이 첫 번째 열 색상보다 우선하지만 첫 번째 열 색상이 두 번째 행 색상보다 우선합니다. 마찬가지로 행 헤더가 왼쪽 상단 셀의 열 헤더보다 우선하지만, 행 헤더가 설정되지 않은 경우 열 헤더가 첫 번째 행 색상보다 우선합니다.
JSON 표현 |
---|
{ "headerColor": { object ( |
필드 | |
---|---|
headerColor
|
첫 번째 행 또는 열의 색상입니다. 이 필드가 설정되면 첫 번째 행 또는 열이 이 색상으로 채워지며
|
headerColorStyle
|
첫 번째 행 또는 열의 색상입니다. 이 필드가 설정되면 첫 번째 행 또는 열이 이 색상으로 채워지며
|
firstBandColor
|
교차되는 첫 번째 색상입니다. (필수) 지원 중단됨: 사용
|
firstBandColorStyle
|
교차되는 첫 번째 색상입니다. (필수)
|
secondBandColor
|
교차되는 두 번째 색상입니다. (필수) 지원 중단됨: 사용
|
secondBandColorStyle
|
교차되는 두 번째 색상입니다. (필수)
|
footerColor
|
마지막 행 또는 열의 색상입니다. 이 필드가 설정되지 않으면 마지막 행 또는 열이 다음 중 하나로 채워집니다.
|
footerColorStyle
|
마지막 행 또는 열의 색상입니다. 이 필드가 설정되지 않으면 마지막 행 또는 열이 다음 중 하나로 채워집니다.
|
DimensionGroup
시트의 행 또는 열 간격에 걸친 그룹으로, 다른 그룹 내에 포함되거나 포함될 수 있습니다. 그룹은 시트에서 하나의 단위로 접히거나 펼칠 수 있습니다.
JSON 표현 |
---|
{
"range": {
object (
|
필드 | |
---|---|
range
|
이 그룹이 존재하는 범위입니다. |
depth
|
그룹의 깊이로, 이 그룹의 범위를 완전히 포함하는 범위가 몇 개인지를 나타냅니다. |
collapsed
|
이 그룹이 접혀 있으면 이 필드는 true입니다. 얕은 깊이에서 겹치는 그룹을 펼치면 접힌 그룹이 그대로 유지됩니다. 측정기준의 공개 상태가 그룹 속성과 관계없이 변경될 수 있으므로 true 값이 그룹 내의 모든 측정기준이 숨겨졌음을 의미하지는 않습니다. 그러나 이 속성을 업데이트할 때 속성 내의 모든 측정기준은 이 필드가 true인 경우 숨김으로 설정되고, 이 필드가 false인 경우 visible로 설정됩니다. |
슬라이서
시트의 슬라이서
JSON 표현 |
---|
{ "slicerId": integer, "spec": { object ( |
필드 | |
---|---|
slicerId
|
슬라이서의 ID입니다. |
spec
|
슬라이서의 사양입니다. |
position
|
슬라이서의 위치입니다. 슬라이서는 기존 시트에만 배치할 수 있습니다. 또한 슬라이서의 너비와 높이는 허용된 한도를 넘지 않도록 자동으로 조정할 수 있습니다. |
SlicerSpec
슬라이서의 사양입니다.
JSON 표현 |
---|
{ "dataRange": { object ( |
필드 | |
---|---|
dataRange
|
슬라이서의 데이터 범위입니다. |
filterCriteria
|
슬라이서의 필터링 기준입니다. |
columnIndex
|
필터가 적용되는 데이터 테이블의 0부터 시작하는 열 색인입니다. |
applyToPivotTables
|
필터를 피벗 테이블에 적용해야 하는 경우 true입니다. 설정하지 않으면 기본값은
|
title
|
슬라이서의 제목입니다. |
textFormat
|
슬라이서에 있는 제목의 텍스트 형식입니다. 지원되지 않는 링크 필드입니다. |
backgroundColor
|
슬라이서의 배경 색상입니다. 지원 중단됨: 다음을 사용하세요.
|
backgroundColorStyle
|
슬라이서의 배경 색상입니다. 만약
|
horizontalAlignment
|
슬라이서에 있는 제목의 가로 정렬입니다. 지정하지 않으면 기본값은
|