Sheets

시트

스프레드시트의 시트입니다.

JSON 표현 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
필드
properties

object (SheetProperties)

시트의 속성입니다.

data[]

object (GridData)

그리드 시트인 경우 그리드의 데이터

반환되는 GridData 객체 수는 이 시트에서 요청된 범위 수에 따라 다릅니다. 예를 들어 이 값이 Sheet1를 나타내고 스프레드시트가 Sheet1!A1:C10 및 Sheet1!D15:E20 범위로 요청된 경우 첫 번째 GridData에는 0의 startRow/startColumn가 있고 두 번째 GridData에는 startRow 14(0부터 시작하는 행 15) 및 startColumn 3(0부터 시작하는 열 D)가 있습니다.

DATA_SOURCE 시트의 경우 특정 범위를 요청할 수 없으며 GridData에 모든 값이 포함됩니다.

merges[]

object (GridRange)

병합된 범위입니다.

conditionalFormats[]

object (ConditionalFormatRule)

이 시트의 조건부 서식 규칙

filterViews[]

object (FilterView)

이 시트의 필터 보기

protectedRanges[]

object (ProtectedRange)

이 시트의 보호된 범위입니다.

basicFilter

object (BasicFilter)

이 시트의 필터(있는 경우)

charts[]

object (EmbeddedChart)

이 시트의 모든 차트 사양

bandedRanges[]

object (BandedRange)

이 시트의 밴딩 (색상 교체) 범위

developerMetadata[]

object (DeveloperMetadata)

시트와 연결된 개발자 메타데이터입니다.

rowGroups[]

object (DimensionGroup)

이 시트의 모든 행 그룹으로, 범위 시작 색인순으로, 그다음 그룹 깊이순으로 정렬됩니다.

columnGroups[]

object (DimensionGroup)

이 시트의 모든 열 그룹으로, 범위 시작 색인이 증가하는 순으로, 그다음 그룹 깊이 순으로 정렬됩니다.

slicers[]

object (Slicer)

이 시트의 슬라이서

tables[]

object (Table)

이 시트의 표

SheetProperties

시트의 속성입니다.

JSON 표현 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
필드
sheetId

integer

시트의 ID입니다. Must be non-negative. 이 필드는 설정된 후에는 변경할 수 없습니다.

title

string

시트의 이름입니다.

index

integer

스프레드시트 내 시트의 색인입니다. 시트 속성을 추가하거나 업데이트할 때 이 필드를 제외하면 시트가 추가되거나 시트 목록의 끝으로 이동합니다. 시트 색인을 업데이트하거나 시트를 삽입할 때 이동은 '이전의 이동' 색인에서 고려됩니다. 예를 들어 시트가 3개 (S1, S2, S3) 있는 경우 S1을 S2 앞에 이동하려면 색인을 2로 설정해야 합니다. 요청된 색인이 시트의 현재 색인과 동일하거나 요청된 새 색인이 현재 시트 색인 + 1과 같은 경우 시트 색인 업데이트 요청은 무시됩니다.

sheetType

enum (SheetType)

시트 유형입니다. 기본값은 GRID입니다. 이 필드는 설정된 후에는 변경할 수 없습니다.

gridProperties

object (GridProperties)

이 시트가 그리드인 경우 시트의 추가 속성입니다. 시트가 차트나 이미지가 포함된 객체 시트인 경우 이 필드는 표시되지 않습니다. 작성 시 그리드가 아닌 시트에 그리드 속성을 설정하면 오류가 발생합니다.

이 시트가 DATA_SOURCE 시트인 경우 이 필드는 출력 전용이지만 데이터 소스 시트가 UI에서 렌더링되는 방식을 반영하는 속성(예: rowCount)을 포함합니다.

hidden

boolean

시트가 UI에 숨겨져 있으면 true이고 표시되어 있으면 false입니다.

tabColor
(deprecated)

object (Color)

UI의 탭 색상입니다. 지원 중단됨: tabColorStyle를 사용하세요.

tabColorStyle

object (ColorStyle)

UI의 탭 색상입니다. tabColor도 설정된 경우 이 필드가 우선 적용됩니다.

rightToLeft

boolean

시트가 LTR 시트가 아닌 RTL 시트인 경우 true입니다.

dataSourceSheetProperties

object (DataSourceSheetProperties)

출력 전용입니다. 이 필드가 있으면 DATA_SOURCE 시트별 속성이 포함됩니다.

SheetType

시트의 종류입니다.

열거형
SHEET_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
GRID 시트는 그리드입니다.
OBJECT 시트에 그리드가 없으며 대신 차트나 이미지와 같은 객체가 있습니다.
DATA_SOURCE 시트가 외부 DataSource에 연결되고 데이터 미리보기가 표시됩니다.

GridProperties

그리드의 속성입니다.

JSON 표현 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
필드
rowCount

integer

그리드의 행 수입니다.

columnCount

integer

그리드의 열 수입니다.

frozenRowCount

integer

그리드에서 고정된 행의 개수입니다.

frozenColumnCount

integer

그리드에서 고정된 열 수입니다.

hideGridlines

boolean

그리드가 UI에 그리드선을 표시하지 않는 경우 true입니다.

rowGroupControlAfter

boolean

행 그룹 컨트롤 전환 버튼이 그룹 뒤에 표시되면 true입니다.

columnGroupControlAfter

boolean

열 그룹화 컨트롤 전환 버튼이 그룹 뒤에 표시되면 true입니다.

DataSourceSheetProperties

DATA_SOURCE 시트의 추가 속성입니다.

JSON 표현 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
dataSourceId

string

시트가 연결된 DataSource의 ID입니다.

columns[]

object (DataSourceColumn)

시트에 표시되는 열로, RowData의 값에 해당합니다.

dataExecutionStatus

object (DataExecutionStatus)

데이터 실행 상태입니다.

GridData

그리드의 데이터와 측정기준에 관한 메타데이터

JSON 표현 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
필드
startRow

integer

GridData가 참조하는 첫 번째 행입니다(0부터 시작).

startColumn

integer

이 GridData가 참조하는 첫 번째 열로, 0부터 시작합니다.

rowData[]

object (RowData)

그리드의 데이터로, 행당 하나의 항목이며 startRow의 행부터 시작됩니다. RowData의 값은 startColumn부터 시작하는 열에 해당합니다.

rowMetadata[]

object (DimensionProperties)

그리드에서 요청된 행에 관한 메타데이터로, startRow의 행부터 시작됩니다.

columnMetadata[]

object (DimensionProperties)

그리드에서 요청된 열에 관한 메타데이터로, startColumn의 열부터 시작합니다.

RowData

행의 각 셀에 관한 데이터입니다.

JSON 표현 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
필드
values[]

object (CellData)

행의 값으로, 열당 하나씩 있습니다.

DimensionProperties

측정기준에 관한 속성입니다.

JSON 표현 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
필드
hiddenByFilter

boolean

이 측정기준이 필터링되는 경우 True입니다. 이 필드는 읽기 전용입니다.

hiddenByUser

boolean

이 측정기준이 명시적으로 숨겨져 있으면 true입니다.

pixelSize

integer

픽셀 단위의 크기(행인 경우 높이, 열인 경우 너비)입니다.

developerMetadata[]

object (DeveloperMetadata)

단일 행 또는 열과 연결된 개발자 메타데이터입니다.

dataSourceColumnReference

object (DataSourceColumnReference)

출력 전용입니다. 설정된 경우 데이터 소스 시트의 열입니다.

ConditionalFormatRule

조건부 서식을 설명하는 규칙입니다.

JSON 표현 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
필드
ranges[]

object (GridRange)

조건이 true인 경우 형식이 지정되는 범위입니다. 모든 범위가 동일한 그리드에 있어야 합니다.

공용체 필드 rule입니다. 이 조건부 서식을 제어하는 규칙으로, 정확히 하나를 설정해야 합니다. rule는 다음 중 하나여야 합니다.
booleanRule

object (BooleanRule)

형식은 규칙에 따라 '사용' 또는 '사용 안함'입니다.

gradientRule

object (GradientRule)

형식은 규칙의 그라데이션에 따라 다릅니다.

BooleanRule

조건에 따라 일치할 수도 있고 일치하지 않을 수도 있는 규칙입니다.

JSON 표현 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
필드
condition

object (BooleanCondition)

규칙의 조건입니다. 조건이 true로 평가되면 형식이 적용됩니다.

format

object (CellFormat)

적용할 형식입니다. 조건부 서식은 bold, italic, strikethrough, foreground color, background color의 서식 하위 집합만 적용할 수 있습니다.

GradientRule

나열된 보간 지점을 기반으로 그라디언트 색상 스케일 형식을 적용하는 규칙입니다. 셀의 형식은 보간 지점의 값에 비해 내용에 따라 다릅니다.

JSON 표현 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
필드
minpoint

object (InterpolationPoint)

시작 보간 지점입니다.

midpoint

object (InterpolationPoint)

중간 보간 지점(선택사항)

maxpoint

object (InterpolationPoint)

마지막 보간 지점입니다.

InterpolationPoint

그라데이션 조건부 서식의 단일 보간 지점입니다. 선택한 색상, 유형, 값에 따라 그라데이션 색상 스케일을 고정합니다.

JSON 표현 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
필드
color
(deprecated)

object (Color)

이 보간 지점에서 사용해야 하는 색상입니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

이 보간 지점에서 사용해야 하는 색상입니다. color도 설정된 경우 이 필드가 우선 적용됩니다.

type

enum (InterpolationPointType)

값을 해석하는 방법입니다.

value

string

이 보간 지점에서 사용하는 값입니다. 수식일 수 있습니다. type이 MIN 또는 MAX인 경우 사용되지 않습니다.

InterpolationPointType

보간 지점의 종류입니다.

열거형
INTERPOLATION_POINT_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
MIN 보간 지점은 조건부 형식 범위 내 셀의 최솟값을 사용합니다.
MAX 보간 지점은 조건부 서식 범위 내 셀의 최대값을 사용합니다.
NUMBER 보간 지점은 InterpolationPoint.value의 값을 정확하게 사용합니다.
PERCENT

보간 지점은 조건부 서식 범위의 모든 셀에 대한 지정된 비율입니다. 이는 값이 =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100)))인 경우 NUMBER과 같습니다. 여기서 평탄화 시 범위의 오류는 무시됩니다.

PERCENTILE 보간 지점은 조건부 서식 범위의 모든 셀에 대해 지정된 백분위수입니다. 이는 값이 =PERCENTILE(FLATTEN(range), value / 100)인 경우 NUMBER와 같습니다. 여기서 평탄화 시 범위의 오류는 무시됩니다.

FilterView

필터 보기

JSON 표현 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
필드
filterViewId

integer

필터 뷰의 ID입니다.

title

string

필터 뷰의 이름입니다.

range

object (GridRange)

이 필터 보기가 적용되는 범위입니다.

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

namedRangeId

string

이 필터 보기가 지원되는 이름이 지정된 범위입니다(해당하는 경우).

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

tableId

string

이 필터 보기가 지원되는 테이블(있는 경우)입니다.

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 이전 사양에서 값이 동일한 경우에 사용됩니다.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

열별로 값을 표시/숨기는 기준입니다. 맵의 키는 열 색인이고 값은 해당 열의 기준입니다.

이 필드는 지원 중단되었으며 filterSpecs로 대체되었습니다.

filterSpecs[]

object (FilterSpec)

열별로 값을 표시/숨기기 위한 필터 기준입니다.

criteria와 filterSpecs가 모두 응답에 채워집니다. 업데이트 요청에 두 필드가 모두 지정된 경우 이 필드가 우선 적용됩니다.

ProtectedRange

보호된 범위

JSON 표현 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
필드
protectedRangeId

integer

보호된 범위의 ID입니다. 이 필드는 읽기 전용입니다.

range

object (GridRange)

보호되는 범위입니다. 범위가 완전히 제한되지 않을 수 있으며, 이 경우 보호된 시트로 간주됩니다.

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

namedRangeId

string

이 보호된 범위가 지원되는 이름이 지정된 범위입니다(있는 경우).

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

tableId

string

이 보호된 범위가 지원되는 테이블입니다(있는 경우).

쓰는 경우 range 또는 namedRangeId 또는 tableId 중 하나만 설정할 수 있습니다.

description

string

이 보호된 범위에 대한 설명입니다.

warningOnly

boolean

이 보호된 범위를 수정할 때 경고가 표시되면 true입니다. 경고 기반 보호는 모든 사용자가 보호된 범위의 데이터를 수정할 수 있다는 것을 의미합니다. 단, 수정 시 사용자에게 수정을 확인해 달라는 경고 메시지가 표시됩니다.

작성 시: 이 필드가 true이면 editors가 무시됩니다. 또한 이 필드가 true에서 false로 변경되고 editors 필드가 설정되지 않았거나 필드 마스크에 포함되지 않은 경우 편집기가 문서의 모든 편집기로 설정됩니다.

requestingUserCanEdit

boolean

이 보호된 범위를 요청한 사용자가 보호된 영역을 수정할 수 있는 경우 true입니다. 이 필드는 읽기 전용입니다.

unprotectedRanges[]

object (GridRange)

보호된 시트 내의 보호되지 않은 범위 목록입니다. 보호되지 않은 범위는 보호된 시트에서만 지원됩니다.

editors

object (Editors)

보호된 범위에 대한 수정 액세스 권한이 있는 사용자 및 그룹 이 필드는 보호된 범위 및 문서에 대한 수정 액세스 권한이 있는 사용자에게만 표시됩니다. warningOnly 보호는 편집기를 지원하지 않습니다.

편집자

보호된 범위의 편집자입니다.

JSON 표현 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
필드
users[]

string

보호된 범위에 대한 수정 액세스 권한이 있는 사용자의 이메일 주소입니다.

groups[]

string

보호된 범위에 대한 수정 액세스 권한이 있는 그룹의 이메일 주소입니다.

domainUsersCanEdit

boolean

문서 도메인의 모든 사용자가 보호된 범위에 대한 수정 액세스 권한을 보유한 경우 true입니다. 도메인 보호는 도메인 내 문서에서만 지원됩니다.

BasicFilter

시트와 연결된 기본 필터입니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
필드
range

object (GridRange)

필터가 적용되는 범위입니다.

tableId

string

이 필터가 지원되는 테이블입니다(있는 경우). 쓰는 경우 range 또는 tableId 중 하나만 설정할 수 있습니다.

sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 이전 사양에서 값이 동일한 경우에 사용됩니다.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

열별로 값을 표시/숨기는 기준입니다. 맵의 키는 열 색인이고 값은 해당 열의 기준입니다.

이 필드는 지원 중단되었으며 filterSpecs로 대체되었습니다.

filterSpecs[]

object (FilterSpec)

열당 필터 기준입니다.

criteria와 filterSpecs가 모두 응답에 채워집니다. 업데이트 요청에 두 필드가 모두 지정된 경우 이 필드가 우선 적용됩니다.

BandedRange

시트의 밴딩된 (색상이 번갈아 표시되는) 범위입니다.

JSON 표현 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
필드
bandedRangeId

integer

범위의 ID입니다. 설정하지 않으면 bandedRangeReference를 참고하세요.

bandedRangeReference

string

출력 전용입니다. bandedRangeId에서 지원되지 않는 ID를 식별하는 데 사용되는 번들 범위의 참조입니다.

range

object (GridRange)

이러한 속성이 적용되는 범위입니다.

rowProperties

object (BandingProperties)

행 범위의 속성입니다. 이러한 속성은 범위의 모든 행에 행별로 적용됩니다. rowProperties 또는 columnProperties 중 하나를 지정해야 합니다.

columnProperties

object (BandingProperties)

열 범위의 속성입니다. 이러한 속성은 범위의 모든 열에 열별로 적용됩니다. rowProperties 또는 columnProperties 중 하나를 지정해야 합니다.

BandingProperties

단일 측정기준 (행 또는 열)을 참조하는 속성입니다. BandedRange.row_properties 및 BandedRange.column_properties가 모두 설정된 경우 다음 규칙에 따라 채우기 색상이 셀에 적용됩니다.

예를 들어 첫 번째 행 색상은 첫 번째 열 색상보다 우선 적용되지만 첫 번째 열 색상은 두 번째 행 색상보다 우선 적용됩니다. 마찬가지로 행 헤더가 왼쪽 상단 셀의 열 헤더보다 우선 적용되지만 행 헤더가 설정되지 않은 경우 열 헤더가 첫 번째 행 색상보다 우선 적용됩니다.

JSON 표현 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
필드
headerColor
(deprecated)

object (Color)

첫 번째 행 또는 열의 색상입니다. 이 필드가 설정되면 첫 번째 행 또는 열이 이 색상으로 채워지고 두 번째 행 또는 열부터 firstBandColor과 secondBandColor이 번갈아 표시됩니다. 그렇지 않으면 첫 번째 행 또는 열이 firstBandColor로 채워지고 색상이 평소와 같이 교체됩니다. 지원 중단됨: headerColorStyle를 사용하세요.

headerColorStyle

object (ColorStyle)

첫 번째 행 또는 열의 색상입니다. 이 필드가 설정되면 첫 번째 행 또는 열이 이 색상으로 채워지고 두 번째 행 또는 열부터 firstBandColor과 secondBandColor이 번갈아 표시됩니다. 그렇지 않으면 첫 번째 행 또는 열이 firstBandColor로 채워지고 색상이 평소와 같이 번갈아 표시됩니다. headerColor도 설정된 경우 이 필드가 우선 적용됩니다.

firstBandColor
(deprecated)

object (Color)

교체되는 첫 번째 색상입니다. (필수) 지원 중단됨: firstBandColorStyle를 사용하세요.

firstBandColorStyle

object (ColorStyle)

교체되는 첫 번째 색상입니다. (필수) firstBandColor도 설정된 경우 이 필드가 우선 적용됩니다.

secondBandColor
(deprecated)

object (Color)

교차되는 두 번째 색상입니다. (필수) 지원 중단됨: secondBandColorStyle를 사용하세요.

secondBandColorStyle

object (ColorStyle)

교차되는 두 번째 색상입니다. (필수) secondBandColor도 설정된 경우 이 필드가 우선 적용됩니다.

footerColor
(deprecated)

object (Color)

마지막 행 또는 열의 색상입니다. 이 필드를 설정하지 않으면 이전 행 또는 열의 색상에 따라 마지막 행 또는 열이 firstBandColor 또는 secondBandColor로 채워집니다. 지원 중단됨: footerColorStyle를 사용하세요.

footerColorStyle

object (ColorStyle)

마지막 행 또는 열의 색상입니다. 이 필드를 설정하지 않으면 이전 행 또는 열의 색상에 따라 마지막 행 또는 열이 firstBandColor 또는 secondBandColor로 채워집니다. footerColor도 설정된 경우 이 필드가 우선 적용됩니다.

DimensionGroup

시트의 행 또는 열 간격을 기준으로 하는 그룹으로, 다른 그룹을 포함하거나 다른 그룹 내에 포함될 수 있습니다. 그룹은 시트에서 단위로 접거나 펼칠 수 있습니다.

JSON 표현 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
필드
range

object (DimensionRange)

이 그룹이 존재하는 범위입니다.

depth

integer

그룹의 깊이로, 이 그룹의 범위를 완전히 포함하는 범위가 있는 그룹의 수를 나타냅니다.

collapsed

boolean

이 그룹이 접히면 이 필드는 true입니다. 겹치는 그룹이 더 낮은 깊이에서 펼쳐지더라도 접힌 그룹은 접힌 상태로 유지됩니다.

true 값은 그룹 내의 모든 측정기준이 숨겨져 있음을 의미하지는 않습니다. 측정기준의 표시 여부는 이 그룹 속성과는 별개로 변경될 수 있기 때문입니다. 그러나 이 속성이 업데이트되면 이 필드가 true인 경우 내부의 모든 측정기준이 숨김으로 설정되고, 이 필드가 false인 경우 표시로 설정됩니다.

슬라이서

시트의 슬라이서

JSON 표현 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
필드
slicerId

integer

슬라이서의 ID입니다.

spec

object (SlicerSpec)

슬라이서 사양입니다.

position

object (EmbeddedObjectPosition)

슬라이서의 위치입니다. 슬라이서는 기존 시트에만 배치할 수 있습니다. 또한 슬라이서의 너비와 높이를 허용된 한도 내로 유지하도록 자동으로 조정할 수 있습니다.

SlicerSpec

슬라이서 사양입니다.

JSON 표현 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
필드
dataRange

object (GridRange)

슬라이서의 데이터 범위입니다.

filterCriteria

object (FilterCriteria)

슬라이서의 필터링 기준입니다.

columnIndex

integer

필터가 적용되는 데이터 테이블의 0부터 시작하는 열 색인입니다.

applyToPivotTables

boolean

필터를 피벗 테이블에 적용해야 하는 경우 true입니다. 설정하지 않으면 기본값은 True입니다.

title

string

슬라이서의 제목입니다.

textFormat

object (TextFormat)

슬라이서에 표시되는 제목의 텍스트 형식입니다. 링크 필드는 지원되지 않습니다.

backgroundColor
(deprecated)

object (Color)

슬라이서의 배경 색상입니다. 지원 중단됨: backgroundColorStyle를 사용하세요.

backgroundColorStyle

object (ColorStyle)

슬라이서의 배경 색상입니다. backgroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

horizontalAlignment

enum (HorizontalAlign)

슬라이서에서 제목의 가로 정렬입니다. 지정하지 않으면 기본값은 LEFT입니다.

표

테이블.

JSON 표현 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
필드
tableId

string

테이블의 ID입니다.

name

string

테이블 이름입니다. 이 값은 동일한 스프레드시트의 모든 테이블에 고유합니다.

range

object (GridRange)

테이블 범위입니다.

rowsProperties

object (TableRowsProperties)

테이블 행 속성

columnProperties[]

object (TableColumnProperties)

테이블 열 속성

TableRowsProperties

테이블 행 속성

JSON 표현 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
필드
headerColorStyle

object (ColorStyle)

헤더 행의 색상입니다. 이 필드를 설정하면 헤더 행이 지정된 색상으로 채워집니다. 그렇지 않으면 헤더 행이 기본 색상으로 채워집니다.

firstBandColorStyle

object (ColorStyle)

교체되는 첫 번째 색상입니다. 이 필드를 설정하면 첫 번째 밴딩된 행이 지정된 색상으로 채워집니다. 그렇지 않으면 첫 번째 밴딩된 행이 기본 색상으로 채워집니다.

secondBandColorStyle

object (ColorStyle)

교차되는 두 번째 색상입니다. 이 필드를 설정하면 두 번째 밴딩된 행이 지정된 색상으로 채워집니다. 그렇지 않으면 두 번째 밴딩된 행이 기본 색상으로 채워집니다.

footerColorStyle

object (ColorStyle)

마지막 행의 색상입니다. 이 필드를 설정하지 않으면 바닥글이 추가되지 않고 마지막 행은 이전 행의 색상에 따라 firstBandColorStyle 또는 secondBandColorStyle로 채워집니다. 바닥글이 없는 기존 테이블을 바닥글이 있는 테이블로 업데이트하면 범위가 1행 확장됩니다. 기존 테이블을 업데이트하여 바닥글을 추가하고 바닥글을 삭제하면 범위가 1행 줄어듭니다.

TableColumnProperties

테이블 열입니다.

JSON 표현 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
필드
columnIndex

integer

0부터 시작하는 열 색인입니다. 이 색인은 테이블의 위치를 기준으로 하며 시트의 열 색인과 반드시 일치하지는 않습니다.

columnName

string

열 이름입니다.

columnType

enum (ColumnType)

열 유형입니다.

dataValidationRule

object (TableColumnDataValidationRule)

열 데이터 확인 규칙 드롭다운 열 유형에만 설정됩니다.

ColumnType

테이블의 특정 열에 대한 열 유형입니다.

열거형
COLUMN_TYPE_UNSPECIFIED 지정되지 않은 열 유형입니다.
DOUBLE 숫자 열 유형입니다.
CURRENCY 통화 열 유형입니다.
PERCENT 퍼센트 열 유형입니다.
DATE 날짜 열 유형입니다.
TIME 시간 열 유형입니다.
DATE_TIME 날짜 및 시간 열 유형입니다.
TEXT 텍스트 열 유형입니다.
BOOLEAN 불리언 열 유형입니다.
DROPDOWN 드롭다운 열 유형입니다.
FILES_CHIP 파일 칩 열 유형
PEOPLE_CHIP 사용자 칩 열 유형
FINANCE_CHIP 금융 칩 열 유형
PLACE_CHIP 장소 칩 열 유형
RATINGS_CHIP 평점 칩 열 유형

TableColumnDataValidationRule

테이블의 열에 대한 데이터 유효성 검사 규칙입니다.

JSON 표현 
{
  "condition": {
    object (BooleanCondition)
  }
}
필드
condition

object (BooleanCondition)

셀의 데이터가 일치해야 하는 조건입니다. [BooleanCondition.type] 이 ONE_OF_LIST인 경우에만 유효합니다.