Charts

EmbeddedChart

시트에 삽입된 차트

JSON 표현 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
필드
chartId

integer

차트의 ID입니다.

spec

object (ChartSpec)

차트 사양입니다.

position

object (EmbeddedObjectPosition)

차트의 위치입니다.

border

object (EmbeddedObjectBorder)

차트의 테두리입니다.

ChartSpec

차트의 사양입니다.

JSON 표현 
{
  "title": string,
  "altText": string,
  "titleTextFormat": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "subtitle": string,
  "subtitleTextFormat": {
    object (TextFormat)
  },
  "subtitleTextPosition": {
    object (TextPosition)
  },
  "fontName": string,
  "maximized": boolean,
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "dataSourceChartProperties": {
    object (DataSourceChartProperties)
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "hiddenDimensionStrategy": enum (ChartHiddenDimensionStrategy),

  // Union field chart can be only one of the following:
  "basicChart": {
    object (BasicChartSpec)
  },
  "pieChart": {
    object (PieChartSpec)
  },
  "bubbleChart": {
    object (BubbleChartSpec)
  },
  "candlestickChart": {
    object (CandlestickChartSpec)
  },
  "orgChart": {
    object (OrgChartSpec)
  },
  "histogramChart": {
    object (HistogramChartSpec)
  },
  "waterfallChart": {
    object (WaterfallChartSpec)
  },
  "treemapChart": {
    object (TreemapChartSpec)
  },
  "scorecardChart": {
    object (ScorecardChartSpec)
  }
  // End of list of possible types for union field chart.
}
필드
title

string

차트의 제목입니다.

altText

string

차트를 설명하는 대체 텍스트입니다. 접근성을 위해 자주 사용됩니다.

titleTextFormat

object (TextFormat)

제목 텍스트 형식입니다. 취소선, 밑줄, 링크는 지원되지 않습니다.

titleTextPosition

object (TextPosition)

제목 텍스트 위치입니다. 이 필드는 선택사항입니다.

subtitle

string

차트의 부제목입니다.

subtitleTextFormat

object (TextFormat)

자막 텍스트 형식입니다. 취소선, 밑줄, 링크는 지원되지 않습니다.

subtitleTextPosition

object (TextPosition)

자막 텍스트 위치입니다. 이 필드는 선택사항입니다.

fontName

string

모든 차트 텍스트 (예: 제목, 축 라벨, 범례)에 기본적으로 사용할 글꼴의 이름입니다. 글꼴이 차트의 특정 부분에 지정된 경우 이 글꼴 이름을 재정의합니다.

maximized

boolean

차트가 최소 패딩으로 렌더링되는 전체 공간을 채우도록 하려면 true입니다. 기본 패딩을 사용하려면 false입니다. 지역 및 조직 차트에는 적용되지 않습니다.

backgroundColor
(deprecated)

object (Color)

전체 차트의 배경 색상입니다. 조직도에는 적용되지 않습니다. 지원 중단됨: backgroundColorStyle를 사용하세요.

backgroundColorStyle

object (ColorStyle)

전체 차트의 배경 색상입니다. 조직 차트에는 적용되지 않습니다. backgroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

dataSourceChartProperties

object (DataSourceChartProperties)

이 필드가 있는 경우 데이터 소스 차트별 속성이 포함됩니다.

filterSpecs[]

object (FilterSpec)

차트의 소스 데이터에 적용된 필터입니다. 데이터 소스 차트에만 지원됩니다.

sortSpecs[]

object (SortSpec)

차트 데이터를 정렬하는 순서입니다. 단일 정렬 사양만 지원됩니다. 데이터 소스 차트에만 지원됩니다.

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

차트에서 숨겨진 행 또는 열을 사용하는 방법을 결정합니다.

공용체 필드 chart입니다. 특정 차트 사양. 정확히 하나의 값을 설정해야 합니다. chart는 다음 중 하나여야 합니다.
basicChart

object (BasicChartSpec)

기본 차트 사양은 여러 종류의 차트 중 하나일 수 있습니다. 지원되는 모든 차트의 목록은 BasicChartType를 참고하세요.

pieChart

object (PieChartSpec)

원형 차트 사양

bubbleChart

object (BubbleChartSpec)

풍선형 차트 사양

candlestickChart

object (CandlestickChartSpec)

원통형 차트 사양입니다.

orgChart

object (OrgChartSpec)

조직 차트 사양.

histogramChart

object (HistogramChartSpec)

히스토그램 차트 사양

waterfallChart

object (WaterfallChartSpec)

폭포식 차트 사양

treemapChart

object (TreemapChartSpec)

트리맵 차트 사양

scorecardChart

object (ScorecardChartSpec)

스코어카드 차트 사양

TextPosition

텍스트의 위치 설정입니다.

JSON 표현 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
필드
horizontalAlignment

enum (HorizontalAlign)

텍스트의 가로 정렬 설정입니다.

DataSourceChartProperties

데이터 소스 차트의 속성입니다.

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

string

차트가 연결된 데이터 소스의 ID입니다.

dataExecutionStatus

object (DataExecutionStatus)

출력 전용입니다. 데이터 실행 상태입니다.

BasicChartSpec

기본 차트의 사양입니다. 지원되는 차트 목록은 BasicChartType를 참고하세요.

JSON 표현 
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
필드
chartType

enum (BasicChartType)

차트 유형입니다.

legendPosition

enum (BasicChartLegendPosition)

차트 범례의 위치입니다.

axis[]

object (BasicChartAxis)

차트의 축입니다.

domains[]

object (BasicChartDomain)

차트로 표시하는 데이터 도메인입니다. 단일 도메인만 지원됩니다.

series[]

object (BasicChartSeries)

이 차트에서 시각화하는 데이터입니다.

headerCount

integer

데이터에서 '헤더'인 행 또는 열의 수입니다. 설정하지 않으면 Google Sheets에서 데이터를 기반으로 헤더가 몇 행인지 추측합니다.

BasicChartAxis.title는 헤더 값에서 추론된 축 제목을 재정의할 수 있습니다.

threeDimensional

boolean

차트를 3D로 만들려면 true입니다. 막대 그래프 및 열 차트에 적용됩니다.

interpolateNulls

boolean

계열의 일부 값이 누락되면 차트에 공백이 표시될 수 있습니다 (예: 선 차트의 선 구간이 누락됨). 이러한 간격을 없애려면 이 옵션을 true로 설정하세요. 선, 영역, 콤보 차트에 적용됩니다.

stackedType

enum (BasicChartStackedType)

세로 누적을 지원하는 차트의 누적 유형입니다. 영역, 막대, 열, 콤보, 계단식 영역 차트에 적용됩니다.

lineSmoothing

boolean

기본적으로 모든 선을 부드럽게 렌더링할지 또는 직선으로 렌더링할지 여부를 가져옵니다. 선 차트에 적용됩니다.

compareMode

enum (BasicChartCompareMode)

데이터 및 차트 영역 위로 마우스를 가져갈 때의 도움말 및 데이터 강조 표시 동작

totalDataLabel

object (DataLabel)

누적 차트에 도메인 축을 따라 각 값에서 모든 누적 값의 총 값을 합산하는 데이터 라벨을 추가로 표시할지 여부를 제어합니다. 이러한 데이터 라벨은 chartType이 AREA, BAR, COLUMN, COMBO 또는 STEPPED_AREA 중 하나이고 stackedType이 STACKED 또는 PERCENT_STACKED인 경우에만 설정할 수 있습니다. 또한 COMBO의 경우 쌓을 수 있는 계열 type 유형이 하나뿐이거나 한 유형에 다른 유형보다 계열이 더 많고 다른 유형에는 계열이 하나도 없는 경우에만 지원됩니다. 예를 들어 차트에 누적 막대 계열이 2개 있고 영역 계열이 1개 있는 경우 총 데이터 라벨이 지원됩니다. 3개의 막대 계열과 두 개의 영역 계열이 있는 경우 총 데이터 라벨은 허용되지 않습니다. totalDataLabel에서는 CUSTOM 또는 placement를 설정할 수 없습니다.

BasicChartType

차트를 시각화하는 방법입니다.

열거형
BASIC_CHART_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BAR 막대 그래프
LINE 선 차트
AREA 영역 차트
COLUMN 열 차트.
SCATTER 분산형 차트
COMBO 콤보 차트.
STEPPED_AREA 계단식 영역 차트.

BasicChartLegendPosition

차트의 범례를 배치할 위치입니다.

열거형
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BOTTOM_LEGEND 범례는 차트 하단에 렌더링됩니다.
LEFT_LEGEND 범례는 차트 왼쪽에 렌더링됩니다.
RIGHT_LEGEND 범례가 차트 오른쪽에 렌더링됩니다.
TOP_LEGEND 범례는 차트 상단에 렌더링됩니다.
NO_LEGEND 범례가 렌더링되지 않습니다.

BasicChartAxis

차트의 축입니다. 차트에는 axis position당 축이 2개 이상 있을 수 없습니다.

JSON 표현 
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
필드
position

enum (BasicChartAxisPosition)

이 축의 위치입니다.

title

string

이 축의 제목입니다. 이 속성을 설정하면 데이터의 헤더에서 추론된 제목이 재정의됩니다.

format

object (TextFormat)

제목의 형식입니다. 축이 도메인과 연결되지 않은 경우에만 유효합니다. 지원되지 않는 링크 필드입니다.

titleTextPosition

object (TextPosition)

축 제목 텍스트 위치입니다.

viewWindowOptions

object (ChartAxisViewWindowOptions)

이 축의 뷰 창 옵션입니다.

BasicChartAxisPosition

차트 축의 위치입니다.

열거형
BASIC_CHART_AXIS_POSITION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BOTTOM_AXIS 차트 하단에 렌더링된 축입니다. 대부분의 차트에서는 표준 주축입니다. 막대 그래프의 경우 보조 축입니다.
LEFT_AXIS 차트 왼쪽에 렌더링된 축입니다. 이는 대부분의 차트에서 보조 축입니다. 막대 그래프의 경우 표준 주축입니다.
RIGHT_AXIS 차트 오른쪽에 렌더링된 축입니다. 대부분의 차트에서는 이 축이 부차 축입니다. 막대 그래프의 경우 이는 일반적이지 않은 주요 축입니다.

ChartAxisViewWindowOptions

차트의 '뷰 창'을 정의하는 옵션입니다 (예: 축에 표시되는 값).

JSON 표현 
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
필드
viewWindowMin

number

이 보기 창에 표시할 최소 숫자 값입니다. 설정하지 않으면 데이터에 적합한 최소값이 자동으로 결정됩니다.

viewWindowMax

number

이 뷰 창에 표시할 최대 숫자 값입니다. 설정하지 않으면 데이터에 적합한 최대 값이 자동으로 결정됩니다.

viewWindowMode

enum (ViewWindowMode)

보기 창의 모드입니다.

ViewWindowMode

보기 창의 모드입니다. 뷰 창의 최솟값과 최댓값을 처리하는 방법을 정의합니다.

열거형
DEFAULT_VIEW_WINDOW_MODE 이 차트 유형의 Sheets 편집기에서 사용되는 기본 뷰 창 모드입니다. 대부분의 경우, 기본 모드는 PRETTY와 동일합니다.
VIEW_WINDOW_MODE_UNSUPPORTED 사용하지 마세요. 현재 설정된 모드가 API에서 지원되지 않음을 나타냅니다.
EXPLICIT 지정된 경우 최솟값과 최댓값을 정확하게 따릅니다. 값이 지정되지 않으면 PRETTY 값으로 대체됩니다.
PRETTY 차트를 보기 좋게 만들기 위한 최솟값과 최댓값을 선택합니다. 이 모드에서는 최솟값과 최댓값이 모두 무시됩니다.

BasicChartDomain

차트의 도메인입니다. 예를 들어 시간 경과에 따른 주가를 차트로 표시하는 경우 날짜가 됩니다.

JSON 표현 
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
필드
domain

object (ChartData)

도메인의 데이터입니다. 예를 들어 시간 경과에 따른 주가를 차트로 표시하는 경우 이 데이터는 날짜를 나타내는 데이터입니다.

reversed

boolean

도메인 값의 순서를 반대로 바꾸려면 true입니다 (가로축).

ChartData

도메인 또는 시리즈에 포함된 데이터입니다.

JSON 표현 
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
필드
groupRule

object (ChartGroupRule)

ChartData가 데이터 소스 차트의 도메인을 지원하는 경우 데이터를 그룹화하는 규칙입니다. 데이터 소스 차트에만 지원됩니다.

aggregateType

enum (ChartAggregateType)

데이터 소스 차트의 계열에 대한 집계 유형입니다. 데이터 소스 차트에만 지원됩니다.

공용체 필드 type입니다. 포함된 데이터의 유형입니다. 정확히 하나의 값을 설정해야 합니다. type는 다음 중 하나여야 합니다.
sourceRange

object (ChartSourceRange)

데이터의 소스 범위입니다.

columnReference

object (DataSourceColumnReference)

데이터가 읽는 데이터 소스 열에 대한 참조입니다.

ChartSourceRange

차트의 소스 범위입니다.

JSON 표현 
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
필드
sources[]

object (GridRange)

계열 또는 도메인의 데이터 범위입니다. 정확히 하나의 측정기준은 길이가 1이어야 하며 목록의 모든 소스는 길이가 1인 동일한 측정기준을 가져야 합니다. 도메인 (있는 경우)과 모든 계열의 소스 범위 수가 동일해야 합니다. 소스 범위를 두 개 이상 사용하는 경우 지정된 오프셋의 소스 범위는 도메인과 계열 전체에서 순서가 지정되고 연속되어야 합니다.

예를 들어 다음은 유효한 구성입니다. 

domain sources: A1:A5
series1 sources: B1:B5
series2 sources: D6:D10

domain sources: A1:A5, C10:C12
series1 sources: B1:B5, D10:D12
series2 sources: C1:C5, E10:E12

ChartGroupRule

데이터 소스 차트의 도메인에 있는 ChartData의 선택적 설정으로, 각 개별 값을 분류하는 대신 도메인의 값에 대한 버킷을 정의합니다.

예를 들어 데이터 소스 차트를 구성할 때 도메인에 히스토그램 규칙을 지정하여 (숫자 값만 포함해야 함) 값을 버킷으로 그룹화할 수 있습니다. 동일한 버킷에 속하는 차트 계열의 모든 값은 aggregateType를 기준으로 집계됩니다.

JSON 표현 
{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}
필드
공용체 필드 rule입니다. ChartData에 적용할 규칙입니다. rule는 다음 중 하나여야 합니다.
dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule입니다.

histogramRule

object (ChartHistogramRule)

A ChartHistogramRule

ChartDateTimeRule

소스 데이터 열의 날짜/시간 값에서 선택한 부분을 기준으로 일시 값을 버킷으로 구성할 수 있습니다.

JSON 표현 
{
  "type": enum (ChartDateTimeRuleType)
}
필드
type

enum (ChartDateTimeRuleType)

적용할 날짜 시간 그룹화 유형입니다.

ChartDateTimeRuleType

사용 가능한 날짜-시간 그룹화 규칙 유형입니다.

열거형
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED 기본 유형이며 사용하지 마세요.
SECOND 0에서 59까지 초별로 날짜를 그룹화합니다.
MINUTE 0~59분 단위로 날짜를 그룹화합니다.
HOUR 0~23 사이의 24시간제를 사용하여 시간별로 날짜를 그룹화합니다.
HOUR_MINUTE 24시간 시스템(예: 19:45)을 사용하여 시간과 분으로 날짜를 그룹화합니다.
HOUR_MINUTE_AMPM 12시간제를 사용하여 시간과 분으로 날짜를 그룹화합니다(예:오후 7시 45분). AM/PM 지정은 스프레드시트 언어를 기반으로 번역됩니다.
DAY_OF_WEEK 일요일과 같이 요일별로 날짜를 그룹화합니다. 요일은 스프레드시트 언어를 기반으로 번역됩니다.
DAY_OF_YEAR 1에서 366까지 날짜별로 그룹화합니다. 2월 29일 이후의 날짜는 윤년과 윤년이 아닌 해에 따라 다른 버킷에 포함됩니다.
DAY_OF_MONTH 1~31일의 일별로 날짜를 그룹화합니다.
DAY_MONTH 날짜를 일과 월별로 그룹화합니다(예: 2022년 11월 22일). 월은 스프레드시트 언어에 따라 번역됩니다.
MONTH 날짜를 월별로 그룹화합니다(예: 11월). 월은 스프레드시트 언어에 따라 변환됩니다.
QUARTER 분기별로 날짜를 그룹화합니다(예: 1분기(1월~3월)).
YEAR 연도별로 그룹화합니다(예: 2008).
YEAR_MONTH 연도 및 월별로 날짜를 그룹화합니다(예: 2008-Nov). 월은 스프레드시트 언어에 따라 번역됩니다.
YEAR_QUARTER 연도 및 분기별로 날짜를 그룹화합니다(예: 2008년 4분기).
YEAR_MONTH_DAY 연도, 월, 일(예: 2008-11-22)별로 날짜를 그룹화합니다.

ChartHistogramRule

소스 데이터 열의 숫자 값을 일정한 크기의 버킷으로 구성할 수 있습니다.

JSON 표현 
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
필드
minValue

number

항목이 버킷에 배치되는 최소값입니다. 최솟값보다 작은 값은 하나의 버킷으로 그룹화됩니다. 생략하면 최소 상품 값으로 결정됩니다.

maxValue

number

항목이 버킷에 배치되는 최대 값입니다. 최댓값보다 큰 값은 단일 버킷으로 그룹화됩니다. 생략하면 최대 항목 값에 따라 결정됩니다.

intervalSize

number

생성되는 버킷의 크기입니다. 양수여야 합니다.

ChartAggregateType

차트 계열의 집계 유형입니다.

열거형
CHART_AGGREGATE_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
AVERAGE 평균 집계 함수입니다.
COUNT 집계 함수입니다.
MAX 최대 집계 함수
MEDIAN 중간값 집계 함수
MIN 최소 집계 함수입니다.
SUM Sum 집계 함수

BasicChartSeries

차트의 단일 데이터 계열입니다. 예를 들어 시간 경과에 따른 주식 가격 차트를 표시하는 경우 '시작가', '최고가', '최저가', '종가'에 각각 하나씩 시리즈가 있을 수 있습니다.

JSON 표현 
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
필드
series

object (ChartData)

이 차트 계열에 시각화되는 데이터입니다.

targetAxis

enum (BasicChartAxisPosition)

이 계열의 값 범위를 지정할 부축입니다. 예를 들어 시간 경과에 따른 주식을 차트로 표시하는 경우 거래량의 규모가 가격 규모와 다르기 때문에 '거래량' 계열을 오른쪽에 고정하고 가격을 왼쪽에 고정하는 것이 좋습니다. 차트의 type에 유효한 보조 축이 아닌 축을 지정하면 오류가 발생합니다.

type

enum (BasicChartType)

이 계열의 유형입니다. chartType가 COMBO인 경우에만 유효합니다. 유형에 따라 계열이 시각화되는 방식이 달라집니다. LINE, AREA, COLUMN만 지원됩니다.

lineStyle

object (LineStyle)

이 계열의 선 스타일입니다. chartType가 AREA, LINE 또는 SCATTER인 경우에만 유효합니다. series chart type이 AREA 또는 LINE인 경우 COMBO 차트도 지원됩니다.

dataLabel

object (DataLabel)

이 계열의 데이터 라벨에 대한 정보입니다.

color
(deprecated)

object (Color)

이 계열과 연결된 요소 (예: 막대, 선, 점)의 색상입니다. 비워 두면 기본 색상이 사용됩니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

이 계열과 연결된 요소 (예: 막대, 선, 점)의 색상입니다. 비워 두면 기본 색상이 사용됩니다. color도 설정된 경우 이 필드가 우선 적용됩니다.

pointStyle

object (PointStyle)

이 계열과 연결된 포인트의 스타일입니다. chartType가 AREA, LINE 또는 SCATTER인 경우에만 유효합니다. series chart type이 AREA, LINE 또는 SCATTER인 경우에도 COMBO 차트가 지원됩니다. 비워 두면 기본 점 스타일이 사용됩니다.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

계열 데이터 포인트의 스타일 재정의 설정입니다.

선 스타일(LineStyle)

선의 스타일을 설명하는 속성입니다.

JSON 표현 
{
  "width": integer,
  "type": enum (LineDashType)
}
필드
width

integer

선의 두께입니다(px).

type

enum (LineDashType)

선의 대시 유형입니다.

LineDashType

선의 대시 유형입니다.

열거형
LINE_DASH_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
INVISIBLE 대시 유형이 없으며 이는 표시되지 않는 선과 같습니다.
CUSTOM 선의 맞춤 파선입니다. 정확한 맞춤 대시 스타일을 수정하는 기능은 현재 지원되지 않습니다.
SOLID 실선
DOTTED 점선
MEDIUM_DASHED 대시의 길이가 '중간'인 점선
MEDIUM_DASHED_DOTTED '중간' 대시와 점이 번갈아 표시되는 선입니다.
LONG_DASHED 대시의 길이가 '길이'인 대시 선
LONG_DASHED_DOTTED '긴' 대시와 점이 번갈아 표시되는 선입니다.

DataLabel

하나의 데이터 라벨 세트에 대한 설정입니다. 데이터 라벨은 선 차트의 점과 같은 데이터 세트 옆에 표시되는 주석으로, 그래프의 해당 지점 뒤에 있는 값의 텍스트 표현과 같이 데이터가 나타내는 항목에 관한 추가 정보를 제공합니다.

JSON 표현 
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
필드
type

enum (DataLabelType)

데이터 라벨의 유형입니다.

textFormat

object (TextFormat)

데이터 라벨에 사용되는 텍스트 형식입니다. 링크 필드는 지원되지 않습니다.

placement

enum (DataLabelPlacement)

라벨이 지정된 데이터를 기준으로 데이터 라벨의 배치입니다.

customLabelData

object (ChartData)

맞춤 라벨에 사용할 데이터입니다. type가 CUSTOM로 설정된 경우에만 사용됩니다. 이 데이터는 이 데이터 라벨이 적용되는 계열 또는 다른 요소와 길이가 같아야 합니다. 또한 계열이 여러 소스 범위로 분할된 경우 이 소스 데이터는 소스 데이터의 다음 열에서 가져와야 합니다. 예를 들어 계열이 B2:B4,E6:E8이면 이 데이터는 C2:C4,F6:F8에서 가져와야 합니다.

DataLabelType

데이터 라벨의 유형입니다.

열거형
DATA_LABEL_TYPE_UNSPECIFIED 데이터 라벨 유형은 지정되지 않으며 차트 내 데이터 라벨의 컨텍스트에 따라 해석됩니다.
NONE 데이터 라벨이 표시되지 않습니다.
DATA 데이터 라벨은 계열 데이터의 값을 사용하여 표시됩니다.
CUSTOM 데이터 라벨은 customLabelData로 표시된 커스텀 데이터 소스의 값을 사용하여 표시됩니다.

DataLabelPlacement

라벨이 지정된 데이터를 기준으로 데이터 라벨의 배치입니다.

열거형
DATA_LABEL_PLACEMENT_UNSPECIFIED 위치는 렌더러에 의해 자동으로 결정됩니다.
CENTER 막대 또는 열 내에서 가로와 세로로 중앙에 배치합니다.
LEFT 데이터 포인트 왼쪽
RIGHT 데이터 포인트의 오른쪽에 위치합니다.
ABOVE 데이터 포인트 위에 표시됩니다.
BELOW 데이터 포인트 아래
INSIDE_END 막대 또는 열의 끝부분 (양수인 경우 상단, 음수인 경우 하단)
INSIDE_BASE 하단의 막대 또는 열 내부
OUTSIDE_END 막대 또는 열의 끝 외부

PointStyle

차트의 점 스타일입니다.

JSON 표현 
{
  "size": number,
  "shape": enum (PointShape)
}
필드
size

number

점 크기입니다. 비워 두면 기본 크기가 사용됩니다.

shape

enum (PointShape)

점 모양입니다. 비어 있거나 지정되지 않으면 기본 도형이 사용됩니다.

PointShape

점의 모양입니다.

열거형
POINT_SHAPE_UNSPECIFIED 기본값
CIRCLE 원 모양
DIAMOND 마름모 도형
HEXAGON 육각형 모양
PENTAGON 다각형 모양
SQUARE 정사각형 모양
STAR 별 모양
TRIANGLE 삼각형 도형
X_MARK x 표시 도형

BasicSeriesDataPointStyleOverride

단일 계열 데이터 포인트의 스타일 재정의 설정입니다.

JSON 표현 
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
필드
index

integer

계열 데이터 포인트의 0부터 시작하는 색인입니다.

color
(deprecated)

object (Color)

계열 데이터 포인트의 색상입니다. 비어 있으면 계열 기본값이 사용됩니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

계열 데이터 포인트의 색상입니다. 비어 있으면 계열 기본값이 사용됩니다. color도 설정된 경우 이 필드가 우선 적용됩니다.

pointStyle

object (PointStyle)

계열 데이터 포인트의 점 스타일입니다. chartType가 AREA, LINE 또는 SCATTER인 경우에만 유효합니다. series chart type이 AREA, LINE 또는 SCATTER인 경우에도 COMBO 차트가 지원됩니다. 비어 있으면 계열 기본값이 사용됩니다.

BasicChartStackedType

차트를 쌓으면 범위 (세로축) 값이 가로축이 아닌 겹쳐서 렌더링됩니다. 예를 들어 두 값 20과 80은 0에서 그려지며, 80은 가로축에서 80단위 떨어져 있습니다. 쌓인 경우 80은 20에서 렌더링되어 가로축에서 100단위 떨어지게 됩니다.

열거형
BASIC_CHART_STACKED_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
NOT_STACKED 계열이 누적되지 않습니다.
STACKED 계열 값이 누적되며, 각 값은 그 아래 값 위에서부터 세로로 렌더링됩니다.
PERCENT_STACKED 세로 스택은 차트 상단에 도달하도록 늘어나며 값은 서로의 비율로 표시됩니다.

BasicChartCompareMode

데이터 및 차트 영역에 마우스를 가져갈 때 표시되는 도움말 및 데이터 강조표시의 동작을 설명하는 비교 모드 유형입니다.

열거형
BASIC_CHART_COMPARE_MODE_UNSPECIFIED 기본값이며 사용하지 마세요.
DATUM 포커스가 있는 데이터 요소만 강조 표시되어 도움말에 표시됩니다.
CATEGORY 카테고리 (예: 도메인 값)가 동일한 모든 데이터 요소가 강조 표시되고 도움말에 표시됩니다.

PieChartSpec

원형 차트

JSON 표현 
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
필드
legendPosition

enum (PieChartLegendPosition)

원형 차트의 범례를 그려야 하는 위치입니다.

domain

object (ChartData)

원형 차트의 도메인을 다루는 데이터입니다.

series

object (ChartData)

원형 차트의 유일한 계열을 나타내는 데이터입니다.

threeDimensional

boolean

원형이 3차원이면 참입니다.

pieHole

number

원형 차트의 구멍 크기입니다.

PieChartLegendPosition

차트의 범례를 배치할 위치입니다.

열거형
PIE_CHART_LEGEND_POSITION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BOTTOM_LEGEND 범례는 차트 하단에 렌더링됩니다.
LEFT_LEGEND 범례는 차트 왼쪽에 렌더링됩니다.
RIGHT_LEGEND 범례가 차트 오른쪽에 렌더링됩니다.
TOP_LEGEND 범례는 차트 상단에 렌더링됩니다.
NO_LEGEND 범례가 렌더링되지 않습니다.
LABELED_LEGEND 각 파이 조각에는 라벨이 연결되어 있습니다.

BubbleChartSpec

풍선형 차트

JSON 표현 
{
  "legendPosition": enum (BubbleChartLegendPosition),
  "bubbleLabels": {
    object (ChartData)
  },
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "groupIds": {
    object (ChartData)
  },
  "bubbleSizes": {
    object (ChartData)
  },
  "bubbleOpacity": number,
  "bubbleBorderColor": {
    object (Color)
  },
  "bubbleBorderColorStyle": {
    object (ColorStyle)
  },
  "bubbleMaxRadiusSize": integer,
  "bubbleMinRadiusSize": integer,
  "bubbleTextStyle": {
    object (TextFormat)
  }
}
필드
legendPosition

enum (BubbleChartLegendPosition)

차트의 범례를 그려야 하는 위치입니다.

bubbleLabels

object (ChartData)

풍선 라벨이 포함된 데이터입니다. 고유하지 않아도 됩니다.

domain

object (ChartData)

풍선 x 값이 포함된 데이터입니다. 이 값은 차트에서 거품을 가로로 배치합니다.

series

object (ChartData)

풍선 y 값이 포함된 데이터입니다. 이 값은 차트에서 거품을 세로로 배치합니다.

groupIds

object (ChartData)

풍선 그룹 ID가 포함된 데이터입니다. 그룹 ID가 동일한 모든 풍선은 동일한 색상으로 그려집니다. bubbleSizes가 지정된 경우 이 필드도 지정해야 하지만 빈 값을 포함할 수 있습니다. 이 필드는 선택사항입니다.

bubbleSizes

object (ChartData)

풍선 크기가 포함된 데이터입니다. 풍선 크기는 서로 다른 크기로 풍선을 그리는 데 사용됩니다. 지정된 경우 groupIds도 지정해야 합니다. 이 필드는 선택사항입니다.

bubbleOpacity

number

0~1.0 사이의 풍선 불투명도입니다. 0은 완전히 투명하고 1은 완전히 불투명합니다.

bubbleBorderColor
(deprecated)

object (Color)

풍선 테두리 색상입니다. 지원 중단됨: bubbleBorderColorStyle를 사용하세요.

bubbleBorderColorStyle

object (ColorStyle)

풍선 테두리 색상입니다. bubbleBorderColor도 설정된 경우 이 필드가 우선 적용됩니다.

bubbleMaxRadiusSize

integer

풍선의 최대 반경 크기(픽셀)입니다. 지정된 경우 필드는 양수여야 합니다.

bubbleMinRadiusSize

integer

풍선의 최소 반경 크기(픽셀)입니다. 구체적인 경우 필드는 양수여야 합니다.

bubbleTextStyle

object (TextFormat)

풍선 내 텍스트의 형식입니다. 취소선, 밑줄, 링크는 지원되지 않습니다.

BubbleChartLegendPosition

차트의 범례가 배치될 위치입니다.

열거형
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BOTTOM_LEGEND 범례는 차트 하단에 렌더링됩니다.
LEFT_LEGEND 범례는 차트 왼쪽에 렌더링됩니다.
RIGHT_LEGEND 범례가 차트 오른쪽에 렌더링됩니다.
TOP_LEGEND 범례는 차트 상단에 렌더링됩니다.
NO_LEGEND 범례가 렌더링되지 않습니다.
INSIDE_LEGEND 범례는 차트 영역 내에 렌더링됩니다.

CandlestickChartSpec

원통형 차트

JSON 표현 
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
필드
domain

object (CandlestickDomain)

양초 차트의 도메인 데이터 (가로축)입니다. 문자열 데이터는 개별 라벨로, 다른 데이터는 연속된 값으로 처리됩니다.

data[]

object (CandlestickData)

원통형 차트 데이터입니다. 하나의 CandlestickData만 지원됩니다.

CandlestickDomain

CandlestickChart의 도메인입니다.

JSON 표현 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
필드
data

object (ChartData)

CandlestickDomain의 데이터입니다.

reversed

boolean

도메인 값의 순서를 반대로 바꾸려면 true입니다 (가로축).

CandlestickData

시리즈의 하한가, 시가, 종가, 상한가를 각각 포함하는 원통형 차트 데이터입니다.

JSON 표현 
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
필드
lowSeries

object (CandlestickSeries)

각 양초의 최솟값 범위 데이터 (세로축)입니다. 원통 중앙선의 하단입니다.

openSeries

object (CandlestickSeries)

각 양초의 개장/초기 값의 범위 데이터 (세로축)입니다. 양초 본체의 하단입니다. 종가 값보다 작으면 색이 채워진 원통이 표시되고 그렇지 않으면 원통이 속이 보입니다.

closeSeries

object (CandlestickSeries)

각 원통의 종가/최종 값에 대한 범위 데이터 (세로축)입니다. 양초 본체의 상단입니다. 종가 값보다 크면 양초가 채워집니다. 그렇지 않으면 양초가 비어 있게 됩니다.

highSeries

object (CandlestickSeries)

각 양초의 최고/최대 값의 범위 데이터 (세로 축)입니다. 이는 원통 중심선의 상단입니다.

CandlestickSeries

CandlestickData의 계열입니다.

JSON 표현 
{
  "data": {
    object (ChartData)
  }
}
필드
data

object (ChartData)

CandlestickSeries의 데이터입니다.

OrgChartSpec

조직도. 조직도에는 labels에 고유한 라벨 집합이 필요하며 선택적으로 parentLabels 및 tooltips를 포함할 수 있습니다. parentLabels 각 노드에 대해 상위 노드를 식별하는 라벨을 포함합니다. tooltips는 각 노드에 대한 선택적 도움말을 포함합니다.

예를 들어 Alice가 CEO이고, Bob이 회장 (Alice에게 보고)이고, Cathy가 영업 부사장 (Alice에게 보고)인 조직도를 설명하려면 labels에 'Alice', 'Bob', 'Cathy'를, parentLabels에 '"', 'Alice', 'Alice'를, tooltips에 'CEO', '회장', '영업 부사장'을 포함합니다.

JSON 표현 
{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}
필드
nodeSize

enum (OrgChartNodeSize)

조직도 노드의 크기입니다.

nodeColor
(deprecated)

object (Color)

조직 차트 노드의 색상입니다. 지원 중단됨: nodeColorStyle를 사용하세요.

nodeColorStyle

object (ColorStyle)

조직도 노드의 색상입니다. nodeColor도 설정된 경우 이 필드가 우선 적용됩니다.

selectedNodeColor
(deprecated)

object (Color)

선택한 조직도 노드의 색상입니다. 지원 중단됨: selectedNodeColorStyle를 사용하세요.

selectedNodeColorStyle

object (ColorStyle)

선택한 조직도 노드의 색상입니다. selectedNodeColor도 설정된 경우 이 필드가 우선 적용됩니다.

labels

object (ChartData)

차트의 모든 노드에 대한 라벨이 포함된 데이터입니다. 라벨은 고유해야 합니다.

parentLabels

object (ChartData)

해당 노드의 상위 요소의 라벨이 포함된 데이터입니다. 공백 값은 노드에 상위 요소가 없으며 최상위 노드임을 나타냅니다. 이 필드는 선택사항입니다.

tooltips

object (ChartData)

해당 노드의 도움말이 포함된 데이터입니다. 값이 비어 있으면 노드에 도움말이 표시되지 않습니다. 이 필드는 선택사항입니다.

OrgChartNodeSize

조직도 노드의 크기입니다.

열거형
ORG_CHART_LABEL_SIZE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
SMALL 작은 조직도 노드 크기입니다.
MEDIUM 중간 조직도 노드 크기입니다.
LARGE 대규모 조직도 노드 크기입니다.

HistogramChartSpec

히스토그램 차트 히스토그램 차트는 데이터 항목을 구간으로 그룹화하여 각 구간을 누적된 항목의 열로 표시합니다. 히스토그램은 데이터 세트의 분포를 표시하는 데 사용됩니다. 항목의 각 열은 해당 항목이 속하는 범위를 나타냅니다. 구간 수는 자동으로 선택되거나 명시적으로 지정될 수 있습니다.

JSON 표현 
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
필드
series[]

object (HistogramSeries)

히스토그램의 계열은 버케팅할 단일 계열이거나 각각 길이가 같은 여러 계열일 수 있습니다. 여기에는 계열 이름 뒤에 해당 계열에 대해 버케팅할 값이 포함됩니다.

legendPosition

enum (HistogramChartLegendPosition)

차트 범례의 위치

showItemDividers

boolean

각 열의 항목 사이에 가로 구분선을 표시할지 여부입니다.

bucketSize

number

기본적으로 버킷 크기 (단일 열에 스택된 값 범위)는 자동으로 선택되지만 여기에서 재정의할 수 있습니다. 예: 버킷 크기가 1.5이면 0~1.5, 1.5~3.0 등의 버킷이 생성됩니다. 음수일 수 없습니다. 이 필드는 선택사항입니다.

outlierPercentile

number

외부값 백분위수는 외부값이 버킷 크기 계산에 부정적인 영향을 미치지 않도록 하는 데 사용됩니다. 예를 들어 이상치 백분위수를 0.05로 설정하면 버킷을 계산할 때 값의 상위 5%와 하위 5%를 나타냅니다. 값은 여전히 차트에 포함되며 자체 버킷 대신 첫 번째 또는 마지막 버킷에 추가됩니다. 0.0과 0.5 사이여야 합니다.

HistogramSeries

계열 색상과 데이터가 포함된 히스토그램 계열입니다.

JSON 표현 
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
필드
barColor
(deprecated)

object (Color)

각 버킷에서 이 계열을 나타내는 열의 색상입니다. 이 필드는 선택사항입니다. 지원 중단됨: barColorStyle를 사용하세요.

barColorStyle

object (ColorStyle)

각 버킷에서 이 계열을 나타내는 열의 색상입니다. 이 필드는 선택사항입니다. barColor도 설정된 경우 이 필드가 우선 적용됩니다.

data

object (ChartData)

이 히스토그램 계열의 데이터입니다.

HistogramChartLegendPosition

차트의 범례가 배치될 위치입니다.

열거형
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED 기본값이며 사용할 수 없습니다.
BOTTOM_LEGEND 범례는 차트 하단에 렌더링됩니다.
LEFT_LEGEND 범례는 차트 왼쪽에 렌더링됩니다.
RIGHT_LEGEND 범례가 차트 오른쪽에 렌더링됩니다.
TOP_LEGEND 범례는 차트 상단에 렌더링됩니다.
NO_LEGEND 범례가 렌더링되지 않습니다.
INSIDE_LEGEND 범례는 차트 영역 내에 렌더링됩니다.

WaterfallChartSpec

폭포식 차트

JSON 표현 
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
필드
domain

object (WaterfallChartDomain)

폭포식 차트의 도메인 데이터 (가로축)입니다.

series[]

object (WaterfallChartSeries)

이 폭포식 구조 차트에서 시각화하는 데이터입니다.

stackedType

enum (WaterfallChartStackedType)

스택 유형입니다.

firstValueIsTotal

boolean

첫 번째 값을 합계로 해석하려면 true입니다.

hideConnectorLines

boolean

열 사이의 커넥터 선을 숨기려면 true로 설정합니다.

connectorLineStyle

object (LineStyle)

커넥터 선의 선 스타일입니다.

totalDataLabel

object (DataLabel)

누적 차트에 도메인 축을 따라 각 값에서 모든 누적 값의 총 값을 합산하는 데이터 라벨을 추가로 표시할지 여부를 제어합니다. stackedType는 STACKED여야 하며 totalDataLabel에서 CUSTOM 및 placement를 설정할 수 없습니다.

WaterfallChartDomain

폭포형 차트의 도메인입니다.

JSON 표현 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
필드
data

object (ChartData)

WaterfallChartDomain의 데이터입니다.

reversed

boolean

도메인 값 (가로 축)의 순서를 뒤집으려면 true로 설정합니다.

WaterfallChartSeries

폭포식 차트의 단일 데이터 계열입니다.

JSON 표현 
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
필드
data

object (ChartData)

이 계열에 시각화되는 데이터입니다.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

이 계열의 모든 열에 적용되는 양수 값의 스타일입니다.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

이 계열의 모든 열에 적용되는 스타일로, 값이 음수입니다.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

이 시리즈의 모든 하위 합계 열의 스타일입니다.

hideTrailingSubtotal

boolean

True이면 계열의 끝에서 총계 열을 숨깁니다. 기본적으로 각 계열의 끝에 총계 열이 표시됩니다. 이 필드를 true로 설정하면 이 계열의 하위 총괄 열이 숨겨집니다.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

이 시리즈에 표시되는 맞춤 합계 열입니다. 하위 합계를 정의하는 순서는 중요하지 않습니다. 각 데이터 포인트에는 하나의 하위 합계만 정의할 수 있습니다.

dataLabel

object (DataLabel)

이 계열의 데이터 라벨에 대한 정보입니다.

WaterfallChartColumnStyle

폭포식 차트 열의 스타일입니다.

JSON 표현 
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
필드
label

string

열의 범례 라벨입니다.

color
(deprecated)

object (Color)

열의 색상입니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

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

WaterfallChartCustomSubtotal

폭포형 차트 시리즈의 맞춤 소계 열입니다.

JSON 표현 
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
필드
subtotalIndex

integer

계열 내 데이터 포인트의 0부터 시작하는 색인입니다. dataIsSubtotal가 true이면 이 색인의 데이터 포인트가 하위 합계입니다. 그렇지 않으면 이 색인이 있는 데이터 포인트 뒤에 소계가 표시됩니다. 계열에는 임의의 색인에 여러 개의 총계가 있을 수 있지만 총계는 데이터 포인트의 색인에 영향을 미치지 않습니다. 예를 들어 계열에 세 개의 데이터 포인트가 있는 경우 계열의 소계 수나 연결된 데이터 포인트에 관계없이 색인이 항상 0, 1, 2가 됩니다.

label

string

총계 열의 라벨입니다.

dataIsSubtotal

boolean

subtotalIndex의 데이터 포인트가 소계이면 true입니다. false인 경우 하위 합계가 계산되어 데이터 포인트 뒤에 표시됩니다.

WaterfallChartStackedType

폭포형 차트의 누적 유형 옵션

열거형
WATERFALL_STACKED_TYPE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
STACKED 동일한 도메인 (가로축) 값에 해당하는 값은 수직으로 쌓입니다.
SEQUENTIAL 계열이 가로 축을 따라 펼쳐집니다.

TreemapChartSpec

트리맵 차트.

JSON 표현 
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
필드
labels

object (ChartData)

트리맵 셀 라벨이 포함된 데이터입니다.

parentLabels

object (ChartData)

트리맵 셀의 상위 라벨이 포함된 데이터

sizeData

object (ChartData)

각 트리맵 데이터 셀의 크기를 결정하는 데이터입니다. 이 데이터는 숫자여야 합니다. 숫자가 아니거나 누락된 데이터에 해당하는 셀은 렌더링되지 않습니다. colorData이 지정되지 않으면 이 데이터는 데이터 셀 배경 색상을 결정하는 데도 사용됩니다.

colorData

object (ChartData)

각 트리맵 데이터 셀의 배경 색상을 결정하는 데이터입니다. 이 필드는 선택사항입니다. 지정하지 않으면 sizeData이 배경색을 결정하는 데 사용됩니다. 지정된 경우 데이터는 숫자여야 합니다. colorScale에 따라 이 데이터의 값이 데이터 셀 배경색에 매핑되는 방식이 결정됩니다.

textFormat

object (TextFormat)

차트에 있는 모든 라벨의 텍스트 형식입니다. 지원되지 않는 링크 필드입니다.

levels

integer

트리맵 차트에 표시할 데이터 수준의 수입니다. 이러한 수준은 대화형이며 라벨과 함께 표시됩니다. 지정하지 않을 경우 기본값은 2입니다.

hintedLevels

integer

트리맵 차트에 표시될 라벨이 지정된 수준 외의 추가 데이터 수준의 수입니다. 이러한 수준은 상호작용이 불가능하며 라벨 없이 표시됩니다. 지정하지 않을 경우 기본값은 0입니다.

minValue

number

가능한 최소 데이터 값입니다. 이 값보다 작은 값의 셀은 이 값의 셀과 동일한 색상으로 표시됩니다. 지정하지 않으면 기본값은 colorData의 실제 최솟값이거나 colorData가 지정되지 않은 경우 sizeData의 최솟값입니다.

maxValue

number

가능한 최대 데이터 값입니다. 이보다 큰 값이 포함된 셀은 이 값을 가진 셀과 색상이 동일합니다. 지정하지 않으면 기본값은 colorData의 실제 최대 값 또는 colorData가 지정되지 않은 경우 sizeData의 최대 값입니다.

headerColor
(deprecated)

object (Color)

헤더 셀의 배경 색상입니다. 지원 중단됨: headerColorStyle를 사용하세요.

headerColorStyle

object (ColorStyle)

헤더 셀의 배경 색상입니다. headerColor도 설정된 경우 이 필드가 우선 적용됩니다.

colorScale

object (TreemapChartColorScale)

트리맵 차트의 데이터 셀에 대한 색상 스케일입니다. 데이터 셀에는 색상 값을 기준으로 색상이 할당됩니다. 이러한 색상 값은 colorData에서 가져오거나 colorData가 지정되지 않은 경우 sizeData에서 가져옵니다. 색상 값이 minValue 이하인 셀은 minValueColor을 배경색으로 사용합니다. 색상 값이 maxValue 이상인 셀의 경우 maxValueColor이 배경색이 됩니다. 색상 값이 minValue과 maxValue 사이인 셀은 minValueColor과 maxValueColor 사이의 그라데이션에 배경 색상이 적용되며 그라데이션의 중간점은 midValueColor입니다. 색상 값이 누락되었거나 숫자가 아닌 셀의 배경색은 noDataColor입니다.

hideTooltips

boolean

도움말을 숨기려면 true입니다.

TreemapChartColorScale

트리맵 차트의 색상 스케일입니다.

JSON 표현 
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
필드
minValueColor
(deprecated)

object (Color)

색상 값이 minValue 이하인 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #dc3912입니다. 지원 중단됨: minValueColorStyle를 사용하세요.

minValueColorStyle

object (ColorStyle)

색상 값이 minValue 이하인 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #dc3912입니다. minValueColor도 설정된 경우 이 필드가 우선 적용됩니다.

midValueColor
(deprecated)

object (Color)

색상 값이 minValue과 maxValue의 중간 지점에 있는 셀의 배경 색상입니다. 지정하지 않으면 기본값은 #efe6dc입니다. 지원 중단됨: midValueColorStyle를 사용하세요.

midValueColorStyle

object (ColorStyle)

색상 값이 minValue과 maxValue의 중간 지점에 있는 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #efe6dc입니다. midValueColor도 설정된 경우 이 필드가 우선 적용됩니다.

maxValueColor
(deprecated)

object (Color)

색상 값이 maxValue 이상인 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #109618입니다. 지원 중단됨: maxValueColorStyle를 사용하세요.

maxValueColorStyle

object (ColorStyle)

색상 값이 maxValue 이상인 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #109618입니다. maxValueColor도 설정된 경우 이 필드가 우선 적용됩니다.

noDataColor
(deprecated)

object (Color)

색상 데이터가 연결되지 않은 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #000000입니다. 지원 중단됨: noDataColorStyle를 사용하세요.

noDataColorStyle

object (ColorStyle)

연결된 색상 데이터가 없는 셀의 배경 색상입니다. 지정하지 않을 경우 기본값은 #000000입니다. noDataColor도 설정된 경우 이 필드가 우선 적용됩니다.

ScorecardChartSpec

스코어카드 차트 스코어카드 차트는 스프레드시트에서 핵심성과지표(KPI)를 강조 표시하는 데 사용됩니다. 스코어카드 차트는 총매출, 평균 비용, 인기 상품 등을 나타낼 수 있습니다. 단일 데이터 값을 지정하거나 데이터 범위에 대해 집계할 수 있습니다. 시간 경과에 따른 변화와 같이 기준 값과의 백분율 또는 절대 차이를 강조 표시할 수 있습니다.

JSON 표현 
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
필드
keyValueData

object (ChartData)

스코어카드 키 값의 데이터입니다.

baselineValueData

object (ChartData)

스코어카드 기준 값의 데이터입니다. 이 필드는 선택사항입니다.

aggregateType

enum (ChartAggregateType)

스코어카드 차트의 주요 항목 및 기준 차트 데이터의 집계 유형입니다. 이 필드는 데이터 소스 차트에서 지원되지 않습니다. 데이터 소스 차트에는 keyValueData 또는 baselineValueData의 ChartData.aggregateType 필드를 대신 사용하세요. 이 필드는 선택사항입니다.

keyValueFormat

object (KeyValueFormat)

키 값의 서식 옵션입니다.

baselineValueFormat

object (BaselineValueFormat)

기준 값의 형식 지정 옵션입니다. 이 필드는 baselineValueData가 지정된 경우에만 필요합니다.

scaleFactor

number

스코어카드 키와 기준 값을 조정할 값입니다. 예를 들어 10의 배수를 사용하여 차트의 모든 값을 10으로 나눌 수 있습니다. 이 필드는 선택사항입니다.

numberFormatSource

enum (ChartNumberFormatSource)

스코어카드 차트에 사용된 숫자 형식 소스입니다. 이 필드는 선택사항입니다.

customFormatOptions

object (ChartCustomNumberFormatOptions)

스코어카드 차트의 숫자 키/기준 값에 대한 맞춤 형식 지정 옵션입니다. 이 필드는 numberFormatSource가 CUSTOM로 설정된 경우에만 사용됩니다. 이 필드는 선택사항입니다.

KeyValueFormat

키 값의 서식 옵션입니다.

JSON 표현 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
필드
textFormat

object (TextFormat)

키 값의 텍스트 서식 지정 옵션입니다. 링크 필드는 지원되지 않습니다.

position

object (TextPosition)

키 값의 가로 텍스트 위치를 지정합니다. 이 필드는 선택사항입니다. 지정하지 않으면 기본 위치 지정이 사용됩니다.

BaselineValueFormat

기준 값의 형식 지정 옵션입니다.

JSON 표현 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
필드
comparisonType

enum (ComparisonType)

키 값과 기준 값의 비교 유형입니다.

textFormat

object (TextFormat)

기준 값의 텍스트 서식 지정 옵션입니다. 링크 필드는 지원되지 않습니다.

position

object (TextPosition)

기준 값의 가로 텍스트 위치를 지정합니다. 이 필드는 선택사항입니다. 지정하지 않으면 기본 위치 지정이 사용됩니다.

description

string

기준 값 뒤에 추가되는 설명입니다. 이 필드는 선택사항입니다.

positiveColor
(deprecated)

object (Color)

기준 값이 키 값의 양수 변화를 나타내는 경우 사용되는 색상입니다. 이 필드는 선택사항입니다. 지원 중단됨: positiveColorStyle를 사용하세요.

positiveColorStyle

object (ColorStyle)

기준값이 키 값의 양수 변화를 나타내는 경우 사용할 색상입니다. 이 필드는 선택사항입니다. positiveColor도 설정된 경우 이 필드가 우선 적용됩니다.

negativeColor
(deprecated)

object (Color)

기준 값이 키 값의 음수 변화를 나타내는 경우 사용할 색상입니다. 이 필드는 선택사항입니다. 지원 중단됨: negativeColorStyle를 사용하세요.

negativeColorStyle

object (ColorStyle)

기준값이 키 값의 음수 변경을 나타내는 경우 사용할 색상입니다. 이 필드는 선택사항입니다. negativeColor도 설정된 경우 이 필드가 우선 적용됩니다.

ComparisonType

키 값과 기준 값의 비교 유형입니다.

열거형
COMPARISON_TYPE_UNDEFINED 기본값이며 사용할 수 없습니다.
ABSOLUTE_DIFFERENCE 키와 기준 값의 절대차를 사용합니다.
PERCENTAGE_DIFFERENCE 키와 기준 값 간의 비율 차이를 사용합니다.

ChartNumberFormatSource

차트 속성의 숫자 형식 지정 소스 옵션입니다.

열거형
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED 기본값이며 사용할 수 없습니다.
FROM_DATA 데이터에서 숫자 형식을 상속합니다.
CUSTOM ChartCustomNumberFormatOptions에 지정된 대로 맞춤 서식을 적용합니다.

ChartCustomNumberFormatOptions

차트 속성의 맞춤 숫자 서식 옵션입니다.

JSON 표현 
{
  "prefix": string,
  "suffix": string
}
필드
prefix

string

차트 속성에 추가할 맞춤 접두사입니다. 이 필드는 선택사항입니다.

suffix

string

차트 속성에 추가할 맞춤 접미사입니다. 이 필드는 선택사항입니다.

ChartHiddenDimensionStrategy

차트에서 숨겨진 소스 행을 처리하는 방법을 결정합니다. 숨겨진 행에는 수동으로 숨겨진 행과 필터로 숨겨진 행이 모두 포함됩니다.

열거형
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED 기본값이며 사용하지 마세요.
SKIP_HIDDEN_ROWS_AND_COLUMNS 차트는 숨겨진 행과 열을 건너뜁니다.
SKIP_HIDDEN_ROWS 차트는 숨겨진 행만 건너뜁니다.
SKIP_HIDDEN_COLUMNS 차트는 숨겨진 열만 건너뜁니다.
SHOW_ALL 차트는 숨겨진 행이나 열을 건너뛰지 않습니다.

EmbeddedObjectBorder

삽입된 객체의 테두리입니다.

JSON 표현 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
필드
color
(deprecated)

object (Color)

테두리의 색상입니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

테두리의 색상입니다. color도 설정된 경우 이 필드가 우선 적용됩니다.