Charts

삽입된 차트

시트에 삽입된 차트

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

integer

차트의 ID입니다.

spec

object (ChartSpec)

차트 사양입니다.

position

object (EmbeddedObjectPosition)

차트의 위치입니다.

border

object (EmbeddedObjectBorder)

차트의 테두리.

차트 사양

차트 사양입니다.

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

참으로 설정하면 차트가 렌더링되는 전체 공간을 최소 패딩으로 채웁니다. False로 기본 패딩을 사용합니다. 지역 및 조직 차트에는 적용되지 않습니다.

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

dataSourceChartProperties

object (DataSourceChartProperties)

필드가 있으면 이 필드에 데이터 소스 차트별 속성이 포함됩니다.

filterSpecs[]

object (FilterSpec)

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

sortSpecs[]

object (SortSpec)

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

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

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

공용체 필드 chart는 구체적인 차트 사양으로 정확히 1개의 값을 설정해야 합니다. 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)

스코어카드 차트 사양

텍스트 위치

텍스트 위치 설정

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

enum (HorizontalAlign)

텍스트 부분의 가로 정렬 설정

데이터 소스 차트 속성

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

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

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

기본 차트 사양

기본 차트 사양입니다. 지원되는 차트 목록은 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로 만듭니다. 막대 그래프와 열 차트에 적용됩니다.

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개와 영역 계열 2개가 있는 경우 총 데이터 라벨이 허용되지 않습니다. totalDataLabel에서 CUSTOM 및 placement를 설정할 수 없습니다.

기본 차트 유형

차트 시각화 방법

열거형
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 범례가 렌더링되지 않습니다.

기본 차트 축

차트의 축입니다. 차트는 axis position당 두 개 이상의 축을 가질 수 있습니다.

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)

이 축의 창 보기 옵션입니다.

기본 차트 축 위치

차트 축의 위치입니다.

열거형
BASIC_CHART_AXIS_POSITION_UNSPECIFIED 기본값이며 사용하지 마세요.
BOTTOM_AXIS 차트 하단에 렌더링된 축입니다. 대부분의 차트에서 이는 표준 주요 축입니다. 막대 그래프의 경우 보조 축입니다.
LEFT_AXIS 차트 왼쪽에 렌더링된 축입니다. 대부분의 차트에서 이 값은 보조 축입니다. 막대 그래프의 경우 표준 주 축입니다.
RIGHT_AXIS 차트 오른쪽에 렌더링된 축입니다. 대부분의 차트에서 이 값은 보조 축입니다. 막대 그래프에서는 이것이 비정상적인 주축입니다.

차트 AxisViewWindowOptions

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

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 차트를 보기 좋게 만들 최소 및 최대 값을 선택합니다. 이 모드에서는 최솟값 및 최댓값이 모두 무시됩니다.

기본 차트 도메인

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

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

object (ChartData)

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

reversed

boolean

도메인 값의 순서 (가로 축)를 반전하려면 참입니다.

차트 데이터

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

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는 포함되는 데이터 유형으로 정확히 1개의 값을 설정해야 합니다. type는 다음 중 하나여야 합니다.
sourceRange

object (ChartSourceRange)

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

columnReference

object (DataSourceColumnReference)

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

차트 소스 범위

차트의 소스 범위입니다.

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

object (GridRange)

시리즈 또는 도메인의 데이터 범위 정확히 1개의 측정기준이 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

차트 그룹 규칙

각 개별 값을 분석하는 대신 도메인 내 값의 버킷을 정의하는 데이터 소스 차트 도메인의 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)

ChartHistogramRule

차트 날짜 시간 규칙

소스 데이터 열의 날짜-시간 값을 해당 날짜 또는 시간 값의 선택된 부분을 기준으로 버킷으로 구성할 수 있습니다.

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

enum (ChartDateTimeRuleType)

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

차트 날짜 시간 규칙 유형

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

열거형
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED 기본 유형이며 사용하지 않습니다.
SECOND 0에서 59까지 초 단위로 날짜를 그룹화합니다.
MINUTE 날짜를 분 단위로 그룹화합니다(0~59).
HOUR 24시간제(0~23시)를 사용하여 시간을 그룹화합니다.
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 날짜를 일, 월(예: 11월 22일) 기준으로 그룹화합니다. 해당 월은 스프레드시트 언어에 따라 번역됩니다.
MONTH 날짜를 기준으로 그룹화합니다(예: 11월). 스프레드시트 언어에 따라 월이 변환됩니다.
QUARTER 분기별로 날짜를 그룹화합니다(예: 1분기(3월)).
YEAR 연도별로 날짜를 그룹화합니다(예: 2008).
YEAR_MONTH 연도와 월을 기준으로 날짜를 그룹화합니다(예: 2008-11월). 스프레드시트 언어를 기준으로 월이 변환됩니다.
YEAR_QUARTER 연도 및 분기별로 날짜를 그룹화합니다(예: 2008년 4분기).
YEAR_MONTH_DAY 연도, 월, 일을 기준으로 날짜를 그룹화합니다(예: 2008-11-22).

차트 히스토그램 규칙

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

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

number

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

maxValue

number

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

intervalSize

number

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

차트 집계 유형

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

열거형
CHART_AGGREGATE_TYPE_UNSPECIFIED 기본값이며 사용하지 마세요.
AVERAGE 평균 집계 함수입니다.
COUNT 집계 함수.
MAX 최대 집계 함수입니다.
MEDIAN 중앙값 집계 함수입니다.
MIN 최소 집계 함수입니다.
SUM 합계 함수

기본 차트 시리즈

차트의 단일 데이터 계열 예를 들어 시간 경과에 따라 주가를 차트로 표시하는 경우 '공개가', '높은 가격', '저가', '최종가'에 대한 여러 개의 시리즈가 존재할 수 있습니다.

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

선의 두께(픽셀)입니다.

type

enum (LineDashType)

선의 파선 유형입니다.

점선 유형

선의 파선 유형입니다.

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

데이터 라벨

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

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에서 가져와야 합니다.

데이터 라벨 유형

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

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

데이터 라벨 배치

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

열거형
DATA_LABEL_PLACEMENT_UNSPECIFIED 배치는 렌더기에 의해 자동으로 결정됩니다.
CENTER 가로 또는 세로 모두 막대 또는 열 내부에 배치됩니다.
LEFT 데이터 포인트 왼쪽에 있습니다.
RIGHT 데이터 포인트 오른쪽에 있습니다.
ABOVE 데이터 포인트 초과
BELOW 데이터 포인트 아래
INSIDE_END 막대 또는 열 내부 (양쪽은 상단, 음수는 하단)
INSIDE_BASE 하단의 막대 또는 열 내부
OUTSIDE_END 끝부분의 막대 또는 열 외부

점 스타일

차트에 있는 점의 스타일입니다.

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

number

점 크기 비어 있으면 기본 크기가 사용됩니다.

shape

enum (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 차트도 지원됩니다. 비어 있으면 시리즈 기본값이 사용됩니다.

기본 차트 스택 유형

차트가 누적되면 범위 (세로축) 값이 가로축이 아닌 서로 위아래로 렌더링됩니다. 예를 들어 두 값 20과 80은 0에서 그려지며 80은 가로축에서 80단위가 됩니다. 쌓여 있으면 20에서 80이 렌더링되어 가로축에서 100단위가 떨어집니다.

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

기본 차트 비교 모드

비교 모드 유형: 데이터 및 차트 영역으로 마우스를 가져가면 도움말 및 데이터 강조표시 동작을 설명합니다.

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

원형 차트 사양

원형 차트

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차원인 경우 true입니다.

pieHole

number

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

PieChartLegendPosition

차트의 범례를 배치할 위치

열거형
PIE_CHART_LEGEND_POSITION_UNSPECIFIED 기본값이며 사용하지 마세요.
BOTTOM_LEGEND 범례는 차트 하단에 렌더링됩니다.
LEFT_LEGEND 범례는 차트 왼쪽에 렌더링됩니다.
RIGHT_LEGEND 범례는 차트 오른쪽에 렌더링됩니다.
TOP_LEGEND 범례는 차트 상단에 렌더링됩니다.
NO_LEGEND 범례가 렌더링되지 않습니다.
LABELED_LEGEND 각 원형 차트 슬라이스에는 라벨이 있습니다.

풍선형 차트 사양

풍선형 차트

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)

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

풍선형 차트 범례 위치

차트의 범례를 배치할 위치

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

원통형 차트 사양

원통형 차트

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

object (CandlestickDomain)

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

data[]

object (CandlestickData)

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

원통 도메인

CandlestickChart의 도메인입니다.

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

object (ChartData)

CandlestickDomain의 데이터입니다.

reversed

boolean

도메인 값의 순서 (가로 축)를 반전하려면 참입니다.

원통형 데이터

원통형 차트 데이터이며, 각 열에는 연속된 낮은 값, 열린 값, 닫기 값, 높은 값이 포함됩니다.

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)

각 원통의 최고/최댓값에 대한 범위 데이터 (세로축)입니다. 원통 중앙선의 상단입니다.

원통형 계열

CandlestickData 시리즈입니다.

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

object (ChartData)

CandlestickSeries의 데이터입니다.

조직도 사양

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

예를 들어 앨리스를 CEO로, 밥을 사장 (앨리스에게 보고)과 캐시가 영업 부사장 (또한 앨리스에게 보고)을 포함하는 조직도를 설명하려면 labels에 'Alice', 'Bob', 'Cathy'를 포함하고 parentLabels에는 ''', 'Alice', 'Alice'를 포함하고 tooltips에는 'CEO', 'CEO', VP를 포함합니다.

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)

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

조직도 노드 크기

조직도 노드의 크기

열거형
ORG_CHART_LABEL_SIZE_UNSPECIFIED 기본값이며 사용하지 마세요.
SMALL 소규모 조직 차트 노드 크기
MEDIUM 중간 조직 차트 노드 크기
LARGE 대규모 조직 차트 노드 크기

히스토그램 차트 사양

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

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 사이여야 합니다.

히스토그램 시리즈

계열 색상과 데이터가 포함된 히스토그램 시리즈

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

object (Color)

각 버킷에서 이 시리즈를 나타내는 열의 색상입니다. 이 필드는 선택사항입니다. 지원 중단됨: barColorStyle를 사용합니다.

barColorStyle

object (ColorStyle)

각 버킷에서 이 시리즈를 나타내는 열의 색상입니다. 이 필드는 선택사항입니다. barColor도 설정하면 이 필드가 우선 적용됩니다.

data

object (ChartData)

이 히스토그램 시리즈의 데이터입니다.

히스토그램 차트 범례 위치

차트의 범례를 배치할 위치

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

폭포 차트 사양

폭포 차트

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

참을 사용하여 첫 번째 값을 전체 값으로 해석합니다.

hideConnectorLines

boolean

열 사이에 커넥터 선을 숨기려면 True를 선택하세요.

connectorLineStyle

object (LineStyle)

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

totalDataLabel

object (DataLabel)

도메인 축을 따라 각 값, stackedType는 STACKED여야 하며 totalDataLabel에 CUSTOM 또는 placement를 설정할 수 없습니다.

폭포형 차트 도메인

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

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

object (ChartData)

WaterfallChartDomain의 데이터

reversed

boolean

도메인 값의 순서 (가로 축)를 반전하려면 참입니다.

폭포형 차트 시리즈

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

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로 설정하면 이 시리즈의 해당 소계 열이 숨겨집니다.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

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

dataLabel

object (DataLabel)

이 시리즈의 데이터 라벨에 대한 정보입니다.

폭포식 차트 열 스타일

폭포형 차트 열의 스타일

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

string

열의 범례 라벨입니다.

color
(deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

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

폭포식 차트 맞춤 소계

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

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

integer

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

label

string

소계 열의 라벨입니다.

dataIsSubtotal

boolean

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

폭포식 차트 스택 유형

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

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

트리맵차트 사양

트리맵 차트.

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이면 도움말을 숨깁니다.

트리맵 차트 색상 스케일

트리맵 차트의 색상 척도

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도 설정하면 이 필드가 우선 적용됩니다.

스코어카드 차트 사양

스코어카드 차트 스코어카드 차트는 스프레드시트의 핵심성과지표(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로 설정된 경우에만 사용됩니다. 이 필드는 선택사항입니다.

키-값 형식

키 값의 형식 지정 옵션

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

object (TextFormat)

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

position

object (TextPosition)

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

기준 값 형식

기준 값의 형식 지정 옵션

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도 설정하면 이 필드가 우선 적용됩니다.

비교 유형

기준 값이 있는 키 값의 비교 유형입니다.

열거형
COMPARISON_TYPE_UNDEFINED 기본값이며 사용하지 마세요.
ABSOLUTE_DIFFERENCE 키와 기준 값의 절대차를 사용하세요.
PERCENTAGE_DIFFERENCE 키와 기준 값의 백분율 차이를 사용하세요.

차트 번호 형식 소스

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

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

차트 맞춤 숫자형식 옵션

차트 속성의 맞춤 숫자 형식 지정 옵션

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

string

차트 속성 앞에 추가할 커스텀 프리픽스입니다. 이 필드는 선택사항입니다.

suffix

string

차트 속성에 추가할 커스텀 서픽스입니다. 이 필드는 선택사항입니다.

숨겨진 차원의 차트

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

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

삽입된 개체 테두리

삽입된 객체의 테두리

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

object (Color)

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

colorStyle

object (ColorStyle)

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