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)

מפרט תרשים של מפת עצים.

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 עד נובמבר. החודש יתורגם לפי הלוקאל של הגיליון האלקטרוני.
MONTH מקבצים תאריכים לפי חודש, לדוגמה, נובמבר. החודש מתורגם בהתאם ללוקאל של הגיליון האלקטרוני.
QUARTER מקבצים תאריכים לפי רבעון. לדוגמה, רבעון 1 (שמייצג ינואר-מרץ).
YEAR צריך לקבץ תאריכים לפי שנה, לדוגמה 2008.
YEAR_MONTH צריך לקבץ את התאריכים לפי שנה וחודש, לדוגמה 2008 עד נובמבר. החודש יתורגם לפי הלוקאל של הגיליון האלקטרוני.
YEAR_QUARTER מקבצים תאריכים לפי שנה ורבעון, לדוגמה רבעון 4 של שנת 2008.
YEAR_MONTH_DAY קיבוץ תאריכים לפי שנה, חודש ויום. לדוגמה, 2008-11-22.

ChartHistogramRule

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

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

number

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

maxValue

number

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

intervalSize

number

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

ChartAggregateType

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

טיפוסים בני מנייה (enum)
CHART_AGGREGATE_TYPE_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
AVERAGE פונקציית צבירה ממוצעת.
COUNT פונקציית ספירת הצבירה.
MAX פונקציית צבירה מקסימלית.
MEDIAN פונקציית צבירה חציונית.
MIN פונקציית צבירה מינימלית.
SUM פונקציית סיכום צבירה.

BasicChartSeries

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

ייצוג JSON
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
שדות
series

object (ChartData)

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

targetAxis

enum (BasicChartAxisPosition)

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

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 יחידות מהציר האופקי. אם הן היו מקובצות בערימה, המערכת תעבד 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 לכלול הסבר קצר עבור כל צומת.

לדוגמה, כדי לתאר OrgChart עם אליס כמנכ"ל, יוסי כנשיא (מדווח לאיס) וקאת'י כסמנכ"ל מכירות (גם מדווח לאליס). 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)

נתוני הדומיין (הציר האופקי) של תרשים ה-Waterfall.

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

סדרת נתונים יחידה לתרשים Waterfall.

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

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

ייצוג JSON
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
שדות
subtotalIndex

integer

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

label

string

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

dataIsSubtotal

boolean

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

WaterfallChartStackedType

אפשרויות של סוגי ערימה לתרשימי Waterfall.

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

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

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)

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