EmbeddedChart
نموداری که در یک برگه جاسازی شده است.
نمایندگی JSON |
---|
{ "chartId": integer, "spec": { object ( |
زمینه های | |
---|---|
chartId | شناسه نمودار. |
spec | مشخصات نمودار. |
position | موقعیت نمودار. |
border | مرز نمودار. |
ChartSpec
مشخصات یک نمودار
نمایندگی JSON |
---|
{ "title": string, "altText": string, "titleTextFormat": { object ( |
زمینه های | |
---|---|
title | عنوان نمودار. |
altText | متن جایگزینی که نمودار را توصیف می کند. این اغلب برای دسترسی استفاده می شود. |
titleTextFormat | قالب متن عنوان خط خطی، زیر خط، و پیوند پشتیبانی نمی شود. |
titleTextPosition | موقعیت متن عنوان این فیلد اختیاری است. |
subtitle | زیرنویس نمودار. |
subtitleTextFormat | قالب متن زیرنویس خط خطی، زیر خط، و پیوند پشتیبانی نمی شود. |
subtitleTextPosition | موقعیت متن زیرنویس. این فیلد اختیاری است. |
fontName | نام فونتی که بهطور پیشفرض برای تمام متن نمودار استفاده میشود (مثلاً عنوان، برچسبهای محور، افسانه). اگر فونتی برای قسمت خاصی از نمودار مشخص شده باشد، این نام فونت را لغو می کند. |
maximized | درست است که یک نمودار کل فضایی را که در آن رندر شده است با حداقل padding پر کند. برای استفاده از بالشتک پیش فرض نادرست است. (برای نمودارهای جغرافیایی و سازمانی قابل استفاده نیست.) |
backgroundColor | رنگ پس زمینه کل نمودار. برای نمودارهای سازمانی قابل استفاده نیست. منسوخ شده: از |
backgroundColorStyle | رنگ پس زمینه کل نمودار. برای نمودارهای سازمانی قابل استفاده نیست. اگر |
dataSourceChartProperties | در صورت وجود، فیلد حاوی ویژگی های خاص نمودار منبع داده است. |
filterSpecs[] | فیلترهای اعمال شده روی داده های منبع نمودار. فقط برای نمودارهای منبع داده پشتیبانی می شود. |
sortSpecs[] | ترتیب مرتب سازی داده های نمودار بر اساس. فقط یک مشخصات مرتب سازی پشتیبانی می شود. فقط برای نمودارهای منبع داده پشتیبانی می شود. |
chart میدان اتحادیه. مشخصات نمودار خاص، دقیقاً یک مقدار باید تنظیم شود. chart فقط می تواند یکی از موارد زیر باشد: | |
basicChart | مشخصات نمودار پایه، می تواند یکی از انواع نمودارها باشد. برای لیست همه نمودارهایی که این پشتیبانی می کند، |
pieChart | مشخصات نمودار دایره ای |
bubbleChart | مشخصات نمودار حباب. |
candlestickChart | مشخصات نمودار شمعی. |
orgChart | مشخصات نمودار سازمانی |
histogramChart | مشخصات نمودار هیستوگرام |
waterfallChart | مشخصات نمودار آبشار |
treemapChart | مشخصات نمودار نقشه درختی |
scorecardChart | مشخصات نمودار کارت امتیازی |
موقعیت متن
تنظیمات موقعیت برای متن
نمایندگی JSON |
---|
{
"horizontalAlignment": enum ( |
زمینه های | |
---|---|
horizontalAlignment | تنظیم تراز افقی برای قطعه متن. |
DataSourceChartProperties
ویژگی های نمودار منبع داده
نمایندگی JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
زمینه های | |
---|---|
dataSourceId | شناسه منبع داده ای که نمودار با آن مرتبط است. |
dataExecutionStatus | فقط خروجی وضعیت اجرای داده ها |
BasicChartSpec
مشخصات یک نمودار پایه برای لیست نمودارهایی که این پشتیبانی می کند به BasicChartType
مراجعه کنید.
نمایندگی JSON |
---|
{ "chartType": enum ( |
زمینه های | |
---|---|
chartType | نوع نمودار. |
legendPosition | موقعیت افسانه نمودار. |
axis[] | محور روی نمودار. |
domains[] | دامنه داده این نمودار است. فقط یک دامنه پشتیبانی می شود. |
series[] | داده هایی که این نمودار در حال تجسم است. |
headerCount | تعداد سطرها یا ستونها در دادهها که «هدر» هستند. اگر تنظیم نشود، Google Sheets بر اساس دادهها حدس میزند چند ردیف سرصفحه هستند. (توجه داشته باشید که |
threeDimensional | درست است که نمودار را سه بعدی کنید. برای نمودارهای میله ای و ستونی اعمال می شود. |
interpolateNulls | اگر برخی از مقادیر در یک سری از دست رفته باشد، ممکن است شکاف هایی در نمودار ظاهر شود (به عنوان مثال، بخش هایی از خطوط در نمودار خطی از بین خواهند رفت). برای از بین بردن این شکاف ها، این را روی true قرار دهید. برای نمودارهای خط، مساحت و ترکیبی اعمال می شود. |
stackedType | نوع پشتهای برای نمودارهایی که از انباشته شدن عمودی پشتیبانی میکنند. برای نمودارهای ناحیه، میله، ستون، ترکیبی، و منطقه پله ای اعمال می شود. |
lineSmoothing | دریافت می کند که آیا همه خطوط باید به طور پیش فرض صاف یا مستقیم ارائه شوند. برای نمودارهای خطی اعمال می شود. |
compareMode | رفتار نکات ابزار و برجسته کردن داده ها هنگام شناور شدن روی داده ها و منطقه نمودار. |
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 ( |
زمینه های | |
---|---|
position | موقعیت این محور. |
title | عنوان این محور. اگر تنظیم شود، هر عنوانی که از سرصفحه داده ها استنباط می شود لغو می شود. |
format | قالب عنوان. فقط در صورتی معتبر است که محور با دامنه مرتبط نباشد. فیلد پیوند پشتیبانی نمی شود. |
titleTextPosition | موقعیت متن عنوان محور. |
viewWindowOptions | گزینه های پنجره view برای این محور. |
BasicChartAxisPosition
موقعیت یک محور نمودار.
Enums | |
---|---|
BASIC_CHART_AXIS_POSITION_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
BOTTOM_AXIS | محور در پایین نمودار ارائه شده است. برای اکثر نمودارها، این محور اصلی استاندارد است. برای نمودارهای میله ای، این یک محور فرعی است. |
LEFT_AXIS | محور در سمت چپ نمودار ارائه شده است. برای اکثر نمودارها، این یک محور فرعی است. برای نمودارهای میله ای، این محور اصلی استاندارد است. |
RIGHT_AXIS | محور در سمت راست نمودار ارائه شده است. برای اکثر نمودارها، این یک محور فرعی است. برای نمودارهای میله ای، این یک محور اصلی غیر معمول است. |
ChartAxisViewWindowOptions
گزینه هایی که یک "پنجره مشاهده" را برای نمودار تعریف می کنند (مانند مقادیر قابل مشاهده در یک محور).
نمایندگی JSON |
---|
{
"viewWindowMin": number,
"viewWindowMax": number,
"viewWindowMode": enum ( |
زمینه های | |
---|---|
viewWindowMin | حداقل مقدار عددی که باید در این پنجره نمایش نشان داده شود. اگر تنظیم نشود، به طور خودکار حداقل مقداری را تعیین می کند که برای داده ها خوب به نظر می رسد. |
viewWindowMax | حداکثر مقدار عددی که باید در این پنجره نمایش نشان داده شود. اگر تنظیم نشود، به طور خودکار حداکثر مقداری را تعیین می کند که برای داده ها خوب به نظر می رسد. |
viewWindowMode | حالت پنجره مشاهده |
ViewWindowMode
حالت پنجره مشاهده نحوه برخورد با حداقل و حداکثر پنجره نمایش را مشخص می کند.
Enums | |
---|---|
DEFAULT_VIEW_WINDOW_MODE | حالت پنجره نمای پیشفرض که در ویرایشگر Sheets برای این نوع نمودار استفاده میشود. در بیشتر موارد، اگر تنظیم شود، حالت پیشفرض معادل PRETTY است. |
VIEW_WINDOW_MODE_UNSUPPORTED | استفاده نکن. نشان می دهد که حالت تنظیم شده فعلی توسط API پشتیبانی نمی شود. |
EXPLICIT | اگر مشخص شده باشد، از حداقل و حداکثر پیروی می کند. اگر مقداری نامشخص باشد، به مقدار PRETTY برمی گردد. |
PRETTY | حداقل و حداکثری را انتخاب می کند که نمودار را خوب جلوه دهد. هر دو حداقل و حداکثر در این حالت نادیده گرفته می شوند. |
BasicChartDomain
دامنه یک نمودار. به عنوان مثال، اگر نمودار قیمت سهام در طول زمان مشخص شود، این تاریخ خواهد بود.
نمایندگی JSON |
---|
{
"domain": {
object ( |
زمینه های | |
---|---|
domain | داده های دامنه به عنوان مثال، اگر نمودار قیمت سهام را در طول زمان ترسیم کنید، این داده ها نشان دهنده تاریخ است. |
reversed | درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی). |
نمودار دیتا
داده های موجود در یک دامنه یا سری.
نمایندگی JSON |
---|
{ "groupRule": { object ( |
زمینه های | |
---|---|
groupRule | قانون گروه بندی داده ها بر اساس اگر ChartData از دامنه نمودار منبع داده پشتیبانی کند. فقط برای نمودارهای منبع داده پشتیبانی می شود. |
aggregateType | نوع تجمع برای سری نمودار منبع داده. فقط برای نمودارهای منبع داده پشتیبانی می شود. |
type فیلد اتحادیه نوع داده شامل، دقیقاً یک مقدار باید تنظیم شود. type می تواند تنها یکی از موارد زیر باشد: | |
sourceRange | محدوده منبع داده ها |
columnReference | ارجاع به ستون منبع داده که داده ها از آن خوانده می شوند. |
ChartSourceRange
محدوده منبع برای نمودار.
نمایندگی JSON |
---|
{
"sources": [
{
object ( |
زمینه های | |
---|---|
sources[] | محدوده داده ها برای یک سری یا دامنه. دقیقاً یک بعد باید دارای طول 1 باشد، و همه منابع موجود در لیست باید دارای بعد یکسان با طول 1 باشند. دامنه (در صورت وجود) و همه سری ها باید تعداد محدوده منبع یکسانی داشته باشند. اگر از بیش از یک محدوده منبع استفاده می شود، آنگاه محدوده منبع در یک افست معین باید به ترتیب و در سراسر دامنه و سری به هم پیوسته باشد. به عنوان مثال، این تنظیمات معتبر هستند:
|
ChartGroupRule
یک تنظیم اختیاری در ChartData
دامنه یک نمودار منبع داده که به جای شکستن هر مقدار جداگانه، سطل هایی را برای مقادیر موجود در دامنه تعریف می کند.
به عنوان مثال، هنگام ترسیم نمودار منبع داده، می توانید یک قانون هیستوگرام را در دامنه مشخص کنید (فقط باید مقادیر عددی داشته باشد)، و مقادیر آن را در سطل گروه بندی کنید. هر مقدار از یک سری نمودار که در یک سطل قرار می گیرد، بر اساس aggregateType
جمع می شود.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
rule میدان اتحادیه قاعده ای که باید در ChartData اعمال شود. rule فقط می تواند یکی از موارد زیر باشد: | |
dateTimeRule | یک |
histogramRule | |
ChartDateTimeRule
به شما امکان میدهد مقادیر تاریخ-زمان را در یک ستون داده منبع در سطلهایی بر اساس بخشهای انتخاب شده از مقادیر تاریخ یا زمان آنها سازماندهی کنید.
نمایندگی JSON |
---|
{
"type": enum ( |
زمینه های | |
---|---|
type | نوع گروه بندی تاریخ-زمان برای اعمال. |
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 | حداقل مقداری که اقلام در سطل ها قرار می گیرند. مقادیری که کمتر از حداقل هستند در یک سطل واحد گروه بندی می شوند. اگر حذف شود، با حداقل مقدار مورد تعیین می شود. |
maxValue | حداکثر مقداری که اقلام در سطل ها قرار می گیرند. مقادیر بیشتر از حداکثر در یک سطل واحد گروه بندی می شوند. اگر حذف شود، با حداکثر مقدار مورد تعیین می شود. |
intervalSize | اندازه سطل هایی که ایجاد می شود. باید مثبت باشه |
ChartAggregateType
نوع تجمع برای سری نمودار.
Enums | |
---|---|
CHART_AGGREGATE_TYPE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
AVERAGE | میانگین تابع کل. |
COUNT | شمارش تابع کل. |
MAX | حداکثر تابع کل. |
MEDIAN | تابع کل میانه. |
MIN | حداقل تابع کل. |
SUM | تابع مجموع. |
BasicChartSeries
یک سری از داده ها در نمودار. برای مثال، اگر نمودار قیمت سهام در طول زمان مشخص شود، ممکن است چندین سری وجود داشته باشد، یکی برای «قیمت باز»، «قیمت بالا»، «قیمت پایین» و «قیمت بسته».
نمایندگی JSON |
---|
{ "series": { object ( |
زمینه های | |
---|---|
series | داده هایی که در این سری نمودار تجسم می شوند. |
targetAxis | محور فرعی که محدوده مقادیر این سری را مشخص می کند. به عنوان مثال، اگر در طول زمان نمودارهای سهام را ترسیم کنید، ممکن است سری "حجم" بخواهد به سمت راست و قیمت ها به سمت چپ سنجاق شود، زیرا مقیاس حجم معاملات با مقیاس قیمت ها متفاوت است. تعیین محوری که یک محور فرعی معتبر برای |
type | نوع این سریال. فقط در صورتی معتبر است که |
lineStyle | سبک خط این سریال. فقط در صورتی معتبر است که |
dataLabel | اطلاعات در مورد برچسب های داده برای این سری. |
color | رنگ عناصر (مانند میله ها، خطوط و نقاط) مرتبط با این سری. اگر خالی باشد، یک رنگ پیش فرض استفاده می شود. منسوخ شده: از |
colorStyle | رنگ عناصر (مانند میله ها، خطوط و نقاط) مرتبط با این سری. اگر خالی باشد، یک رنگ پیش فرض استفاده می شود. اگر |
pointStyle | سبک برای نقاط مرتبط با این سری. فقط در صورتی معتبر است که |
styleOverrides[] | تنظیمات نادیده گرفتن سبک برای نقاط داده سری. |
لاین استایل
ویژگی هایی که سبک یک خط را توصیف می کند.
نمایندگی JSON |
---|
{
"width": integer,
"type": enum ( |
زمینه های | |
---|---|
width | ضخامت خط، بر حسب px. |
type | نوع خط تیره. |
LineDashType
نوع خط تیره یک خط.
Enums | |
---|---|
LINE_DASH_TYPE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
INVISIBLE | بدون نوع خط تیره، که معادل یک خط غیر قابل مشاهده است. |
CUSTOM | خط تیره سفارشی برای یک خط. اصلاح سبک خط تیره سفارشی دقیق در حال حاضر پشتیبانی نمی شود. |
SOLID | یک خط ثابت |
DOTTED | یک خط نقطه چین. |
MEDIUM_DASHED | خط چین که در آن خط تیره ها دارای طول "متوسط" هستند. |
MEDIUM_DASHED_DOTTED | خطی که به طور متناوب بین یک خط تیره «متوسط» و یک نقطه تغییر می کند. |
LONG_DASHED | یک خط چین که در آن خط تیره ها دارای طول "طولانی" هستند. |
LONG_DASHED_DOTTED | خطی که به طور متناوب بین یک خط تیره "بلند" و یک نقطه تغییر می کند. |
DataLabel
تنظیمات برای یک مجموعه از برچسب های داده. برچسبهای داده، حاشیهنویسیهایی هستند که در کنار مجموعهای از دادهها، مانند نقاط روی نمودار خطی ظاهر میشوند و اطلاعات بیشتری درباره آنچه که دادهها نشان میدهند، ارائه میدهند، مانند نمایش متنی مقدار پشت آن نقطه در نمودار.
نمایندگی JSON |
---|
{ "type": enum ( |
زمینه های | |
---|---|
type | نوع برچسب داده |
textFormat | قالب متنی که برای برچسب داده استفاده می شود. فیلد پیوند پشتیبانی نمی شود. |
placement | قرار دادن برچسب داده ها نسبت به داده های برچسب دار. |
customLabelData | داده هایی برای استفاده برای برچسب های سفارشی. فقط در صورتی استفاده می شود که |
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 ( |
زمینه های | |
---|---|
size | اندازه نقطه اگر خالی باشد، یک اندازه پیش فرض استفاده می شود. |
shape | شکل نقطه. اگر خالی یا نامشخص باشد، یک شکل پیش فرض استفاده می شود. |
شکل نقطه
شکل یک نقطه.
Enums | |
---|---|
POINT_SHAPE_UNSPECIFIED | مقدار پیش فرض. |
CIRCLE | شکل دایره ای |
DIAMOND | یک شکل الماس |
HEXAGON | یک شکل شش ضلعی. |
PENTAGON | شکل پنج ضلعی |
SQUARE | یک شکل مربع |
STAR | یک شکل ستاره |
TRIANGLE | مثلثی شکل |
X_MARK | یک شکل علامت ایکس. |
BasicSeriesDataPointStyleOverride
تنظیمات نادیده گرفتن سبک برای یک نقطه داده سری واحد.
نمایندگی JSON |
---|
{ "index": integer, "color": { object ( |
زمینه های | |
---|---|
index | شاخص مبتنی بر صفر نقطه داده سری. |
color | رنگ نقطه داده سری. اگر خالی باشد، پیش فرض سری استفاده می شود. منسوخ شده: از |
colorStyle | رنگ نقطه داده سری. اگر خالی باشد، پیش فرض سری استفاده می شود. اگر |
pointStyle | سبک نقطه نقطه داده سری. فقط در صورتی معتبر است که |
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 ( |
زمینه های | |
---|---|
legendPosition | جایی که افسانه نمودار دایره ای باید رسم شود. |
domain | داده هایی که دامنه نمودار دایره ای را پوشش می دهد. |
series | داده هایی که یک و تنها سری نمودار دایره ای را پوشش می دهد. |
threeDimensional | اگر پای سه بعدی باشد درست است. |
pieHole | اندازه سوراخ در نمودار دایره ای. |
PieChartLegendPosition
جایی که افسانه نمودار باید قرار گیرد.
Enums | |
---|---|
PIE_CHART_LEGEND_POSITION_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
BOTTOM_LEGEND | افسانه در پایین نمودار ارائه شده است. |
LEFT_LEGEND | افسانه در سمت چپ نمودار ارائه شده است. |
RIGHT_LEGEND | افسانه در سمت راست نمودار ارائه شده است. |
TOP_LEGEND | افسانه در بالای نمودار ارائه شده است. |
NO_LEGEND | هیچ افسانه ای ارائه نمی شود. |
LABELED_LEGEND | هر برش پای یک برچسب به آن چسبانده شده است. |
BubbleChartSpec
نمایندگی JSON |
---|
{ "legendPosition": enum ( |
زمینه های | |
---|---|
legendPosition | جایی که افسانه نمودار باید ترسیم شود. |
bubbleLabels | داده های حاوی برچسب های حباب. لازم نیست اینها منحصر به فرد باشند. |
domain | داده های حاوی مقادیر x حباب. این مقادیر حباب ها را در نمودار به صورت افقی قرار می دهند. |
series | داده های حاوی مقادیر y حباب. این مقادیر حباب ها را در نمودار به صورت عمودی قرار می دهند. |
groupIds | داده های حاوی شناسه های گروه حباب. همه حباب ها با شناسه گروه یکسان به یک رنگ کشیده می شوند. اگر |
bubbleSizes | داده های حاوی اندازه حباب. از اندازه های حباب برای کشیدن حباب ها در اندازه های مختلف نسبت به یکدیگر استفاده می شود. در صورت مشخص شدن، |
bubbleOpacity | کدورت حباب ها بین 0 تا 1.0 است. 0 کاملاً شفاف و 1 کاملاً مات است. |
bubbleBorderColor | رنگ حاشیه حباب. منسوخ شده: از |
bubbleBorderColorStyle | رنگ حاشیه حباب. اگر |
bubbleMaxRadiusSize | حداکثر اندازه شعاع حباب ها، بر حسب پیکسل. اگر مشخص شده باشد، فیلد باید یک مقدار مثبت باشد. |
bubbleMinRadiusSize | حداقل اندازه شعاع حباب ها، بر حسب پیکسل. اگر مشخص باشد، فیلد باید یک مقدار مثبت باشد. |
bubbleTextStyle | فرمت متن داخل حباب ها. خط خطی، زیر خط، و پیوند پشتیبانی نمی شود. |
BubbleChartLegendPosition
جایی که افسانه نمودار باید قرار گیرد.
Enums | |
---|---|
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
BOTTOM_LEGEND | افسانه در پایین نمودار ارائه شده است. |
LEFT_LEGEND | افسانه در سمت چپ نمودار ارائه شده است. |
RIGHT_LEGEND | افسانه در سمت راست نمودار ارائه شده است. |
TOP_LEGEND | افسانه در بالای نمودار ارائه شده است. |
NO_LEGEND | هیچ افسانه ای ارائه نمی شود. |
INSIDE_LEGEND | افسانه در داخل منطقه نمودار ارائه شده است. |
CandlestickChartSpec
نمایندگی JSON |
---|
{ "domain": { object ( |
زمینه های | |
---|---|
domain | داده های دامنه (محور افقی) برای نمودار کندل استیک. دادههای رشتهای به عنوان برچسبهای مجزا در نظر گرفته میشوند و سایر دادهها به عنوان مقادیر پیوسته در نظر گرفته میشوند. |
data[] | داده های نمودار کندل استیک. فقط یک CandlestickData پشتیبانی می شود. |
CandlestickDomain
دامنه یک CandlestickChart.
نمایندگی JSON |
---|
{
"data": {
object ( |
زمینه های | |
---|---|
data | داده های CandlestickDomain. |
reversed | درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی). |
CandlestickData
داده های نمودار Candlestick که هر کدام شامل مقادیر کم، باز، بسته و زیاد برای یک سری هستند.
نمایندگی JSON |
---|
{ "lowSeries": { object ( |
زمینه های | |
---|---|
lowSeries | داده های محدوده (محور عمودی) برای مقدار کم/حداقل برای هر کندل. این پایین خط مرکزی شمع است. |
openSeries | داده های محدوده (محور عمودی) برای مقدار باز / اولیه برای هر کندل. این قسمت پایین بدنه شمع است. اگر کمتر از مقدار بسته باشد شمع پر می شود. در غیر این صورت شمع توخالی خواهد بود. |
closeSeries | داده های محدوده (محور عمودی) برای مقدار بسته/نهایی برای هر کندل. این قسمت بالای بدنه شمع است. اگر بیشتر از مقدار باز باشد شمع پر می شود. در غیر این صورت شمع توخالی خواهد بود. |
highSeries | داده های محدوده (محور عمودی) برای مقدار زیاد/حداکثر برای هر کندل. این قسمت بالای خط مرکزی شمع است. |
Candlestick Series
سری یک CandlestickData.
نمایندگی JSON |
---|
{
"data": {
object ( |
زمینه های | |
---|---|
data | داده های CandlestickSeries. |
OrgChartSpec
نمودار سازمانی نمودارهای سازمانی به مجموعه منحصربهفردی از برچسبها در labels
نیاز دارند و ممکن است به صورت اختیاری شامل parentLabels
و tooltips
باشند. parentLabels
برای هر گره حاوی برچسبی است که گره والد را مشخص می کند. tooltips
شامل، برای هر گره، یک راهنمای اختیاری است.
به عنوان مثال، برای توصیف یک نمودار ارگ با آلیس به عنوان مدیر عامل، باب به عنوان رئیس (گزارش دهنده به آلیس) و کتی به عنوان معاون فروش (همچنین به آلیس گزارش می دهد)، labels
حاوی "آلیس"، "باب"، "کتی"، parentLabels
شامل «»، «آلیس»، «آلیس» و tooltips
حاوی «مدیرعامل»، «رئیسجمهور»، «فروشگاه معاونت» است.
نمایندگی JSON |
---|
{ "nodeSize": enum ( |
زمینه های | |
---|---|
nodeSize | اندازه گره های نمودار سازمانی. |
nodeColor | رنگ گره های نمودار سازمانی. منسوخ شده: از |
nodeColorStyle | رنگ گره های نمودار سازمانی. اگر |
selectedNodeColor | رنگ گره های نمودار سازمانی انتخاب شده. منسوخ شده: از |
selectedNodeColorStyle | رنگ گره های نمودار سازمانی انتخاب شده. اگر |
labels | دادههای حاوی برچسبهای تمام گرههای نمودار. برچسب ها باید منحصر به فرد باشند. |
parentLabels | داده های حاوی برچسب والد برای گره مربوطه. یک مقدار خالی نشان می دهد که گره والد ندارد و یک گره سطح بالا است. این فیلد اختیاری است. |
tooltips | داده های حاوی راهنمای ابزار برای گره مربوطه. یک مقدار خالی باعث می شود که هیچ نکته ابزاری برای گره نمایش داده نشود. این فیلد اختیاری است. |
OrgChartNodeSize
اندازه گره های نمودار سازمانی.
Enums | |
---|---|
ORG_CHART_LABEL_SIZE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
SMALL | اندازه گره نمودار سازمانی کوچک. |
MEDIUM | اندازه گره نمودار سازمانی متوسط. |
LARGE | اندازه گره نمودار سازمانی بزرگ. |
HistogramChartSpec
نمودار هیستوگرام یک نمودار هیستوگرام اقلام داده را در سطل ها گروه بندی می کند و هر سطل را به عنوان ستونی از موارد انباشته نشان می دهد. هیستوگرام برای نمایش توزیع یک مجموعه داده استفاده می شود. هر ستون از آیتم ها محدوده ای را نشان می دهد که آن آیتم ها در آن قرار می گیرند. تعداد سطل ها را می توان به طور خودکار انتخاب کرد یا به صراحت مشخص کرد.
نمایندگی JSON |
---|
{ "series": [ { object ( |
زمینه های | |
---|---|
series[] | سری برای یک هیستوگرام ممکن است یک سری از مقادیر منفرد برای سطل یا چند سری باشد که هر کدام با طول یکسان، حاوی نام سری و به دنبال آن مقادیری باشد که باید برای آن سری سطل شوند. |
legendPosition | موقعیت افسانه نمودار. |
showItemDividers | آیا خطوط تقسیم افقی باید بین موارد در هر ستون نمایش داده شود یا خیر. |
bucketSize | بهطور پیشفرض، اندازه سطل (محدوده مقادیر روی هم در یک ستون) بهطور خودکار انتخاب میشود، اما ممکن است در اینجا لغو شود. به عنوان مثال، اندازه سطل 1.5 منجر به سطل هایی از 0 - 1.5، 1.5 - 3.0 و غیره می شود. نمی تواند منفی باشد. این فیلد اختیاری است. |
outlierPercentile | صدک پرت برای اطمینان از عدم تأثیر منفی بر محاسبه اندازه سطل استفاده می شود. به عنوان مثال، تنظیم یک صدک پرت 0.05 نشان می دهد که 5٪ بالا و پایین مقادیر هنگام محاسبه سطل ها. مقادیر همچنان در نمودار گنجانده شده است، آنها به جای سطل های خود به اولین یا آخرین سطل اضافه می شوند. باید بین 0.0 و 0.5 باشد. |
سری هیستوگرام
یک سری هیستوگرام حاوی رنگ و داده های سری.
نمایندگی JSON |
---|
{ "barColor": { object ( |
زمینه های | |
---|---|
barColor | رنگ ستون نشان دهنده این سری در هر سطل. این فیلد اختیاری است. منسوخ شده: از |
barColorStyle | رنگ ستون نشان دهنده این سری در هر سطل. این فیلد اختیاری است. اگر |
data | داده های این سری هیستوگرام. |
HistogramChartLegendPosition
جایی که افسانه نمودار باید قرار گیرد.
Enums | |
---|---|
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
BOTTOM_LEGEND | افسانه در پایین نمودار ارائه شده است. |
LEFT_LEGEND | افسانه در سمت چپ نمودار ارائه شده است. |
RIGHT_LEGEND | افسانه در سمت راست نمودار ارائه شده است. |
TOP_LEGEND | افسانه در بالای نمودار ارائه شده است. |
NO_LEGEND | هیچ افسانه ای ارائه نمی شود. |
INSIDE_LEGEND | افسانه در داخل منطقه نمودار ارائه شده است. |
WaterfallChartSpec
نمودار آبشار
نمایندگی JSON |
---|
{ "domain": { object ( |
زمینه های | |
---|---|
domain | داده های دامنه (محور افقی) برای نمودار آبشار. |
series[] | داده هایی که این نمودار آبشار در حال تجسم است. |
stackedType | نوع انباشته. |
firstValueIsTotal | برای تفسیر مقدار اول به عنوان یک مقدار درست است. |
hideConnectorLines | درست برای پنهان کردن خطوط اتصال بین ستون ها. |
connectorLineStyle | سبک خط برای خطوط اتصال. |
totalDataLabel | کنترل می کند که آیا برچسب های داده های اضافی در نمودارهای انباشته نمایش داده شود که مجموع ارزش کل همه مقادیر انباشته شده در هر مقدار در امتداد محور دامنه است. |
WaterfallChartDomain
دامنه نمودار آبشار.
نمایندگی JSON |
---|
{
"data": {
object ( |
زمینه های | |
---|---|
data | داده های WaterfallChartDomain. |
reversed | درست برای معکوس کردن ترتیب مقادیر دامنه (محور افقی). |
WaterfallChart Series
یک سری از داده ها برای نمودار آبشار.
نمایندگی JSON |
---|
{ "data": { object ( |
زمینه های | |
---|---|
data | داده هایی که در این مجموعه به تصویر کشیده می شوند. |
positiveColumnsStyle | سبکهای همه ستونهای این سری با مقادیر مثبت. |
negativeColumnsStyle | سبکهای همه ستونهای این سری با مقادیر منفی. |
subtotalColumnsStyle | سبکها برای تمام ستونهای فرعی در این سری. |
hideTrailingSubtotal | درست است برای پنهان کردن ستون فرعی از انتهای سری. به طور پیش فرض، یک ستون فرعی در پایان هر سری ظاهر می شود. تنظیم این فیلد روی true، ستون فرعی این سری را پنهان می کند. |
customSubtotals[] | ستون های فرعی سفارشی که در این سری ظاهر می شوند. ترتیب تعریف مجموع فرعی مهم نیست. برای هر نقطه داده فقط یک جمع فرعی ممکن است تعریف شود. |
dataLabel | اطلاعات در مورد برچسب های داده برای این سری. |
WaterfallChartColumnStyle
سبک های ستون نمودار آبشار.
نمایندگی JSON |
---|
{ "label": string, "color": { object ( |
زمینه های | |
---|---|
label | برچسب افسانه ستون. |
color | رنگ ستون. منسوخ شده: از |
colorStyle | رنگ ستون. اگر |
WaterfallChartCustomSubtotal
یک ستون فرعی سفارشی برای یک سری نمودار آبشار.
نمایندگی JSON |
---|
{ "subtotalIndex": integer, "label": string, "dataIsSubtotal": boolean } |
زمینه های | |
---|---|
subtotalIndex | شاخص مبتنی بر صفر یک نقطه داده در سری. اگر |
label | یک برچسب برای ستون فرعی. |
dataIsSubtotal | درست است اگر نقطه داده در |
WaterfallChartStackedType
گزینه های نوع انباشته برای نمودارهای آبشار.
Enums | |
---|---|
WATERFALL_STACKED_TYPE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
STACKED | مقادیر مربوط به همان مقدار دامنه (محور افقی) به صورت عمودی انباشته می شوند. |
SEQUENTIAL | سری در امتداد محور افقی پخش خواهد شد. |
TreemapChartSpec
نمایندگی JSON |
---|
{ "labels": { object ( |
زمینه های | |
---|---|
labels | داده هایی که حاوی برچسب های سلولی نقشه درختی هستند. |
parentLabels | داده ها حاوی برچسب های والد سلول های نقشه درخت هستند. |
sizeData | داده هایی که اندازه هر سلول داده نقشه درختی را تعیین می کند. انتظار می رود این داده ها عددی باشد. سلول های مربوط به داده های غیر عددی یا از دست رفته ارائه نمی شوند. اگر |
colorData | داده هایی که رنگ پس زمینه هر سلول داده نقشه درختی را تعیین می کند. این فیلد اختیاری است. اگر مشخص نشده باشد، |
textFormat | قالب متن برای همه برچسب های نمودار. فیلد پیوند پشتیبانی نمی شود. |
levels | تعداد سطوح داده برای نمایش در نمودار درختی. این سطوح تعاملی هستند و با برچسب های خود نشان داده می شوند. اگر مشخص نشده باشد به طور پیشفرض 2 میشود. |
hintedLevels | تعداد سطوح داده اضافی فراتر از سطوح برچسبگذاری شده برای نشان دادن در نمودار درختی. این سطوح تعاملی نیستند و بدون برچسب نشان داده می شوند. اگر مشخص نشده باشد به صورت پیش فرض 0 می شود. |
minValue | حداقل مقدار داده ممکن سلول هایی با مقادیر کمتر از این همان رنگ سلول های با این مقدار را خواهند داشت. اگر مشخص نشده باشد، مقدار حداقل واقعی از |
maxValue | حداکثر مقدار داده ممکن سلول هایی با مقادیر بیشتر از این همان رنگ سلول های با این مقدار را خواهند داشت. اگر مشخص نشده باشد، مقدار حداکثر واقعی را از |
headerColor | رنگ پس زمینه برای سلول های هدر. منسوخ شده: از |
headerColorStyle | رنگ پس زمینه برای سلول های هدر. اگر |
colorScale | مقیاس رنگ برای سلول های داده در نمودار درختی. به سلول های داده رنگ ها بر اساس مقادیر رنگ آنها اختصاص داده می شود. این مقادیر رنگ از |
hideTooltips | درست برای پنهان کردن نکات ابزار. |
TreemapChartColorScale
مقیاس رنگی برای نمودار درختی.
نمایندگی JSON |
---|
{ "minValueColor": { object ( |
زمینه های | |
---|---|
minValueColor | رنگ پس زمینه سلول هایی با مقدار رنگ کمتر یا مساوی |
minValueColorStyle | رنگ پس زمینه سلول هایی با مقدار رنگ کمتر یا مساوی |
midValueColor | رنگ پس زمینه سلول هایی با مقدار رنگ در نقطه میانی بین |
midValueColorStyle | رنگ پس زمینه سلول هایی با مقدار رنگ در نقطه میانی بین |
maxValueColor | رنگ پس زمینه سلول هایی با مقدار رنگ بزرگتر یا مساوی |
maxValueColorStyle | رنگ پس زمینه سلول هایی با مقدار رنگ بزرگتر یا مساوی |
noDataColor | رنگ پس زمینه برای سلول هایی که هیچ داده رنگی مرتبط با آنها ندارند. اگر مشخص نشده باشد به طور پیشفرض به #000000 میرسد. منسوخ شده: از |
noDataColorStyle | رنگ پس زمینه برای سلول هایی که هیچ داده رنگی مرتبط با آنها ندارند. اگر مشخص نشده باشد به طور پیشفرض به #000000 میرسد. اگر |
ScorecardChartSpec
نمودار کارت امتیازی نمودارهای کارت امتیازی برای برجسته کردن شاخصهای کلیدی عملکرد، معروف به KPI، در صفحهگسترده استفاده میشوند. نمودار کارت امتیازی می تواند مواردی مانند فروش کل، هزینه متوسط یا یک کالای پرفروش را نشان دهد. شما می توانید یک مقدار داده را مشخص کنید، یا در محدوده ای از داده ها را جمع آوری کنید. درصد یا تفاوت مطلق از یک مقدار پایه را می توان برجسته کرد، مانند تغییرات در طول زمان.
نمایندگی JSON |
---|
{ "keyValueData": { object ( |
زمینه های | |
---|---|
keyValueData | داده ها برای ارزش کلید کارت امتیازی. |
baselineValueData | داده ها برای ارزش پایه کارت امتیازی. این فیلد اختیاری است. |
aggregateType | نوع تجمیع برای داده های نمودار کلیدی و پایه در نمودار کارت امتیازی. این فیلد برای نمودارهای منبع داده پشتیبانی نمی شود. به جای آن از فیلد |
keyValueFormat | گزینه های قالب بندی برای مقدار کلید. |
baselineValueFormat | گزینه های قالب بندی برای مقدار پایه. این فیلد فقط در صورتی مورد نیاز است که |
scaleFactor | ارزش به مقیاس کلید کارت امتیازی و ارزش پایه. برای مثال می توان از ضریب 10 برای تقسیم تمام مقادیر نمودار بر 10 استفاده کرد. این فیلد اختیاری است. |
numberFormatSource | منبع قالب عددی استفاده شده در نمودار کارت امتیازی. این فیلد اختیاری است. |
customFormatOptions | گزینه های قالب بندی سفارشی برای مقادیر کلید عددی/خط پایه در نمودار کارت امتیازی. This field is used only when |
KeyValueFormat
Formatting options for key value.
نمایندگی JSON |
---|
{ "textFormat": { object ( |
زمینه های | |
---|---|
textFormat | Text formatting options for key value. The link field is not supported. |
position | 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 | The comparison type of key value with baseline value. |
textFormat | Text formatting options for baseline value. The link field is not supported. |
position | Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used. |
description | Description which is appended after the baseline value. This field is optional. |
positiveColor | Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use |
positiveColorStyle | Color to be used, in case baseline value represents a positive change for key value. This field is optional. If |
negativeColor | Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use |
negativeColorStyle | Color to be used, in case baseline value represents a negative change for key value. This field is optional. If |
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 | Custom prefix to be prepended to the chart attribute. This field is optional. |
suffix | 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 | The color of the border. Deprecated: Use |
colorStyle | The color of the border. If |
EmbeddedChart
A chart embedded in a sheet.
نمایندگی JSON |
---|
{ "chartId": integer, "spec": { object ( |
زمینه های | |
---|---|
chartId | The ID of the chart. |
spec | The specification of the chart. |
position | The position of the chart. |
border | The border of the chart. |
ChartSpec
The specifications of a chart.
نمایندگی JSON |
---|
{ "title": string, "altText": string, "titleTextFormat": { object ( |
زمینه های | |
---|---|
title | The title of the chart. |
altText | The alternative text that describes the chart. This is often used for accessibility. |
titleTextFormat | The title text format. Strikethrough, underline, and link are not supported. |
titleTextPosition | The title text position. This field is optional. |
subtitle | The subtitle of the chart. |
subtitleTextFormat | The subtitle text format. Strikethrough, underline, and link are not supported. |
subtitleTextPosition | The subtitle text position. This field is optional. |
fontName | 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 | 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 | The background color of the entire chart. Not applicable to Org charts. Deprecated: Use |
backgroundColorStyle | The background color of the entire chart. Not applicable to Org charts. If |
dataSourceChartProperties | If present, the field contains data source chart specific properties. |
filterSpecs[] | The filters applied to the source data of the chart. Only supported for data source charts. |
sortSpecs[] | The order to sort the chart data by. Only a single sort spec is supported. Only supported for data source charts. |
Union field chart . The specific chart specification, exactly one value must be set. chart can be only one of the following: | |
basicChart | A basic chart specification, can be one of many kinds of charts. See |
pieChart | A pie chart specification. |
bubbleChart | A bubble chart specification. |
candlestickChart | A candlestick chart specification. |
orgChart | An org chart specification. |
histogramChart | A histogram chart specification. |
waterfallChart | A waterfall chart specification. |
treemapChart | A treemap chart specification. |
scorecardChart | A scorecard chart specification. |
TextPosition
Position settings for text.
نمایندگی JSON |
---|
{
"horizontalAlignment": enum ( |
زمینه های | |
---|---|
horizontalAlignment | Horizontal alignment setting for the piece of text. |
DataSourceChartProperties
Properties of a data source chart.
نمایندگی JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
زمینه های | |
---|---|
dataSourceId | ID of the data source that the chart is associated with. |
dataExecutionStatus | فقط خروجی The data execution status. |
BasicChartSpec
The specification for a basic chart. See BasicChartType
for the list of charts this supports.
نمایندگی JSON |
---|
{ "chartType": enum ( |
زمینه های | |
---|---|
chartType | The type of the chart. |
legendPosition | The position of the chart legend. |
axis[] | The axis on the chart. |
domains[] | The domain of data this is charting. Only a single domain is supported. |
series[] | The data this chart is visualizing. |
headerCount | 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 |
threeDimensional | True to make the chart 3D. Applies to Bar and Column charts. |
interpolateNulls | 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 | The stacked type for charts that support vertical stacking. Applies to Area, Bar, Column, Combo, and Stepped Area charts. |
lineSmoothing | Gets whether all lines should be rendered smooth or straight by default. Applies to Line charts. |
compareMode | The behavior of tooltips and data highlighting when hovering on data and chart area. |
totalDataLabel | 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 |
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 ( |
زمینه های | |
---|---|
position | The position of this axis. |
title | The title of this axis. If set, this overrides any title inferred from headers of the data. |
format | The format of the title. Only valid if the axis is not associated with the domain. The link field is not supported. |
titleTextPosition | The axis title text position. |
viewWindowOptions | 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 ( |
زمینه های | |
---|---|
viewWindowMin | 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 | 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 | 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 ( |
زمینه های | |
---|---|
domain | The data of the domain. For example, if charting stock prices over time, this is the data representing the dates. |
reversed | True to reverse the order of the domain values (horizontal axis). |
ChartData
The data included in a domain or series.
نمایندگی JSON |
---|
{ "groupRule": { object ( |
زمینه های | |
---|---|
groupRule | 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 | 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 | The source ranges of the data. |
columnReference | The reference to the data source column that the data reads from. |
ChartSourceRange
Source ranges for a chart.
نمایندگی JSON |
---|
{
"sources": [
{
object ( |
زمینه های | |
---|---|
sources[] | 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:
|
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 |
زمینه های | |
---|---|
Union field rule . The rule to apply to the ChartData . rule can be only one of the following: | |
dateTimeRule | |
histogramRule | |
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 ( |
زمینه های | |
---|---|
type | 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 | 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 | 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 | 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 ( |
زمینه های | |
---|---|
series | The data being visualized in this chart series. |
targetAxis | 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 | The type of this series. Valid only if the |
lineStyle | The line style of this series. Valid only if the |
dataLabel | Information about the data labels for this series. |
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 | The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. If |
pointStyle | The style for points associated with this series. Valid only if the |
styleOverrides[] | Style override settings for series data points. |
LineStyle
Properties that describe the style of a line.
نمایندگی JSON |
---|
{
"width": integer,
"type": enum ( |
زمینه های | |
---|---|
width | The thickness of the line, in px. |
type | 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 ( |
زمینه های | |
---|---|
type | The type of the data label. |
textFormat | The text format used for the data label. The link field is not supported. |
placement | The placement of the data label relative to the labeled data. |
customLabelData | Data to use for custom labels. Only used if |
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 ( |
زمینه های | |
---|---|
size | The point size. If empty, a default size is used. |
shape | 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 ( |
زمینه های | |
---|---|
index | The zero-based index of the series data point. |
color | Color of the series data point. If empty, the series default is used. Deprecated: Use |
colorStyle | Color of the series data point. If empty, the series default is used. If |
pointStyle | Point style of the series data point. Valid only if the |
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 ( |
زمینه های | |
---|---|
legendPosition | Where the legend of the pie chart should be drawn. |
domain | The data that covers the domain of the pie chart. |
series | The data that covers the one and only series of the pie chart. |
threeDimensional | True if the pie is three dimensional. |
pieHole | 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 ( |
زمینه های | |
---|---|
legendPosition | Where the legend of the chart should be drawn. |
bubbleLabels | The data containing the bubble labels. These do not need to be unique. |
domain | The data containing the bubble x-values. These values locate the bubbles in the chart horizontally. |
series | The data containing the bubble y-values. These values locate the bubbles in the chart vertically. |
groupIds | The data containing the bubble group IDs. All bubbles with the same group ID are drawn in the same color. If |
bubbleSizes | The data containing the bubble sizes. Bubble sizes are used to draw the bubbles at different sizes relative to each other. If specified, |
bubbleOpacity | The opacity of the bubbles between 0 and 1.0. 0 is fully transparent and 1 is fully opaque. |
bubbleBorderColor | The bubble border color. Deprecated: Use |
bubbleBorderColorStyle | The bubble border color. If |
bubbleMaxRadiusSize | The max radius size of the bubbles, in pixels. If specified, the field must be a positive value. |
bubbleMinRadiusSize | The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value. |
bubbleTextStyle | 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
نمایندگی JSON |
---|
{ "domain": { object ( |
زمینه های | |
---|---|
domain | 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[] | The Candlestick chart data. Only one CandlestickData is supported. |
CandlestickDomain
The domain of a CandlestickChart.
نمایندگی JSON |
---|
{
"data": {
object ( |
زمینه های | |
---|---|
data | The data of the CandlestickDomain. |
reversed | 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 ( |
زمینه های | |
---|---|
lowSeries | The range data (vertical axis) for the low/minimum value for each candle. This is the bottom of the candle's center line. |
openSeries | 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 | 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 | 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 ( |
زمینه های | |
---|---|
data | 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 ( |
زمینه های | |
---|---|
nodeSize | The size of the org chart nodes. |
nodeColor | The color of the org chart nodes. Deprecated: Use |
nodeColorStyle | The color of the org chart nodes. If |
selectedNodeColor | The color of the selected org chart nodes. Deprecated: Use |
selectedNodeColorStyle | The color of the selected org chart nodes. If |
labels | The data containing the labels for all the nodes in the chart. Labels must be unique. |
parentLabels | 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 | 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 ( |
زمینه های | |
---|---|
series[] | 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 | The position of the chart legend. |
showItemDividers | Whether horizontal divider lines should be displayed between items in each column. |
bucketSize | 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 | 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 ( |
زمینه های | |
---|---|
barColor | The color of the column representing this series in each bucket. This field is optional. Deprecated: Use |
barColorStyle | The color of the column representing this series in each bucket. This field is optional. If |
data | 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 ( |
زمینه های | |
---|---|
domain | The domain data (horizontal axis) for the waterfall chart. |
series[] | The data this waterfall chart is visualizing. |
stackedType | The stacked type. |
firstValueIsTotal | True to interpret the first value as a total. |
hideConnectorLines | True to hide connector lines between columns. |
connectorLineStyle | The line style for the connector lines. |
totalDataLabel | 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. |
WaterfallChartDomain
The domain of a waterfall chart.
نمایندگی JSON |
---|
{
"data": {
object ( |
زمینه های | |
---|---|
data | The data of the WaterfallChartDomain. |
reversed | True to reverse the order of the domain values (horizontal axis). |
WaterfallChartSeries
A single series of data for a waterfall chart.
نمایندگی JSON |
---|
{ "data": { object ( |
زمینه های | |
---|---|
data | The data being visualized in this series. |
positiveColumnsStyle | Styles for all columns in this series with positive values. |
negativeColumnsStyle | Styles for all columns in this series with negative values. |
subtotalColumnsStyle | Styles for all subtotal columns in this series. |
hideTrailingSubtotal | 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[] | 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 | Information about the data labels for this series. |
WaterfallChartColumnStyle
Styles for a waterfall chart column.
نمایندگی JSON |
---|
{ "label": string, "color": { object ( |
زمینه های | |
---|---|
label | The label of the column's legend. |
color | The color of the column. Deprecated: Use |
colorStyle | The color of the column. If |
WaterfallChartCustomSubtotal
A custom subtotal column for a waterfall chart series.
نمایندگی JSON |
---|
{ "subtotalIndex": integer, "label": string, "dataIsSubtotal": boolean } |
زمینه های | |
---|---|
subtotalIndex | The zero-based index of a data point within the series. If |
label | A label for the subtotal column. |
dataIsSubtotal | True if the data point at |
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 ( |
زمینه های | |
---|---|
labels | The data that contains the treemap cell labels. |
parentLabels | The data the contains the treemap cells' parent labels. |
sizeData | 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 | The data that determines the background color of each treemap data cell. This field is optional. If not specified, |
textFormat | The text format for all labels on the chart. The link field is not supported. |
levels | 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 | 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 | 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 |
maxValue | 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 |
headerColor | The background color for header cells. Deprecated: Use |
headerColorStyle | The background color for header cells. If |
colorScale | 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 |
hideTooltips | True to hide tooltips. |
TreemapChartColorScale
A color scale for a treemap chart.
نمایندگی JSON |
---|
{ "minValueColor": { object ( |
زمینه های | |
---|---|
minValueColor | The background color for cells with a color value less than or equal to |
minValueColorStyle | The background color for cells with a color value less than or equal to |
midValueColor | The background color for cells with a color value at the midpoint between |
midValueColorStyle | The background color for cells with a color value at the midpoint between |
maxValueColor | The background color for cells with a color value greater than or equal to |
maxValueColorStyle | The background color for cells with a color value greater than or equal to |
noDataColor | The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. Deprecated: Use |
noDataColorStyle | The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. If |
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 ( |
زمینه های | |
---|---|
keyValueData | The data for scorecard key value. |
baselineValueData | The data for scorecard baseline value. This field is optional. |
aggregateType | The aggregation type for key and baseline chart data in scorecard chart. This field is not supported for data source charts. Use the |
keyValueFormat | Formatting options for key value. |
baselineValueFormat | Formatting options for baseline value. This field is needed only if |
scaleFactor | 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 | The number format source used in the scorecard chart. This field is optional. |
customFormatOptions | Custom formatting options for numeric key/baseline values in scorecard chart. This field is used only when |
KeyValueFormat
Formatting options for key value.
نمایندگی JSON |
---|
{ "textFormat": { object ( |
زمینه های | |
---|---|
textFormat | Text formatting options for key value. The link field is not supported. |
position | 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 | The comparison type of key value with baseline value. |
textFormat | Text formatting options for baseline value. The link field is not supported. |
position | Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used. |
description | Description which is appended after the baseline value. This field is optional. |
positiveColor | Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use |
positiveColorStyle | Color to be used, in case baseline value represents a positive change for key value. This field is optional. If |
negativeColor | Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use |
negativeColorStyle | Color to be used, in case baseline value represents a negative change for key value. This field is optional. If |
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 | Custom prefix to be prepended to the chart attribute. This field is optional. |
suffix | 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 | The color of the border. Deprecated: Use |
colorStyle | The color of the border. If |