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。特定のグラフの仕様で、値を 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)

スコアカード グラフの仕様。

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 スプレッドシートはデータに基づきヘッダーの行数を推測します。

BasicChartAxis.title は、ヘッダー値から推測される軸のタイトルをオーバーライドする場合があります)。

threeDimensional

boolean

true に設定すると、グラフが 3D になります。棒グラフと縦棒グラフに適用されます。

interpolateNulls

boolean

グラフの一部の値が不足している場合、グラフにギャップが表示されることがあります(折れ線グラフの線分が欠落するなど)。このギャップを埋めるには、これを true に設定します。折れ線グラフ、面グラフ、複合グラフに適用されます。

stackedType

enum (BasicChartStackedType)

垂直積み上げをサポートするグラフの積み上げ型です。面グラフ、棒グラフ、縦棒グラフ、複合グラフ、階段面グラフに適用されます。

lineSmoothing

boolean

すべての線をデフォルトで滑らかにレンダリングするか直線化するかを取得します。折れ線グラフに適用されます。

compareMode

enum (BasicChartCompareMode)

データとグラフの領域にカーソルを合わせると、ツールチップとデータがハイライト表示されます。

totalDataLabel

object (DataLabel)

ドメイン軸に沿って各値のすべての積み重ねられた値の合計を積み上げグラフで表示する、追加のデータラベルを表示するかどうかを指定します。このデータラベルは、chartTypeAREABARCOLUMNCOMBOSTEPPED_AREA のいずれかであり、stackedTypeSTACKED または PERCENT_STACKED の場合にのみ設定できます。また、COMBO の場合、これは、積み重ね可能な系列 type が 1 種類しかないか、1 つの種類で他の系列よりも多い系列があり、他の系列が 1 つしかない場合にのみサポートされます。たとえば、グラフに 2 つの積み上げ棒グラフと 1 つの面グラフ系が含まれる場合、データラベルの合計がサポートされます。3 つの棒の系列と 2 つの領域の系列がある場合、データラベルの合計は許可されません。totalDataLabel には CUSTOMplacement のどちらも設定できません。

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

グラフの軸です。1 つのグラフに複数の軸が存在するとは限りません。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)

この軸のビュー ウィンドウ オプション。

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 このグラフのタイプのスプレッドシート エディタで使用されるデフォルトのビュー ウィンドウ モード。ほとんどの場合、デフォルト モードに設定すると 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。含まれるデータのタイプ。1 つの値のみを設定する必要があります。 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.
}
フィールド
共用体フィールド ruleChartData に適用するルール。 rule は次のいずれかになります。
dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule

histogramRule

object (ChartHistogramRule)

ChartHistogramRule

ChartDateTimeRule

ソースデータ列の日時値を、選択した日付値または時刻値に基づいてバケットにまとめることができます。

JSON 表現
{
  "type": enum (ChartDateTimeRuleType)
}
フィールド
type

enum (ChartDateTimeRuleType)

適用する日時グループのタイプ。

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 月の第 1 四半期)。
YEAR 日付を年別にグループ化します(例: 2008)。
YEAR_MONTH 日付を年別や月別にグループ化する(2008 年~ 11 月など)。月はスプレッドシートのロケールに基づいて翻訳されます。
YEAR_QUARTER 年と四半期ごとの日付をグループ化します(例: 2008 Q4)。
YEAR_MONTH_DAY 年、月、日ごとに日付をグループ化します(例: 2008-11-22)。

ChartHistogramRule

ソースデータ列の数値を定数サイズのバケットに整理できます。

JSON 表現
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
フィールド
minValue

number

アイテムをバケットに配置する最小値。最小値より小さい値は、1 つのバケットにグループ化されます。省略した場合は、商品アイテムの最小値によって決定されます。

maxValue

number

商品アイテムをバケットに配置する最大値。最大値を超えると、1 つのバケットにグループ化されます。省略した場合、最大アイテム値によって決まります。

intervalSize

number

作成されるバケットのサイズ。正の値を指定する必要があります。

ChartAggregateType

グラフ系列の集計の種類。

列挙型
CHART_AGGREGATE_TYPE_UNSPECIFIED デフォルト値。使用しないでください。
AVERAGE 平均集計関数。
COUNT 集計関数。
MAX 最大集計関数。
MEDIAN 集計関数の中央値。
MIN 最小集計関数。
SUM 集計関数。

BasicChartSeries

グラフ内の単一のデータ系列。たとえば、株価を時系列でグラフ化する場合、「Open Price」、「High Price」、「Low Price」、「Close Price」のシリーズが複数ある場合があります。

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)

このシリーズのタイプ。chartTypeCOMBO の場合にのみ有効です。種類によって、一連のビジュアル表示方法が変わります。サポートされているのは LINEAREACOLUMN のみです。

lineStyle

object (LineStyle)

この系列の線のスタイル。chartTypeAREALINE、または SCATTER の場合にのみ有効です。series chart typeAREA または LINE の場合、COMBO グラフもサポートされます。

dataLabel

object (DataLabel)

このシリーズのデータラベルに関する情報。

color
(deprecated)

object (Color)

このシリーズに関連付けられている要素(棒、線、点など)の色。空の場合は、デフォルトの色が使用されます。非推奨: colorStyle を使用してください。

colorStyle

object (ColorStyle)

このシリーズに関連付けられている要素(棒、線、点など)の色。空の場合は、デフォルトの色が使用されます。color も設定されている場合、このフィールドが優先されます。

pointStyle

object (PointStyle)

このシリーズに関連付けられたポイントのスタイル。chartTypeAREALINE、または SCATTER の場合にのみ有効です。series chart typeAREALINE、または 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)

カスタムラベルに使用するデータ。typeCUSTOM に設定されている場合にのみ使用します。このデータは、このデータラベルが適用される系列またはその他の要素と同じ長さである必要があります。また、系列が複数のソース範囲に分割されている場合、このソースデータはソースデータの次の列から取得する必要があります。たとえば、系列が 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

系列データポイントのゼロベースのインデックス。

color
(deprecated)

object (Color)

系列データポイントの色。空の場合、シリーズのデフォルトが使用されます。非推奨: colorStyle を使用してください。

colorStyle

object (ColorStyle)

系列データポイントの色。空の場合、シリーズのデフォルトが使用されます。color も設定されている場合、このフィールドが優先されます。

pointStyle

object (PointStyle)

系列データポイントのポイント スタイル。chartTypeAREALINE、または SCATTER の場合にのみ有効です。series chart typeAREALINE、または SCATTER の場合、COMBO グラフもサポートされます。空の場合、シリーズのデフォルトが使用されます。

BasicChartStackedType

グラフを積み上げると、範囲(縦軸)の値は横軸ではなく縦にレンダリングされます。たとえば、20 と 80 の 2 つの値は 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)

円グラフの 1 系列のみを含むデータです。

threeDimensional

boolean

円が 3 次元の場合は True。

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 は 1 つのみです。

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)

各キャンドルの最大値と最大値の範囲データ(縦軸)。キャンドルの中心線の最上部です。

キャンドルスティック シリーズ

CandlestickData のシリーズ。

JSON 表現
{
  "data": {
    object (ChartData)
  }
}
フィールド
data

object (ChartData)

CandleickSeries のデータ。

OrgChartSpec

組織図。組織のグラフには、labels 内の一意のラベルセットが必要です。また、必要に応じて parentLabelstooltips を含めることもできます。parentLabels には、各ノードに親ノードを識別するラベルが含まれます。 tooltips には、各ノードでオプションのツールチップが含まれます。

たとえば、Alice を CEO として、Bob を社長(Alice に報告)と Cathy を営業担当副社として説明する場合、labels には「Alice」、"Bob"、"Cathy"、"Alice"、"Alice"、"CEO"、"CEO"、Pc には「CEO」が含まれます。parentLabelstooltips

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)

ヒストグラムの系列は、バケット化する 1 つの系列または複数の系列のいずれかを指定します。複数の系列はそれぞれ同じ長さで、系列の名前の後にその系列をバケット化する値が続きます。

legendPosition

enum (HistogramChartLegendPosition)

グラフの凡例の位置。

showItemDividers

boolean

各列のアイテムの間に水平分割線を表示するかどうか。

bucketSize

number

デフォルトでは、バケットサイズ(1 つの列に積み重ねられた値の範囲)が自動的に選択されますが、ここでオーバーライドすることもできます。例: バケットサイズが 1.5 の場合、バケットは 0 ~ 1.5、1.5 ~ 3.0 などとなります。負の値にすることはできません。このフィールドは省略可能です。

outlierPercentile

number

外れ値パーセンタイルは、バケットサイズの計算に悪影響が及ばないようにするために使用されます。たとえば、外れ値パーセンタイルを 0.05 に設定すると、バケットの計算時に、値の上下 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)

このヒストグラム シリーズのデータ。

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

最初の値を合計として解釈します。

hideConnectorLines

boolean

列間のコネクタ行を非表示にする場合は true。

connectorLineStyle

object (LineStyle)

コネクタ線の線のスタイル。

totalDataLabel

object (DataLabel)

ドメイン軸に沿って各値のすべての積み重ねられた値の合計を積み上げグラフに表示する追加のデータラベルを表示するかどうかを指定します。stackedTypeSTACKED にする必要があります。totalDataLabelCUSTOMplacement を設定することはできません。

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 に設定すると、このシリーズの小計列が非表示になります。

customSubtotals[]

object (WaterfallChartCustomSubtotal)

このシリーズに表示されるカスタム小計列。小計が定義される順序は重要ではありません。小計は、データポイントごとに 1 つだけ定義できます。

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

系列内のデータポイントのゼロベースのインデックス。dataIsSubtotal が true の場合、このインデックスのデータポイントは小計です。それ以外の場合は、このインデックスを持つデータポイントの後に小計が表示されます。1 つの系列は任意のインデックスで複数の小計を作成できますが、小計はデータポイントのインデックスには影響しません。たとえば、系列が 3 つのデータポイントを持つ場合、系列に存在する小計の数やそれに関連付けられているデータポイントにかかわらず、インデックスは常に 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 になります。minValuemaxValue のカラー値を持つセルのグラデーションは、minValueColormaxValueColor のグラデーションで示されます(グラデーションの中点は 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)をスプレッドシートでハイライト表示するために使用されます。スコアカード グラフには、総売上、平均費用、売上上位の商品などが表示されます。1 つのデータ値を指定することも、データの範囲を指定して集計することもできます。時間の経過に伴う変化など、ベースライン値に対する割合や絶対的な差異をハイライト表示できます。

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)

スコアカードの Key-Value のデータです。

baselineValueData

object (ChartData)

スコアカードのベースライン値のデータ。このフィールドは省略可能です。

aggregateType

enum (ChartAggregateType)

スコアカード グラフのキーグラフとベースライン グラフデータの集計タイプ。このフィールドはデータソース グラフではサポートされていません。代わりに、データソース グラフには keyValueData または baselineValueDataChartData.aggregateType フィールドを使用します。このフィールドは省略可能です。

keyValueFormat

object (KeyValueFormat)

Key-Value のフォーマット オプション。

baselineValueFormat

object (BaselineValueFormat)

ベースライン値の形式オプション。このフィールドは、baselineValueData が指定されている場合にのみ必要です。

scaleFactor

number

スコアカードのキーとベースライン値を拡張する値。たとえば、10 という係数を使用して、グラフ内のすべての値を 10 で割ることができます。このフィールドは省略可能です。

numberFormatSource

enum (ChartNumberFormatSource)

スコアカード グラフで使用される数値形式のソース。このフィールドは省略可能です。

customFormatOptions

object (ChartCustomNumberFormatOptions)

スコアカード グラフの数値キー/ベースライン値のカスタム フォーマット オプション。このフィールドは、numberFormatSourceCUSTOM に設定されている場合にのみ使用されます。このフィールドは省略可能です。

KeyValueFormat

Key-Value のフォーマット オプション。

JSON 表現
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
フィールド
textFormat

object (TextFormat)

Key-Value のテキストの書式設定オプション。リンク フィールドはサポートされていません。

position

object (TextPosition)

Key-Value の水平方向のテキスト位置を指定します。このフィールドは省略可能です。指定しない場合は、デフォルトの配置が使用されます。

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)

Key-Value とベースライン値の比較タイプ。

textFormat

object (TextFormat)

ベースライン値のテキスト形式のオプション。リンク フィールドはサポートされていません。

position

object (TextPosition)

ベースライン値の水平方向のテキスト位置を指定します。このフィールドは省略可能です。指定しない場合は、デフォルトの配置が使用されます。

description

string

ベースライン値の後に追加される説明。このフィールドは省略可能です。

positiveColor
(deprecated)

object (Color)

使用される色。ベースライン値が Key-Value の正の変化を表す場合に使用されます。このフィールドは省略可能です。非推奨: positiveColorStyle を使用してください。

positiveColorStyle

object (ColorStyle)

使用される色。ベースライン値が Key-Value の正の変化を表す場合に使用されます。このフィールドは省略可能です。positiveColor も設定されている場合、このフィールドが優先されます。

negativeColor
(deprecated)

object (Color)

ベースラインの色が Key-Value の負の変化を表す場合に使用される色。このフィールドは省略可能です。非推奨: negativeColorStyle を使用してください。

negativeColorStyle

object (ColorStyle)

ベースラインの色が Key-Value の負の変化を表す場合に使用される色。このフィールドは省略可能です。negativeColor も設定されている場合、このフィールドが優先されます。

ComparisonType

Key-Value とベースライン値の比較タイプ。

列挙型
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 も設定されている場合、このフィールドが優先されます。