REST Resource: projects.locations.instances.dashboardCharts

Resource: DashboardChart

DashboardChart resource. NEXT TAG: 10

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "nativeDashboard": string,
  "tileType": enum (TileType),
  "chartDatasource": {
    object (ChartDatasource)
  },
  "visualization": {
    object (Visualization)
  },
  "etag": string,
  "drillDownConfig": {
    object (DrillDownConfig)
  }
}
Fields
name

string

Output only. Name of the dashboardChart.

displayName

string

Required. Display name/Title of the dashboardChart visible to users.

description

string

Optional. Description of the dashboardChart.

nativeDashboard

string

Output only. NativeDashboard this chart belongs to.

tileType

enum (TileType)

Optional. Type of tile i.e., visualization, button or text.

chartDatasource

object (ChartDatasource)

Optional. Query and datasource used in the chart. Should be empty for Button Tiles.

visualization

object (Visualization)

Required. Depending on tileType one of below fields will be required.

etag

string

Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.

drillDownConfig

object (DrillDownConfig)

Optional. Drill down configuration.

TileType

TileType indicates what type of chart tile it is i.e., visualization chart, button or text.

Enums
TILE_TYPE_UNSPECIFIED Defaults to VISUALIZATION.
TILE_TYPE_VISUALIZATION Visualization i.e., bar charts, pie charts etc.
TILE_TYPE_BUTTON Button with hyperlink.
TILE_TYPE_MARKDOWN Markdown tile.

ChartDatasource

Datasource of the chart including the query reference and source name.

JSON representation
{
  "dashboardQuery": string,
  "dataSources": [
    enum (DataSource)
  ]
}
Fields
dashboardQuery

string

Reference to dashboard query resource used in the chart.

dataSources[]

enum (DataSource)

Name of the datasource used in the chart.

Visualization

Visualization config for a chart. https://echarts.apache.org/en/option.html#series NEXT TAG: 19

JSON representation
{
  "xAxes": [
    {
      object (Axis)
    }
  ],
  "yAxes": [
    {
      object (Axis)
    }
  ],
  "series": [
    {
      object (Series)
    }
  ],
  "tooltip": {
    object (Tooltip)
  },
  "legends": [
    {
      object (Legend)
    }
  ],
  "columnDefs": [
    {
      object (ColumnDef)
    }
  ],
  "tableConfig": {
    object (TableConfig)
  },
  "button": {
    object (Button)
  },
  "markdown": {
    object (Markdown)
  },
  "seriesColumn": [
    string
  ],
  "groupingType": string,
  "googleMapsConfig": {
    object (GoogleMapsConfig)
  },
  "thresholdColoringEnabled": boolean,
  "visualMaps": [
    {
      object (VisualMap)
    }
  ]
}
Fields
xAxes[]

object (Axis)

yAxes[]

object (Axis)

series[]

object (Series)

tooltip

object (Tooltip)

legends[]

object (Legend)

columnDefs[]

object (ColumnDef)

Column Definition to represent chart as a table.

tableConfig

object (TableConfig)

Optional. Configuration for table appearance.

button

object (Button)

Button config for a chart if tileType is TILE_TYPE_BUTTON.

markdown

object (Markdown)

Optional. Markdown config for a chart if tileType is TILE_TYPE_MARKDOWN.

seriesColumn[]

string

Optional. Selected column for series

groupingType

string

Optional. Selected grouping type for series

googleMapsConfig

object (GoogleMapsConfig)

Optional. Google Maps config for a chart if type is GOOGLE MAPS.

thresholdColoringEnabled

boolean

Optional. Whether threshold coloring is enabled for the chart. If it's enabled, the chart will be colored based on the values stored in VisualMap below.

visualMaps[]

object (VisualMap)

Optional. Visual maps for the chart.

Axis

JSON representation
{
  "axisType": enum (AxisType),
  "displayName": string,
  "min": integer,
  "max": integer
}
Fields
axisType

enum (AxisType)

displayName

string

min

integer

Minimum value to be rendered in ECharts as per https://echarts.apache.org/en/option.html#xAxis.min

max

integer

Maximum value to be rendered in ECharts as per https://echarts.apache.org/en/option.html#xAxis.max

AxisType

Enums
AXIS_TYPE_UNSPECIFIED
VALUE
CATEGORY
TIME
LOG

Series

JSON representation
{
  "seriesType": enum (SeriesType),
  "seriesName": string,
  "showSymbol": boolean,
  "showBackground": boolean,
  "stack": string,
  "seriesStackStrategy": enum (SeriesStackStrategy),
  "encode": {
    object (Encode)
  },
  "label": string,
  "field": string,
  "dataLabel": {
    object (DataLabel)
  },
  "radius": [
    string
  ],
  "itemStyle": {
    object (ItemStyle)
  },
  "seriesUniqueValue": string,
  "areaStyle": {
    object (AreaStyle)
  },
  "itemColors": {
    object (ItemColors)
  },
  "gaugeConfig": {
    object (GaugeConfig)
  },
  "metricTrendConfig": {
    object (MetricTrendConfig)
  }
}
Fields
seriesType

enum (SeriesType)

seriesName

string

user specified series label

showSymbol

boolean

showBackground

boolean

stack

string

seriesStackStrategy

enum (SeriesStackStrategy)

encode

object (Encode)

label

string

field

string

dataLabel

object (DataLabel)

Optional. Data label config for a series. Displays data vaule in the chart

radius[]

string

Optional. Used to make a pie chart into a douhnut chart

itemStyle

object (ItemStyle)

Optional. Custom styling for chart

seriesUniqueValue

string

Optional. Series unique value from the query result

areaStyle

object (AreaStyle)

Optional. Custom styling for area chart

itemColors

object (ItemColors)

Optional. Field to be saved for retrieving slice colors for the chart

gaugeConfig

object (GaugeConfig)

Optional. Field to be saved for retrieving gauge config for gauge chart

metricTrendConfig

object (MetricTrendConfig)

Optional. Fields to capture trend config for metric charts

SeriesType

Enums
SERIES_TYPE_UNSPECIFIED
LINE
BAR
PIE
TEXT
MAP Represents map chart type.
GAUGE Represents gauge chart type.
SCATTERPLOT Represents scatterplot chart type.

SeriesStackStrategy

Enums
SERIES_STACK_STRATEGY_UNSPECIFIED
SAMESIGN
ALL
POSITIVE
NEGATIVE

Encode

JSON representation
{
  "x": string,
  "y": string,
  "value": string,
  "itemName": string
}
Fields
x

string

y

string

value

string

For some type of series that are not in any coordinate system, like 'pie'

itemName

string

This is useful in charts like 'pie', where data item name can be displayed in legend.

DataLabel

Data label config for a series.

JSON representation
{
  "show": boolean
}
Fields
show

boolean

Optional. Whether to show data label.

ItemStyle

Custom styling for chart

JSON representation
{
  "borderWidth": integer,
  "borderColor": string,
  "color": string
}
Fields
borderWidth

integer

Optional. Used to add border width

borderColor

string

Optional. Used to add border color

color

string

Optional. Used to add color

AreaStyle

Custom styling for area chart

JSON representation
{
  "color": string,
  "origin": string,
  "shadowBlur": integer,
  "shadowColor": string,
  "shadowOffsetX": integer,
  "shadowOffsetY": integer,
  "opacity": integer
}
Fields
color

string

Optional. Used to add color

origin

string

Optional. Used to add origin

shadowBlur

integer

Optional. Used to add shadow blur

shadowColor

string

Optional. Used to add shadow color

shadowOffsetX

integer

Optional. Used to add shadow offsetX

shadowOffsetY

integer

Optional. Used to add shadow offsetY

opacity

integer

Optional. Used to add opacity

ItemColors

Field to be saved for retrieving slice colors for the chart

JSON representation
{
  "colors": [
    {
      object (ChartSliceColor)
    }
  ]
}
Fields
colors[]

object (ChartSliceColor)

Optional. Slice colors array

ChartSliceColor

Slice containing the key and value for a slice in the chart

JSON representation
{
  "key": string,
  "value": {
    object (UserSelectedValues)
  }
}
Fields
key

string

Optional. Key for the slice

value

object (UserSelectedValues)

Optional. Value for the slice

UserSelectedValues

User selected color and label for the slice of the chart

JSON representation
{
  "color": string,
  "label": string
}
Fields
color

string

Optional. User specified color of a pie slice

label

string

Optional. User specified label for a pie slice

GaugeConfig

Field to be saved for retrieving value and color for gauge chart

JSON representation
{
  "baseValue": {
    object (GaugeValue)
  },
  "limitValue": {
    object (GaugeValue)
  },
  "thresholdValues": [
    {
      object (GaugeValue)
    }
  ]
}
Fields
baseValue

object (GaugeValue)

Optional. Base value for gauge chart

limitValue

object (GaugeValue)

Optional. Limit value for gauge chart

thresholdValues[]

object (GaugeValue)

Optional. Threshold values for gauge chart

GaugeValue

Field to be saved for retrieving value and color for gauge chart

JSON representation
{
  "value": integer,
  "color": string
}
Fields
value

integer

Optional. Value for gauge chart

color

string

Optional. Color for gauge chart

MetricTrendConfig

Metric trend config for displaying trend value in Metrics chart

JSON representation
{
  "metricFormat": enum (MetricFormat),
  "showMetricTrend": boolean,
  "metricDisplayTrend": enum (MetricDisplayTrend),
  "metricTrendType": enum (MetricTrendType)
}
Fields
metricFormat

enum (MetricFormat)

Optional. Metric chart configuration to display metric trend

showMetricTrend

boolean

Optional. Metric chart configuration to toggle the trend value display

metricDisplayTrend

enum (MetricDisplayTrend)

Optional. Metric chart configuration to display the trend value

metricTrendType

enum (MetricTrendType)

Optional. Metric chart configuration to display trend type whether regular or inverse

MetricFormat

Metric format to be displayed for the metric charts.

Enums
METRIC_FORMAT_UNSPECIFIED Metric format is not specified.
METRIC_FORMAT_NUMBER Metric format in number
METRIC_FORMAT_PLAIN_TEXT Metric format in plain text

MetricDisplayTrend

Trend to be displayed for the metric charts as.

Enums
METRIC_DISPLAY_TREND_UNSPECIFIED Trend is not specified.
METRIC_DISPLAY_TREND_ABSOLUTE_VALUE Trend data in absolute value
METRIC_DISPLAY_TREND_PERCENTAGE Trend data in percentage
METRIC_DISPLAY_TREND_ABSOLUTE_VALUE_AND_PERCENTAGE Trend data in both absolute value and percentage

MetricTrendType

Trend to be displayed for the metric charts as.

Enums
METRIC_TREND_TYPE_UNSPECIFIED Trend type is not specified.
METRIC_TREND_TYPE_REGULAR The trend type is regular(green for positive delta)
METRIC_TREND_TYPE_INVERSE The trend type is inverse(red for positive delta)

Tooltip

JSON representation
{
  "show": boolean,
  "tooltipTrigger": enum (ToolTipTrigger)
}
Fields
show

boolean

tooltipTrigger

enum (ToolTipTrigger)

ToolTipTrigger

Enums
TOOLTIP_TRIGGER_UNSPECIFIED
TOOLTIP_TRIGGER_NONE
TOOLTIP_TRIGGER_ITEM
TOOLTIP_TRIGGER_AXIS

Legend

JSON representation
{
  "id": string,
  "show": boolean,
  "zLevel": integer,
  "z": integer,
  "left": integer,
  "top": integer,
  "right": integer,
  "bottom": integer,
  "legendOrient": enum (LegendOrient),
  "legendAlign": enum (LegendAlign),
  "padding": [
    integer
  ]
}
Fields
id

string

show

boolean

zLevel

integer

z

integer

left

integer

top

integer

right

integer

bottom

integer

legendOrient

enum (LegendOrient)

legendAlign

enum (LegendAlign)

padding[]

integer

LegendOrient

Enums
LEGEND_ORIENT_UNSPECIFIED
VERTICAL
HORIZONTAL

LegendAlign

Enums
LEGEND_ALIGN_UNSPECIFIED
AUTO
LEFT
RIGHT

ColumnDef

Column Definition.

JSON representation
{
  "field": string,
  "header": string
}
Fields
field

string

Field key in data.

header

string

Header name for column.

TableConfig

Configuration for table appearance.

JSON representation
{
  "enableTextWrap": boolean,
  "columnRenderTypeSettings": [
    {
      object (ColumnRenderTypeSettings)
    }
  ]
}
Fields
enableTextWrap

boolean

Optional. Whether to show the table.

columnRenderTypeSettings[]

object (ColumnRenderTypeSettings)

Optional. Column render type settings.

ColumnRenderTypeSettings

Column render type settings. This is used to determine the data render type of the column in the table.

JSON representation
{
  "field": string,
  "columnRenderType": enum (RenderType)
}
Fields
field

string

Optional. Field key in data.

columnRenderType

enum (RenderType)

Optional. Column render type.

RenderType

Render type of the data in the chart.

Enums
RENDER_TYPE_UNSPECIFIED Defaults to Unspecified.
RENDER_TYPE_TEXT Text render type.
RENDER_TYPE_ICON Icon render type.
RENDER_TYPE_ICON_AND_TEXT Icon and text render type.

Button

Button config for a chart.

JSON representation
{
  "label": string,
  "hyperlink": string,
  "description": string,
  "newTab": boolean,
  "properties": {
    object (Properties)
  }
}
Fields
label

string

description

string

newTab

boolean

Whether to open the link in a new tab.

properties

object (Properties)

Properties

JSON representation
{
  "color": string,
  "buttonStyle": enum (ButtonStyle)
}
Fields
color

string

buttonStyle

enum (ButtonStyle)

ButtonStyle

Enums
BUTTON_STYLE_UNSPECIFIED
BUTTON_STYLE_FILLED
BUTTON_STYLE_OUTLINED
BUTTON_STYLE_TRANSPARENT

Markdown

Markdown config for a dashboard tile.

JSON representation
{
  "content": string,
  "properties": {
    object (MarkdownProperties)
  }
}
Fields
content

string

Required. Markdown content.

properties

object (MarkdownProperties)

Optional. Properties for the markdown.

MarkdownProperties

Properties for the markdown.

JSON representation
{
  "backgroundColor": string
}
Fields
backgroundColor

string

Optional. Background color of the markdown.

GoogleMapsConfig

Google Maps config for a chart if chart type is map.

JSON representation
{
  "dataSettings": {
    object (DataSettings)
  },
  "plotMode": enum (PlotMode),
  "mapPosition": {
    object (MapPosition)
  },
  "pointSettings": {
    object (PointSettings)
  }
}
Fields
dataSettings

object (DataSettings)

Optional. Data settings for the map.

plotMode

enum (PlotMode)

Optional. Plot mode for the map. This is used to determine whether to show points, heatmap or both.

mapPosition

object (MapPosition)

Optional. Map position settings for the map.

pointSettings

object (PointSettings)

Optional. Point settings for the map.

DataSettings

Data settings for the map.

JSON representation
{
  "latitudeColumn": string,
  "longitudeColumn": string,
  "countColumn": string
}
Fields
latitudeColumn

string

Optional. Latitude column.

longitudeColumn

string

Optional. Longitude column.

countColumn

string

Optional. Field to count.

PlotMode

Plot mode for the map.

Enums
PLOT_MODE_UNSPECIFIED Plot mode is not specified.
PLOT_MODE_POINTS Plot mode is points.
PLOT_MODE_HEATMAP Plot mode is heatmap.
PLOT_MODE_BOTH Plot mode is both points and heatmap.

MapPosition

Map position settings for the map.

JSON representation
{
  "fitData": boolean,
  "latitudeValue": number,
  "longitudeValue": number,
  "zoomScaleValue": number
}
Fields
fitData

boolean

Optional. Whether to fit the map to the data. If true, the map will be resized to fit the data. If false, langitude and longitude will be used to set the map size.

latitudeValue

number

Optional. Latitude of the map.

longitudeValue

number

Optional. Longitude of the map.

zoomScaleValue

number

Optional. Scale of the map.

PointSettings

Point settings for the map.

JSON representation
{
  "pointSizeType": enum (PointSizeType),
  "color": string
}
Fields
pointSizeType

enum (PointSizeType)

Optional. Point size type for the map. This is used to determine the size of the points on the map.

color

string

Optional. Color for the point on the map.

PointSizeType

Point size type for the map.

Enums
POINT_SIZE_TYPE_UNSPECIFIED Point size is not specified.
POINT_SIZE_TYPE_FIXED Point size is fixed.
POINT_SIZE_TYPE_PROPORTIONAL_TO_SIZE Point size is proportional to the size of the data point.

VisualMap

Conveys what range of values should be rendered in what color. This field is used when thresholdColoringEnabled is true.

JSON representation
{
  "visualMapType": enum (VisualMapType),
  "pieces": [
    {
      object (VisualMapPiece)
    }
  ]
}
Fields
visualMapType

enum (VisualMapType)

Optional. Contains one of the valid visual map types such as 'continuous' or 'piecewise'.

pieces[]

object (VisualMapPiece)

Optional. Pieces of the visual map.

VisualMapType

Visual map for various charts. More info: https://echarts.apache.org/en/option.html#visualMap

Enums
VISUAL_MAP_TYPE_UNSPECIFIED Visual map type is not specified
CONTINUOUS Continuous visual map
PIECEWISE Piecewise visual map

VisualMapPiece

An ECharts visual map of type 'piecewise' contain many pieces. Each piece has a min, max, and color with which it's rendered.

JSON representation
{
  "color": string,
  "label": string,
  "min": string,
  "max": string
}
Fields
color

string

Optional. Color to render the piece in when the value is between min and max.

label

string

Optional. Label used in visual map controller.

min

string (int64 format)

Optional. Minimum value for the piece.

max

string (int64 format)

Optional. Minimum value for the piece.

DrillDownConfig

NEXT TAG: 3 Drill down configuration.

JSON representation
{
  "leftDrillDowns": [
    {
      object (DrillDown)
    }
  ],
  "rightDrillDowns": [
    {
      object (DrillDown)
    }
  ]
}
Fields
leftDrillDowns[]

object (DrillDown)

Required. Left click drill downs.

rightDrillDowns[]

object (DrillDown)

Required. Right click drill downs.

DrillDown

NEXT TAG: 5 Drill down config.

JSON representation
{
  "id": string,
  "displayName": string,

  // Union field settings can be only one of the following:
  "defaultSettings": {
    object (DefaultDrillDownSettings)
  },
  "customSettings": {
    object (CustomDrillDownSettings)
  }
  // End of list of possible types for union field settings.
}
Fields
id

string

Required. ID of the drill down.

displayName

string

Required. Display name of the drill down.

Union field settings. Drill down settings. settings can be only one of the following:
defaultSettings

object (DefaultDrillDownSettings)

Default drill down settings.

customSettings

object (CustomDrillDownSettings)

Custom drill down settings.

DefaultDrillDownSettings

Default drill down settings.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Required. Whether the default drill down is enabled.

CustomDrillDownSettings

NEXT TAG: 6 Custom drill down settings.

JSON representation
{
  "newTab": boolean,
  "leftClickColumn": string,

  // Union field action can be only one of the following:
  "query": {
    object (DrillDownQuery)
  },
  "filter": {
    object (DrillDownFilter)
  },
  "externalLink": {
    object (DrillDownExternalLink)
  }
  // End of list of possible types for union field action.
}
Fields
newTab

boolean

Required. Whether to open the drill down action in a new tab.

leftClickColumn

string

Optional. Table chart column name to associate the custom drill down action on left click.

Union field action. Action to be performed on drill down. action can be only one of the following:
query

object (DrillDownQuery)

Drill down query action config.

filter

object (DrillDownFilter)

Drill down filter action config.

DrillDownQuery

Drill down query config.

JSON representation
{
  "query": string
}
Fields
query

string

Required. Search query to be executed on drill down.

DrillDownFilter

Drill down filter config.

JSON representation
{
  "dashboardFilters": [
    {
      object (DrillDownDashboardFilter)
    }
  ]
}
Fields
dashboardFilters[]

object (DrillDownDashboardFilter)

Required. Dashboard filters to be applied on drill down.

DrillDownDashboardFilter

Drill down dashboard filter config.

JSON representation
{
  "dashboardFilterId": string,
  "filterOperatorAndValues": [
    {
      object (FilterOperatorAndValues)
    }
  ]
}
Fields
dashboardFilterId

string

Required. ID of the dashboard filter.

filterOperatorAndValues[]

object (FilterOperatorAndValues)

Required. Filter operator and field values for the dashboard filter.

Methods

batchGet

Get dashboard charts in batches.

get

Get a dashboard chart.