Charts

Biểu đồ đã nhúng

Một biểu đồ được nhúng trong một trang tính.

Biểu diễn dưới dạng JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
Các trường
chartId

integer

Mã của biểu đồ.

spec

object (ChartSpec)

Thông số kỹ thuật của biểu đồ.

position

object (EmbeddedObjectPosition)

Vị trí của biểu đồ.

border

object (EmbeddedObjectBorder)

Đường viền của biểu đồ.

Biểu đồ

Thông số kỹ thuật của biểu đồ.

Biểu diễn dưới dạng 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.
}
Các trường
title

string

Tiêu đề của biểu đồ.

altText

string

Văn bản thay thế mô tả biểu đồ. Phương thức này thường dùng để hỗ trợ tiếp cận.

titleTextFormat

object (TextFormat)

Định dạng văn bản tiêu đề. Không hỗ trợ gạch ngang, gạch chân và liên kết.

titleTextPosition

object (TextPosition)

Vị trí văn bản tiêu đề. Trường này là tùy chọn.

subtitle

string

Phụ đề của biểu đồ.

subtitleTextFormat

object (TextFormat)

Định dạng văn bản phụ đề. Không hỗ trợ gạch ngang, gạch chân và liên kết.

subtitleTextPosition

object (TextPosition)

Vị trí văn bản phụ đề. Trường này là tùy chọn.

fontName

string

Tên của phông chữ sẽ sử dụng theo mặc định cho tất cả văn bản trên biểu đồ (ví dụ: tiêu đề, nhãn trục, chú giải). Nếu phông chữ được chỉ định cho một phần cụ thể của biểu đồ, phông chữ đó sẽ ghi đè tên phông chữ này.

maximized

boolean

Đúng để làm cho một biểu đồ lấp đầy toàn bộ không gian có biểu đồ đó với khoảng đệm tối thiểu. Sai để sử dụng khoảng đệm mặc định. (Không áp dụng cho biểu đồ Địa lý và Tổ chức).

backgroundColor
(deprecated)

object (Color)

Màu nền của toàn bộ biểu đồ. Không áp dụng cho biểu đồ tổ chức. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Màu nền của toàn bộ biểu đồ. Không áp dụng cho biểu đồ tổ chức. Nếu bạn cũng đặt backgroundColor, trường này sẽ được ưu tiên.

dataSourceChartProperties

object (DataSourceChartProperties)

Nếu có, trường này sẽ chứa các thuộc tính cụ thể của biểu đồ nguồn dữ liệu.

filterSpecs[]

object (FilterSpec)

Các bộ lọc được áp dụng cho dữ liệu nguồn của biểu đồ. Chỉ được hỗ trợ cho biểu đồ nguồn dữ liệu.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp dữ liệu biểu đồ. Chỉ hỗ trợ một thông số sắp xếp. Chỉ được hỗ trợ cho biểu đồ nguồn dữ liệu.

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

Xác định cách biểu đồ sẽ sử dụng các hàng hoặc cột ẩn.

Trường nhóm chart. Thông số kỹ thuật biểu đồ cụ thể phải đặt chính xác một giá trị. chart chỉ có thể là một trong những loại sau đây:
basicChart

object (BasicChartSpec)

Bản đặc tả biểu đồ cơ bản có thể là một trong nhiều loại biểu đồ. Hãy xem BasicChartType để biết danh sách tất cả các biểu đồ mà nhóm này hỗ trợ.

pieChart

object (PieChartSpec)

Thông số kỹ thuật của biểu đồ hình tròn.

bubbleChart

object (BubbleChartSpec)

Thông số kỹ thuật của biểu đồ bong bóng.

candlestickChart

object (CandlestickChartSpec)

Thông số kỹ thuật cho biểu đồ hình nến.

orgChart

object (OrgChartSpec)

Thông số biểu đồ tổ chức.

histogramChart

object (HistogramChartSpec)

Thông số biểu đồ biểu đồ.

waterfallChart

object (WaterfallChartSpec)

Thông số kỹ thuật của biểu đồ thác nước.

treemapChart

object (TreemapChartSpec)

Thông số kỹ thuật của biểu đồ dạng cây.

scorecardChart

object (ScorecardChartSpec)

Thông số kỹ thuật của biểu đồ thẻ điểm.

Vị trí văn bản

Cài đặt vị trí cho văn bản.

Biểu diễn dưới dạng JSON 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
Các trường
horizontalAlignment

enum (HorizontalAlign)

Cài đặt căn chỉnh theo chiều ngang cho đoạn văn bản.

Thuộc tính DataSourceChart

Thuộc tính của biểu đồ nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Các trường
dataSourceId

string

Mã của nguồn dữ liệu liên kết với biểu đồ.

dataExecutionStatus

object (DataExecutionStatus)

Chỉ đầu ra. Trạng thái thực thi dữ liệu.

Thông số cơ bản của biểu đồ

Nội dung đặc tả cho biểu đồ cơ bản. Hãy xem BasicChartType để biết danh sách các biểu đồ mà tính năng này hỗ trợ.

Biểu diễn dưới dạng 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)
  }
}
Các trường
chartType

enum (BasicChartType)

Loại biểu đồ.

legendPosition

enum (BasicChartLegendPosition)

Vị trí của chú giải biểu đồ.

axis[]

object (BasicChartAxis)

Trục trên biểu đồ.

domains[]

object (BasicChartDomain)

Miền dữ liệu đang hiển thị biểu đồ. Chỉ một miền được hỗ trợ.

series[]

object (BasicChartSeries)

Dữ liệu mà biểu đồ này đang hiển thị.

headerCount

integer

Số hàng hoặc cột trong dữ liệu là "tiêu đề". Nếu bạn không đặt chính sách này, Google Trang tính sẽ đoán có bao nhiêu hàng là tiêu đề dựa trên dữ liệu.

(Lưu ý rằng BasicChartAxis.title có thể ghi đè tiêu đề trục được rút ra từ các giá trị tiêu đề.)

threeDimensional

boolean

True để tạo biểu đồ 3D. Áp dụng cho biểu đồ Thanh và Cột.

interpolateNulls

boolean

Nếu một số giá trị trong một chuỗi bị thiếu, thì các khoảng trống có thể xuất hiện trong biểu đồ (ví dụ: các phân đoạn của đường trong biểu đồ dạng đường sẽ bị thiếu). Để loại bỏ những khoảng trống này, hãy đặt giá trị này là true. Áp dụng cho biểu đồ dạng đường, vùng và kết hợp.

stackedType

enum (BasicChartStackedType)

Loại xếp chồng cho biểu đồ hỗ trợ xếp chồng theo chiều dọc. Áp dụng cho biểu đồ Vùng, Thanh, Cột, Kết hợp và Vùng theo bước.

lineSmoothing

boolean

Xem xem tất cả các dòng nên được hiển thị mượt mà hay thẳng theo mặc định. Áp dụng cho Biểu đồ đường.

compareMode

enum (BasicChartCompareMode)

Hành vi của chú giải công cụ và dữ liệu được làm nổi bật khi di chuột qua dữ liệu và vùng biểu đồ.

totalDataLabel

object (DataLabel)

Kiểm soát việc có hiển thị các nhãn dữ liệu bổ sung trên biểu đồ xếp chồng về tổng giá trị của tất cả giá trị xếp chồng ở mỗi giá trị dọc theo trục miền hay không. Bạn chỉ có thể đặt các nhãn dữ liệu này khi chartType là một trong AREA, BAR, COLUMN, COMBO hoặc STEPPED_AREA và stackedType là STACKED hoặc PERCENT_STACKED. Ngoài ra, đối với COMBO, phương thức này sẽ chỉ được hỗ trợ nếu chỉ có một loại chuỗi có thể xếp chồng type hoặc một loại có nhiều chuỗi hơn các loại còn lại và mỗi loại trong số đó không có nhiều loạt. Ví dụ: nếu một biểu đồ có hai chuỗi thanh xếp chồng và một chuỗi vùng, thì tổng nhãn dữ liệu sẽ được hỗ trợ. Nếu có ba chuỗi thanh và hai chuỗi vùng, thì tổng số nhãn dữ liệu không được phép. Không thể đặt CUSTOM và placement trên totalDataLabel.

Loại biểu đồ cơ bản

Cách hiển thị biểu đồ.

Enum
BASIC_CHART_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
BAR Biểu đồ thanh.
LINE Biểu đồ dạng đường.
AREA Biểu đồ vùng.
COLUMN Biểu đồ cột.
SCATTER Biểu đồ tán xạ.
COMBO Biểu đồ kết hợp.
STEPPED_AREA Biểu đồ vùng dạng bậc.

BasicChartLegendPosition

Vị trí chú giải của biểu đồ.

Enum
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED Giá trị mặc định, không sử dụng.
BOTTOM_LEGEND Chú giải được hiển thị ở cuối biểu đồ.
LEFT_LEGEND Chú giải được hiển thị ở bên trái của biểu đồ.
RIGHT_LEGEND Chú giải được hiển thị ở bên phải của biểu đồ.
TOP_LEGEND Chú giải được hiển thị ở đầu biểu đồ.
NO_LEGEND Không có chú giải nào được hiển thị.

Trục biểu đồ cơ bản

Trục của biểu đồ. Một biểu đồ không được có nhiều trục trên mỗi axis position.

Biểu diễn dưới dạng JSON 
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
Các trường
position

enum (BasicChartAxisPosition)

Vị trí của trục này.

title

string

Tiêu đề của trục này. Nếu được đặt, tuỳ chọn này sẽ ghi đè mọi tiêu đề được suy ra từ tiêu đề của dữ liệu.

format

object (TextFormat)

Định dạng của tiêu đề. Chỉ hợp lệ nếu trục không được liên kết với tên miền. Trường liên kết không được hỗ trợ.

titleTextPosition

object (TextPosition)

Vị trí văn bản tiêu đề trục.

viewWindowOptions

object (ChartAxisViewWindowOptions)

Các tùy chọn cửa sổ chế độ xem cho trục này.

Vị trí trục cơ bản

Vị trí của trục biểu đồ.

Enum
BASIC_CHART_AXIS_POSITION_UNSPECIFIED Giá trị mặc định, không sử dụng.
BOTTOM_AXIS Trục hiển thị ở cuối biểu đồ. Đối với hầu hết các biểu đồ, đây là trục chính chuẩn. Đối với biểu đồ thanh, đây là một trục nhỏ.
LEFT_AXIS Trục hiển thị ở bên trái của biểu đồ. Đối với hầu hết các biểu đồ, đây là một trục nhỏ. Đối với biểu đồ thanh, đây là trục chính tiêu chuẩn.
RIGHT_AXIS Trục hiển thị ở bên phải của biểu đồ. Đối với hầu hết các biểu đồ, đây là một trục nhỏ. Đối với biểu đồ thanh, đây là một trục chính bất thường.

Biểu đồ chế độ xem cửa sổ tùy chọn

Các tùy chọn xác định "cửa sổ xem" cho biểu đồ (chẳng hạn như các giá trị hiển thị trong trục).

Biểu diễn dưới dạng JSON 
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
Các trường
viewWindowMin

number

Giá trị số tối thiểu sẽ được hiển thị trong cửa sổ xem này. Nếu bạn không đặt chính sách này, hệ thống sẽ tự động xác định một giá trị tối thiểu phù hợp với dữ liệu.

viewWindowMax

number

Giá trị số tối đa được hiển thị trong cửa sổ xem này. Nếu bạn không đặt chính sách này, hệ thống sẽ tự động xác định một giá trị tối đa phù hợp với dữ liệu.

viewWindowMode

enum (ViewWindowMode)

Chế độ của cửa sổ chế độ xem.

Chế độ xem cửa sổ

Chế độ của cửa sổ chế độ xem. Nó xác định cách xử lý giá trị tối thiểu và tối đa của cửa sổ chế độ xem.

Enum
DEFAULT_VIEW_WINDOW_MODE Chế độ cửa sổ chế độ xem mặc định được sử dụng trong trình chỉnh sửa Trang tính cho loại biểu đồ này. Trong hầu hết trường hợp, nếu được đặt, chế độ mặc định sẽ tương đương với PRETTY.
VIEW_WINDOW_MODE_UNSUPPORTED Không được dùng. Biểu thị rằng API hiện không hỗ trợ chế độ đã đặt.
EXPLICIT Theo sau phút và tối đa chính xác nếu được chỉ định. Nếu bạn không chỉ định thì một giá trị sẽ trở lại giá trị PRETTY.
PRETTY Chọn mức tối thiểu và tối đa để làm cho biểu đồ dễ nhìn. Cả tối thiểu và tối đa đều bị bỏ qua trong chế độ này.

Miền biểu đồ cơ bản

Miền của biểu đồ. Ví dụ: nếu biểu đồ giá cổ phiếu theo thời gian, thì đây sẽ là ngày.

Biểu diễn dưới dạng JSON 
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
Các trường
domain

object (ChartData)

Dữ liệu của miền. Ví dụ: nếu biểu đồ giá cổ phiếu theo thời gian, thì đây là dữ liệu biểu thị ngày.

reversed

boolean

Đúng để đảo thứ tự của các giá trị miền (trục ngang).

Dữ liệu biểu đồ

Dữ liệu được bao gồm trong một miền hoặc chuỗi chủ đề.

Biểu diễn dưới dạng 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.
}
Các trường
groupRule

object (ChartGroupRule)

Quy tắc nhóm dữ liệu nếu ChartData hỗ trợ miền của biểu đồ nguồn dữ liệu. Chỉ được hỗ trợ cho biểu đồ nguồn dữ liệu.

aggregateType

enum (ChartAggregateType)

Loại tổng hợp cho chuỗi biểu đồ nguồn dữ liệu. Chỉ được hỗ trợ cho biểu đồ nguồn dữ liệu.

Trường nhóm type. Loại dữ liệu được bao gồm, phải đặt chính xác một giá trị. type chỉ có thể là một trong những loại sau đây:
sourceRange

object (ChartSourceRange)

Dải ô dữ liệu.

columnReference

object (DataSourceColumnReference)

Tham chiếu đến cột nguồn dữ liệu mà dữ liệu được đọc.

Dải ô biểu đồ

Dải ô nguồn của biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
Các trường
sources[]

object (GridRange)

Dải ô dữ liệu cho một chuỗi hoặc miền. Chính xác một thứ nguyên phải có độ dài là 1 và tất cả các nguồn trong danh sách phải có cùng thứ nguyên với độ dài 1. Miền (nếu có) và tất cả các chuỗi phải có cùng số dải nguồn. Nếu sử dụng nhiều dải ô nguồn, thì dải ô nguồn tại một khoảng lệch nhất định phải có thứ tự và liền kề nhau trên toàn bộ miền và chuỗi dữ liệu.

Ví dụ: đây là các cấu hình hợp lệ: 

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

Quy tắc nhóm biểu đồ

Một chế độ cài đặt không bắt buộc trên ChartData của miền của biểu đồ nguồn dữ liệu xác định các nhóm cho các giá trị trong miền thay vì chia nhỏ từng giá trị riêng lẻ.

Ví dụ: khi vẽ biểu đồ nguồn dữ liệu, bạn có thể chỉ định quy tắc biểu đồ trên miền (chỉ cần chứa giá trị số), nhóm giá trị của nó thành nhóm. Mọi giá trị của một chuỗi biểu đồ thuộc cùng một nhóm sẽ được tổng hợp dựa trên aggregateType.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm rule. Quy tắc áp dụng cho ChartData. rule chỉ có thể là một trong những loại sau đây:
dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule.

histogramRule

object (ChartHistogramRule)

ChartHistogramRule

Biểu đồ ngày

Cho phép bạn sắp xếp các giá trị ngày-giờ trong cột dữ liệu nguồn thành các nhóm dựa trên những phần được chọn của giá trị ngày hoặc giờ của chúng.

Biểu diễn dưới dạng JSON 
{
  "type": enum (ChartDateTimeRuleType)
}
Các trường
type

enum (ChartDateTimeRuleType)

Loại nhóm ngày giờ sẽ áp dụng.

Loại biểu đồ ngày giờ quy tắc

Các loại quy tắc nhóm ngày-giờ có sẵn.

Enum
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED Loại mặc định, không sử dụng.
SECOND Nhóm các ngày theo thứ tự từ 0 đến 59.
MINUTE Nhóm ngày theo phút, từ 0 đến 59.
HOUR Nhóm theo ngày bằng cách sử dụng hệ thống 24 giờ, từ 0 đến 23.
HOUR_MINUTE Nhóm ngày theo giờ và phút sử dụng hệ thống 24 giờ, ví dụ: 19:45.
HOUR_MINUTE_AMPM Nhóm ngày theo giờ và phút sử dụng hệ thống 12 giờ, ví dụ: 7:45 tối. Ký hiệu AM/PM được dịch dựa trên ngôn ngữ của bảng tính.
DAY_OF_WEEK Nhóm các ngày theo tuần, ví dụ: Chủ Nhật. Các ngày trong tuần sẽ được dịch dựa trên ngôn ngữ của bảng tính.
DAY_OF_YEAR Nhóm theo ngày trong năm, từ 1 đến 366. Lưu ý rằng các ngày sau ngày 29 tháng 2 rơi vào các nhóm khác nhau vào các năm nhuận so với các năm không nhuận.
DAY_OF_MONTH Nhóm ngày theo ngày trong tháng, từ 1 đến 31.
DAY_MONTH Nhóm theo ngày và tháng, ví dụ: 22-11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
MONTH Nhóm ngày theo tháng, ví dụ: tháng 11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
QUARTER Nhóm ngày theo quý, ví dụ: Q1 (đại diện cho tháng 1-tháng 3).
YEAR Nhóm ngày theo năm, ví dụ: 2008.
YEAR_MONTH Nhóm ngày theo năm và tháng, ví dụ: 2008-Tháng 11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
YEAR_QUARTER Nhóm ngày theo năm và quý, ví dụ như Q4 năm 2008.
YEAR_MONTH_DAY Nhóm ngày theo năm, tháng và ngày, ví dụ: 2008-11-22.

Biểu đồ quy mô

Cho phép bạn sắp xếp các giá trị số trong cột dữ liệu nguồn thành các nhóm có kích thước không đổi.

Biểu diễn dưới dạng JSON 
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
Các trường
minValue

number

Giá trị tối thiểu mà tại đó các mục được đặt vào bộ chứa. Các giá trị nhỏ hơn mức tối thiểu được nhóm vào một bộ chứa. Nếu bị bỏ qua, giá trị này được xác định theo giá trị mục tối thiểu.

maxValue

number

Giá trị tối đa mà các mục được đặt vào nhóm. Các giá trị lớn hơn giới hạn tối đa được nhóm vào một bộ chứa. Nếu bỏ qua thì giá trị này được xác định theo giá trị mục tối đa.

intervalSize

number

Kích thước của nhóm được tạo. Phải dương.

Loại tổng hợp biểu đồ

Loại tổng hợp cho chuỗi biểu đồ.

Enum
CHART_AGGREGATE_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
AVERAGE Hàm tổng hợp trung bình.
COUNT Đếm hàm tổng hợp.
MAX Hàm tổng hợp tối đa.
MEDIAN Hàm tổng hợp trung bình.
MIN Hàm tổng hợp tối thiểu.
SUM Tổng hợp hàm.

Dòng đồ thị cơ bản

Một chuỗi dữ liệu duy nhất trong một biểu đồ. Ví dụ: nếu lập biểu đồ giá cổ phiếu theo thời gian, có thể có nhiều chuỗi, một cho "Giá mở", "Giá cao", "Giá thấp" và "Giá đóng".

Biểu diễn dưới dạng 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)
    }
  ]
}
Các trường
series

object (ChartData)

Dữ liệu đang được trực quan hóa trong chuỗi biểu đồ này.

targetAxis

enum (BasicChartAxisPosition)

Trục nhỏ sẽ chỉ định phạm vi giá trị cho chuỗi này. Ví dụ: nếu lập biểu đồ cổ phiếu theo thời gian, chuỗi "Khối lượng" có thể muốn được ghim sang bên phải với giá đã ghim ở bên trái, vì quy mô khối lượng giao dịch khác với quy mô giá. Việc chỉ định một trục không phải là trục nhỏ hợp lệ cho type của biểu đồ là một lỗi.

type

enum (BasicChartType)

Loại của bộ sách này. Chỉ hợp lệ nếu chartType là COMBO. Các loại khác nhau sẽ thay đổi cách hiển thị chuỗi video. Chỉ hỗ trợ LINE, AREA và COLUMN.

lineStyle

object (LineStyle)

Kiểu đường kẻ của chuỗi này. Chỉ hợp lệ nếu chartType là AREA, LINE hoặc SCATTER. Biểu đồ COMBO cũng được hỗ trợ nếu series chart type là AREA hoặc LINE.

dataLabel

object (DataLabel)

Thông tin về các nhãn dữ liệu cho bộ sách này.

color
(deprecated)

object (Color)

Màu của các phần tử (chẳng hạn như thanh, đường và điểm) liên kết với chuỗi này. Nếu trống, hệ thống sẽ sử dụng màu mặc định. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu của các phần tử (chẳng hạn như thanh, đường và điểm) liên kết với chuỗi này. Nếu trống, hệ thống sẽ sử dụng màu mặc định. Nếu bạn cũng đặt color, trường này sẽ được ưu tiên.

pointStyle

object (PointStyle)

Kiểu dành cho điểm liên kết với bộ sách này. Chỉ hợp lệ nếu chartType là AREA, LINE hoặc SCATTER. Biểu đồ COMBO cũng được hỗ trợ nếu series chart type là AREA, LINE hoặc SCATTER. Nếu trống, kiểu điểm mặc định được sử dụng.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

Cài đặt ghi đè kiểu cho các điểm dữ liệu chuỗi.

Kiểu đường kẻ

Thuộc tính mô tả kiểu của một đường.

Biểu diễn dưới dạng JSON 
{
  "width": integer,
  "type": enum (LineDashType)
}
Các trường
width

integer

Độ dày của đường, tính bằng px.

type

enum (LineDashType)

Loại dấu gạch ngang.

Loại đường kẻ

Kiểu gạch ngang của một đường.

Enum
LINE_DASH_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
INVISIBLE Không có loại dấu gạch ngang, tương đương với đường không hiển thị.
CUSTOM Dấu gạch ngang tùy chỉnh cho một đường. Việc sửa đổi kiểu dấu gạch ngang tùy chỉnh chính xác hiện không được hỗ trợ.
SOLID Một đường liền nét.
DOTTED Đường chấm.
MEDIUM_DASHED Một đường đứt nét trong đó các dấu gạch ngang có độ dài "trung bình".
MEDIUM_DASHED_DOTTED Đường kẻ xen kẽ giữa dấu gạch ngang "trung bình" và dấu chấm.
LONG_DASHED Một đường đứt nét trong đó dấu gạch ngang có độ dài "dài".
LONG_DASHED_DOTTED Đường kẻ xen kẽ giữa dấu gạch ngang "dài" và dấu chấm.

Nhãn dữ liệu

Cài đặt cho một bộ nhãn dữ liệu. Nhãn dữ liệu là các chú thích xuất hiện bên cạnh một tập dữ liệu, chẳng hạn như các điểm trên biểu đồ dạng đường, đồng thời cung cấp thêm thông tin về dữ liệu mà bạn đại diện, chẳng hạn như văn bản trình bày giá trị sau điểm đó trên biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
Các trường
type

enum (DataLabelType)

Loại nhãn dữ liệu.

textFormat

object (TextFormat)

Định dạng văn bản được sử dụng cho nhãn dữ liệu. Trường liên kết không được hỗ trợ.

placement

enum (DataLabelPlacement)

Vị trí của nhãn dữ liệu so với dữ liệu đã gắn nhãn.

customLabelData

object (ChartData)

Dữ liệu để sử dụng cho nhãn tùy chỉnh. Chỉ sử dụng nếu bạn đặt type thành CUSTOM. Dữ liệu này phải có cùng độ dài với chuỗi hoặc phần tử khác áp dụng nhãn dữ liệu này. Ngoài ra, nếu chuỗi được chia thành nhiều dải nguồn, thì dữ liệu nguồn này phải đến từ cột tiếp theo trong dữ liệu nguồn. Ví dụ: nếu chuỗi là B2: B4, E6: E8 thì dữ liệu này phải đến từ C2: C4, F6: F8.

Loại nhãn dữ liệu

Loại nhãn dữ liệu.

Enum
DATA_LABEL_TYPE_UNSPECIFIED Loại nhãn dữ liệu không được chỉ định và sẽ được hiểu tùy thuộc vào ngữ cảnh của nhãn dữ liệu trong biểu đồ.
NONE Nhãn dữ liệu không được hiển thị.
DATA Nhãn dữ liệu được hiển thị bằng cách sử dụng các giá trị từ dữ liệu chuỗi.
CUSTOM Nhãn dữ liệu được hiển thị bằng cách sử dụng các giá trị từ một nguồn dữ liệu tùy chỉnh do customLabelData chỉ định.

Nhãn vị trí dữ liệu

Vị trí của nhãn dữ liệu so với dữ liệu đã gắn nhãn.

Enum
DATA_LABEL_PLACEMENT_UNSPECIFIED Vị trí được xác định tự động bởi trình kết xuất.
CENTER Căn giữa bên trong một thanh hoặc cột, theo cả chiều ngang và chiều dọc.
LEFT Ở bên trái của điểm dữ liệu.
RIGHT Ở bên phải của điểm dữ liệu.
ABOVE Trên một điểm dữ liệu.
BELOW Bên dưới điểm dữ liệu.
INSIDE_END Bên trong thanh hoặc cột ở cuối (trên cùng nếu là giá trị dương, dưới cùng nếu là giá trị âm).
INSIDE_BASE Bên trong một thanh hoặc cột ở chân đế.
OUTSIDE_END Bên ngoài một thanh hoặc cột ở cuối.

Kiểu dáng điểm

Kiểu của một điểm trên biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "size": number,
  "shape": enum (PointShape)
}
Các trường
size

number

Kích thước điểm. Nếu trống, kích thước mặc định sẽ được sử dụng.

shape

enum (PointShape)

Hình dạng điểm. Nếu trống hoặc không được chỉ định, hình dạng mặc định được sử dụng.

Hình dạng điểm

Hình dạng của một điểm.

Enum
POINT_SHAPE_UNSPECIFIED Giá trị mặc định.
CIRCLE Hình tròn.
DIAMOND Hình kim cương.
HEXAGON Hình lục giác.
PENTAGON Một hình ngũ giác.
SQUARE Hình vuông.
STAR Hình ngôi sao.
TRIANGLE Hình tam giác.
X_MARK Hình dạng dấu x.

BasicSeriesDataPointStyleOverride

Chế độ cài đặt ghi đè kiểu cho một điểm dữ liệu trong một chuỗi.

Biểu diễn dưới dạng JSON 
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
Các trường
index

integer

Chỉ mục bắt đầu từ 0 của điểm dữ liệu chuỗi.

color
(deprecated)

object (Color)

Màu của điểm dữ liệu chuỗi. Nếu trống, chuỗi mặc định sẽ được sử dụng. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu của điểm dữ liệu chuỗi. Nếu trống, chuỗi mặc định sẽ được sử dụng. Nếu bạn cũng đặt color, trường này sẽ được ưu tiên.

pointStyle

object (PointStyle)

Kiểu điểm của điểm dữ liệu chuỗi. Chỉ hợp lệ nếu chartType là AREA, LINE hoặc SCATTER. Biểu đồ COMBO cũng được hỗ trợ nếu series chart type là AREA, LINE hoặc SCATTER. Nếu trống, chuỗi mặc định sẽ được sử dụng.

Kiểu ngăn xếp cơ bản

Khi biểu đồ xếp chồng, các giá trị phạm vi (trục tung) sẽ được hiển thị chồng lên nhau thay vì từ trục hoành. Ví dụ: hai giá trị 20 và 80 sẽ được vẽ từ 0, với 80 là 80 đơn vị cách trục hoành. Nếu chúng được xếp chồng lên nhau, 80 sẽ được hiển thị từ 20, đặt nó cách trục ngang 100 đơn vị.

Enum
BASIC_CHART_STACKED_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
NOT_STACKED Chuỗi không được xếp chồng.
STACKED Giá trị chuỗi được xếp chồng lên nhau, mỗi giá trị được hiển thị theo chiều dọc bắt đầu từ đầu giá trị bên dưới.
PERCENT_STACKED Các ngăn xếp dọc được kéo dài để hiển thị ở đầu biểu đồ, trong đó các giá trị được sắp xếp theo tỷ lệ phần trăm lẫn nhau.

Chế độ so sánh biểu đồ cơ bản

Loại chế độ so sánh mô tả hành vi của chú giải công cụ và đánh dấu dữ liệu khi di chuột qua dữ liệu và vùng biểu đồ.

Enum
BASIC_CHART_COMPARE_MODE_UNSPECIFIED Giá trị mặc định, không sử dụng.
DATUM Chỉ phần tử dữ liệu được đặt tiêu điểm được làm nổi bật và hiển thị trong chú giải công cụ.
CATEGORY Tất cả các yếu tố dữ liệu cùng danh mục (ví dụ: giá trị tên miền) được đánh dấu và hiển thị trong chú giải công cụ.

PieChartSpec

Biểu đồ hình tròn.

Biểu diễn dưới dạng JSON 
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
Các trường
legendPosition

enum (PieChartLegendPosition)

Vị trí chú giải của biểu đồ hình tròn sẽ được vẽ.

domain

object (ChartData)

Dữ liệu bao gồm miền của biểu đồ hình tròn.

series

object (ChartData)

Dữ liệu trong chuỗi một và duy nhất của đồ thị hình tròn.

threeDimensional

boolean

Đúng nếu biểu đồ hình tròn có 3 chiều.

pieHole

number

Kích thước của lỗ trong biểu đồ hình tròn.

PieChartLegendPosition

Vị trí chú giải của biểu đồ.

Enum
PIE_CHART_LEGEND_POSITION_UNSPECIFIED Giá trị mặc định, không sử dụng.
BOTTOM_LEGEND Chú giải được hiển thị ở cuối biểu đồ.
LEFT_LEGEND Chú giải được hiển thị ở bên trái của biểu đồ.
RIGHT_LEGEND Chú giải được hiển thị ở bên phải của biểu đồ.
TOP_LEGEND Chú giải được hiển thị ở đầu biểu đồ.
NO_LEGEND Không có chú giải nào được hiển thị.
LABELED_LEGEND Mỗi lát bánh có một nhãn đi kèm.

BubbleChartSpec

Biểu đồ bong bóng.

Biểu diễn dưới dạng 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)
  }
}
Các trường
legendPosition

enum (BubbleChartLegendPosition)

Vị trí chú giải của biểu đồ.

bubbleLabels

object (ChartData)

Dữ liệu chứa các nhãn bong bóng. Những giá trị này không cần phải là duy nhất.

domain

object (ChartData)

Dữ liệu chứa bong bóng trò chuyện x-value. Các giá trị này định vị bong bóng trong biểu đồ theo chiều ngang.

series

object (ChartData)

Dữ liệu chứa giá trị bong bóng y. Các giá trị này xác định vị trí các bong bóng trong biểu đồ theo chiều dọc.

groupIds

object (ChartData)

Dữ liệu chứa mã nhóm bong bóng. Tất cả bong bóng trò chuyện có cùng mã nhóm được vẽ cùng một màu. Nếu bạn chỉ định bubbleSizes thì trường này cũng phải được chỉ định nhưng có thể chứa giá trị trống. Trường này là tùy chọn.

bubbleSizes

object (ChartData)

Dữ liệu chứa kích thước bong bóng. Kích thước cửa sổ chú giải được dùng để vẽ các bong bóng ở các kích thước khác nhau liên quan đến nhau. Nếu được chỉ định, bạn cũng phải chỉ định groupIds. Trường này là tùy chọn.

bubbleOpacity

number

Độ mờ của bong bóng từ 0 đến 1,0. 0 hoàn toàn trong suốt và 1 hoàn toàn mờ đục.

bubbleBorderColor
(deprecated)

object (Color)

Màu đường viền bong bóng. Không dùng nữa: Sử dụng bubbleBorderColorStyle.

bubbleBorderColorStyle

object (ColorStyle)

Màu đường viền bong bóng. Nếu bạn cũng đặt bubbleBorderColor, trường này sẽ được ưu tiên.

bubbleMaxRadiusSize

integer

Kích thước bán kính tối đa của bong bóng, tính bằng pixel. Nếu được chỉ định, thì trường này phải là một giá trị dương.

bubbleMinRadiusSize

integer

Kích thước bán kính tối thiểu của bong bóng, tính bằng pixel. Nếu cụ thể, trường phải là giá trị dương.

bubbleTextStyle

object (TextFormat)

Định dạng của văn bản bên trong bong bóng. Không hỗ trợ gạch ngang, gạch chân và liên kết.

BubbleChartLegendPosition

Vị trí chú giải của biểu đồ.

Enum
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED Giá trị mặc định, không sử dụng.
BOTTOM_LEGEND Chú giải được hiển thị ở cuối biểu đồ.
LEFT_LEGEND Chú giải được hiển thị ở bên trái của biểu đồ.
RIGHT_LEGEND Chú giải được hiển thị ở bên phải của biểu đồ.
TOP_LEGEND Chú giải được hiển thị ở đầu biểu đồ.
NO_LEGEND Không có chú giải nào được hiển thị.
INSIDE_LEGEND Chú giải được hiển thị bên trong vùng biểu đồ.

CandlestickChartSpec

Biểu đồ hình nến.

Biểu diễn dưới dạng JSON 
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
Các trường
domain

object (CandlestickDomain)

Dữ liệu miền (trục ngang) cho biểu đồ hình nến. Dữ liệu chuỗi sẽ được coi là nhãn rời rạc, các dữ liệu khác sẽ được coi là giá trị liên tục.

data[]

object (CandlestickData)

Dữ liệu biểu đồ hình nến. Chỉ hỗ trợ CandlestickData.

Miền nến

Miền của Biểu đồ hình nến.

Biểu diễn dưới dạng JSON 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Các trường
data

object (ChartData)

Dữ liệu của CandlestickDomain.

reversed

boolean

Đúng để đảo thứ tự của các giá trị miền (trục ngang).

Dữ liệu hình nến

Dữ liệu biểu đồ hình nến, mỗi giá trị chứa giá trị thấp, mở, đóng và cao cho một chuỗi.

Biểu diễn dưới dạng JSON 
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
Các trường
lowSeries

object (CandlestickSeries)

Dữ liệu dải ô (trục dọc) cho giá trị thấp/tối thiểu cho mỗi nến. Đây là phần dưới cùng của đường tâm của hình nến.

openSeries

object (CandlestickSeries)

Dữ liệu dải (trục dọc) cho giá trị mở/mở cho mỗi nến. Đây là phần đáy của thân nến. Nếu giá trị thấp hơn giá trị đóng, hình nến sẽ được tô màu. Nếu không, nến sẽ rỗng.

closeSeries

object (CandlestickSeries)

Dữ liệu dải ô (trục dọc) cho giá trị đóng/cuối cùng của từng nến. Đây là phần trên cùng của thân nến. Nếu lớn hơn giá trị mở, nến sẽ được tô. Nếu không, nến sẽ rỗng.

highSeries

object (CandlestickSeries)

Dữ liệu dải (trục dọc) cho giá trị cao/tối đa cho mỗi nến. Đây là đỉnh của đường tâm của hình nến.

Bộ nến

Chuỗi CandlestickData.

Biểu diễn dưới dạng JSON 
{
  "data": {
    object (ChartData)
  }
}
Các trường
data

object (ChartData)

Dữ liệu về CandlestickSeries.

Biểu đồ tổ chức

Biểu đồ tổ chức. Biểu đồ tổ chức yêu cầu một bộ nhãn duy nhất trong labels và có thể bao gồm parentLabels và tooltips (không bắt buộc). Đối với mỗi nút, parentLabels chứa nhãn nhận dạng nút mẹ. Đối với mỗi nút, tooltips chứa chú giải công cụ không bắt buộc.

Ví dụ: để mô tả OrgChart trong đó Alice là Giám đốc điều hành, Bob là Chủ tịch (báo cáo cho Alice) và Cathy là Phó chủ tịch phụ trách bán hàng (cũng báo cáo cho Alice), labels có chứa "Alice", "Bob", "Cathy", "parentLabels" chứa "", "Alice", "Alice" và tooltips chứa "CEO", "Phair", "PP Sales".

Biểu diễn dưới dạng 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)
  }
}
Các trường
nodeSize

enum (OrgChartNodeSize)

Kích thước của các nút biểu đồ tổ chức.

nodeColor
(deprecated)

object (Color)

Màu của các nút biểu đồ tổ chức. Không dùng nữa: Sử dụng nodeColorStyle.

nodeColorStyle

object (ColorStyle)

Màu của các nút biểu đồ tổ chức. Nếu bạn cũng đặt nodeColor, trường này sẽ được ưu tiên.

selectedNodeColor
(deprecated)

object (Color)

Màu của các nút biểu đồ tổ chức đã chọn. Không dùng nữa: Sử dụng selectedNodeColorStyle.

selectedNodeColorStyle

object (ColorStyle)

Màu của các nút biểu đồ tổ chức đã chọn. Nếu bạn cũng đặt selectedNodeColor, trường này sẽ được ưu tiên.

labels

object (ChartData)

Dữ liệu chứa nhãn của tất cả các nút trong biểu đồ. Nhãn phải là duy nhất.

parentLabels

object (ChartData)

Dữ liệu chứa nhãn của thành phần mẹ cho nút tương ứng. Giá trị trống cho biết nút không có nút mẹ và là nút cấp cao nhất. Trường này là tùy chọn.

tooltips

object (ChartData)

Dữ liệu chứa chú giải công cụ cho nút tương ứng. Giá trị trống sẽ không hiển thị chú giải công cụ cho nút. Trường này là tùy chọn.

OrgChartNodeSize

Kích thước của các nút biểu đồ tổ chức.

Enum
ORG_CHART_LABEL_SIZE_UNSPECIFIED Giá trị mặc định, không sử dụng.
SMALL Kích thước nút của biểu đồ tổ chức nhỏ.
MEDIUM Kích thước nút của biểu đồ tổ chức trung bình.
LARGE Kích thước nút của biểu đồ tổ chức lớn.

Biểu đồ tần suất

Biểu đồ tần suất. Biểu đồ biểu đồ nhóm các mục dữ liệu vào thùng rác, hiển thị từng thùng dưới dạng cột gồm các mục xếp chồng. Biểu đồ được sử dụng để hiển thị phân phối của tập dữ liệu. Mỗi cột của các mục thể hiện một dải ô chứa các mục đó. Bạn có thể chọn số lượng thùng tự động hoặc chỉ định rõ ràng.

Biểu diễn dưới dạng JSON 
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
Các trường
series[]

object (HistogramSeries)

Chuỗi của biểu đồ có thể là một chuỗi giá trị cần được nhóm hoặc nhiều chuỗi, mỗi chuỗi có cùng độ dài, chứa tên của chuỗi, theo sau là các giá trị được nhóm cho chuỗi đó.

legendPosition

enum (HistogramChartLegendPosition)

Vị trí của chú giải biểu đồ.

showItemDividers

boolean

Liệu các dòng phân cách ngang có nên hiển thị giữa các mục trong mỗi cột hay không.

bucketSize

number

Theo mặc định, kích thước nhóm (phạm vi các giá trị xếp chồng trong một cột) được chọn tự động nhưng có thể bị ghi đè tại đây. Ví dụ: Kích thước nhóm 1,5 dẫn đến các nhóm từ 0 - 1,5, 1,5 - 3,0, v.v. Không thể âm. Trường này là tùy chọn.

outlierPercentile

number

Phân vị ngoại lệ được dùng để đảm bảo rằng các giá trị ngoại lệ không ảnh hưởng xấu đến việc tính toán kích thước nhóm. Ví dụ: đặt phân vị ngoại lệ là 0, 05 cho biết rằng 5% giá trị trên cùng và dưới cùng khi tính toán nhóm. Các giá trị vẫn được đưa vào biểu đồ. Chúng sẽ được thêm vào nhóm đầu tiên hoặc nhóm cuối cùng thay vì nhóm của riêng chúng. Phải từ 0,0 đến 0,5.

Chuỗi biểu đồ

Một chuỗi biểu đồ chứa dữ liệu và màu của chuỗi.

Biểu diễn dưới dạng JSON 
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
Các trường
barColor
(deprecated)

object (Color)

Màu của cột thể hiện chuỗi này trong mỗi nhóm. Trường này là tùy chọn. Không dùng nữa: Sử dụng barColorStyle.

barColorStyle

object (ColorStyle)

Màu của cột thể hiện chuỗi này trong mỗi nhóm. Trường này là tùy chọn. Nếu bạn cũng đặt barColor, trường này sẽ được ưu tiên.

data

object (ChartData)

Dữ liệu cho chuỗi biểu đồ này.

Biểu đồ chú giải

Vị trí chú giải của biểu đồ.

Enum
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED Giá trị mặc định, không sử dụng.
BOTTOM_LEGEND Chú giải được hiển thị ở cuối biểu đồ.
LEFT_LEGEND Chú giải được hiển thị ở bên trái của biểu đồ.
RIGHT_LEGEND Chú giải được hiển thị ở bên phải của biểu đồ.
TOP_LEGEND Chú giải được hiển thị ở đầu biểu đồ.
NO_LEGEND Không có chú giải nào được hiển thị.
INSIDE_LEGEND Chú giải được hiển thị bên trong vùng biểu đồ.

Biểu đồ thác nước

Biểu đồ thác nước.

Biểu diễn dưới dạng JSON 
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
Các trường
domain

object (WaterfallChartDomain)

Dữ liệu miền (trục ngang) cho biểu đồ thác nước.

series[]

object (WaterfallChartSeries)

Dữ liệu mà biểu đồ thác nước này đang hiển thị.

stackedType

enum (WaterfallChartStackedType)

Loại xếp chồng.

firstValueIsTotal

boolean

Đúng để hiểu tổng giá trị đầu tiên.

hideConnectorLines

boolean

True để ẩn các dòng trình kết nối giữa các cột.

connectorLineStyle

object (LineStyle)

Kiểu đường cho các đường nối.

totalDataLabel

object (DataLabel)

Kiểm soát việc có hiển thị các nhãn dữ liệu bổ sung trên biểu đồ xếp chồng về tổng giá trị của tất cả giá trị xếp chồng ở mỗi giá trị dọc theo trục miền hay không. stackedType phải là STACKED và không thể đặt CUSTOM cũng như placement trên totalDataLabel.

Miền biểu đồ thác nước

Miền của biểu đồ thác nước.

Biểu diễn dưới dạng JSON 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Các trường
data

object (ChartData)

Dữ liệu của FallsChartDomain.

reversed

boolean

Đúng để đảo thứ tự của các giá trị miền (trục ngang).

Chuỗi biểu đồ thác nước

Một chuỗi dữ liệu duy nhất của biểu đồ thác nước.

Biểu diễn dưới dạng JSON 
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
Các trường
data

object (ChartData)

Dữ liệu đang được trực quan hóa trong chuỗi chủ đề này.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

Kiểu cho tất cả các cột trong chuỗi này với các giá trị dương.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

Kiểu cho tất cả các cột trong chuỗi này có giá trị âm.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

Kiểu cho tất cả các cột tổng phụ trong chuỗi này.

hideTrailingSubtotal

boolean

True để ẩn cột tổng con khỏi cuối chuỗi. Theo mặc định, cột tổng phụ sẽ xuất hiện ở cuối mỗi chuỗi. Việc đặt trường này thành true sẽ ẩn cột tổng số phụ cho chuỗi chủ đề này.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

Các cột tổng phụ tùy chỉnh xuất hiện trong chuỗi này. Thứ tự mà các tổng phụ được xác định là không quan trọng. Bạn chỉ có thể xác định một tổng phụ cho mỗi điểm dữ liệu.

dataLabel

object (DataLabel)

Thông tin về các nhãn dữ liệu cho bộ sách này.

Biểu đồ thác nướcKiểu cột

Kiểu cho cột biểu đồ thác nước.

Biểu diễn dưới dạng JSON 
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Các trường
label

string

Nhãn chú giải của cột.

color
(deprecated)

object (Color)

Màu của cột. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu của cột. Nếu bạn cũng đặt color, trường này sẽ được ưu tiên.

Biểu đồ dạng thác nước

Một cột tổng con tuỳ chỉnh cho một chuỗi biểu đồ thác nước.

Biểu diễn dưới dạng JSON 
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
Các trường
subtotalIndex

integer

Chỉ mục bắt đầu từ 0 của một điểm dữ liệu trong chuỗi. Nếu dataIsSubtotal là đúng, điểm dữ liệu tại chỉ mục này sẽ là tổng phụ. Nếu không, tổng giá trị phụ sẽ xuất hiện sau điểm dữ liệu với chỉ mục này. Một chuỗi có thể có nhiều tổng phụ tại các chỉ mục tùy ý nhưng tổng phụ không ảnh hưởng đến chỉ mục của các điểm dữ liệu. Ví dụ: nếu một chuỗi có ba điểm dữ liệu, chỉ mục của chúng sẽ luôn là 0, 1 và 2, bất kể có bao nhiêu tổng phụ trên chuỗi hoặc chúng liên kết với điểm dữ liệu nào.

label

string

Nhãn cho cột tổng số phụ.

dataIsSubtotal

boolean

Đúng nếu điểm dữ liệu tại subtotalIndex là tổng phụ. Nếu sai, tổng phụ sẽ được tính toán và xuất hiện sau điểm dữ liệu.

Biểu đồ thác nướcLoại ngăn xếp

Các tùy chọn kiểu ngăn xếp cho biểu đồ thác nước.

Enum
WATERFALL_STACKED_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
STACKED Giá trị tương ứng với cùng một miền (trục ngang) sẽ được xếp chồng theo chiều dọc.
SEQUENTIAL Chuỗi sẽ trải đều theo trục hoành.

Biểu đồ dạng cây

Biểu đồ dạng bản đồ.

Biểu diễn dưới dạng 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
}
Các trường
labels

object (ChartData)

Dữ liệu chứa các nhãn ô bản đồ cây.

parentLabels

object (ChartData)

Dữ liệu chứa nhãn gốc của các ô trong bản đồ cây.

sizeData

object (ChartData)

Dữ liệu xác định kích thước của mỗi ô dữ liệu biểu đồ dạng cây. Dữ liệu này phải là số. Các ô tương ứng với dữ liệu không phải là số hoặc bị thiếu dữ liệu sẽ không được hiển thị. Nếu bạn không xác định colorData, thì dữ liệu này cũng sẽ được dùng để xác định màu nền của ô dữ liệu.

colorData

object (ChartData)

Dữ liệu xác định màu nền của mỗi ô dữ liệu biểu đồ dạng cây. Trường này là tùy chọn. Nếu không được chỉ định, sizeData sẽ được dùng để xác định màu nền. Nếu được chỉ định, dữ liệu dự kiến là số. colorScale sẽ xác định cách các giá trị trong bản đồ dữ liệu này liên kết với màu nền của ô dữ liệu.

textFormat

object (TextFormat)

Định dạng văn bản cho tất cả các nhãn trên biểu đồ. Trường liên kết không được hỗ trợ.

levels

integer

Số lượng cấp dữ liệu cần hiển thị trên biểu đồ dạng cây. Các cấp độ này có tính tương tác và được hiển thị cùng với nhãn. Giá trị mặc định là 2 nếu không được chỉ định.

hintedLevels

integer

Số lượng cấp dữ liệu bổ sung ngoài các cấp được gắn nhãn sẽ được hiển thị trên biểu đồ dạng cây. Các cấp độ này không có tính tương tác và hiển thị mà không có nhãn. Giá trị mặc định là 0 nếu không được chỉ định.

minValue

number

Giá trị dữ liệu tối thiểu có thể có. Các ô có giá trị nhỏ hơn giá trị này sẽ có cùng màu với các ô có giá trị này. Nếu không được chỉ định, giá trị mặc định sẽ là giá trị tối thiểu thực tế từ colorData hoặc giá trị tối thiểu từ sizeData nếu colorData không được chỉ định.

maxValue

number

Giá trị dữ liệu có thể có tối đa. Các ô có giá trị lớn hơn giá trị này sẽ có cùng màu với các ô có giá trị này. Nếu không được chỉ định, giá trị mặc định sẽ là giá trị tối đa thực tế từ colorData hoặc giá trị tối đa từ sizeData nếu colorData không được chỉ định.

headerColor
(deprecated)

object (Color)

Màu nền của ô tiêu đề. Không dùng nữa: Sử dụng headerColorStyle.

headerColorStyle

object (ColorStyle)

Màu nền của ô tiêu đề. Nếu bạn cũng đặt headerColor, trường này sẽ được ưu tiên.

colorScale

object (TreemapChartColorScale)

Thang màu cho ô dữ liệu trong biểu đồ dạng cây. Các ô dữ liệu được gán màu dựa trên giá trị màu của chúng. Các giá trị màu này có nguồn gốc từ colorData hoặc từ sizeData nếu không chỉ định colorData. Các ô có giá trị màu nhỏ hơn hoặc bằng minValue sẽ có màu nền là minValueColor. Các ô có giá trị màu lớn hơn hoặc bằng maxValue sẽ có màu nền là maxValueColor. Các ô có giá trị màu nằm trong khoảng từ minValue đến maxValue sẽ có màu nền trên một hiệu ứng chuyển màu từ minValueColor đến maxValueColor, điểm giữa của hiệu ứng chuyển màu là midValueColor. Các ô bị thiếu giá trị màu hoặc giá trị không phải là số sẽ có màu nền là noDataColor.

hideTooltips

boolean

True để ẩn chú giải công cụ.

TreemapChartColorScale

Thang màu cho biểu đồ dạng cây.

Biểu diễn dưới dạng 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)
  }
}
Các trường
minValueColor
(deprecated)

object (Color)

Màu nền của các ô có giá trị màu nhỏ hơn hoặc bằng minValue. Giá trị mặc định là #dc3912 nếu không được chỉ định. Không dùng nữa: Sử dụng minValueColorStyle.

minValueColorStyle

object (ColorStyle)

Màu nền của các ô có giá trị màu nhỏ hơn hoặc bằng minValue. Giá trị mặc định là #dc3912 nếu không được chỉ định. Nếu bạn cũng đặt minValueColor, trường này sẽ được ưu tiên.

midValueColor
(deprecated)

object (Color)

Màu nền của các ô có giá trị màu ở điểm giữa từ minValue đến maxValue. Giá trị mặc định là #efe6dc nếu không được chỉ định. Không dùng nữa: Sử dụng midValueColorStyle.

midValueColorStyle

object (ColorStyle)

Màu nền của các ô có giá trị màu ở điểm giữa từ minValue đến maxValue. Giá trị mặc định là #efe6dc nếu không được chỉ định. Nếu bạn cũng đặt midValueColor, trường này sẽ được ưu tiên.

maxValueColor
(deprecated)

object (Color)

Màu nền của các ô có giá trị màu lớn hơn hoặc bằng maxValue. Giá trị mặc định là #109618 nếu không được chỉ định. Không dùng nữa: Sử dụng maxValueColorStyle.

maxValueColorStyle

object (ColorStyle)

Màu nền của các ô có giá trị màu lớn hơn hoặc bằng maxValue. Giá trị mặc định là #109618 nếu không được chỉ định. Nếu bạn cũng đặt maxValueColor, trường này sẽ được ưu tiên.

noDataColor
(deprecated)

object (Color)

Màu nền của các ô không có dữ liệu màu liên kết với các ô đó. Giá trị mặc định là #000000 nếu không được chỉ định. Không dùng nữa: Sử dụng noDataColorStyle.

noDataColorStyle

object (ColorStyle)

Màu nền của các ô không có dữ liệu màu liên kết với các ô đó. Giá trị mặc định là #000000 nếu không được chỉ định. Nếu bạn cũng đặt noDataColor, trường này sẽ được ưu tiên.

Thẻ điểm biểu đồ

Biểu đồ thẻ điểm. Biểu đồ thẻ điểm được dùng để làm nổi bật các chỉ báo hiệu suất chính, còn gọi là KPI, trên bảng tính. Biểu đồ thẻ điểm có thể thể hiện những thông tin như tổng doanh số, chi phí trung bình hoặc một mặt hàng bán chạy nhất. Bạn có thể chỉ định một giá trị dữ liệu duy nhất hoặc tổng hợp trong một phạm vi dữ liệu. Bạn có thể đánh dấu tỷ lệ phần trăm hoặc mức chênh lệch tuyệt đối so với giá trị cơ sở, chẳng hạn như các thay đổi theo thời gian.

Biểu diễn dưới dạng JSON 
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
Các trường
keyValueData

object (ChartData)

Dữ liệu cho khóa giá trị thẻ điểm.

baselineValueData

object (ChartData)

Dữ liệu cho giá trị đường cơ sở của thẻ điểm. Trường này là tùy chọn.

aggregateType

enum (ChartAggregateType)

Loại tổng hợp cho dữ liệu biểu đồ cơ bản và khóa cho biểu đồ thẻ điểm. Trường này không được hỗ trợ cho biểu đồ nguồn dữ liệu. Thay vào đó, hãy sử dụng trường ChartData.aggregateType của keyValueData hoặc baselineValueData cho biểu đồ nguồn dữ liệu. Trường này là tùy chọn.

keyValueFormat

object (KeyValueFormat)

Các tùy chọn định dạng cho khóa-giá trị.

baselineValueFormat

object (BaselineValueFormat)

Các tùy chọn định dạng cho giá trị cơ sở. Trường này chỉ cần thiết nếu bạn chỉ định baselineValueData.

scaleFactor

number

Giá trị để chia tỷ lệ khóa thẻ điểm và giá trị cơ sở. Ví dụ: thừa số 10 có thể được sử dụng để chia tất cả các giá trị trong biểu đồ cho 10. Trường này là tùy chọn.

numberFormatSource

enum (ChartNumberFormatSource)

Nguồn định dạng số được sử dụng trong biểu đồ thẻ điểm. Trường này là tùy chọn.

customFormatOptions

object (ChartCustomNumberFormatOptions)

Tùy chọn định dạng tùy chỉnh cho các khóa số/giá trị cơ sở trong biểu đồ thẻ điểm. Trường này chỉ được dùng khi bạn đặt numberFormatSource thành CUSTOM. Trường này là tùy chọn.

Định dạng khóa-giá trị

Các tùy chọn định dạng cho khóa-giá trị.

Biểu diễn dưới dạng JSON 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
Các trường
textFormat

object (TextFormat)

Tùy chọn định dạng văn bản cho khóa-giá trị. Trường liên kết không được hỗ trợ.

position

object (TextPosition)

Xác định vị trí văn bản theo chiều ngang của giá trị khoá. Trường này là tùy chọn. Nếu không xác định thì định vị mặc định sẽ được sử dụng.

Định dạng Giá trị Đường cơ sở

Các tùy chọn định dạng cho giá trị cơ sở.

Biểu diễn dưới dạng JSON 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
Các trường
comparisonType

enum (ComparisonType)

Loại so sánh giá trị khóa với giá trị cơ sở.

textFormat

object (TextFormat)

Tùy chọn định dạng văn bản cho giá trị đường cơ sở. Trường liên kết không được hỗ trợ.

position

object (TextPosition)

Chỉ định vị trí văn bản theo chiều ngang của giá trị cơ sở. Trường này là tùy chọn. Nếu không xác định thì định vị mặc định sẽ được sử dụng.

description

string

Mô tả được nối sau giá trị đường cơ sở. Trường này là tùy chọn.

positiveColor
(deprecated)

object (Color)

Màu sắc sẽ được sử dụng, trong trường hợp giá trị cơ sở thể hiện sự thay đổi tích cực đối với giá trị khóa. Trường này là tùy chọn. Không dùng nữa: Sử dụng positiveColorStyle.

positiveColorStyle

object (ColorStyle)

Màu sắc sẽ được sử dụng, trong trường hợp giá trị cơ sở thể hiện sự thay đổi tích cực đối với giá trị khóa. Trường này là tùy chọn. Nếu bạn cũng đặt positiveColor, trường này sẽ được ưu tiên.

negativeColor
(deprecated)

object (Color)

Màu sắc sẽ được sử dụng, trong trường hợp giá trị cơ sở thể hiện sự thay đổi tiêu cực đối với giá trị khóa. Trường này là tùy chọn. Không dùng nữa: Sử dụng negativeColorStyle.

negativeColorStyle

object (ColorStyle)

Màu sắc sẽ được sử dụng, trong trường hợp giá trị cơ sở thể hiện sự thay đổi tiêu cực đối với giá trị khóa. Trường này là tùy chọn. Nếu bạn cũng đặt negativeColor, trường này sẽ được ưu tiên.

Loại so sánh

Loại so sánh giá trị khóa với giá trị cơ sở.

Enum
COMPARISON_TYPE_UNDEFINED Giá trị mặc định, không sử dụng.
ABSOLUTE_DIFFERENCE Sử dụng giá trị chênh lệch tuyệt đối giữa khóa và giá trị cơ sở.
PERCENTAGE_DIFFERENCE Sử dụng chênh lệch phần trăm giữa khóa và giá trị cơ sở.

NumberNumberFormatSource biểu đồ

Các tùy chọn nguồn định dạng số cho các thuộc tính của biểu đồ.

Enum
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Giá trị mặc định, không sử dụng.
FROM_DATA Kế thừa định dạng số từ dữ liệu.
CUSTOM Áp dụng định dạng tùy chỉnh như đã chỉ định trong ChartCustomNumberFormatOptions.

Biểu đồ tùy chỉnh định dạng tùy chọn

Tùy chọn định dạng số tùy chỉnh cho các thuộc tính của biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "prefix": string,
  "suffix": string
}
Các trường
prefix

string

Tiền tố tùy chỉnh cần được thêm vào trước thuộc tính biểu đồ. Trường này là tùy chọn.

suffix

string

Hậu tố tùy chỉnh cần được thêm vào thuộc tính biểu đồ. Trường này là tùy chọn.

Biểu đồ chiến lược đã ẩn

Xác định cách biểu đồ sẽ xử lý các hàng nguồn bị ẩn. Các hàng bị ẩn bao gồm cả bộ lọc bị ẩn và ẩn thủ công.

Enum
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Giá trị mặc định, không sử dụng.
SKIP_HIDDEN_ROWS_AND_COLUMNS Biểu đồ sẽ bỏ qua các hàng và cột bị ẩn.
SKIP_HIDDEN_ROWS Biểu đồ sẽ chỉ bỏ qua những hàng bị ẩn.
SKIP_HIDDEN_COLUMNS Biểu đồ sẽ chỉ bỏ qua các cột ẩn.
SHOW_ALL Biểu đồ sẽ không bỏ qua bất kỳ hàng hoặc cột bị ẩn nào.

Đường viền đối tượng đã nhúng

Đường viền dọc theo đối tượng được nhúng.

Biểu diễn dưới dạng JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Các trường
color
(deprecated)

object (Color)

Màu của đường viền. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu của đường viền. Nếu bạn cũng đặt color, trường này sẽ được ưu tiên.