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