Charts

תרשים מוטמע

תרשים המוטמע בגיליון.

ייצוג JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
שדות
chartId

integer

המזהה של התרשים.

spec

object (ChartSpec)

מפרט התרשים.

position

object (EmbeddedObjectPosition)

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

border

object (EmbeddedObjectBorder)

גבול התרשים.

מפרט התרשים

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

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

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

מיקום טקסט

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

ייצוג JSON 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
שדות
horizontalAlignment

enum (HorizontalAlign)

הגדרת יישור אופקי עבור קטע הטקסט.

DataSourceChartProperties

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

ייצוג JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
שדות
dataSourceId

string

המזהה של מקור הנתונים שאליו התרשים משויך.

dataExecutionStatus

object (DataExecutionStatus)

פלט בלבד. סטטוס ביצוע הנתונים.

מידע בסיסי על תרשים

המפרט של תרשים בסיסי. לרשימת התרשימים הנתמכים, אפשר לעיין ב-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.

סוג BasicChart

המחשה ויזואלית של התרשים.

טיפוסים בני מנייה (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 לא מוצג אף מקרא.

ציר בסיסי

ציר של התרשים. תרשים לא יכול לכלול יותר מציר אחד לכל 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)

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

מיקום בסיסי בתרשים

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

טיפוסים בני מנייה (enum)
BASIC_CHART_AXIS_POSITION_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
BOTTOM_AXIS הציר מוצג בחלק התחתון של התרשים. עבור רוב התרשימים, זהו הציר הראשי הרגיל. בתרשימי עמודות, זהו ציר משני.
LEFT_AXIS הציר מוצג מימין לתרשים. עבור רוב התרשימים, זהו ציר משני. לתרשימי עמודות, זהו הציר הראשי הרגיל.
RIGHT_AXIS הציר מוצג משמאל לתרשים. עבור רוב התרשימים, זהו ציר משני. בתרשימי עמודות, זהו ציר ראשי בלתי רגיל.

אפשרויות של תרשים תרשים

האפשרויות שמגדירות "חלון תצוגה" של תרשים (כגון הערכים הגלויים בציר).

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

דומיין בסיסי

הדומיין של התרשים. לדוגמה, אם אתם מציגים את מחירי המניות לאורך זמן, זהו התאריך.

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

object (ChartData)

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

reversed

boolean

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

נתוני תרשים

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

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

הכלל לקיבוץ הנתונים לפי אם ה-DataData מגבה את הדומיין של תרשים מקור הנתונים. האפשרות הזו נתמכת רק בתרשימים של מקורות נתונים.

aggregateType

enum (ChartAggregateType)

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

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

object (ChartSourceRange)

טווחי המקור של הנתונים.

columnReference

object (DataSourceColumnReference)

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

טווח של תרשים

טווחי המקור של תרשים.

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

כלל ChartGroup

הגדרה אופציונלית ב-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)

סוג הקיבוץ של תאריך ושעה שרוצים להחיל.

סוג תרשיםתאריך ושעה

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

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

תרשים היסטוגרמה

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

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

number

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

maxValue

number

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

intervalSize

number

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

סוג צבירה בתרשים

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

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

סדרות בסיסיות

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

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

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

סגנון קו

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

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

integer

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

type

enum (LineDashType)

סוג המקף של הקו.

סוג LineDash

סוג הקו המקווקו של הקו.

טיפוסים בני מנייה (enum)
LINE_DASH_TYPE_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
INVISIBLE אין סוג מקף, שהוא שווה ערך לשורה שאינה גלויה.
CUSTOM מקף מותאם אישית עבור קו. כרגע אין תמיכה בשינוי סגנון המקף המותאם אישית בדיוק.
SOLID קו רצוף.
DOTTED קו מקווקו.
MEDIUM_DASHED קו מקווקו שבו למקפים יש אורך 'בינוני'.
MEDIUM_DASHED_DOTTED קו שמחליף בין מקף 'בינוני' לבין נקודה.
LONG_DASHED קו מקווקו שבו למקפים יש אורך 'ארוך'.
LONG_DASHED_DOTTED קו שמחליף בין מקף ארוך ונקודה.

תווית נתונים

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

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

סוג תווית נתונים

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

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

מיקום תווית נתונים

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

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

סגנון פוינט

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

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

number

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

shape

enum (PointShape)

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

צורת Point

הצורה של נקודה.

טיפוסים בני מנייה (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. אם השדה ריק, ייעשה שימוש בברירת המחדל של הסדרה.

סוג התרשים הבסיסי

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

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

מידע בסיסי על השוואה בין תרשימים

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

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

תרשים עוגה

תרשים עוגה.

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

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

מצעד העוגה

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

טיפוסים בני מנייה (enum)
PIE_CHART_LEGEND_POSITION_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
BOTTOM_LEGEND המקרא מוצג בחלק התחתון של התרשים.
LEFT_LEGEND המקרא מוצג בצד שמאל של התרשים.
RIGHT_LEGEND המקרא מוצג בצד שמאל של התרשים.
TOP_LEGEND האגדה מעובדת בחלק העליון של התרשים.
NO_LEGEND לא מוצג אף מקרא.
LABELED_LEGEND לכל פרוסת עוגה משויכת תווית.

תרשים בועות

תרשים בועות.

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

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

מיקום הבועה בטבלה

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

טיפוסים בני מנייה (enum)
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
BOTTOM_LEGEND המקרא מוצג בחלק התחתון של התרשים.
LEFT_LEGEND המקרא מוצג בצד שמאל של התרשים.
RIGHT_LEGEND המקרא מוצג בצד שמאל של התרשים.
TOP_LEGEND האגדה מעובדת בחלק העליון של התרשים.
NO_LEGEND לא מוצג אף מקרא.
INSIDE_LEGEND המקרא מוצג בתוך אזור התרשים.

עמידת צינור בתרשים

תרשים פמוט.

ייצוג JSON 
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
שדות
domain

object (CandlestickDomain)

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

data[]

object (CandlestickData)

הנתונים של תרשים הנרות. יש תמיכה בקובץ CandleickData אחד בלבד.

דומיין Candleick

הדומיין של CandleickChart.

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

object (ChartData)

הנתונים של CandleickDomain.

reversed

boolean

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

נתוני נרות

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

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

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

סדרת נרות

סדרה של CandleickData.

ייצוג JSON 
{
  "data": {
    object (ChartData)
  }
}
שדות
data

object (ChartData)

הנתונים של CandleickSeries.

מפרט OrgChart

תרשים ארגוני. לתרשימים ארגוניים נדרשת קבוצה ייחודית של תוויות ב- labels ועשויים לכלול parentLabels ו-tooltips. parentLabels מכיל את התווית שמזהה את צומת ההורה של כל צומת. tooltips מכיל הסבר קצר אופציונלי לכל צומת.

לדוגמה, כדי לתאר את OrgChart עם Alice בתפקיד מנכ"ל, בוב כנשיא (דיווח לאליס) ואת קאת'י כסמנכ"לית מכירות (מדווחת גם לאליס), מכילים את labels שכוללות את "Alice", "Bob", "Cathy", parentLabels כוללות את ""Alice", "Alice" ואת tooltips מכילות "CEO", " נשיא", " נשיא"

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

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

גודל התרשים של הארגון

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

טיפוסים בני מנייה (enum)
ORG_CHART_LABEL_SIZE_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
SMALL גודל הצומת הקטן בתרשים הארגוני.
MEDIUM גודל הצומת של התרשים הארגוני הבינוני.
LARGE גודל הצומת הגדול של התרשים הארגוני.

מפרט היסטוגרמה

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

ייצוג JSON 
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
שדות
series[]

object (HistogramSeries)

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

legendPosition

enum (HistogramChartLegendPosition)

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

showItemDividers

boolean

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

bucketSize

number

כברירת מחדל, גודל הקטגוריה (טווח הערכים בערימה בעמודה אחת) נבחר באופן אוטומטי, אבל אפשר לשנות אותו כאן. למשל: גודל קבוצה של 1.5 מוביל לקטגוריות בין 0 ל-1.5, 1.5 - 3.0 וכו'. לא יכול להיות שלילי. השדה הזה אופציונלי.

outlierPercentile

number

האחוזון החיצוני משמש כדי לוודא שהחריגים לא ישפיעו לרעה על החישוב של גודל הקטגוריות. לדוגמה, הגדרת אחוזון חיצוני של 0.05, מציינת שה-5% העליונים והתחתונים של הערכים כשמחושבים את הקטגוריות. הערכים עדיין נכללים בתרשים, והם יתווספו לקטגוריה הראשונה או האחרונה במקום לקטגוריה שלהם. חייב להיות בין 0.0 ל-0.5.

סדרת היסטוגרמה

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

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

object (Color)

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

barColorStyle

object (ColorStyle)

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

data

object (ChartData)

הנתונים עבור סדרת ההיסטוגרמה הזו.

היסטוגרמה.

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

טיפוסים בני מנייה (enum)
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED ערך ברירת המחדל, לא להשתמש.
BOTTOM_LEGEND המקרא מוצג בחלק התחתון של התרשים.
LEFT_LEGEND המקרא מוצג בצד שמאל של התרשים.
RIGHT_LEGEND המקרא מוצג בצד שמאל של התרשים.
TOP_LEGEND האגדה מעובדת בחלק העליון של התרשים.
NO_LEGEND לא מוצג אף מקרא.
INSIDE_LEGEND המקרא מוצג בתוך אזור התרשים.

מפרט WaterfallChart

תרשים מפל.

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

דומיין WaterfallChart

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

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

object (ChartData)

הנתונים של WaterfallChartDomain.

reversed

boolean

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

סדרות WaterfallChart

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

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

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

סגנון תרשים עמודות של מפל

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

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

string

התווית של מקרא העמודה.

color
(deprecated)

object (Color)

צבע העמודה. הוצאה משימוש: colorStyle.

colorStyle

object (ColorStyle)

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

סה"כ WaterfallChartCustomSubtotal

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

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

integer

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

label

string

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

dataIsSubtotal

boolean

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

סוג WaterfallChartStacked

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

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

תרשים מפת עץ

תרשים מפת עץ.

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

object (ChartData)

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

parentLabels

object (ChartData)

הנתונים ששייכים לתוויות ההורה של תאי העץ.

sizeData

object (ChartData)

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

colorData

object (ChartData)

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

textFormat

object (TextFormat)

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

levels

integer

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

hintedLevels

integer

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

minValue

number

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

maxValue

number

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

headerColor
(deprecated)

object (Color)

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

headerColorStyle

object (ColorStyle)

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

colorScale

object (TreemapChartColorScale)

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

hideTooltips

boolean

True כדי להסתיר הסברים קצרים.

תרשים מפת צבעים:צבע שינוי

קנה מידה של תרשים בתרשים עץ.

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

object (Color)

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

minValueColorStyle

object (ColorStyle)

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

midValueColor
(deprecated)

object (Color)

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

midValueColorStyle

object (ColorStyle)

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

maxValueColor
(deprecated)

object (Color)

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

maxValueColorStyle

object (ColorStyle)

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

noDataColor
(deprecated)

object (Color)

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

noDataColorStyle

object (ColorStyle)

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

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

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

ערך מפתח

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

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

סוג השוואה

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

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

מספר

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

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

ChartCustomNumberFormatOption

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

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

string

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

suffix

string

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

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

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

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

מוט אובייקט מוטמע

גבול לאורך אובייקט מוטמע.

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

object (Color)

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

colorStyle

object (ColorStyle)

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