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)
    }
  ]
}
필드
properties

object (SheetProperties)

시트의 속성입니다.

data[]

object (GridData)

그리드의 데이터인 경우 그리드의 데이터입니다.

반환되는 GridData 객체의 수는 이 시트에서 요청된 범위 수에 따라 다릅니다. 예를 들어 Sheet1를 나타내고 스프레드시트가 Sheet1!A1:C10Sheet1!D15:E20 범위로 요청된 경우 첫 번째 GridData는 0startRow/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)

이 시트의 슬라이서입니다.

시트 속성

시트의 속성.

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

스프레드시트 내 시트의 색인입니다. 시트 속성을 추가하거나 업데이트할 때 이 필드를 제외하면 시트가 시트 목록의 끝으로 추가되거나 이동합니다. 시트 색인을 업데이트하거나 시트를 삽입할 때 '이동 전' 색인에서 이동이 고려됩니다. 예를 들어 S1을 S2 앞으로 이동하려면 시트 3개 (S1, S2, S3)가 있는 경우 색인을 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 시트인 경우 참입니다.

dataSourceSheetProperties

object (DataSourceSheetProperties)

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

시트 유형

시트 종류

열거형
SHEET_TYPE_UNSPECIFIED 기본값이며 사용하지 마세요.
GRID 시트가 그리드입니다.
OBJECT 시트에는 그리드가 없으며 대신 차트나 이미지와 같은 객체가 있습니다.
DATA_SOURCE 시트가 외부 DataSource에 연결되어 데이터의 미리보기를 보여줍니다.

그리드 속성

그리드의 속성입니다.

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)

데이터 실행 상태입니다.

그리드 데이터

그리드의 데이터 및 측정기준에 대한 메타데이터입니다.

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의 열로 시작합니다.

행 데이터

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

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

object (CellData)

행의 값(열당 하나)

측정기준 속성

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

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)

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

조건부 서식 규칙

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

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는 이 조건부 형식을 제어하는 규칙으로 정확히 1을 설정해야 합니다. rule는 다음 중 하나여야 합니다.
booleanRule

object (BooleanRule)

형식은 규칙에 따라 '사용' 또는 '사용 중지'됩니다.

gradientRule

object (GradientRule)

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

부울 규칙

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

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

object (BooleanCondition)

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

format

object (CellFormat)

적용할 형식입니다. 조건부 서식은 bold, italic, strikethrough, foreground color, background color 등 일부 서식만 적용할 수 있습니다.

그라데이션 규칙

나열된 보간 지점을 기준으로 그라데이션 색상 스케일 형식을 적용하는 규칙입니다. 셀의 형식은 보간점의 값과 비교했을 때 셀의 내용에 따라 달라집니다.

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

object (InterpolationPoint)

시작 보간 지점입니다.

midpoint

object (InterpolationPoint)

중간 보간 지점(선택사항)입니다.

maxpoint

object (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

이 보간점에서 사용하는 값입니다. 수식일 수 있습니다. typeMIN 또는 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과 같습니다. 평면화 시 범위의 오류는 무시됩니다.

필터 보기

필터 보기

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

integer

필터 보기의 ID입니다.

title

string

필터 보기의 이름

range

object (GridRange)

이 필터 보기에서 다루는 범위입니다.

작성할 때 range 또는 namedRangeId 중 하나만 설정할 수 있습니다.

namedRangeId

string

이 필터 보기에서 지원되는 이름이 지정된 범위(있는 경우)

작성할 때 range 또는 namedRangeId 중 하나만 설정할 수 있습니다.

sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 값이 이전 사양과 같을 때 사용됩니다.

criteria
(deprecated)

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

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

이 필드는 지원 중단되고 filterSpecs로 대체됩니다.

filterSpecs[]

object (FilterSpec)

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

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

보호된 범위

보호된 범위

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

integer

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

range

object (GridRange)

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

작성할 때 range 또는 namedRangeId 중 하나만 설정할 수 있습니다.

namedRangeId

string

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

작성할 때 range 또는 namedRangeId 중 하나만 설정할 수 있습니다.

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입니다. 도메인 보호는 도메인 내 문서에서만 지원됩니다.

기본 필터

시트와 관련된 기본 필터입니다.

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

object (GridRange)

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

sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 값이 이전 사양과 같을 때 사용됩니다.

criteria
(deprecated)

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

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

이 필드는 지원 중단되고 filterSpecs로 대체됩니다.

filterSpecs[]

object (FilterSpec)

열당 필터 기준입니다.

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

범위

시트의 밴딩 (교체 색상) 범위입니다.

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

integer

밴딩된 범위의 ID입니다.

range

object (GridRange)

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

rowProperties

object (BandingProperties)

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

columnProperties

object (BandingProperties)

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

밴딩 속성

단일 측정기준 (행 또는 열)을 참조하는 속성 BandedRange.row_propertiesBandedRange.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)

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

headerColorStyle

object (ColorStyle)

첫 번째 행 또는 열의 색상입니다. 이 필드가 설정되면 첫 번째 행 또는 열이 이 색상으로 채워지고 두 번째 행 또는 열부터 색상이 firstBandColorsecondBandColor 사이를 번갈아 표시됩니다. 그렇지 않으면 첫 번째 행 또는 열에 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도 설정하면 이 필드가 우선 적용됩니다.

측정기준 그룹

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

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

object (DimensionRange)

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

depth

integer

이 그룹의 범위를 완전히 포함하는 그룹 수를 나타내는 그룹의 깊이입니다.

collapsed

boolean

이 필드는 그룹이 축소된 경우 true입니다. 얕은 깊이에서 겹치는 그룹이 펼쳐져도 접힌 그룹은 접힌 상태로 유지됩니다.

측정기준의 표시 여부는 이 그룹 속성과는 별개로 변경되므로 true 값은 그룹 내의 모든 측정기준이 숨겨져 있음을 의미하지 않습니다. 하지만 이 속성이 업데이트되면 이 속성이 참인 경우 속성 내 모든 측정기준이 숨김으로 설정되고 거짓인 경우 보이게 설정됩니다.

슬라이서

시트의 슬라이서입니다.

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

integer

슬라이서의 ID입니다.

spec

object (SlicerSpec)

슬라이서의 사양입니다.

position

object (EmbeddedObjectPosition)

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

슬라이서 사양

슬라이서의 사양입니다.

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입니다.