Charts

EmbeddedChart

نموداری که در یک برگه جاسازی شده است.

نمایندگی JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
زمینه های
chartId

integer

شناسه نمودار.

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

درست است که یک نمودار کل فضایی را که در آن رندر شده است با حداقل padding پر کند. برای استفاده از بالشتک پیش فرض نادرست است. (برای نمودارهای جغرافیایی و سازمانی قابل استفاده نیست.)

backgroundColor
(deprecated)

object ( Color )

رنگ پس زمینه کل نمودار. برای نمودارهای سازمانی قابل استفاده نیست. منسوخ شده: از backgroundColorStyle استفاده کنید.

backgroundColorStyle

object ( ColorStyle )

رنگ پس زمینه کل نمودار. برای نمودارهای سازمانی قابل استفاده نیست. اگر backgroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

dataSourceChartProperties

object ( DataSourceChartProperties )

در صورت وجود، فیلد حاوی ویژگی های خاص نمودار منبع داده است.

filterSpecs[]

object ( FilterSpec )

فیلترهای اعمال شده روی داده های منبع نمودار. فقط برای نمودارهای منبع داده پشتیبانی می شود.

sortSpecs[]

object ( SortSpec )

ترتیب مرتب سازی داده های نمودار بر اساس. فقط یک مشخصات مرتب سازی پشتیبانی می شود. فقط برای نمودارهای منبع داده پشتیبانی می شود.

hiddenDimensionStrategy

enum ( ChartHiddenDimensionStrategy )

نحوه استفاده نمودارها از سطرها یا ستون های مخفی را تعیین می کند.

chart میدان اتحادیه. مشخصات نمودار خاص، دقیقاً یک مقدار باید تنظیم شود. chart فقط می تواند یکی از موارد زیر باشد:
basicChart

object ( BasicChartSpec )

مشخصات نمودار پایه، می تواند یکی از انواع نمودارها باشد. برای لیست همه نمودارهایی که این پشتیبانی می کند، BasicChartType ببینید.

pieChart

object ( PieChartSpec )

مشخصات نمودار دایره ای

bubbleChart

object ( BubbleChartSpec )

مشخصات نمودار حباب.

candlestickChart

object ( CandlestickChartSpec )

مشخصات نمودار شمعی.

orgChart

object ( OrgChartSpec )

مشخصات نمودار سازمانی

histogramChart

object ( HistogramChartSpec )

مشخصات نمودار هیستوگرام

waterfallChart

object ( WaterfallChartSpec )

مشخصات نمودار آبشار

treemapChart

object ( TreemapChartSpec )

مشخصات نمودار نقشه درختی

scorecardChart

object ( ScorecardChartSpec )

مشخصات نمودار کارت امتیازی

موقعیت متن

تنظیمات موقعیت برای متن

نمایندگی JSON
{
  "horizontalAlignment": enum (HorizontalAlign)
}
زمینه های
horizontalAlignment

enum ( HorizontalAlign )

تنظیم تراز افقی برای قطعه متن.

DataSourceChartProperties

ویژگی های نمودار منبع داده

نمایندگی JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
زمینه های
dataSourceId

string

شناسه منبع داده ای که نمودار با آن مرتبط است.

dataExecutionStatus

object ( DataExecutionStatus )

فقط خروجی وضعیت اجرای داده ها

BasicChartSpec

مشخصات یک نمودار پایه برای لیست نمودارهایی که این پشتیبانی می کند به BasicChartType مراجعه کنید.

نمایندگی JSON
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
زمینه های
chartType

enum ( BasicChartType )

نوع نمودار.

legendPosition

enum ( BasicChartLegendPosition )

موقعیت افسانه نمودار.

axis[]

object ( BasicChartAxis )

محور روی نمودار.

domains[]

object ( BasicChartDomain )

دامنه داده این نمودار است. فقط یک دامنه پشتیبانی می شود.

series[]

object ( BasicChartSeries )

داده هایی که این نمودار در حال تجسم است.

headerCount

integer

تعداد سطرها یا ستون‌ها در داده‌ها که «هدر» هستند. اگر تنظیم نشود، Google Sheets بر اساس داده‌ها حدس می‌زند چند ردیف سرصفحه هستند.

(توجه داشته باشید که BasicChartAxis.title ممکن است عنوان محور استنتاج شده از مقادیر سرصفحه را لغو کند.)

threeDimensional

boolean

درست است که نمودار را سه بعدی کنید. برای نمودارهای میله ای و ستونی اعمال می شود.

interpolateNulls

boolean

اگر برخی از مقادیر در یک سری از دست رفته باشد، ممکن است شکاف هایی در نمودار ظاهر شود (به عنوان مثال، بخش هایی از خطوط در نمودار خطی از بین خواهند رفت). برای از بین بردن این شکاف ها، این را روی true قرار دهید. برای نمودارهای خط، مساحت و ترکیبی اعمال می شود.

stackedType

enum ( BasicChartStackedType )

نوع پشته‌ای برای نمودارهایی که از انباشته شدن عمودی پشتیبانی می‌کنند. برای نمودارهای ناحیه، میله، ستون، ترکیبی، و منطقه پله ای اعمال می شود.

lineSmoothing

boolean

دریافت می کند که آیا همه خطوط باید به طور پیش فرض صاف یا مستقیم ارائه شوند. برای نمودارهای خطی اعمال می شود.

compareMode

enum ( BasicChartCompareMode )

رفتار نکات ابزار و برجسته کردن داده ها هنگام شناور شدن روی داده ها و منطقه نمودار.

totalDataLabel

object ( DataLabel )

کنترل می کند که آیا برچسب های داده های اضافی در نمودارهای انباشته نمایش داده شود که مجموع ارزش کل همه مقادیر انباشته شده در هر مقدار در امتداد محور دامنه است. این برچسب‌های داده را فقط زمانی می‌توان تنظیم کرد که chartType یکی از AREA ، BAR ، COLUMN ، COMBO یا STEPPED_AREA باشد و stackedType STACKED یا PERCENT_STACKED باشد. علاوه بر این، برای COMBO ، این تنها در صورتی پشتیبانی می‌شود که فقط یک type از سری‌های قابل انباشته وجود داشته باشد یا یک نوع سری‌های بیشتری نسبت به بقیه داشته باشد و هر یک از انواع دیگر بیش از یک سری نداشته باشد. به عنوان مثال، اگر نمودار دارای دو سری نوار پشته‌ای و یک سری ناحیه باشد، کل برچسب‌های داده پشتیبانی می‌شوند. اگر دارای سه سری نوار و دو سری ناحیه باشد، برچسب داده کل مجاز نیست. نه CUSTOM و نه placement نمی توان روی totalDataLabel تنظیم کرد.

BasicChartType

نمودار چگونه باید تجسم شود.

Enums
BASIC_CHART_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
BAR یک نمودار میله ای .
LINE یک نمودار خطی
AREA نمودار مساحتی
COLUMN نمودار ستونی
SCATTER یک نمودار پراکنده .
COMBO یک نمودار ترکیبی
STEPPED_AREA نمودار مساحت پلکانی

BasicChartLegendPosition

جایی که افسانه نمودار باید قرار گیرد.

Enums
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
BOTTOM_LEGEND افسانه در پایین نمودار ارائه شده است.
LEFT_LEGEND افسانه در سمت چپ نمودار ارائه شده است.
RIGHT_LEGEND افسانه در سمت راست نمودار ارائه شده است.
TOP_LEGEND افسانه در بالای نمودار ارائه شده است.
NO_LEGEND هیچ افسانه ای ارائه نمی شود.

BasicChartAxis

یک محور از نمودار. نمودار نباید بیش از یک محور در هر 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 )

گزینه های پنجره view برای این محور.

BasicChartAxisPosition

موقعیت یک محور نمودار.

Enums
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

حالت پنجره مشاهده نحوه برخورد با حداقل و حداکثر پنجره نمایش را مشخص می کند.

Enums
DEFAULT_VIEW_WINDOW_MODE حالت پنجره نمای پیش‌فرض که در ویرایشگر Sheets برای این نوع نمودار استفاده می‌شود. در بیشتر موارد، اگر تنظیم شود، حالت پیش‌فرض معادل PRETTY است.
VIEW_WINDOW_MODE_UNSUPPORTED استفاده نکن. نشان می دهد که حالت تنظیم شده فعلی توسط API پشتیبانی نمی شود.
EXPLICIT اگر مشخص شده باشد، از حداقل و حداکثر پیروی می کند. اگر مقداری نامشخص باشد، به مقدار PRETTY برمی گردد.
PRETTY حداقل و حداکثری را انتخاب می کند که نمودار را خوب جلوه دهد. هر دو حداقل و حداکثر در این حالت نادیده گرفته می شوند.

BasicChartDomain

دامنه یک نمودار. به عنوان مثال، اگر نمودار قیمت سهام در طول زمان مشخص شود، این تاریخ خواهد بود.

نمایندگی JSON
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
domain

object ( ChartData )

داده های دامنه به عنوان مثال، اگر نمودار قیمت سهام را در طول زمان ترسیم کنید، این داده ها نشان دهنده تاریخ است.

reversed

boolean

درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی).

نمودار دیتا

داده های موجود در یک دامنه یا سری.

نمایندگی JSON
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
زمینه های
groupRule

object ( ChartGroupRule )

قانون گروه بندی داده ها بر اساس اگر ChartData از دامنه نمودار منبع داده پشتیبانی کند. فقط برای نمودارهای منبع داده پشتیبانی می شود.

aggregateType

enum ( ChartAggregateType )

نوع تجمع برای سری نمودار منبع داده. فقط برای نمودارهای منبع داده پشتیبانی می شود.

type فیلد اتحادیه نوع داده شامل، دقیقاً یک مقدار باید تنظیم شود. type می تواند تنها یکی از موارد زیر باشد:
sourceRange

object ( ChartSourceRange )

محدوده منبع داده ها

columnReference

object ( DataSourceColumnReference )

ارجاع به ستون منبع داده که داده ها از آن خوانده می شوند.

ChartSourceRange

محدوده منبع برای نمودار.

نمایندگی JSON
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
زمینه های
sources[]

object ( GridRange )

محدوده داده ها برای یک سری یا دامنه. دقیقاً یک بعد باید دارای طول 1 باشد، و همه منابع موجود در لیست باید دارای بعد یکسان با طول 1 باشند. دامنه (در صورت وجود) و همه سری ها باید تعداد محدوده منبع یکسانی داشته باشند. اگر از بیش از یک محدوده منبع استفاده می شود، آنگاه محدوده منبع در یک افست معین باید به ترتیب و در سراسر دامنه و سری به هم پیوسته باشد.

به عنوان مثال، این تنظیمات معتبر هستند:

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

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

ChartGroupRule

یک تنظیم اختیاری در ChartData دامنه یک نمودار منبع داده که به جای شکستن هر مقدار جداگانه، سطل هایی را برای مقادیر موجود در دامنه تعریف می کند.

به عنوان مثال، هنگام ترسیم نمودار منبع داده، می توانید یک قانون هیستوگرام را در دامنه مشخص کنید (فقط باید مقادیر عددی داشته باشد)، و مقادیر آن را در سطل گروه بندی کنید. هر مقدار از یک سری نمودار که در یک سطل قرار می گیرد، بر اساس aggregateType جمع می شود.

نمایندگی JSON
{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}
زمینه های
rule میدان اتحادیه قاعده ای که باید در ChartData اعمال شود. rule فقط می تواند یکی از موارد زیر باشد:
dateTimeRule

object ( ChartDateTimeRule )

یک ChartDateTimeRule .

histogramRule

object ( ChartHistogramRule )

یک ChartHistogramRule

ChartDateTimeRule

به شما امکان می‌دهد مقادیر تاریخ-زمان را در یک ستون داده منبع در سطل‌هایی بر اساس بخش‌های انتخاب شده از مقادیر تاریخ یا زمان آنها سازماندهی کنید.

نمایندگی JSON
{
  "type": enum (ChartDateTimeRuleType)
}
زمینه های
type

enum ( ChartDateTimeRuleType )

نوع گروه بندی تاریخ-زمان برای اعمال.

ChartDateTimeRuleType

انواع موجود قوانین گروه بندی تاریخ-زمان.

Enums
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 گروه بندی کنید. توجه داشته باشید که تاریخ های بعد از 29 فوریه در سال های کبیسه در سطل های متفاوتی نسبت به سال های غیر کبیسه قرار می گیرند.
DAY_OF_MONTH تاریخ های گروه بر اساس روز ماه، از 1 تا 31.
DAY_MONTH تاریخ ها را بر اساس روز و ماه گروه بندی کنید، برای مثال 22 تا نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه شده است.
MONTH تاریخ ها را بر اساس ماه گروه بندی کنید، برای مثال نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه می شود.
QUARTER تاریخ ها را بر اساس سه ماهه گروه بندی کنید، برای مثال Q1 (که نشان دهنده ژانویه-مارس است).
YEAR تاریخ های گروه بر اساس سال، به عنوان مثال 2008.
YEAR_MONTH تاریخ های گروه بر اساس سال و ماه، به عنوان مثال 2008- نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه شده است.
YEAR_QUARTER تاریخ های گروه بر اساس سال و سه ماهه، به عنوان مثال Q4 2008.
YEAR_MONTH_DAY تاریخ ها را بر اساس سال، ماه و روز گروه بندی کنید، به عنوان مثال 22-11-2008.

ChartHistogram Rule

به شما امکان می دهد مقادیر عددی را در یک ستون داده منبع در سطل هایی با اندازه ثابت سازماندهی کنید.

نمایندگی JSON
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
زمینه های
minValue

number

حداقل مقداری که اقلام در سطل ها قرار می گیرند. مقادیری که کمتر از حداقل هستند در یک سطل واحد گروه بندی می شوند. اگر حذف شود، با حداقل مقدار مورد تعیین می شود.

maxValue

number

حداکثر مقداری که اقلام در سطل ها قرار می گیرند. مقادیر بیشتر از حداکثر در یک سطل واحد گروه بندی می شوند. اگر حذف شود، با حداکثر مقدار مورد تعیین می شود.

intervalSize

number

اندازه سطل هایی که ایجاد می شود. باید مثبت باشه

ChartAggregateType

نوع تجمع برای سری نمودار.

Enums
CHART_AGGREGATE_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
AVERAGE میانگین تابع کل.
COUNT شمارش تابع کل.
MAX حداکثر تابع کل.
MEDIAN تابع کل میانه.
MIN حداقل تابع کل.
SUM تابع مجموع.

BasicChartSeries

یک سری از داده ها در نمودار. برای مثال، اگر نمودار قیمت سهام در طول زمان مشخص شود، ممکن است چندین سری وجود داشته باشد، یکی برای «قیمت باز»، «قیمت بالا»، «قیمت پایین» و «قیمت بسته».

نمایندگی JSON
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
زمینه های
series

object ( ChartData )

داده هایی که در این سری نمودار تجسم می شوند.

targetAxis

enum ( BasicChartAxisPosition )

محور فرعی که محدوده مقادیر این سری را مشخص می کند. به عنوان مثال، اگر در طول زمان نمودارهای سهام را ترسیم کنید، ممکن است سری "حجم" بخواهد به سمت راست و قیمت ها به سمت چپ سنجاق شود، زیرا مقیاس حجم معاملات با مقیاس قیمت ها متفاوت است. تعیین محوری که یک محور فرعی معتبر برای type نمودار نیست یک خطا است.

type

enum ( BasicChartType )

نوع این سریال. فقط در صورتی معتبر است که chartType COMBO باشد. انواع مختلف نحوه تجسم سریال را تغییر خواهند داد. فقط LINE ، AREA ، و COLUMN پشتیبانی می شوند.

lineStyle

object ( LineStyle )

سبک خط این سریال. فقط در صورتی معتبر است که chartType AREA ، LINE یا SCATTER باشد. اگر series chart type AREA یا LINE باشد، نمودارهای COMBO نیز پشتیبانی می شوند.

dataLabel

object ( DataLabel )

اطلاعات در مورد برچسب های داده برای این سری.

color
(deprecated)

object ( Color )

رنگ عناصر (مانند میله ها، خطوط و نقاط) مرتبط با این سری. اگر خالی باشد، یک رنگ پیش فرض استفاده می شود. منسوخ شده: از colorStyle استفاده کنید.

colorStyle

object ( ColorStyle )

رنگ عناصر (مانند میله ها، خطوط و نقاط) مرتبط با این سری. اگر خالی باشد، یک رنگ پیش فرض استفاده می شود. اگر color نیز تنظیم شده باشد، این قسمت اولویت دارد.

pointStyle

object ( PointStyle )

سبک برای نقاط مرتبط با این سری. فقط در صورتی معتبر است که chartType AREA ، LINE یا SCATTER باشد. اگر series chart type AREA ، LINE ، یا SCATTER باشد، نمودارهای COMBO نیز پشتیبانی می شوند. اگر خالی باشد، از یک سبک نقطه پیش فرض استفاده می شود.

styleOverrides[]

object ( BasicSeriesDataPointStyleOverride )

تنظیمات نادیده گرفتن سبک برای نقاط داده سری.

لاین استایل

ویژگی هایی که سبک یک خط را توصیف می کند.

نمایندگی JSON
{
  "width": integer,
  "type": enum (LineDashType)
}
زمینه های
width

integer

ضخامت خط، بر حسب px.

type

enum ( LineDashType )

نوع خط تیره.

LineDashType

نوع خط تیره یک خط.

Enums
LINE_DASH_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
INVISIBLE بدون نوع خط تیره، که معادل یک خط غیر قابل مشاهده است.
CUSTOM خط تیره سفارشی برای یک خط. اصلاح سبک خط تیره سفارشی دقیق در حال حاضر پشتیبانی نمی شود.
SOLID یک خط ثابت
DOTTED یک خط نقطه چین.
MEDIUM_DASHED خط چین که در آن خط تیره ها دارای طول "متوسط" هستند.
MEDIUM_DASHED_DOTTED خطی که به طور متناوب بین یک خط تیره «متوسط» و یک نقطه تغییر می کند.
LONG_DASHED یک خط چین که در آن خط تیره ها دارای طول "طولانی" هستند.
LONG_DASHED_DOTTED خطی که به طور متناوب بین یک خط تیره "بلند" و یک نقطه تغییر می کند.

DataLabel

تنظیمات برای یک مجموعه از برچسب های داده. برچسب‌های داده، حاشیه‌نویسی‌هایی هستند که در کنار مجموعه‌ای از داده‌ها، مانند نقاط روی نمودار خطی ظاهر می‌شوند و اطلاعات بیشتری درباره آنچه که داده‌ها نشان می‌دهند، ارائه می‌دهند، مانند نمایش متنی مقدار پشت آن نقطه در نمودار.

نمایندگی JSON
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
زمینه های
type

enum ( DataLabelType )

نوع برچسب داده

textFormat

object ( TextFormat )

قالب متنی که برای برچسب داده استفاده می شود. فیلد پیوند پشتیبانی نمی شود.

placement

enum ( DataLabelPlacement )

قرار دادن برچسب داده ها نسبت به داده های برچسب دار.

customLabelData

object ( ChartData )

داده هایی برای استفاده برای برچسب های سفارشی. فقط در صورتی استفاده می شود که type روی CUSTOM تنظیم شده باشد. طول این داده باید به اندازه سری یا عنصر دیگری باشد که این برچسب داده روی آن اعمال می شود. علاوه بر این، اگر سری به چندین محدوده منبع تقسیم شود، این داده منبع باید از ستون بعدی در داده منبع آمده باشد. به عنوان مثال، اگر سری B2:B4،E6:E8 باشد، این داده باید از C2:C4،F6:F8 آمده باشد.

DataLabelType

نوع برچسب داده

Enums
DATA_LABEL_TYPE_UNSPECIFIED نوع برچسب داده مشخص نشده است و بسته به بافت برچسب داده در نمودار تفسیر می شود.
NONE برچسب داده نمایش داده نمی شود.
DATA برچسب داده با استفاده از مقادیر داده های سری نمایش داده می شود.
CUSTOM برچسب داده با استفاده از مقادیر یک منبع داده سفارشی نشان داده شده توسط customLabelData نمایش داده می شود.

DataLabel Placement

قرار دادن یک برچسب داده نسبت به داده های برچسب دار.

Enums
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 )

شکل نقطه. اگر خالی یا نامشخص باشد، یک شکل پیش فرض استفاده می شود.

شکل نقطه

شکل یک نقطه.

Enums
POINT_SHAPE_UNSPECIFIED مقدار پیش فرض.
CIRCLE شکل دایره ای
DIAMOND یک شکل الماس
HEXAGON یک شکل شش ضلعی.
PENTAGON شکل پنج ضلعی
SQUARE یک شکل مربع
STAR یک شکل ستاره
TRIANGLE مثلثی شکل
X_MARK یک شکل علامت ایکس.

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 )

سبک نقطه نقطه داده سری. فقط در صورتی معتبر است که chartType AREA ، LINE یا SCATTER باشد. اگر series chart type AREA ، LINE ، یا SCATTER باشد، نمودارهای COMBO نیز پشتیبانی می شوند. اگر خالی باشد، پیش فرض سری استفاده می شود.

BasicChartStackedType

هنگامی که نمودارها روی هم چیده می شوند، مقادیر محدوده (محور عمودی) به جای محور افقی، روی هم نمایش داده می شوند. به عنوان مثال، دو مقدار 20 و 80 از 0 ترسیم می شوند که 80 در فاصله 80 واحدی از محور افقی قرار دارد. اگر انباشته می شدند، 80 از 20 رندر می شد و آن را در فاصله 100 واحدی از محور افقی قرار می داد.

Enums
BASIC_CHART_STACKED_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
NOT_STACKED سری ها روی هم چیده نمی شوند.
STACKED مقادیر سری انباشته می شوند، هر مقدار به صورت عمودی از بالای مقدار زیر آن شروع می شود.
PERCENT_STACKED پشته‌های عمودی برای رسیدن به بالای نمودار کشیده می‌شوند و مقادیر به صورت درصد از یکدیگر نشان داده می‌شوند.

BasicChartCompareMode

نوع حالت مقایسه، که رفتار نکات ابزار و برجسته‌سازی داده‌ها را هنگام شناور کردن روی داده‌ها و ناحیه نمودار توصیف می‌کند.

Enums
BASIC_CHART_COMPARE_MODE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
DATUM فقط عنصر داده متمرکز برجسته شده و در راهنمای ابزار نشان داده می شود.
CATEGORY همه عناصر داده با یک دسته (به عنوان مثال، مقدار دامنه) برجسته شده و در راهنمای ابزار نشان داده می شوند.

PieChartSpec

نمودار دایره ای

نمایندگی JSON
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
زمینه های
legendPosition

enum ( PieChartLegendPosition )

جایی که افسانه نمودار دایره ای باید رسم شود.

domain

object ( ChartData )

داده هایی که دامنه نمودار دایره ای را پوشش می دهد.

series

object ( ChartData )

داده هایی که یک و تنها سری نمودار دایره ای را پوشش می دهد.

threeDimensional

boolean

اگر پای سه بعدی باشد درست است.

pieHole

number

اندازه سوراخ در نمودار دایره ای.

PieChartLegendPosition

جایی که افسانه نمودار باید قرار گیرد.

Enums
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 )

داده های حاوی شناسه های گروه حباب. همه حباب ها با شناسه گروه یکسان به یک رنگ کشیده می شوند. اگر 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

جایی که افسانه نمودار باید قرار گیرد.

Enums
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
BOTTOM_LEGEND افسانه در پایین نمودار ارائه شده است.
LEFT_LEGEND افسانه در سمت چپ نمودار ارائه شده است.
RIGHT_LEGEND افسانه در سمت راست نمودار ارائه شده است.
TOP_LEGEND افسانه در بالای نمودار ارائه شده است.
NO_LEGEND هیچ افسانه ای ارائه نمی شود.
INSIDE_LEGEND افسانه در داخل منطقه نمودار ارائه شده است.

CandlestickChartSpec

نمودار شمعدانی

نمایندگی JSON
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
زمینه های
domain

object ( CandlestickDomain )

داده های دامنه (محور افقی) برای نمودار کندل استیک. داده‌های رشته‌ای به عنوان برچسب‌های مجزا در نظر گرفته می‌شوند و سایر داده‌ها به عنوان مقادیر پیوسته در نظر گرفته می‌شوند.

data[]

object ( CandlestickData )

داده های نمودار کندل استیک. فقط یک CandlestickData پشتیبانی می شود.

CandlestickDomain

دامنه یک CandlestickChart.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
data

object ( ChartData )

داده های CandlestickDomain.

reversed

boolean

درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی).

CandlestickData

داده های نمودار Candlestick که هر کدام شامل مقادیر کم، باز، بسته و زیاد برای یک سری هستند.

نمایندگی 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 )

داده های محدوده (محور عمودی) برای مقدار زیاد/حداکثر برای هر کندل. این قسمت بالای خط مرکزی شمع است.

Candlestick Series

سری یک CandlestickData.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  }
}
زمینه های
data

object ( ChartData )

داده های CandlestickSeries.

OrgChartSpec

نمودار سازمانی نمودارهای سازمانی به مجموعه منحصربه‌فردی از برچسب‌ها در labels نیاز دارند و ممکن است به صورت اختیاری شامل parentLabels و tooltips باشند. parentLabels برای هر گره حاوی برچسبی است که گره والد را مشخص می کند. tooltips شامل، برای هر گره، یک راهنمای اختیاری است.

به عنوان مثال، برای توصیف یک نمودار ارگ با آلیس به عنوان مدیر عامل، باب به عنوان رئیس (گزارش دهنده به آلیس) و کتی به عنوان معاون فروش (همچنین به آلیس گزارش می دهد)، labels حاوی "آلیس"، "باب"، "کتی"، parentLabels شامل «»، «آلیس»، «آلیس» و tooltips حاوی «مدیرعامل»، «رئیس‌جمهور»، «فروشگاه معاونت» است.

نمایندگی 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

اندازه گره های نمودار سازمانی.

Enums
ORG_CHART_LABEL_SIZE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
SMALL اندازه گره نمودار سازمانی کوچک.
MEDIUM اندازه گره نمودار سازمانی متوسط.
LARGE اندازه گره نمودار سازمانی بزرگ.

HistogramChartSpec

نمودار هیستوگرام یک نمودار هیستوگرام اقلام داده را در سطل ها گروه بندی می کند و هر سطل را به عنوان ستونی از موارد انباشته نشان می دهد. هیستوگرام برای نمایش توزیع یک مجموعه داده استفاده می شود. هر ستون از آیتم ها محدوده ای را نشان می دهد که آن آیتم ها در آن قرار می گیرند. تعداد سطل ها را می توان به طور خودکار انتخاب کرد یا به صراحت مشخص کرد.

نمایندگی JSON
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
زمینه های
series[]

object ( HistogramSeries )

سری برای یک هیستوگرام ممکن است یک سری از مقادیر منفرد برای سطل یا چند سری باشد که هر کدام با طول یکسان، حاوی نام سری و به دنبال آن مقادیری باشد که باید برای آن سری سطل شوند.

legendPosition

enum ( HistogramChartLegendPosition )

موقعیت افسانه نمودار.

showItemDividers

boolean

آیا خطوط تقسیم افقی باید بین موارد در هر ستون نمایش داده شود یا خیر.

bucketSize

number

به‌طور پیش‌فرض، اندازه سطل (محدوده مقادیر روی هم در یک ستون) به‌طور خودکار انتخاب می‌شود، اما ممکن است در اینجا لغو شود. به عنوان مثال، اندازه سطل 1.5 منجر به سطل هایی از 0 - 1.5، 1.5 - 3.0 و غیره می شود. نمی تواند منفی باشد. این فیلد اختیاری است.

outlierPercentile

number

صدک پرت برای اطمینان از عدم تأثیر منفی بر محاسبه اندازه سطل استفاده می شود. به عنوان مثال، تنظیم یک صدک پرت 0.05 نشان می دهد که 5٪ بالا و پایین مقادیر هنگام محاسبه سطل ها. مقادیر همچنان در نمودار گنجانده شده است، آنها به جای سطل های خود به اولین یا آخرین سطل اضافه می شوند. باید بین 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

جایی که افسانه نمودار باید قرار گیرد.

Enums
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

درست برای پنهان کردن خطوط اتصال بین ستون ها.

connectorLineStyle

object ( LineStyle )

سبک خط برای خطوط اتصال.

totalDataLabel

object ( DataLabel )

کنترل می کند که آیا برچسب های داده های اضافی در نمودارهای انباشته نمایش داده شود که مجموع ارزش کل همه مقادیر انباشته شده در هر مقدار در امتداد محور دامنه است. stackedType باید STACKED باشد و نه CUSTOM و نه placement نمی توان روی totalDataLabel تنظیم کرد.

WaterfallChartDomain

دامنه نمودار آبشار.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
data

object ( ChartData )

داده های WaterfallChartDomain.

reversed

boolean

درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی).

WaterfallChart Series

یک سری از داده ها برای نمودار آبشار.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
زمینه های
data

object ( ChartData )

داده هایی که در این مجموعه به تصویر کشیده می شوند.

positiveColumnsStyle

object ( WaterfallChartColumnStyle )

سبک‌های همه ستون‌های این سری با مقادیر مثبت.

negativeColumnsStyle

object ( WaterfallChartColumnStyle )

سبک‌های همه ستون‌های این سری با مقادیر منفی.

subtotalColumnsStyle

object ( WaterfallChartColumnStyle )

سبک‌ها برای تمام ستون‌های فرعی در این سری.

hideTrailingSubtotal

boolean

درست است برای پنهان کردن ستون فرعی از انتهای سری. به طور پیش فرض، یک ستون فرعی در پایان هر سری ظاهر می شود. تنظیم این فیلد روی true، ستون فرعی این سری را پنهان می کند.

customSubtotals[]

object ( WaterfallChartCustomSubtotal )

ستون های فرعی سفارشی که در این سری ظاهر می شوند. ترتیب تعریف مجموع فرعی مهم نیست. برای هر نقطه داده فقط یک جمع فرعی ممکن است تعریف شود.

dataLabel

object ( DataLabel )

اطلاعات در مورد برچسب های داده برای این سری.

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 درست باشد، نقطه داده در این شاخص کل فرعی است. در غیر این صورت، جمع فرعی بعد از نقطه داده با این شاخص ظاهر می شود. یک سری می‌تواند چندین جمع فرعی در شاخص‌های دلخواه داشته باشد، اما جمع‌های فرعی بر شاخص‌های نقاط داده تأثیری ندارند. به عنوان مثال، اگر یک سری دارای سه نقطه داده باشد، شاخص های آنها همیشه 0، 1 و 2 خواهد بود، صرف نظر از اینکه چه تعداد زیرمجموعه در سری وجود دارد یا با چه نقاط داده ای مرتبط هستند.

label

string

یک برچسب برای ستون فرعی.

dataIsSubtotal

boolean

درست است اگر نقطه داده در subtotalIndex جمع فرعی باشد. اگر نادرست باشد، جمع فرعی محاسبه می شود و بعد از نقطه داده ظاهر می شود.

WaterfallChartStackedType

گزینه های نوع انباشته برای نمودارهای آبشار.

Enums
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 یا حداقل مقدار از sizeData در صورتی که colorData مشخص نشده باشد، پیش‌فرض می‌شود.

maxValue

number

حداکثر مقدار داده ممکن سلول هایی با مقادیر بیشتر از این همان رنگ سلول های با این مقدار را خواهند داشت. اگر مشخص نشده باشد، مقدار حداکثر واقعی را از colorData یا حداکثر مقدار را از sizeData در صورتی که colorData مشخص نشده باشد، پیش‌فرض می‌کند.

headerColor
(deprecated)

object ( Color )

رنگ پس زمینه برای سلول های هدر. منسوخ شده: از headerColorStyle استفاده کنید.

headerColorStyle

object ( ColorStyle )

رنگ پس زمینه برای سلول های هدر. اگر headerColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

colorScale

object ( TreemapChartColorScale )

مقیاس رنگ برای سلول های داده در نمودار درختی. به سلول های داده رنگ ها بر اساس مقادیر رنگ آنها اختصاص داده می شود. این مقادیر رنگ از colorData یا از sizeData می‌آیند اگر colorData مشخص نشده باشد. سلول هایی با مقادیر رنگ کمتر یا مساوی minValue دارای minValueColor به عنوان رنگ پس زمینه خواهند بود. سلول هایی با مقادیر رنگ بزرگتر یا مساوی maxValue دارای maxValueColor به عنوان رنگ پس زمینه خواهند بود. سلول‌های دارای مقادیر رنگ بین minValue و maxValue دارای رنگ‌های پس‌زمینه بر روی یک گرادیان بین minValueColor و maxValueColor خواهند بود که نقطه وسط گرادیان midValueColor است. سلول‌های دارای مقادیر رنگ از دست رفته یا غیرعددی، رنگ پس‌زمینه‌شان را noDataColor خواهند داشت.

hideTooltips

boolean

درست برای پنهان کردن نکات ابزار.

TreemapChartColorScale

مقیاس رنگی برای نمودار درختی.

نمایندگی JSON
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
زمینه های
minValueColor
(deprecated)

object ( Color )

رنگ پس زمینه سلول هایی با مقدار رنگ کمتر یا مساوی minValue . اگر مشخص نشده باشد به طور پیش‌فرض به #dc3912 می‌رسد. منسوخ شده: از minValueColorStyle استفاده کنید.

minValueColorStyle

object ( ColorStyle )

رنگ پس زمینه سلول هایی با مقدار رنگ کمتر یا مساوی minValue . اگر مشخص نشده باشد به طور پیش‌فرض به #dc3912 می‌رسد. اگر minValueColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

midValueColor
(deprecated)

object ( Color )

رنگ پس زمینه سلول هایی با مقدار رنگ در نقطه میانی بین minValue و maxValue . اگر مشخص نشده باشد به طور پیش‌فرض به #efe6dc می‌رسد. منسوخ شده: از midValueColorStyle استفاده کنید.

midValueColorStyle

object ( ColorStyle )

رنگ پس زمینه سلول هایی با مقدار رنگ در نقطه میانی بین minValue و maxValue . اگر مشخص نشده باشد به طور پیش‌فرض به #efe6dc می‌رسد. اگر midValueColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

maxValueColor
(deprecated)

object ( Color )

رنگ پس زمینه سلول هایی با مقدار رنگ بزرگتر یا مساوی maxValue . اگر مشخص نشده باشد، پیش‌فرض به #109618 می‌رسد. منسوخ شده: از maxValueColorStyle استفاده کنید.

maxValueColorStyle

object ( ColorStyle )

رنگ پس زمینه سلول هایی با مقدار رنگ بزرگتر یا مساوی maxValue . اگر مشخص نشده باشد، پیش‌فرض به #109618 می‌رسد. اگر maxValueColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

noDataColor
(deprecated)

object ( Color )

رنگ پس زمینه برای سلول هایی که هیچ داده رنگی مرتبط با آنها ندارند. اگر مشخص نشده باشد به طور پیش‌فرض به #000000 می‌رسد. منسوخ شده: از noDataColorStyle استفاده کنید.

noDataColorStyle

object ( ColorStyle )

رنگ پس زمینه برای سلول هایی که هیچ داده رنگی مرتبط با آنها ندارند. اگر مشخص نشده باشد به طور پیش‌فرض به #000000 می‌رسد. اگر noDataColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

ScorecardChartSpec

نمودار کارت امتیازی نمودارهای کارت امتیازی برای برجسته کردن شاخص‌های کلیدی عملکرد، معروف به KPI، در صفحه‌گسترده استفاده می‌شوند. نمودار کارت امتیازی می تواند مواردی مانند فروش کل، هزینه متوسط ​​یا یک کالای پرفروش را نشان دهد. شما می توانید یک مقدار داده را مشخص کنید، یا در محدوده ای از داده ها را جمع آوری کنید. درصد یا تفاوت مطلق از یک مقدار پایه را می توان برجسته کرد، مانند تغییرات در طول زمان.

نمایندگی JSON
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
زمینه های
keyValueData

object ( ChartData )

داده ها برای ارزش کلید کارت امتیازی.

baselineValueData

object ( ChartData )

داده ها برای ارزش پایه کارت امتیازی. این فیلد اختیاری است.

aggregateType

enum ( ChartAggregateType )

نوع تجمیع برای داده های نمودار کلیدی و پایه در نمودار کارت امتیازی. این فیلد برای نمودارهای منبع داده پشتیبانی نمی شود. به جای آن از فیلد ChartData.aggregateType keyValueData یا baselineValueData برای نمودارهای منبع داده استفاده کنید. این فیلد اختیاری است.

keyValueFormat

object ( KeyValueFormat )

گزینه های قالب بندی برای مقدار کلید.

baselineValueFormat

object ( BaselineValueFormat )

گزینه های قالب بندی برای مقدار پایه. این فیلد فقط در صورتی مورد نیاز است که baselineValueData مشخص شده باشد.

scaleFactor

number

ارزش به مقیاس کلید کارت امتیازی و ارزش پایه. برای مثال می توان از ضریب 10 برای تقسیم تمام مقادیر نمودار بر 10 استفاده کرد. این فیلد اختیاری است.

numberFormatSource

enum ( ChartNumberFormatSource )

منبع قالب عددی استفاده شده در نمودار کارت امتیازی. این فیلد اختیاری است.

customFormatOptions

object ( ChartCustomNumberFormatOptions )

گزینه های قالب بندی سفارشی برای مقادیر کلید عددی/خط پایه در نمودار کارت امتیازی. This field is used only when numberFormatSource is set to CUSTOM . This field is optional.

KeyValueFormat

Formatting options for key value.

نمایندگی JSON
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
زمینه های
textFormat

object ( TextFormat )

Text formatting options for key value. The link field is not supported.

position

object ( TextPosition )

Specifies the horizontal text positioning of key value. This field is optional. If not specified, default positioning is used.

BaselineValueFormat

Formatting options for baseline value.

نمایندگی 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 )

The comparison type of key value with baseline value.

textFormat

object ( TextFormat )

Text formatting options for baseline value. The link field is not supported.

position

object ( TextPosition )

Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used.

description

string

Description which is appended after the baseline value. This field is optional.

positiveColor
(deprecated)

object ( Color )

Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use positiveColorStyle .

positiveColorStyle

object ( ColorStyle )

Color to be used, in case baseline value represents a positive change for key value. This field is optional. If positiveColor is also set, this field takes precedence.

negativeColor
(deprecated)

object ( Color )

Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use negativeColorStyle .

negativeColorStyle

object ( ColorStyle )

Color to be used, in case baseline value represents a negative change for key value. This field is optional. If negativeColor is also set, this field takes precedence.

ComparisonType

The comparison type of key value with baseline value.

Enums
COMPARISON_TYPE_UNDEFINED Default value, do not use.
ABSOLUTE_DIFFERENCE Use absolute difference between key and baseline value.
PERCENTAGE_DIFFERENCE Use percentage difference between key and baseline value.

ChartNumberFormatSource

The number formatting source options for chart attributes.

Enums
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Default value, do not use.
FROM_DATA Inherit number formatting from data.
CUSTOM Apply custom formatting as specified by ChartCustomNumberFormatOptions .

ChartCustomNumberFormatOptions

Custom number formatting options for chart attributes.

نمایندگی JSON
{
  "prefix": string,
  "suffix": string
}
زمینه های
prefix

string

Custom prefix to be prepended to the chart attribute. This field is optional.

suffix

string

Custom suffix to be appended to the chart attribute. This field is optional.

ChartHiddenDimensionStrategy

Determines how charts should handle source rows that are hidden. Hidden rows include both manually hidden and hidden by a filter.

Enums
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Default value, do not use.
SKIP_HIDDEN_ROWS_AND_COLUMNS Charts will skip hidden rows and columns.
SKIP_HIDDEN_ROWS Charts will skip hidden rows only.
SKIP_HIDDEN_COLUMNS Charts will skip hidden columns only.
SHOW_ALL Charts will not skip any hidden rows or columns.

EmbeddedObjectBorder

A border along an embedded object.

نمایندگی JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
زمینه های
color
(deprecated)

object ( Color )

The color of the border. Deprecated: Use colorStyle .

colorStyle

object ( ColorStyle )

The color of the border. If color is also set, this field takes precedence.

،

EmbeddedChart

A chart embedded in a sheet.

نمایندگی JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
زمینه های
chartId

integer

The ID of the chart.

spec

object ( ChartSpec )

The specification of the chart.

position

object ( EmbeddedObjectPosition )

The position of the chart.

border

object ( EmbeddedObjectBorder )

The border of the chart.

ChartSpec

The specifications of a chart.

نمایندگی 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

The title of the chart.

altText

string

The alternative text that describes the chart. This is often used for accessibility.

titleTextFormat

object ( TextFormat )

The title text format. Strikethrough, underline, and link are not supported.

titleTextPosition

object ( TextPosition )

The title text position. This field is optional.

subtitle

string

The subtitle of the chart.

subtitleTextFormat

object ( TextFormat )

The subtitle text format. Strikethrough, underline, and link are not supported.

subtitleTextPosition

object ( TextPosition )

The subtitle text position. This field is optional.

fontName

string

The name of the font to use by default for all chart text (eg title, axis labels, legend). If a font is specified for a specific part of the chart it will override this font name.

maximized

boolean

True to make a chart fill the entire space in which it's rendered with minimum padding. False to use the default padding. (Not applicable to Geo and Org charts.)

backgroundColor
(deprecated)

object ( Color )

The background color of the entire chart. Not applicable to Org charts. Deprecated: Use backgroundColorStyle .

backgroundColorStyle

object ( ColorStyle )

The background color of the entire chart. Not applicable to Org charts. If backgroundColor is also set, this field takes precedence.

dataSourceChartProperties

object ( DataSourceChartProperties )

If present, the field contains data source chart specific properties.

filterSpecs[]

object ( FilterSpec )

The filters applied to the source data of the chart. Only supported for data source charts.

sortSpecs[]

object ( SortSpec )

The order to sort the chart data by. Only a single sort spec is supported. Only supported for data source charts.

hiddenDimensionStrategy

enum ( ChartHiddenDimensionStrategy )

Determines how the charts will use hidden rows or columns.

Union field chart . The specific chart specification, exactly one value must be set. chart can be only one of the following:
basicChart

object ( BasicChartSpec )

A basic chart specification, can be one of many kinds of charts. See BasicChartType for the list of all charts this supports.

pieChart

object ( PieChartSpec )

A pie chart specification.

bubbleChart

object ( BubbleChartSpec )

A bubble chart specification.

candlestickChart

object ( CandlestickChartSpec )

A candlestick chart specification.

orgChart

object ( OrgChartSpec )

An org chart specification.

histogramChart

object ( HistogramChartSpec )

A histogram chart specification.

waterfallChart

object ( WaterfallChartSpec )

A waterfall chart specification.

treemapChart

object ( TreemapChartSpec )

A treemap chart specification.

scorecardChart

object ( ScorecardChartSpec )

A scorecard chart specification.

TextPosition

Position settings for text.

نمایندگی JSON
{
  "horizontalAlignment": enum (HorizontalAlign)
}
زمینه های
horizontalAlignment

enum ( HorizontalAlign )

Horizontal alignment setting for the piece of text.

DataSourceChartProperties

Properties of a data source chart.

نمایندگی JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
زمینه های
dataSourceId

string

ID of the data source that the chart is associated with.

dataExecutionStatus

object ( DataExecutionStatus )

فقط خروجی The data execution status.

BasicChartSpec

The specification for a basic chart. See BasicChartType for the list of charts this supports.

نمایندگی 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 )

The type of the chart.

legendPosition

enum ( BasicChartLegendPosition )

The position of the chart legend.

axis[]

object ( BasicChartAxis )

The axis on the chart.

domains[]

object ( BasicChartDomain )

The domain of data this is charting. Only a single domain is supported.

series[]

object ( BasicChartSeries )

The data this chart is visualizing.

headerCount

integer

The number of rows or columns in the data that are "headers". If not set, Google Sheets will guess how many rows are headers based on the data.

(Note that BasicChartAxis.title may override the axis title inferred from the header values.)

threeDimensional

boolean

True to make the chart 3D. Applies to Bar and Column charts.

interpolateNulls

boolean

If some values in a series are missing, gaps may appear in the chart (eg, segments of lines in a line chart will be missing). To eliminate these gaps set this to true. Applies to Line, Area, and Combo charts.

stackedType

enum ( BasicChartStackedType )

The stacked type for charts that support vertical stacking. Applies to Area, Bar, Column, Combo, and Stepped Area charts.

lineSmoothing

boolean

Gets whether all lines should be rendered smooth or straight by default. Applies to Line charts.

compareMode

enum ( BasicChartCompareMode )

The behavior of tooltips and data highlighting when hovering on data and chart area.

totalDataLabel

object ( DataLabel )

Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. These data labels can only be set when chartType is one of AREA , BAR , COLUMN , COMBO or STEPPED_AREA and stackedType is either STACKED or PERCENT_STACKED . In addition, for COMBO , this will only be supported if there is only one type of stackable series type or one type has more series than the others and each of the other types have no more than one series. For example, if a chart has two stacked bar series and one area series, the total data labels will be supported. If it has three bar series and two area series, total data labels are not allowed. Neither CUSTOM nor placement can be set on the totalDataLabel .

BasicChartType

How the chart should be visualized.

Enums
BASIC_CHART_TYPE_UNSPECIFIED Default value, do not use.
BAR A bar chart .
LINE A line chart .
AREA An area chart .
COLUMN A column chart .
SCATTER A scatter chart .
COMBO A combo chart .
STEPPED_AREA A stepped area chart .

BasicChartLegendPosition

Where the legend of the chart should be positioned.

Enums
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED Default value, do not use.
BOTTOM_LEGEND The legend is rendered on the bottom of the chart.
LEFT_LEGEND The legend is rendered on the left of the chart.
RIGHT_LEGEND The legend is rendered on the right of the chart.
TOP_LEGEND The legend is rendered on the top of the chart.
NO_LEGEND No legend is rendered.

BasicChartAxis

An axis of the chart. A chart may not have more than one axis per axis position .

نمایندگی JSON
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
زمینه های
position

enum ( BasicChartAxisPosition )

The position of this axis.

title

string

The title of this axis. If set, this overrides any title inferred from headers of the data.

format

object ( TextFormat )

The format of the title. Only valid if the axis is not associated with the domain. The link field is not supported.

titleTextPosition

object ( TextPosition )

The axis title text position.

viewWindowOptions

object ( ChartAxisViewWindowOptions )

The view window options for this axis.

BasicChartAxisPosition

The position of a chart axis.

Enums
BASIC_CHART_AXIS_POSITION_UNSPECIFIED Default value, do not use.
BOTTOM_AXIS The axis rendered at the bottom of a chart. For most charts, this is the standard major axis. For bar charts, this is a minor axis.
LEFT_AXIS The axis rendered at the left of a chart. For most charts, this is a minor axis. For bar charts, this is the standard major axis.
RIGHT_AXIS The axis rendered at the right of a chart. For most charts, this is a minor axis. For bar charts, this is an unusual major axis.

ChartAxisViewWindowOptions

The options that define a "view window" for a chart (such as the visible values in an axis).

نمایندگی JSON
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
زمینه های
viewWindowMin

number

The minimum numeric value to be shown in this view window. If unset, will automatically determine a minimum value that looks good for the data.

viewWindowMax

number

The maximum numeric value to be shown in this view window. If unset, will automatically determine a maximum value that looks good for the data.

viewWindowMode

enum ( ViewWindowMode )

The view window's mode.

ViewWindowMode

The view window's mode. It defines how to treat the min and max of the view window.

Enums
DEFAULT_VIEW_WINDOW_MODE The default view window mode used in the Sheets editor for this chart type. In most cases, if set, the default mode is equivalent to PRETTY .
VIEW_WINDOW_MODE_UNSUPPORTED Do not use. Represents that the currently set mode is not supported by the API.
EXPLICIT Follows the min and max exactly if specified. If a value is unspecified, it will fall back to the PRETTY value.
PRETTY Chooses a min and max that make the chart look good. Both min and max are ignored in this mode.

BasicChartDomain

The domain of a chart. For example, if charting stock prices over time, this would be the date.

نمایندگی JSON
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
domain

object ( ChartData )

The data of the domain. For example, if charting stock prices over time, this is the data representing the dates.

reversed

boolean

True to reverse the order of the domain values (horizontal axis).

ChartData

The data included in a domain or series.

نمایندگی 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 )

The rule to group the data by if the ChartData backs the domain of a data source chart. Only supported for data source charts.

aggregateType

enum ( ChartAggregateType )

The aggregation type for the series of a data source chart. Only supported for data source charts.

Union field type . The type of data included, exactly one value must be set. type can be only one of the following:
sourceRange

object ( ChartSourceRange )

The source ranges of the data.

columnReference

object ( DataSourceColumnReference )

The reference to the data source column that the data reads from.

ChartSourceRange

Source ranges for a chart.

نمایندگی JSON
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
زمینه های
sources[]

object ( GridRange )

The ranges of data for a series or domain. Exactly one dimension must have a length of 1, and all sources in the list must have the same dimension with length 1. The domain (if it exists) & all series must have the same number of source ranges. If using more than one source range, then the source range at a given offset must be in order and contiguous across the domain and series.

For example, these are valid configurations:

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

An optional setting on the ChartData of the domain of a data source chart that defines buckets for the values in the domain rather than breaking out each individual value.

For example, when plotting a data source chart, you can specify a histogram rule on the domain (it should only contain numeric values), grouping its values into buckets. Any values of a chart series that fall into the same bucket are aggregated based on the 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.
}
زمینه های
Union field rule . The rule to apply to the ChartData . rule can be only one of the following:
dateTimeRule

object ( ChartDateTimeRule )

A ChartDateTimeRule .

histogramRule

object ( ChartHistogramRule )

A ChartHistogramRule

ChartDateTimeRule

Allows you to organize the date-time values in a source data column into buckets based on selected parts of their date or time values.

نمایندگی JSON
{
  "type": enum (ChartDateTimeRuleType)
}
زمینه های
type

enum ( ChartDateTimeRuleType )

The type of date-time grouping to apply.

ChartDateTimeRuleType

The available types of date-time grouping rules.

Enums
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED The default type, do not use.
SECOND Group dates by second, from 0 to 59.
MINUTE Group dates by minute, from 0 to 59.
HOUR Group dates by hour using a 24-hour system, from 0 to 23.
HOUR_MINUTE Group dates by hour and minute using a 24-hour system, for example 19:45.
HOUR_MINUTE_AMPM Group dates by hour and minute using a 12-hour system, for example 7:45 PM. The AM/PM designation is translated based on the spreadsheet locale.
DAY_OF_WEEK Group dates by day of week, for example Sunday. The days of the week will be translated based on the spreadsheet locale.
DAY_OF_YEAR Group dates by day of year, from 1 to 366. Note that dates after Feb. 29 fall in different buckets in leap years than in non-leap years.
DAY_OF_MONTH Group dates by day of month, from 1 to 31.
DAY_MONTH Group dates by day and month, for example 22-Nov. The month is translated based on the spreadsheet locale.
MONTH Group dates by month, for example Nov. The month is translated based on the spreadsheet locale.
QUARTER Group dates by quarter, for example Q1 (which represents Jan-Mar).
YEAR Group dates by year, for example 2008.
YEAR_MONTH Group dates by year and month, for example 2008-Nov. The month is translated based on the spreadsheet locale.
YEAR_QUARTER Group dates by year and quarter, for example 2008 Q4.
YEAR_MONTH_DAY Group dates by year, month, and day, for example 2008-11-22.

ChartHistogramRule

Allows you to organize numeric values in a source data column into buckets of constant size.

نمایندگی JSON
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
زمینه های
minValue

number

The minimum value at which items are placed into buckets. Values that are less than the minimum are grouped into a single bucket. If omitted, it is determined by the minimum item value.

maxValue

number

The maximum value at which items are placed into buckets. Values greater than the maximum are grouped into a single bucket. If omitted, it is determined by the maximum item value.

intervalSize

number

The size of the buckets that are created. Must be positive.

ChartAggregateType

The type of aggregation for chart series.

Enums
CHART_AGGREGATE_TYPE_UNSPECIFIED Default value, do not use.
AVERAGE Average aggregate function.
COUNT Count aggregate function.
MAX Maximum aggregate function.
MEDIAN Median aggregate function.
MIN Minimum aggregate function.
SUM Sum aggregate function.

BasicChartSeries

A single series of data in a chart. For example, if charting stock prices over time, multiple series may exist, one for the "Open Price", "High Price", "Low Price" and "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 )

The data being visualized in this chart series.

targetAxis

enum ( BasicChartAxisPosition )

The minor axis that will specify the range of values for this series. For example, if charting stocks over time, the "Volume" series may want to be pinned to the right with the prices pinned to the left, because the scale of trading volume is different than the scale of prices. It is an error to specify an axis that isn't a valid minor axis for the chart's type .

type

enum ( BasicChartType )

The type of this series. Valid only if the chartType is COMBO . Different types will change the way the series is visualized. Only LINE , AREA , and COLUMN are supported.

lineStyle

object ( LineStyle )

The line style of this series. Valid only if the chartType is AREA , LINE , or SCATTER . COMBO charts are also supported if the series chart type is AREA or LINE .

dataLabel

object ( DataLabel )

Information about the data labels for this series.

color
(deprecated)

object ( Color )

The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. Deprecated: Use colorStyle .

colorStyle

object ( ColorStyle )

The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. If color is also set, this field takes precedence.

pointStyle

object ( PointStyle )

The style for points associated with this series. Valid only if the chartType is AREA , LINE , or SCATTER . COMBO charts are also supported if the series chart type is AREA , LINE , or SCATTER . If empty, a default point style is used.

styleOverrides[]

object ( BasicSeriesDataPointStyleOverride )

Style override settings for series data points.

LineStyle

Properties that describe the style of a line.

نمایندگی JSON
{
  "width": integer,
  "type": enum (LineDashType)
}
زمینه های
width

integer

The thickness of the line, in px.

type

enum ( LineDashType )

The dash type of the line.

LineDashType

The dash type of a line.

Enums
LINE_DASH_TYPE_UNSPECIFIED Default value, do not use.
INVISIBLE No dash type, which is equivalent to a non-visible line.
CUSTOM A custom dash for a line. Modifying the exact custom dash style is currently unsupported.
SOLID A solid line.
DOTTED A dotted line.
MEDIUM_DASHED A dashed line where the dashes have "medium" length.
MEDIUM_DASHED_DOTTED A line that alternates between a "medium" dash and a dot.
LONG_DASHED A dashed line where the dashes have "long" length.
LONG_DASHED_DOTTED A line that alternates between a "long" dash and a dot.

DataLabel

Settings for one set of data labels. Data labels are annotations that appear next to a set of data, such as the points on a line chart, and provide additional information about what the data represents, such as a text representation of the value behind that point on the graph.

نمایندگی JSON
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
زمینه های
type

enum ( DataLabelType )

The type of the data label.

textFormat

object ( TextFormat )

The text format used for the data label. The link field is not supported.

placement

enum ( DataLabelPlacement )

The placement of the data label relative to the labeled data.

customLabelData

object ( ChartData )

Data to use for custom labels. Only used if type is set to CUSTOM . This data must be the same length as the series or other element this data label is applied to. In addition, if the series is split into multiple source ranges, this source data must come from the next column in the source data. For example, if the series is B2:B4,E6:E8 then this data must come from C2:C4,F6:F8.

DataLabelType

The type of a data label.

Enums
DATA_LABEL_TYPE_UNSPECIFIED The data label type is not specified and will be interpreted depending on the context of the data label within the chart.
NONE The data label is not displayed.
DATA The data label is displayed using values from the series data.
CUSTOM The data label is displayed using values from a custom data source indicated by customLabelData .

DataLabelPlacement

The placement of a data label relative to the labeled data.

Enums
DATA_LABEL_PLACEMENT_UNSPECIFIED The positioning is determined automatically by the renderer.
CENTER Center within a bar or column, both horizontally and vertically.
LEFT To the left of a data point.
RIGHT To the right of a data point.
ABOVE Above a data point.
BELOW Below a data point.
INSIDE_END Inside a bar or column at the end (top if positive, bottom if negative).
INSIDE_BASE Inside a bar or column at the base.
OUTSIDE_END Outside a bar or column at the end.

PointStyle

The style of a point on the chart.

نمایندگی JSON
{
  "size": number,
  "shape": enum (PointShape)
}
زمینه های
size

number

The point size. If empty, a default size is used.

shape

enum ( PointShape )

The point shape. If empty or unspecified, a default shape is used.

PointShape

The shape of a point.

Enums
POINT_SHAPE_UNSPECIFIED Default value.
CIRCLE A circle shape.
DIAMOND A diamond shape.
HEXAGON A hexagon shape.
PENTAGON A pentagon shape.
SQUARE A square shape.
STAR A star shape.
TRIANGLE A triangle shape.
X_MARK An x-mark shape.

BasicSeriesDataPointStyleOverride

Style override settings for a single series data point.

نمایندگی JSON
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
زمینه های
index

integer

The zero-based index of the series data point.

color
(deprecated)

object ( Color )

Color of the series data point. If empty, the series default is used. Deprecated: Use colorStyle .

colorStyle

object ( ColorStyle )

Color of the series data point. If empty, the series default is used. If color is also set, this field takes precedence.

pointStyle

object ( PointStyle )

Point style of the series data point. Valid only if the chartType is AREA , LINE , or SCATTER . COMBO charts are also supported if the series chart type is AREA , LINE , or SCATTER . If empty, the series default is used.

BasicChartStackedType

When charts are stacked, range (vertical axis) values are rendered on top of one another rather than from the horizontal axis. For example, the two values 20 and 80 would be drawn from 0, with 80 being 80 units away from the horizontal axis. If they were stacked, 80 would be rendered from 20, putting it 100 units away from the horizontal axis.

Enums
BASIC_CHART_STACKED_TYPE_UNSPECIFIED Default value, do not use.
NOT_STACKED Series are not stacked.
STACKED Series values are stacked, each value is rendered vertically beginning from the top of the value below it.
PERCENT_STACKED Vertical stacks are stretched to reach the top of the chart, with values laid out as percentages of each other.

BasicChartCompareMode

The compare mode type, which describes the behavior of tooltips and data highlighting when hovering on data and chart area.

Enums
BASIC_CHART_COMPARE_MODE_UNSPECIFIED Default value, do not use.
DATUM Only the focused data element is highlighted and shown in the tooltip.
CATEGORY All data elements with the same category (eg, domain value) are highlighted and shown in the tooltip.

PieChartSpec

A pie chart .

نمایندگی JSON
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
زمینه های
legendPosition

enum ( PieChartLegendPosition )

Where the legend of the pie chart should be drawn.

domain

object ( ChartData )

The data that covers the domain of the pie chart.

series

object ( ChartData )

The data that covers the one and only series of the pie chart.

threeDimensional

boolean

True if the pie is three dimensional.

pieHole

number

The size of the hole in the pie chart.

PieChartLegendPosition

Where the legend of the chart should be positioned.

Enums
PIE_CHART_LEGEND_POSITION_UNSPECIFIED Default value, do not use.
BOTTOM_LEGEND The legend is rendered on the bottom of the chart.
LEFT_LEGEND The legend is rendered on the left of the chart.
RIGHT_LEGEND The legend is rendered on the right of the chart.
TOP_LEGEND The legend is rendered on the top of the chart.
NO_LEGEND No legend is rendered.
LABELED_LEGEND Each pie slice has a label attached to it.

BubbleChartSpec

A bubble chart .

نمایندگی 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 )

Where the legend of the chart should be drawn.

bubbleLabels

object ( ChartData )

The data containing the bubble labels. These do not need to be unique.

domain

object ( ChartData )

The data containing the bubble x-values. These values locate the bubbles in the chart horizontally.

series

object ( ChartData )

The data containing the bubble y-values. These values locate the bubbles in the chart vertically.

groupIds

object ( ChartData )

The data containing the bubble group IDs. All bubbles with the same group ID are drawn in the same color. If bubbleSizes is specified then this field must also be specified but may contain blank values. This field is optional.

bubbleSizes

object ( ChartData )

The data containing the bubble sizes. Bubble sizes are used to draw the bubbles at different sizes relative to each other. If specified, groupIds must also be specified. This field is optional.

bubbleOpacity

number

The opacity of the bubbles between 0 and 1.0. 0 is fully transparent and 1 is fully opaque.

bubbleBorderColor
(deprecated)

object ( Color )

The bubble border color. Deprecated: Use bubbleBorderColorStyle .

bubbleBorderColorStyle

object ( ColorStyle )

The bubble border color. If bubbleBorderColor is also set, this field takes precedence.

bubbleMaxRadiusSize

integer

The max radius size of the bubbles, in pixels. If specified, the field must be a positive value.

bubbleMinRadiusSize

integer

The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value.

bubbleTextStyle

object ( TextFormat )

The format of the text inside the bubbles. Strikethrough, underline, and link are not supported.

BubbleChartLegendPosition

Where the legend of the chart should be positioned.

Enums
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED Default value, do not use.
BOTTOM_LEGEND The legend is rendered on the bottom of the chart.
LEFT_LEGEND The legend is rendered on the left of the chart.
RIGHT_LEGEND The legend is rendered on the right of the chart.
TOP_LEGEND The legend is rendered on the top of the chart.
NO_LEGEND No legend is rendered.
INSIDE_LEGEND The legend is rendered inside the chart area.

CandlestickChartSpec

A candlestick chart .

نمایندگی JSON
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
زمینه های
domain

object ( CandlestickDomain )

The domain data (horizontal axis) for the candlestick chart. String data will be treated as discrete labels, other data will be treated as continuous values.

data[]

object ( CandlestickData )

The Candlestick chart data. Only one CandlestickData is supported.

CandlestickDomain

The domain of a CandlestickChart.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
data

object ( ChartData )

The data of the CandlestickDomain.

reversed

boolean

True to reverse the order of the domain values (horizontal axis).

CandlestickData

The Candlestick chart data, each containing the low, open, close, and high values for a series.

نمایندگی JSON
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
زمینه های
lowSeries

object ( CandlestickSeries )

The range data (vertical axis) for the low/minimum value for each candle. This is the bottom of the candle's center line.

openSeries

object ( CandlestickSeries )

The range data (vertical axis) for the open/initial value for each candle. This is the bottom of the candle body. If less than the close value the candle will be filled. Otherwise the candle will be hollow.

closeSeries

object ( CandlestickSeries )

The range data (vertical axis) for the close/final value for each candle. This is the top of the candle body. If greater than the open value the candle will be filled. Otherwise the candle will be hollow.

highSeries

object ( CandlestickSeries )

The range data (vertical axis) for the high/maximum value for each candle. This is the top of the candle's center line.

CandlestickSeries

The series of a CandlestickData.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  }
}
زمینه های
data

object ( ChartData )

The data of the CandlestickSeries.

OrgChartSpec

An org chart . Org charts require a unique set of labels in labels and may optionally include parentLabels and tooltips . parentLabels contain, for each node, the label identifying the parent node. tooltips contain, for each node, an optional tooltip.

For example, to describe an OrgChart with Alice as the CEO, Bob as the President (reporting to Alice) and Cathy as VP of Sales (also reporting to Alice), have labels contain "Alice", "Bob", "Cathy", parentLabels contain "", "Alice", "Alice" and tooltips contain "CEO", "President", "VP Sales".

نمایندگی 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 )

The size of the org chart nodes.

nodeColor
(deprecated)

object ( Color )

The color of the org chart nodes. Deprecated: Use nodeColorStyle .

nodeColorStyle

object ( ColorStyle )

The color of the org chart nodes. If nodeColor is also set, this field takes precedence.

selectedNodeColor
(deprecated)

object ( Color )

The color of the selected org chart nodes. Deprecated: Use selectedNodeColorStyle .

selectedNodeColorStyle

object ( ColorStyle )

The color of the selected org chart nodes. If selectedNodeColor is also set, this field takes precedence.

labels

object ( ChartData )

The data containing the labels for all the nodes in the chart. Labels must be unique.

parentLabels

object ( ChartData )

The data containing the label of the parent for the corresponding node. A blank value indicates that the node has no parent and is a top-level node. This field is optional.

tooltips

object ( ChartData )

The data containing the tooltip for the corresponding node. A blank value results in no tooltip being displayed for the node. This field is optional.

OrgChartNodeSize

The size of the org chart nodes.

Enums
ORG_CHART_LABEL_SIZE_UNSPECIFIED Default value, do not use.
SMALL The small org chart node size.
MEDIUM The medium org chart node size.
LARGE The large org chart node size.

HistogramChartSpec

A histogram chart . A histogram chart groups data items into bins, displaying each bin as a column of stacked items. Histograms are used to display the distribution of a dataset. Each column of items represents a range into which those items fall. The number of bins can be chosen automatically or specified explicitly.

نمایندگی JSON
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
زمینه های
series[]

object ( HistogramSeries )

The series for a histogram may be either a single series of values to be bucketed or multiple series, each of the same length, containing the name of the series followed by the values to be bucketed for that series.

legendPosition

enum ( HistogramChartLegendPosition )

The position of the chart legend.

showItemDividers

boolean

Whether horizontal divider lines should be displayed between items in each column.

bucketSize

number

By default the bucket size (the range of values stacked in a single column) is chosen automatically, but it may be overridden here. Eg, A bucket size of 1.5 results in buckets from 0 - 1.5, 1.5 - 3.0, etc. Cannot be negative. This field is optional.

outlierPercentile

number

The outlier percentile is used to ensure that outliers do not adversely affect the calculation of bucket sizes. For example, setting an outlier percentile of 0.05 indicates that the top and bottom 5% of values when calculating buckets. The values are still included in the chart, they will be added to the first or last buckets instead of their own buckets. Must be between 0.0 and 0.5.

HistogramSeries

A histogram series containing the series color and data.

نمایندگی JSON
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
زمینه های
barColor
(deprecated)

object ( Color )

The color of the column representing this series in each bucket. This field is optional. Deprecated: Use barColorStyle .

barColorStyle

object ( ColorStyle )

The color of the column representing this series in each bucket. This field is optional. If barColor is also set, this field takes precedence.

data

object ( ChartData )

The data for this histogram series.

HistogramChartLegendPosition

Where the legend of the chart should be positioned.

Enums
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED Default value, do not use.
BOTTOM_LEGEND The legend is rendered on the bottom of the chart.
LEFT_LEGEND The legend is rendered on the left of the chart.
RIGHT_LEGEND The legend is rendered on the right of the chart.
TOP_LEGEND The legend is rendered on the top of the chart.
NO_LEGEND No legend is rendered.
INSIDE_LEGEND The legend is rendered inside the chart area.

WaterfallChartSpec

A waterfall chart.

نمایندگی JSON
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
زمینه های
domain

object ( WaterfallChartDomain )

The domain data (horizontal axis) for the waterfall chart.

series[]

object ( WaterfallChartSeries )

The data this waterfall chart is visualizing.

stackedType

enum ( WaterfallChartStackedType )

The stacked type.

firstValueIsTotal

boolean

True to interpret the first value as a total.

hideConnectorLines

boolean

True to hide connector lines between columns.

connectorLineStyle

object ( LineStyle )

The line style for the connector lines.

totalDataLabel

object ( DataLabel )

Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. stackedType must be STACKED and neither CUSTOM nor placement can be set on the totalDataLabel .

WaterfallChartDomain

The domain of a waterfall chart.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
زمینه های
data

object ( ChartData )

The data of the WaterfallChartDomain.

reversed

boolean

True to reverse the order of the domain values (horizontal axis).

WaterfallChartSeries

A single series of data for a waterfall chart.

نمایندگی JSON
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
زمینه های
data

object ( ChartData )

The data being visualized in this series.

positiveColumnsStyle

object ( WaterfallChartColumnStyle )

Styles for all columns in this series with positive values.

negativeColumnsStyle

object ( WaterfallChartColumnStyle )

Styles for all columns in this series with negative values.

subtotalColumnsStyle

object ( WaterfallChartColumnStyle )

Styles for all subtotal columns in this series.

hideTrailingSubtotal

boolean

True to hide the subtotal column from the end of the series. By default, a subtotal column will appear at the end of each series. Setting this field to true will hide that subtotal column for this series.

customSubtotals[]

object ( WaterfallChartCustomSubtotal )

Custom subtotal columns appearing in this series. The order in which subtotals are defined is not significant. Only one subtotal may be defined for each data point.

dataLabel

object ( DataLabel )

Information about the data labels for this series.

WaterfallChartColumnStyle

Styles for a waterfall chart column.

نمایندگی JSON
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
زمینه های
label

string

The label of the column's legend.

color
(deprecated)

object ( Color )

The color of the column. Deprecated: Use colorStyle .

colorStyle

object ( ColorStyle )

The color of the column. If color is also set, this field takes precedence.

WaterfallChartCustomSubtotal

A custom subtotal column for a waterfall chart series.

نمایندگی JSON
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
زمینه های
subtotalIndex

integer

The zero-based index of a data point within the series. If dataIsSubtotal is true, the data point at this index is the subtotal. Otherwise, the subtotal appears after the data point with this index. A series can have multiple subtotals at arbitrary indices, but subtotals do not affect the indices of the data points. For example, if a series has three data points, their indices will always be 0, 1, and 2, regardless of how many subtotals exist on the series or what data points they are associated with.

label

string

A label for the subtotal column.

dataIsSubtotal

boolean

True if the data point at subtotalIndex is the subtotal. If false, the subtotal will be computed and appear after the data point.

WaterfallChartStackedType

Stacked type options for waterfall charts.

Enums
WATERFALL_STACKED_TYPE_UNSPECIFIED Default value, do not use.
STACKED Values corresponding to the same domain (horizontal axis) value will be stacked vertically.
SEQUENTIAL Series will spread out along the horizontal axis.

TreemapChartSpec

A Treemap chart .

نمایندگی 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 )

The data that contains the treemap cell labels.

parentLabels

object ( ChartData )

The data the contains the treemap cells' parent labels.

sizeData

object ( ChartData )

The data that determines the size of each treemap data cell. This data is expected to be numeric. The cells corresponding to non-numeric or missing data will not be rendered. If colorData is not specified, this data is used to determine data cell background colors as well.

colorData

object ( ChartData )

The data that determines the background color of each treemap data cell. This field is optional. If not specified, sizeData is used to determine background colors. If specified, the data is expected to be numeric. colorScale will determine how the values in this data map to data cell background colors.

textFormat

object ( TextFormat )

The text format for all labels on the chart. The link field is not supported.

levels

integer

The number of data levels to show on the treemap chart. These levels are interactive and are shown with their labels. Defaults to 2 if not specified.

hintedLevels

integer

The number of additional data levels beyond the labeled levels to be shown on the treemap chart. These levels are not interactive and are shown without their labels. Defaults to 0 if not specified.

minValue

number

The minimum possible data value. Cells with values less than this will have the same color as cells with this value. If not specified, defaults to the actual minimum value from colorData , or the minimum value from sizeData if colorData is not specified.

maxValue

number

The maximum possible data value. Cells with values greater than this will have the same color as cells with this value. If not specified, defaults to the actual maximum value from colorData , or the maximum value from sizeData if colorData is not specified.

headerColor
(deprecated)

object ( Color )

The background color for header cells. Deprecated: Use headerColorStyle .

headerColorStyle

object ( ColorStyle )

The background color for header cells. If headerColor is also set, this field takes precedence.

colorScale

object ( TreemapChartColorScale )

The color scale for data cells in the treemap chart. Data cells are assigned colors based on their color values. These color values come from colorData , or from sizeData if colorData is not specified. Cells with color values less than or equal to minValue will have minValueColor as their background color. Cells with color values greater than or equal to maxValue will have maxValueColor as their background color. Cells with color values between minValue and maxValue will have background colors on a gradient between minValueColor and maxValueColor , the midpoint of the gradient being midValueColor . Cells with missing or non-numeric color values will have noDataColor as their background color.

hideTooltips

boolean

True to hide tooltips.

TreemapChartColorScale

A color scale for a treemap chart.

نمایندگی 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 )

The background color for cells with a color value less than or equal to minValue . Defaults to #dc3912 if not specified. Deprecated: Use minValueColorStyle .

minValueColorStyle

object ( ColorStyle )

The background color for cells with a color value less than or equal to minValue . Defaults to #dc3912 if not specified. If minValueColor is also set, this field takes precedence.

midValueColor
(deprecated)

object ( Color )

The background color for cells with a color value at the midpoint between minValue and maxValue . Defaults to #efe6dc if not specified. Deprecated: Use midValueColorStyle .

midValueColorStyle

object ( ColorStyle )

The background color for cells with a color value at the midpoint between minValue and maxValue . Defaults to #efe6dc if not specified. If midValueColor is also set, this field takes precedence.

maxValueColor
(deprecated)

object ( Color )

The background color for cells with a color value greater than or equal to maxValue . Defaults to #109618 if not specified. Deprecated: Use maxValueColorStyle .

maxValueColorStyle

object ( ColorStyle )

The background color for cells with a color value greater than or equal to maxValue . Defaults to #109618 if not specified. If maxValueColor is also set, this field takes precedence.

noDataColor
(deprecated)

object ( Color )

The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. Deprecated: Use noDataColorStyle .

noDataColorStyle

object ( ColorStyle )

The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. If noDataColor is also set, this field takes precedence.

ScorecardChartSpec

A scorecard chart. Scorecard charts are used to highlight key performance indicators, known as KPIs, on the spreadsheet. A scorecard chart can represent things like total sales, average cost, or a top selling item. You can specify a single data value, or aggregate over a range of data. Percentage or absolute difference from a baseline value can be highlighted, like changes over time.

نمایندگی 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 )

The data for scorecard key value.

baselineValueData

object ( ChartData )

The data for scorecard baseline value. This field is optional.

aggregateType

enum ( ChartAggregateType )

The aggregation type for key and baseline chart data in scorecard chart. This field is not supported for data source charts. Use the ChartData.aggregateType field of the keyValueData or baselineValueData instead for data source charts. This field is optional.

keyValueFormat

object ( KeyValueFormat )

Formatting options for key value.

baselineValueFormat

object ( BaselineValueFormat )

Formatting options for baseline value. This field is needed only if baselineValueData is specified.

scaleFactor

number

Value to scale scorecard key and baseline value. For example, a factor of 10 can be used to divide all values in the chart by 10. This field is optional.

numberFormatSource

enum ( ChartNumberFormatSource )

The number format source used in the scorecard chart. This field is optional.

customFormatOptions

object ( ChartCustomNumberFormatOptions )

Custom formatting options for numeric key/baseline values in scorecard chart. This field is used only when numberFormatSource is set to CUSTOM . This field is optional.

KeyValueFormat

Formatting options for key value.

نمایندگی JSON
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
زمینه های
textFormat

object ( TextFormat )

Text formatting options for key value. The link field is not supported.

position

object ( TextPosition )

Specifies the horizontal text positioning of key value. This field is optional. If not specified, default positioning is used.

BaselineValueFormat

Formatting options for baseline value.

نمایندگی 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 )

The comparison type of key value with baseline value.

textFormat

object ( TextFormat )

Text formatting options for baseline value. The link field is not supported.

position

object ( TextPosition )

Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used.

description

string

Description which is appended after the baseline value. This field is optional.

positiveColor
(deprecated)

object ( Color )

Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use positiveColorStyle .

positiveColorStyle

object ( ColorStyle )

Color to be used, in case baseline value represents a positive change for key value. This field is optional. If positiveColor is also set, this field takes precedence.

negativeColor
(deprecated)

object ( Color )

Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use negativeColorStyle .

negativeColorStyle

object ( ColorStyle )

Color to be used, in case baseline value represents a negative change for key value. This field is optional. If negativeColor is also set, this field takes precedence.

ComparisonType

The comparison type of key value with baseline value.

Enums
COMPARISON_TYPE_UNDEFINED Default value, do not use.
ABSOLUTE_DIFFERENCE Use absolute difference between key and baseline value.
PERCENTAGE_DIFFERENCE Use percentage difference between key and baseline value.

ChartNumberFormatSource

The number formatting source options for chart attributes.

Enums
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Default value, do not use.
FROM_DATA Inherit number formatting from data.
CUSTOM Apply custom formatting as specified by ChartCustomNumberFormatOptions .

ChartCustomNumberFormatOptions

Custom number formatting options for chart attributes.

نمایندگی JSON
{
  "prefix": string,
  "suffix": string
}
زمینه های
prefix

string

Custom prefix to be prepended to the chart attribute. This field is optional.

suffix

string

Custom suffix to be appended to the chart attribute. This field is optional.

ChartHiddenDimensionStrategy

Determines how charts should handle source rows that are hidden. Hidden rows include both manually hidden and hidden by a filter.

Enums
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Default value, do not use.
SKIP_HIDDEN_ROWS_AND_COLUMNS Charts will skip hidden rows and columns.
SKIP_HIDDEN_ROWS Charts will skip hidden rows only.
SKIP_HIDDEN_COLUMNS Charts will skip hidden columns only.
SHOW_ALL Charts will not skip any hidden rows or columns.

EmbeddedObjectBorder

A border along an embedded object.

نمایندگی JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
زمینه های
color
(deprecated)

object ( Color )

The color of the border. Deprecated: Use colorStyle .

colorStyle

object ( ColorStyle )

The color of the border. If color is also set, this field takes precedence.