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

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

עובי הקו ב-px.

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

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

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

האינדקס מבוסס ה-0 של נקודה על הגרף בתוך הסדרה. אם הערך של dataIsSubtotal הוא True, נקודת הנתונים במדד הזה היא הסכום הכולל המשני. אחרת, הסכום הכולל מופיע אחרי נקודת הנתונים עם המדד הזה. לסדרה יכולות להיות כמה סכומים ביניים באינדיקטורים שרירותיים, אבל הסכומים הביניים לא משפיעים על האינדיקטורים של נקודות הנתונים. לדוגמה, אם לסדרה יש שלוש נקודות נתונים, המדדים שלהן יהיו תמיד 0,‏ 1 ו-2, ללא קשר למספר הסכומים המשניים בסדרה או לנקודות הנתונים שאליהן הם משויכים.

label

string

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

dataIsSubtotal

boolean

הערך הוא True אם נקודת הנתונים ב-subtotalIndex היא סכום הביניים. אם הערך הוא False, סכום הביניים יחושב ויוצג אחרי נקודת הנתונים.

WaterfallChartStackedType

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

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

TreemapChartSpec

תרשים מפת טרמה.

ייצוג ב-JSON 
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
שדות
labels

object (ChartData)

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

parentLabels

object (ChartData)

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

sizeData

object (ChartData)

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

colorData

object (ChartData)

הנתונים שקובעים את צבע הרקע של כל תא נתונים בתרשים עץ. השדה הזה הוא אופציונלי. אם לא מציינים ערך, המערכת משתמשת ב-sizeData כדי לקבוע את צבעי הרקע. אם מציינים את השדה, הנתונים צריכים להיות מספריים. colorScale קובע איך הערכים בנתונים האלה ימופו לצבעים של רקע התאים של הנתונים.

textFormat

object (TextFormat)

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

levels

integer

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

hintedLevels

integer

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

minValue

number

הערך המינימלי האפשרי של הנתונים. תאים עם ערכים נמוכים ממנו יהיו באותו צבע כמו תאים עם הערך הזה. אם לא צוין ערך, ברירת המחדל תהיה הערך המינימלי בפועל מ-colorData, או הערך המינימלי מ-sizeData אם לא צוין colorData.

maxValue

number

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

headerColor
(deprecated)

object (Color)

צבע הרקע של תאי הכותרות. הוצאה משימוש: יש להשתמש ב-headerColorStyle.

headerColorStyle

object (ColorStyle)

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

colorScale

object (TreemapChartColorScale)

סולם הצבעים של תאי הנתונים בתרשים מפת העץ. הצבעים של תאי נתונים מוקצים על סמך ערכי הצבעים שלהם. ערכי הצבעים האלה מגיעים מ-colorData או מ-sizeData אם colorData לא צוין. תאים עם ערכי צבע שקטנים מ-minValue או שווים לו יהיו בצבע רקע minValueColor. תאים עם ערכי צבע שגדולים מ-maxValue או שווים לו יהיו בצבע הרקע maxValueColor. לתאים עם ערכי צבעים בין minValue לבין maxValue יהיו צבעי רקע בהדרגתיות בין minValueColor ל-maxValueColor. נקודת האמצע של ההדרגתיות היא midValueColor. התאים עם ערכי צבע חסרים או לא מספריים יהיו בצבע רקע noDataColor.

hideTooltips

boolean

צריך להסתיר הסברים קצרים.

TreemapChartColorScale

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

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

object (Color)

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

minValueColorStyle

object (ColorStyle)

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

midValueColor
(deprecated)

object (Color)

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

midValueColorStyle

object (ColorStyle)

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

maxValueColor
(deprecated)

object (Color)

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

maxValueColorStyle

object (ColorStyle)

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

noDataColor
(deprecated)

object (Color)

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

noDataColorStyle

object (ColorStyle)

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