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

הערך True גורם לתרשים למלא את כל המרחב שבו הוא מוצג עם מרווח פנימי מינימלי. False כדי להשתמש בברירת המחדל של המילוי. (לא רלוונטי לתרשימי פריסה גיאוגרפית ולתרשימים ארגוניים).

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)

מפרט של תרשים Treemap.

scorecardChart

object (ScorecardChartSpec)

מפרט של תרשים כרטיסי מידע.

TextPosition

הגדרות המיקום של הטקסט.

ייצוג ב-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

True כדי ליצור תרשים תלת-ממדי. האפשרות הזו רלוונטית לתרשים עמודות ולתרשים עמודות אופקי.

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

איך התרשים צריך להיראות.

טיפוסים בני מנייה (enum)
BASIC_CHART_TYPE_UNSPECIFIED ערך ברירת מחדל, אין להשתמש בו.
BAR תרשים עמודות.
LINE תרשים קו.
AREA תרשים שטח.
COLUMN תרשים עמודות.
SCATTER תרשים פיזור.
COMBO תרשים משולב.
STEPPED_AREA תרשים שטח מדורג.

BasicChartLegendPosition

איפה צריך למקם את המקרא של התרשים.

טיפוסים בני מנייה (enum)
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)

האפשרויות של חלון התצוגה לציר הזה.

BasicChartAxisPosition

המיקום של ציר תרשים.

טיפוסים בני מנייה (enum)
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

המצב של חלון התצוגה. הוא מגדיר את האופן שבו המערכת מטפלת בערכי המינימום והמקסימום של חלון התצוגה.

טיפוסים בני מנייה (enum)
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

True כדי להפוך את סדר ערכי הדומיינים (ציר אופקי).

ChartData

הנתונים שכלולים בדומיין או בסדרה.

ייצוג ב-JSON 
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
שדות
groupRule

object (ChartGroupRule)

הכלל לפיו מקובצים הנתונים, אם ChartData תומך בדומיין של תרשים של מקור נתונים. התכונה נתמכת רק בתרשימים של מקורות נתונים.

aggregateType

enum (ChartAggregateType)

סוג הצבירה של הסדרה בתרשים של מקור הנתונים. התכונה נתמכת רק בתרשימים של מקורות נתונים.

שדה האיחוד type. סוג הנתונים הכלולים. צריך להגדיר ערך אחד בלבד. 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 בדומיין של תרשים של מקור נתונים, שמגדירה קטגוריות (buckets) לערכים בדומיין במקום לפרט כל ערך בנפרד.

לדוגמה, כשמציירים תרשים של מקור נתונים, אפשר לציין כלל להיסטוגרמה בדומיין (הוא צריך להכיל רק ערכים מספריים), ולקבץ את הערכים שלו לקטגוריות. כל הערכים של סדרת תרשים שנכללים באותו קטגוריה נצברים על סמך הערך של 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

סוגי הכללים הזמינים לקיבוץ לפי תאריך ושעה.

טיפוסים בני מנייה (enum)
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 שעות, לדוגמה 19:45. ההמרה של השמות AM/PM מתבצעת על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני.
DAY_OF_WEEK קיבוץ תאריכים לפי יום בשבוע, למשל יום ראשון. ימי השבוע יתורגו בהתאם ללוקאל של הגיליון האלקטרוני.
DAY_OF_YEAR קיבוץ תאריכים לפי יום בשנה, מ-1 עד 366. לתשומת ליבכם: תאריכים אחרי 29 בפברואר נכללים בקטגוריות שונות בשנים מעוברות מאשר בשנים לא מעוברות.
DAY_OF_MONTH קיבוץ תאריכים לפי היום בחודש, מ-1 עד 31.
DAY_MONTH קיבוץ תאריכים לפי יום וחודש, לדוגמה 22-Nov. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני.
MONTH קיבוץ תאריכים לפי חודש, למשל נובמבר. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני.
QUARTER קיבוץ תאריכים לפי רבעון, למשל Q1 (שמייצג את ינואר עד מרץ).
YEAR לקבץ תאריכים לפי שנה, למשל 2008.
YEAR_MONTH קיבוץ תאריכים לפי שנה וחודש, לדוגמה 2008-Nov. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני.
YEAR_QUARTER קיבוץ תאריכים לפי שנה ורבעון, לדוגמה: רבעון 4, 2008.
YEAR_MONTH_DAY קיבוץ תאריכים לפי שנה, חודש ויום, לדוגמה 22 בנובמבר 2008.

ChartHistogramRule

מאפשרת לארגן ערכים מספריים בעמודת נתוני מקור לקטגוריות בגודל קבוע.

ייצוג ב-JSON 
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
שדות
minValue

number

הערך המינימלי שבו פריטים מועברים לקטגוריות. ערכים שקטנים מהערך המינימלי מקובצים בקטגוריה אחת. אם לא צוין, הוא נקבע לפי ערך הפריט המינימלי.

maxValue

number

הערך המקסימלי שבו פריטים מוקצים לקטגוריות. ערכים שגבוהים מהערך המקסימלי מקובצים בקטגוריה אחת. אם לא צוין, הוא נקבע לפי הערך המקסימלי של הפריט.

intervalSize

number

הגודל של הקטגוריות שנוצרות. חייב להיות חיובי.

ChartAggregateType

סוג הצבירה של סדרות התרשימים.

טיפוסים בני מנייה (enum)
CHART_AGGREGATE_TYPE_UNSPECIFIED ערך ברירת מחדל, אין להשתמש בו.
AVERAGE פונקציית צבירה של ממוצע.
COUNT פונקציית הצבירה Count.
MAX פונקציית צבירה מקסימלית.
MEDIAN פונקציית צבירה של חציון.
MIN פונקציית צבירה מינימלית.
SUM פונקציית צבירה מסוג 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. יש תמיכה גם בתרשימים מסוג COMBO אם הערך של series chart type הוא AREA או LINE.

dataLabel

object (DataLabel)

מידע על תוויות הנתונים של הסדרה הזו.

color
(deprecated)

object (Color)

הצבע של הרכיבים (כמו עמודות, קווים ונקודות) שמשויכים לסדרה הזו. אם השדה ריק, המערכת תשתמש בצבע ברירת המחדל. הוצאה משימוש: יש להשתמש ב-colorStyle.

colorStyle

object (ColorStyle)

הצבע של הרכיבים (כמו עמודות, קווים ונקודות) שמשויכים לסדרה הזו. אם השדה ריק, המערכת תשתמש בצבע ברירת המחדל. אם גם color מוגדר, השדה הזה מקבל עדיפות.

pointStyle

object (PointStyle)

הסגנון של הנקודות שמשויכות לסדרה הזו. התג תקף רק אם הערך של chartType הוא AREA,‏ LINE או SCATTER. אפשר להשתמש גם בתרשימים מסוג COMBO אם הערך של series chart type הוא AREA,‏ LINE או SCATTER. אם השדה ריק, המערכת תשתמש בסגנון ברירת המחדל של הנקודות.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

הגדרות לשינוי סגנון של נקודות נתונים בסדרה.

LineStyle

מאפיינים שמתארים את הסגנון של קו.

ייצוג ב-JSON 
{
  "width": integer,
  "type": enum (LineDashType)
}
שדות
width

integer

עובי הקו, בפיקסלים.

type

enum (LineDashType)

סוג הקו המפריד.

LineDashType

סוג הקו המפריד.

טיפוסים בני מנייה (enum)
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

הסוג של תווית הנתונים.

טיפוסים בני מנייה (enum)
DATA_LABEL_TYPE_UNSPECIFIED סוג תווית הנתונים לא מצוין, והוא יפורש בהתאם להקשר של תווית הנתונים בתוך התרשים.
NONE תווית הנתונים לא מוצגת.
DATA תווית הנתונים מוצגת באמצעות ערכים מנתוני הסדרה.
CUSTOM תווית הנתונים מוצגת באמצעות ערכים ממקור נתונים מותאם אישית שמסומן ב-customLabelData.

DataLabelPlacement

המיקום של תווית הנתונים ביחס לנתונים המתויגים.

טיפוסים בני מנייה (enum)
DATA_LABEL_PLACEMENT_UNSPECIFIED המיקום נקבע באופן אוטומטי על ידי ה-renderer.
CENTER מרכז בתוך סרגל או עמודה, גם אופקית וגם אנכית.
LEFT מימין לנקודת נתונים.
RIGHT משמאל לנקודת נתונים.
ABOVE מעל נקודה על הגרף.
BELOW מתחת לנקודה על הגרף.
INSIDE_END בתוך סרגל או עמודה בסוף (בחלק העליון אם הערך חיובי, ובחלק התחתון אם הערך שלילי).
INSIDE_BASE בתוך סרגל או עמודה בבסיס.
OUTSIDE_END מחוץ לסרגל או לעמודה בסוף.

PointStyle

הסגנון של נקודה בתרשים.

ייצוג ב-JSON 
{
  "size": number,
  "shape": enum (PointShape)
}
שדות
size

number

גודל הנקודה. אם השדה ריק, המערכת תשתמש בגודל ברירת המחדל.

shape

enum (PointShape)

צורת הנקודה. אם השדה ריק או לא צוין בו ערך, המערכת תשתמש בצורת ברירת מחדל.

PointShape

צורת הנקודה.

טיפוסים בני מנייה (enum)
POINT_SHAPE_UNSPECIFIED ערך ברירת המחדל.
CIRCLE צורה של מעגל.
DIAMOND צורת יהלום.
HEXAGON צורה של משושה.
PENTAGON צורה של משולש בן חמישה צלעות.
SQUARE צורת ריבוע.
STAR בצורת כוכב.
TRIANGLE צורה של משולש.
X_MARK צורה של סימן X.

BasicSeriesDataPointStyleOverride

הגדרות לשינוי סגנון של נקודה אחת על גרף של סדרה.

ייצוג ב-JSON 
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
שדות
index

integer

האינדקס שמתחיל באפס של נקודת הנתונים בסדרה.

color
(deprecated)

object (Color)

הצבע של נקודת הנתונים בסדרה. אם השדה ריק, המערכת תשתמש בברירת המחדל של הסדרה. הוצאה משימוש: יש להשתמש ב-colorStyle.

colorStyle

object (ColorStyle)

הצבע של נקודת הנתונים בסדרה. אם השדה ריק, המערכת תשתמש בברירת המחדל של הסדרה. אם גם color מוגדר, השדה הזה מקבל עדיפות.

pointStyle

object (PointStyle)

סגנון הנקודה של נקודת הנתונים בסדרה. התג תקף רק אם הערך של chartType הוא AREA,‏ LINE או SCATTER. אפשר להשתמש גם בתרשימים מסוג COMBO אם הערך של series chart type הוא AREA,‏ LINE או SCATTER. אם השדה ריק, המערכת תשתמש בברירת המחדל של הסדרה.

BasicChartStackedType

כשהתרשימים מוערמים, ערכי הטווח (הציר האנכי) מוצגים זה על גבי זה ולא בציר האופקי. לדוגמה, שני הערכים 20 ו-80 יימשכו מ-0, כאשר הערך 80 יהיה במרחק של 80 יחידות מהציר האנכי. אם הם יהיו מוערמים, הערך 80 יומר מהערך 20, והוא יהיה במרחק 100 יחידות מהציר האופקי.

טיפוסים בני מנייה (enum)
BASIC_CHART_STACKED_TYPE_UNSPECIFIED ערך ברירת מחדל, אין להשתמש בו.
NOT_STACKED הסדרות לא מוערמות.
STACKED ערכי הסדרות מוערמים, וכל ערך מוצג אנכית, החל מהחלק העליון של הערך שמתחתיו.
PERCENT_STACKED עמודות אנכיות נמתחות עד לחלק העליון של התרשים, והערכים מוצגים כאחוזים זה מזה.

BasicChartCompareMode

סוג מצב ההשוואה, שמתאר את ההתנהגות של הסברים קצרים והדגשת נתונים כשעוברים עם העכבר מעל הנתונים ואזור התרשים.

טיפוסים בני מנייה (enum)
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

הערך יהיה True אם העוגה תהיה תלת-ממדית.

pieHole

number

גודל החור בתרשים העוגה.

PieChartLegendPosition

איפה צריך למקם את המקרא של התרשים.

טיפוסים בני מנייה (enum)
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

איפה צריך למקם את המקרא של התרשים.

טיפוסים בני מנייה (enum)
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

True כדי להפוך את סדר ערכי הדומיינים (ציר אופקי).

CandlestickData

נתוני תרשים הפמוט, שכל אחד מהם מכיל את הערכים הנמוך, הפתוח, הסגור והגבוה של סדרה.

ייצוג ב-JSON 
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
שדות
lowSeries

object (CandlestickSeries)

נתוני הטווח (הציר האנכי) של הערך הנמוך/המינימלי בכל נר. זהו הקצה התחתון של קו האמצע של הנר.

openSeries

object (CandlestickSeries)

נתוני הטווח (ציר אנכי) של הערך הפתוח/הראשוני של כל נר. זהו החלק התחתון של גוף הנר. אם הערך נמוך מערך הסגירה, הנר יהיה מלא. אחרת, הנר יהיה חלול.

closeSeries

object (CandlestickSeries)

נתוני הטווח (ציר אנכי) של הערך הסופי/הסגירה של כל נר. זהו החלק העליון של גוף הנר. אם הערך גבוה מהערך הפתוח, הנר יהיה מלא. אחרת, הנר יהיה חלול.

highSeries

object (CandlestickSeries)

נתוני הטווח (ציר אנכי) של הערך הגבוה/המקסימלי בכל נר. זהו החלק העליון של קו האמצע של הנר.

CandlestickSeries

הסדרה של 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

הגודל של הצמתים בתרשים הארגוני.

טיפוסים בני מנייה (enum)
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.

HistogramSeries

סדרת היסטוגרמה שמכילה את הצבע והנתונים של הסדרה.

ייצוג ב-JSON 
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
שדות
barColor
(deprecated)

object (Color)

הצבע של העמודה שמייצגת את הסדרה הזו בכל קטגוריה. השדה הזה הוא אופציונלי. הוצאה משימוש: יש להשתמש ב-barColorStyle.

barColorStyle

object (ColorStyle)

הצבע של העמודה שמייצגת את הסדרה הזו בכל קטגוריה. השדה הזה הוא אופציונלי. אם גם barColor מוגדר, השדה הזה מקבל עדיפות.

data

object (ChartData)

הנתונים של סדרת ההיסטוגרמה הזו.

HistogramChartLegendPosition

איפה צריך למקם את המקרא של התרשים.

טיפוסים בני מנייה (enum)
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)

הנתונים שמוצגים בתרשים Waterfall.

stackedType

enum (WaterfallChartStackedType)

סוג הערימה.

firstValueIsTotal

boolean

True כדי לפרש את הערך הראשון כסה"כ.

hideConnectorLines

boolean

הערך True מסתיר את קוי המחבר בין העמודות.

connectorLineStyle

object (LineStyle)

סגנון הקו של קווים המחברים.

totalDataLabel

object (DataLabel)

ההגדרה קובעת אם יוצגו תווית נתונים נוספות בתרשימים מוערמים, שמסכמות את הערך הכולל של כל הערכים המוערמים בכל ערך לאורך ציר הדומיין. הערך של stackedType חייב להיות STACKED, ואי אפשר להגדיר את CUSTOM או את placement ב-totalDataLabel.

WaterfallChartDomain

הדומיין של תרשים מפל.

ייצוג ב-JSON 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
שדות
data

object (ChartData)

הנתונים של WaterfallChartDomain.

reversed

boolean

True כדי להפוך את סדר ערכי הדומיינים (ציר אופקי).

WaterfallChartSeries

סדרת נתונים אחת לתרשים מפל.

ייצוג ב-JSON 
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
שדות
data

object (ChartData)

הנתונים שמוצגים בתצוגה החזותית בסדרה הזו.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

סגנונות לכל העמודות בסדרה הזו עם ערכים חיוביים.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

סגנונות לכל העמודות בסדרה הזו עם ערכים שליליים.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

סגנונות לכל עמודות הסיכום החלוק בסדרה הזו.

hideTrailingSubtotal

boolean

הערך True מאפשר להסתיר את העמודה 'סכום ביניים' בסוף הסדרה. כברירת מחדל, עמודת סכום ביניים תופיע בסוף כל סדרה. הגדרת השדה הזה כ-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 הוא True, נקודת הנתונים במדד הזה היא הסכום הכולל המשני. אחרת, הסכום הכולל מופיע אחרי נקודת הנתונים עם המדד הזה. לסדרה יכולות להיות כמה סכומים ביניים באינדיקטורים שרירותיים, אבל הסכומים הביניים לא משפיעים על האינדיקטורים של נקודות הנתונים. לדוגמה, אם לסדרה יש שלוש נקודות נתונים, המדדים שלהן יהיו תמיד 0,‏ 1 ו-2, ללא קשר למספר הסכומים המשניים בסדרה או לנקודות הנתונים שאליהן הם משויכים.

label

string

תווית לעמודת הסכום הכולל.

dataIsSubtotal

boolean

הערך True אם נקודת הנתונים ב-subtotalIndex היא הסכום המצטבר. אם הערך הוא false, הסכום הכולל המשני יחושב ויופיע אחרי נקודת הנתונים.

WaterfallChartStackedType

אפשרויות לסוג 'מוערם' בתרשימי מפל מים.

טיפוסים בני מנייה (enum)
WATERFALL_STACKED_TYPE_UNSPECIFIED ערך ברירת מחדל, אין להשתמש בו.
STACKED ערכים שתואמים לאותו ערך דומיין (ציר אופקי) יאוחסנו בערימה אנכית.
SEQUENTIAL הסדרות יתפרסו לאורך הציר האופקי.

TreemapChartSpec

תרשים Treemap.

ייצוג ב-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)

הנתונים שמכילים את תוויות התאים של ה-Treemap.

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

הערך True מסתיר את ההסבר הקצר.

TreemapChartColorScale

סולם צבעים לתרשים של מפת עץ.

ייצוג ב-JSON 
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
שדות
minValueColor
(deprecated)

object (Color)

צבע הרקע של תאים עם ערך צבע שקטן מ-minValue או שווה לו. אם לא מציינים ערך, ברירת המחדל היא #dc3912. הוצאה משימוש: יש להשתמש ב-minValueColorStyle.

minValueColorStyle

object (ColorStyle)

צבע הרקע של תאים עם ערך צבע שקטן מ-minValue או שווה לו. אם לא מציינים ערך, ברירת המחדל היא #dc3912. אם גם minValueColor מוגדר, השדה הזה מקבל עדיפות.

midValueColor
(deprecated)

object (Color)

צבע הרקע של תאים עם ערך צבע בנקודת האמצע בין minValue ל-maxValue. אם לא מציינים ערך, ערך ברירת המחדל הוא #efe6dc. הוצאה משימוש: יש להשתמש ב-midValueColorStyle.

midValueColorStyle

object (ColorStyle)

צבע הרקע של תאים עם ערך צבע בנקודת האמצע בין minValue ל-maxValue. אם לא מציינים ערך, ערך ברירת המחדל הוא #efe6dc. אם גם midValueColor מוגדר, השדה הזה מקבל עדיפות.

maxValueColor
(deprecated)

object (Color)

צבע הרקע של תאים עם ערך צבע שגדול מ-maxValue או שווה לו. אם לא צוין ערך, ברירת המחדל היא #109618. הוצאה משימוש: יש להשתמש ב-maxValueColorStyle.

maxValueColorStyle

object (ColorStyle)

צבע הרקע של תאים עם ערך צבע שגדול מ-maxValue או שווה לו. אם לא צוין ערך, ברירת המחדל היא #109618. אם גם maxValueColor מוגדר, השדה הזה מקבל עדיפות.

noDataColor
(deprecated)

object (Color)

צבע הרקע של תאים שאין להם נתוני צבע משויכים. אם לא צוין ערך, ערך ברירת המחדל הוא #000000. הוצאה משימוש: יש להשתמש ב-noDataColorStyle.

noDataColorStyle

object (ColorStyle)

צבע הרקע של תאים שאין להם נתוני צבע משויכים. אם לא צוין ערך, ערך ברירת המחדל הוא #000000. אם גם noDataColor מוגדר, השדה הזה מקבל עדיפות.

ScorecardChartSpec

תרשים של כרטיס מידע. תרשימים של כרטיסי מידע משמשים להדגשת מדדי ביצועים מרכזיים (KPI) בגיליון האלקטרוני. תרשים של כרטיס ניקוד יכול לייצג נתונים כמו סה"כ מכירות, עלות ממוצעת או פריט נמכר ביותר. אפשר לציין ערך נתונים יחיד או ערך מצטבר של טווח נתונים. אפשר להדגיש את ההפרש באחוזים או את ההפרש המוחלט לערך בסיס, כמו שינויים לאורך זמן.

ייצוג ב-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)

אפשרויות עיצוב בהתאמה אישית לערכים של מפתחות או של ערכים בסיסיים מספריים בתרשים של כרטיס המידע. השדה הזה משמש רק כשהערך של numberFormatSource מוגדר כ-CUSTOM. השדה הזה הוא אופציונלי.

KeyValueFormat

אפשרויות עיצוב של ערך המפתח.

ייצוג ב-JSON 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
שדות
textFormat

object (TextFormat)

אפשרויות לעיצוב טקסט של ערך מפתח. אין תמיכה בשדה הקישור.

position

object (TextPosition)

מציין את מיקום הטקסט האופקי של ערך המפתח. השדה הזה הוא אופציונלי. אם לא צוין מיקום, המערכת תשתמש במיקום ברירת המחדל.

BaselineValueFormat

אפשרויות עיצוב של ערך הבסיס.

ייצוג ב-JSON 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
שדות
comparisonType

enum (ComparisonType)

סוג ההשוואה של ערך המפתח לערך הבסיס.

textFormat

object (TextFormat)

אפשרויות לעיצוב טקסט של ערך הבסיס. אין תמיכה בשדה הקישור.

position

object (TextPosition)

מציין את מיקום הטקסט האופקי של ערך הבסיס. השדה הזה הוא אופציונלי. אם לא צוין מיקום, המערכת תשתמש במיקום ברירת המחדל.

description

string

תיאור שמצורף אחרי הערך הבסיסי. השדה הזה הוא אופציונלי.

positiveColor
(deprecated)

object (Color)

הצבע שישמש במקרה שבו ערך הבסיס מייצג שינוי חיובי בערך המפתח. השדה הזה הוא אופציונלי. הוצאה משימוש: יש להשתמש ב-positiveColorStyle.

positiveColorStyle

object (ColorStyle)

הצבע שישמש במקרה שבו ערך הבסיס מייצג שינוי חיובי בערך המפתח. השדה הזה הוא אופציונלי. אם גם positiveColor מוגדר, השדה הזה מקבל עדיפות.

negativeColor
(deprecated)

object (Color)

הצבע שישמש במקרה שבו ערך הבסיס מייצג שינוי שלילי בערך המפתח. השדה הזה הוא אופציונלי. הוצאה משימוש: יש להשתמש ב-negativeColorStyle.

negativeColorStyle

object (ColorStyle)

הצבע שישמש במקרה שבו ערך הבסיס מייצג שינוי שלילי בערך המפתח. השדה הזה הוא אופציונלי. אם גם negativeColor מוגדר, השדה הזה מקבל עדיפות.

ComparisonType

סוג ההשוואה של ערך המפתח לערך הבסיס.

טיפוסים בני מנייה (enum)
COMPARISON_TYPE_UNDEFINED ערך ברירת מחדל, אין להשתמש בו.
ABSOLUTE_DIFFERENCE שימוש בהפרש המוחלט בין המפתח לערך הבסיס.
PERCENTAGE_DIFFERENCE שימוש בהפרש באחוזים בין המפתח לערך הבסיס.

ChartNumberFormatSource

אפשרויות המקור לעיצוב המספרים של מאפייני התרשים.

טיפוסים בני מנייה (enum)
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED ערך ברירת מחדל, אין להשתמש בו.
FROM_DATA ירושה של עיצוב המספרים מהנתונים.
CUSTOM החלת עיצוב מותאם אישית כפי שצוין ב-ChartCustomNumberFormatOptions.

ChartCustomNumberFormatOptions

אפשרויות לעיצוב מספרים בהתאמה אישית של מאפייני תרשימים.

ייצוג ב-JSON 
{
  "prefix": string,
  "suffix": string
}
שדות
prefix

string

קידומת מותאמת אישית שתוצמדה למאפיין התרשים. השדה הזה הוא אופציונלי.

suffix

string

סיומת מותאמת אישית שתוסיפ למאפיין התרשים. השדה הזה הוא אופציונלי.

ChartHiddenDimensionStrategy

קובע איך התרשימים יטפלו בשורות מקור מוסתרות. שורות מוסתרות כוללות שורות מוסתרות באופן ידני וגם שורות מוסתרות באמצעות מסנן.

טיפוסים בני מנייה (enum)
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED ערך ברירת מחדל, אין להשתמש בו.
SKIP_HIDDEN_ROWS_AND_COLUMNS התרשימים ידלגו על שורות ועמודות מוסתרות.
SKIP_HIDDEN_ROWS התרשימים ידלגו רק על שורות מוסתרות.
SKIP_HIDDEN_COLUMNS התרשימים ידלגו רק על עמודות מוסתרות.
SHOW_ALL התרשימים לא ידלגו על שורות או עמודות מוסתרות.

EmbeddedObjectBorder

גבול סביב אובייקט מוטמע.

ייצוג ב-JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
שדות
color
(deprecated)

object (Color)

צבע הגבול. הוצאה משימוש: יש להשתמש ב-colorStyle.

colorStyle

object (ColorStyle)

צבע הגבול. אם גם color מוגדר, השדה הזה מקבל עדיפות.