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 لجعل الرسم البياني يملأ المساحة الكاملة التي يتم عرضه فيها بالحد الأدنى للمساحة المتروكة. خطأ لاستخدام المساحة المتروكة التلقائية. (لا ينطبق ذلك على الرسوم البيانية الجغرافية والمخططات التنظيمية).

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" عدد الصفوف التي تحتوي على عناوين بناءً على البيانات.

(لاحظ أن BasicChartAxis.title عنوان المحور الذي تم استنتاجه من قيم العنوان).

threeDimensional

boolean

True لجعل المخطط ثلاثي الأبعاد. تنطبق هذه السياسة على الرسوم البيانية الشريطية والعمودية.

interpolateNulls

boolean

في حال عدم توفّر بعض القيم في سلسلة معيَّنة، قد تظهر فجوات في الرسم البياني (على سبيل المثال، ستكون أجزاء الخطوط في رسم بياني خطي غير متوفّرة). ولسد هذه الثغرات، عليك ضبط هذا الخيار على "صحيح". ينطبق على المخططات الخطية والمساحية والمختلطة.

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

كيف يجب تصور المخطط.

عمليات التعداد
BASIC_CHART_TYPE_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدامها.
BAR حاسمة مخطط شريطي.
LINE حاسمة مخطط خطي.
AREA إنّ مخطط مساحي.
COLUMN حاسمة مخطط عمودي.
SCATTER حاسمة مخططًا بالنقاط المبعثرة.
COMBO حاسمة مخطط التحرير والسرد.
STEPPED_AREA حاسمة مخطط مساحي مدرّج.

BasicChartLegendPosition

المكان الذي يجب وضع وسيلة إيضاح الرسم البياني فيه

عمليات التعداد
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

موضع محور الرسم البياني.

عمليات التعداد
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

وضع نافذة العرض. وتحدّد هذه السياسة كيفية التعامل مع الحدّ الأدنى والأقصى لنافذة العرض.

عمليات التعداد
DEFAULT_VIEW_WINDOW_MODE وضع نافذة العرض التلقائي المُستخدَم في محرّر "جداول بيانات Google" لهذا النوع من الرسوم البيانية. في معظم الحالات، إذا تم التعيين، يكون الوضع الافتراضي معادلاً PRETTY
VIEW_WINDOW_MODE_UNSUPPORTED يُرجى عدم استخدامها. لتمثيل أن الوضع المعين حاليًا غير متوافق مع واجهة برمجة التطبيقات.
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

الأنواع المتاحة من قواعد تجميع التاريخ والوقت.

عمليات التعداد
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED النوع التلقائي هو عدم الاستخدام.
SECOND قم بتجميع التواريخ حسب الثانية، من 0 إلى 59.
MINUTE تجميع التواريخ حسب الدقيقة، من 0 إلى 59.
HOUR تجميع التواريخ حسب الساعة باستخدام نظام 24 ساعة، من 0 إلى 23.
HOUR_MINUTE تجميع التواريخ حسب الساعة والدقيقة باستخدام نظام 24 ساعة، على سبيل المثال 19:45.
HOUR_MINUTE_AMPM تجميع التواريخ حسب الساعة والدقيقة باستخدام نظام 12 ساعة، على سبيل المثال 7:45 مساءً. تتم ترجمة تعيين صباحًا/مساءً بناءً على لغة جدول البيانات.
DAY_OF_WEEK يمكنك تجميع التواريخ حسب أيام الأسبوع، مثل الأحد. ستتم ترجمة أيام الأسبوع استنادًا إلى لغة جدول البيانات.
DAY_OF_YEAR تجميع التواريخ حسب اليوم من السنة، من 1 إلى 366. تجدر الإشارة إلى أنّ التواريخ التي تلي 29 شباط (فبراير) تندرج في مجموعات مختلفة في السنوات الكبيسة مقارنةً بالسنوات غير الكبيسة.
DAY_OF_MONTH تجميع التواريخ حسب اليوم من الشهر، من 1 إلى 31.
DAY_MONTH تجميع التواريخ حسب اليوم والشهر، على سبيل المثال 22 نوفمبر. تتم ترجمة الشهر بناءً على لغة جدول البيانات.
MONTH وتجميع التواريخ حسب الشهر، مثل تشرين الثاني (نوفمبر)، حيث تتم ترجمة الشهر بناءً على لغة جدول البيانات.
QUARTER تجميع التواريخ حسب ربع السنة، على سبيل المثال Q1 (الذي يمثل يناير - مارس).
YEAR تجميع التواريخ حسب السنة، على سبيل المثال 2008.
YEAR_MONTH تجميع التواريخ حسب السنة والشهر، على سبيل المثال 2008-نوفمبر 2008. تتم ترجمة الشهر بناءً على لغة جدول البيانات.
YEAR_QUARTER تجميع التواريخ حسب السنة والربع، على سبيل المثال، الربع الرابع من عام 2008
YEAR_MONTH_DAY تجميع التواريخ حسب السنة والشهر واليوم، على سبيل المثال 2008-11-22.

ChartHistogramRule

تسمح لك بتنظيم القيم الرقمية في عمود بيانات المصدر في مجموعات ذات حجم ثابت.

تمثيل JSON
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
الحقول
minValue

number

الحد الأدنى لقيمة العناصر التي يتم وضع العناصر بها في مجموعات. يتم تجميع القيم التي تقل عن الحد الأدنى في مجموعة بيانات واحدة. وفي حال حذفها، يتم تحديدها من خلال الحدّ الأدنى لقيمة العنصر.

maxValue

number

الحد الأقصى لقيمة يتم وضع العناصر في مجموعات. يتم تجميع القيم التي تزيد عن الحد الأقصى في مجموعة واحدة. وفي حال حذفها، يتم تحديدها من خلال الحدّ الأقصى لقيمة العنصر.

intervalSize

number

حجم الحِزم التي يتم إنشاؤها. يجب أن تكون موجبة.

ChartAggregateType

نوع التجميع لسلسلة الرسوم البيانية.

عمليات التعداد
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)

المحور الثانوي الذي سيحدد نطاق قيم هذه السلسلة. على سبيل المثال، إذا تم رسم مخطط للأسهم بمرور الوقت، فإن عمود "الحجم" قد ترغب في تثبيتها على اليمين مع تثبيت الأسعار على اليسار، لأن مقياس حجم التداول مختلف عن مقياس الأسعار. يعد تحديد محور ليس محورًا ثانويًا صالحًا لمخطط type

type

enum (BasicChartType)

نوع هذه السلسلة. صالح فقط إذا كانت chartType CANNOT TRANSLATE COMBO ستغير الأنواع المختلفة طريقة عرض السلسلة. فقط LINE, AREA و COLUMN

lineStyle

object (LineStyle)

نمط الخط لهذه السلسلة. صالح فقط إذا كانت chartType CANNOT TRANSLATE AREA, LINE، أو SCATTER COMBO المخططات أيضًا إذا كانت series chart type CANNOT TRANSLATE AREA أو LINE

dataLabel

object (DataLabel)

معلومات حول تصنيفات البيانات لهذه السلسلة

color
(deprecated)

object (Color)

لون العناصر (مثل الأشرطة والخطوط والنقاط) المرتبطة بهذه السلسلة إذا كانت فارغة، سيتم استخدام لون تلقائي. مهملة: استخدام colorStyle

colorStyle

object (ColorStyle)

لون العناصر (مثل الأشرطة والخطوط والنقاط) المرتبطة بهذه السلسلة إذا كانت فارغة، سيتم استخدام لون تلقائي. في حال حذف color يتم أيضًا، تكون الأولوية لهذا الحقل.

pointStyle

object (PointStyle)

تمثّل هذه السمة نمط النقاط المرتبطة بهذه السلسلة. صالح فقط إذا كانت chartType CANNOT TRANSLATE AREA, LINE، أو SCATTER COMBO المخططات أيضًا إذا كانت series chart type CANNOT TRANSLATE AREA, LINE، أو SCATTER إذا كانت فارغة، يتم استخدام نمط نقطة تلقائي.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

إعدادات إلغاء النمط لنقاط بيانات السلسلة

LineStyle

الخصائص التي تصف نمط الخط.

تمثيل JSON
{
  "width": integer,
  "type": enum (LineDashType)
}
الحقول
width

integer

سُمك الخط، بالبكسل.

type

enum (LineDashType)

نوع شرطة الخط.

LineDashType

نوع شرطة الخط.

عمليات التعداد
LINE_DASH_TYPE_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدامها.
INVISIBLE بدون نوع شرطة، أي ما يعادل خطًا غير مرئي
CUSTOM شرطة مخصّصة لخط. لا يمكن حاليًا تعديل نمط الشرطة المخصّصة تحديدًا.
SOLID خط متصل
DOTTED خط منقط
MEDIUM_DASHED خط متقطع حيث تحتوي الشرطات على "متوسط" المنقار.
MEDIUM_DASHED_DOTTED خط يتناوب بين "متوسط" شرطة ونقطة.
LONG_DASHED خط متقطع حيث تكون الشرطات "طويلة" المنقار.
LONG_DASHED_DOTTED خط يتناوب بين خط "طويل" شرطة ونقطة.

DataLabel

إعدادات لمجموعة واحدة من تصنيفات البيانات. تسميات البيانات هي تعليقات توضيحية تظهر بجوار مجموعة من البيانات، مثل النقاط الموجودة على مخطط خطي، وتوفر معلومات إضافية حول ما تمثله البيانات، مثل التمثيل النصي للقيمة الكامنة وراء تلك النقطة على الرسم البياني.

تمثيل JSON
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
الحقول
type

enum (DataLabelType)

نوع تصنيف البيانات.

textFormat

object (TextFormat)

تنسيق النص المستخدم لتصنيف البيانات. حقل الرابط غير متاح.

placement

enum (DataLabelPlacement)

تمثّل هذه السمة موضع تصنيف البيانات بالنسبة إلى البيانات المصنّفة.

customLabelData

object (ChartData)

البيانات المطلوب استخدامها للتصنيفات المخصّصة. تُستخدم فقط إذا type تم ضبطه على CUSTOM يجب أن تكون هذه البيانات بنفس طول السلسلة أو العنصر الآخر الذي يتم تطبيق تصنيف البيانات هذا عليه. بالإضافة إلى ذلك، إذا كانت السلسلة مقسّمة إلى نطاقات مصادر متعدّدة، يجب أن تأتي بيانات المصدر هذه من العمود التالي في بيانات المصدر. على سبيل المثال، إذا كانت السلسلة هي B2:B4,E6:E8، يجب أن تأتي هذه البيانات من C2:C4,F6:F8.

DataLabelType

نوع تصنيف البيانات.

عمليات التعداد
DATA_LABEL_TYPE_UNSPECIFIED لم يتم تحديد نوع تصنيف البيانات وسيتم تفسيره اعتمادًا على سياق تصنيف البيانات داخل الرسم البياني.
NONE تصنيف البيانات غير ظاهر.
DATA يتم عرض تصنيف البيانات باستخدام قيم من بيانات السلسلة.
CUSTOM يتم عرض تصنيف البيانات باستخدام القيم من مصدر بيانات مخصّص يُشار إليه باسم customLabelData

DataLabelPlacement

تمثّل هذه السمة موضع تصنيف البيانات بالنسبة إلى البيانات المصنّفة.

عمليات التعداد
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

شكل النقطة.

عمليات التعداد
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 CANNOT TRANSLATE AREA, LINE، أو SCATTER COMBO المخططات أيضًا إذا كانت series chart type CANNOT TRANSLATE AREA, LINE، أو SCATTER إذا كانت فارغة، يتم استخدام القيمة التلقائية للسلسلة.

BasicChartStackedType

عند تكديس المخططات، يتم عرض قيم النطاق (المحور العمودي) فوق بعضها البعض بدلاً من المحور الأفقي. على سبيل المثال، سيتم رسم القيمتين 20 و80 من 0، حيث تبعد 80 عن المحور الأفقي 80 وحدة. وإذا تم تكديسها، فسيتم عرض 80 من 20، مما يضعها على بُعد 100 وحدة من المحور الأفقي.

عمليات التعداد
BASIC_CHART_STACKED_TYPE_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدامها.
NOT_STACKED السلسلة غير مكدسة.
STACKED تُكدس قيم السلسلة، ويتم عرض كل قيمة عموديًا بدءًا من أعلى القيمة التي تقع أسفلها.
PERCENT_STACKED يتم تمديد المكدسات العمودية للوصول إلى أعلى المخطط، مع وضع القيم كنسب مئوية لبعضها البعض.

BasicChartCompareMode

نوع وضع المقارنة الذي يصف سلوك تلميحات الأدوات وتمييز البيانات عند تمرير مؤشر الماوس فوق البيانات ومنطقة الرسم البياني.

عمليات التعداد
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

المكان الذي يجب وضع وسيلة إيضاح الرسم البياني فيه

عمليات التعداد
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)

البيانات التي تحتوي على قيم الفقاعة التفسيرية "س". تحدد هذه القيم الفقاعات التفسيرية في المخطط أفقيًا.

series

object (ChartData)

البيانات التي تحتوي على قيم ص-الفقاعة. تحدد هذه القيم الفقاعات التفسيرية في الرسم البياني عموديًا.

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

المكان الذي يجب وضع وسيلة إيضاح الرسم البياني فيه

عمليات التعداد
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

نطاق مخطط الشموع.

تمثيل 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

سلسلة بيانات الشموع.

تمثيل JSON
{
  "data": {
    object (ChartData)
  }
}
الحقول
data

object (ChartData)

بيانات سلسلة CandlestickSeries.

OrgChartSpec

إنّ مخطط org. تتطلب المخططات التنظيمية مجموعة فريدة من التصنيفات في labels وقد تتضمن بشكل اختياري parentLabels أو tooltips parentLabels سيحتوي، لكل عقدة، على التسمية التي تحدد العقدة الأصلية. tooltips يحتوي على تلميح اختياري لكل عقدة.

على سبيل المثال، لوصف مخطط هيكلي مع أليس كرئيسة تنفيذية، فإن بوب كرئيس (تقديم تقرير إلى أليس) وكاثي كنائب رئيس للمبيعات (يقدم أيضًا تقارير إلى أليس)، يجب أن labels تحتوي على "أليس" و"بوب" و"كاثي" parentLabels تحتوي على "", "Alice", "Alice" أو tooltips وتحتوي على "رئيس تنفيذي"، "الرئيس"، "VP Sales".

تمثيل 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

حجم عُقد الرسم البياني للمؤسسة.

عمليات التعداد
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

المكان الذي يجب وضع وسيلة إيضاح الرسم البياني فيه

عمليات التعداد
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدامها.
BOTTOM_LEGEND يتم عرض وسيلة الإيضاح في أسفل الرسم البياني.
LEFT_LEGEND يتم عرض وسيلة الإيضاح على يسار الرسم البياني.
RIGHT_LEGEND يتم عرض وسيلة الإيضاح على يمين الرسم البياني.
TOP_LEGEND يتم عرض وسيلة الإيضاح في أعلى الرسم البياني.
NO_LEGEND لا يتم عرض أي وسيلة إيضاح.
INSIDE_LEGEND يتم عرض وسيلة الإيضاح داخل منطقة الرسم البياني.

WaterfallChartSpec

رسم بياني انحداري.

تمثيل JSON
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
الحقول
domain

object (WaterfallChartDomain)

بيانات النطاق (المحور الأفقي) للرسم البياني الانحداري

series[]

object (WaterfallChartSeries)

البيانات التي يعرضها الرسم البياني الانحداري هذا

stackedType

enum (WaterfallChartStackedType)

النوع المكدس.

firstValueIsTotal

boolean

صحيح لتفسير القيمة الأولى كإجمالي.

hideConnectorLines

boolean

صحيح لإخفاء خطوط الموصل بين الأعمدة.

connectorLineStyle

object (LineStyle)

نمط الخط لخطوط الموصل.

totalDataLabel

object (DataLabel)

تتحكّم هذه السياسة في ما إذا كان سيتم عرض تصنيفات بيانات إضافية في الرسوم البيانية المكدّسة التي تجمع القيمة الإجمالية لجميع القيم المكدّسة في كل قيمة على طول محور النطاق. stackedType يجب أن يكون STACKED ولا CUSTOM ولا placement يمكن ضبطها على totalDataLabel

WaterfallChartDomain

نطاق الرسم البياني الانحداري.

تمثيل JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
الحقول
data

object (ChartData)

بيانات الشلال والمخطط.

reversed

boolean

True لعكس ترتيب قيم المجال (المحور الأفقي).

WaterfallChartSeries

سلسلة واحدة من البيانات لرسم بياني انحداري.

تمثيل JSON
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
الحقول
data

object (ChartData)

البيانات التي يتم تمثيلها في هذه السلسلة.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

أنماط لجميع الأعمدة في هذه السلسلة ذات القيم الموجبة.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

أنماط لجميع الأعمدة في هذه السلسلة بقيم سلبية.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

أنماط لجميع أعمدة الإجمالي الفرعي في هذه السلسلة.

hideTrailingSubtotal

boolean

True لإخفاء عمود الإجمالي الفرعي من نهاية السلسلة. سيظهر عمود الإجمالي الفرعي بشكلٍ تلقائي في نهاية كلّ سلسلة. سيؤدي ضبط هذا الحقل على "صحيح" إلى إخفاء عمود الإجمالي الفرعي لهذه السلسلة.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

تظهر أعمدة الإجمالي الفرعي المخصّص في هذه السلسلة إنّ الترتيب الذي يتم فيه تعريف الإجماليات الفرعية ليس مهمًا. يمكن تحديد إجمالي فرعي واحد فقط لكل نقطة بيانات.

dataLabel

object (DataLabel)

معلومات حول تصنيفات البيانات لهذه السلسلة

WaterfallChartColumnStyle

أنماط لعمود الرسم البياني الانحداري

تمثيل JSON
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
الحقول
label

string

تسمية وسيلة إيضاح العمود.

color
(deprecated)

object (Color)

لون العمود. مهملة: استخدام colorStyle

colorStyle

object (ColorStyle)

لون العمود. في حال حذف color يتم أيضًا، تكون الأولوية لهذا الحقل.

WaterfallChartCustomSubtotal

عمود إجمالي فرعي مخصّص لسلسلة رسم بياني انحداري

تمثيل JSON
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
الحقول
subtotalIndex

integer

الفهرس القائم على صفر لنقطة بيانات في السلسلة. في حال حذف dataIsSubtotal صحيح، فإن نقطة البيانات في هذا الفهرس هي الإجمالي الفرعي. وبخلاف ذلك، يظهر الإجمالي الفرعي بعد نقطة البيانات مع هذا الفهرس. يمكن أن تحتوي السلسلة على إجماليات فرعية متعددة عند الفهارس العشوائية، لكن الإجماليات الفرعية لا تؤثر في مؤشرات نقاط البيانات. على سبيل المثال، إذا كانت السلسلة تحتوي على ثلاث نقاط بيانات، ستكون فهارسها دائمًا 0 و1 و2، بصرف النظر عن عدد الإجماليات الفرعية الموجودة في السلسلة أو نقاط البيانات المرتبطة بها.

label

string

تسمية لعمود الإجمالي الفرعي.

dataIsSubtotal

boolean

صواب إذا كانت نقطة البيانات في subtotalIndex هو الإجمالي الفرعي. وإذا كان false، فسيتم حساب الإجمالي الفرعي وسيظهر بعد نقطة البيانات.

WaterfallChartStackedType

خيارات النوع المكدّس للمخططات الانحدارية.

عمليات التعداد
WATERFALL_STACKED_TYPE_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدامها.
STACKED سيتم تكديس القيم المقابلة لقيمة النطاق (المحور الأفقي) نفسها عموديًا.
SEQUENTIAL ستنتشر السلسلة على طول المحور الأفقي.

TreemapChartSpec

حاسمة مخطط Treemap.

تمثيل JSON
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
الحقول
labels

object (ChartData)

البيانات التي تحتوي على تصنيفات الخلايا الهيكلية.

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)

لون الخلفية للخلايا التي لا تحتوي على بيانات ألوان مرتبطة بها. وتكون القيمة التلقائية هي #000000 إذا لم يتم تحديدها. مهملة: استخدام noDataColorStyle

noDataColorStyle

object (ColorStyle)

لون الخلفية للخلايا التي لا تحتوي على بيانات ألوان مرتبطة بها. وتكون القيمة التلقائية هي #000000 إذا لم يتم تحديدها. في حال حذف noDataColor يتم أيضًا، تكون الأولوية لهذا الحقل.

ScorecardChartSpec

رسم بياني لبطاقة قياس الأداء يتم استخدام مخططات بطاقة قياس الأداء لتسليط الضوء على مؤشرات الأداء الرئيسية، والمعروفة باسم KPIs، في جدول البيانات. يمكن أن يمثّل الرسم البياني لبطاقة قياس الأداء عناصر مثل إجمالي المبيعات أو متوسط التكلفة أو العنصر الأكثر مبيعًا. ويمكنك تحديد قيمة بيانات واحدة أو تجميعها من خلال نطاق من البيانات. يمكن تمييز النسبة المئوية أو الفرق المطلق عن قيمة مرجعية، مثل التغييرات بمرور الوقت.

تمثيل 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

نوع مقارنة القيمة الرئيسية بالقيمة المرجعية.

عمليات التعداد
COMPARISON_TYPE_UNDEFINED القيمة التلقائية، يُرجى عدم استخدامها.
ABSOLUTE_DIFFERENCE يجب استخدام الفرق المطلق بين القيمة الأساسية والقيمة المرجعية.
PERCENTAGE_DIFFERENCE استخدِم الفرق بالنسبة المئوية بين القيمة الأساسية والقيمة المرجعية.

ChartNumberFormatSource

خيارات مصدر تنسيق الأرقام لسمات الرسم البياني

عمليات التعداد
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED القيمة التلقائية، يُرجى عدم استخدامها.
FROM_DATA اكتساب تنسيق الأرقام من البيانات.
CUSTOM تطبيق التنسيق المخصص كما هو محدد بواسطة ChartCustomNumberFormatOptions

ChartCustomNumberFormatOptions

خيارات تنسيق الأرقام المخصّصة لسمات الرسم البياني

تمثيل JSON
{
  "prefix": string,
  "suffix": string
}
الحقول
prefix

string

بادئة مخصصة يمكن إلحاقها بسمة الرسم البياني. هذا الحقل اختياري.

suffix

string

لاحقة مخصّصة سيتم إلحاقها بسمة الرسم البياني. هذا الحقل اختياري.

ChartHiddenDimensionStrategy

تحدِّد هذه السياسة كيفية تعامل الرسومات البيانية مع صفوف المصدر المخفية. تتضمّن الصفوف المخفية كلاً من المخفية والمخفية يدويًا باستخدام فلتر.

عمليات التعداد
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 يتم أيضًا، تكون الأولوية لهذا الحقل.