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

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

backgroundColor
(deprecated)

object (Color)

لون خلفية الرسم البياني بالكامل لا ينطبق ذلك على الرسوم البيانية للهيكل التنظيمي. متوقّفة نهائيًا: استخدِم backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

لون خلفية الرسم البياني بأكمله لا ينطبق ذلك على الرسوم البيانية الهيكلية. إذا تم ضبط backgroundColor أيضًا، ستكون الأولوية لهذا الحقل.

dataSourceChartProperties

object (DataSourceChartProperties)

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

filterSpecs[]

object (FilterSpec)

الفلاتر المطبَّقة على بيانات المصدر في الرسم البياني لا يتوافق هذا الإجراء إلا مع الرسوم البيانية لمصادر البيانات.

sortSpecs[]

object (SortSpec)

الترتيب الذي يتم ترتيب بيانات الرسم البياني حسبه. لا يُسمح إلا بمواصفة ترتيب واحدة. لا تتوفّر هذه الميزة إلا للرسومات البيانية لمصدر البيانات.

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

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

حقل الربط chart. يجب ضبط قيمة واحدة بالضبط في مواصفات الرسم البياني المحدّدة. chart يمكن أن تكون إحدى القيم التالية فقط:
basicChart

object (BasicChartSpec)

يمكن أن تكون مواصفات المخطط الأساسية واحدة من أنواع عديدة من المخططات. اطّلِع على BasicChartType للحصول على قائمة بجميع الرسوم البيانية المتوافقة مع هذا الخيار.

pieChart

object (PieChartSpec)

مواصفات الرسم البياني الدائري

bubbleChart

object (BubbleChartSpec)

مواصفات الرسم البياني الفقاعي.

candlestickChart

object (CandlestickChartSpec)

مواصفات رسم بياني بالشموع

orgChart

object (OrgChartSpec)

مواصفات الرسم البياني الهيكلي

histogramChart

object (HistogramChartSpec)

مواصفات الرسم البياني للمدرج التكراري

waterfallChart

object (WaterfallChartSpec)

مواصفات الرسم البياني الإنحداري

treemapChart

object (TreemapChartSpec)

مواصفات الرسم البياني الهيكلي

scorecardChart

object (ScorecardChartSpec)

مواصفات الرسم البياني لبطاقة قياس الأداء

TextPosition

إعدادات موضع النص

تمثيل JSON 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
الحقول
horizontalAlignment

enum (HorizontalAlign)

إعداد المحاذاة الأفقية لقطعة النص

DataSourceChartProperties

خصائص الرسم البياني لمصدر البيانات.

تمثيل JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
الحقول
dataSourceId

string

معرّف مصدر البيانات المرتبط بالرسم البياني

dataExecutionStatus

object (DataExecutionStatus)

النتائج فقط. حالة تنفيذ البيانات

BasicChartSpec

مواصفات الرسم البياني الأساسي اطّلِع على BasicChartType للاطّلاع على قائمة الرسوم البيانية المتوافقة مع هذه الميزة.

تمثيل JSON 
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
الحقول
chartType

enum (BasicChartType)

نوع الرسم البياني

legendPosition

enum (BasicChartLegendPosition)

موضع العنوان التفسيري للرسم البياني

axis[]

object (BasicChartAxis)

محور الرسم البياني

domains[]

object (BasicChartDomain)

نطاق البيانات التي يتمّ إنشاء الرسم البياني لها. يمكن استخدام نطاق واحد فقط.

series[]

object (BasicChartSeries)

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

headerCount

integer

عدد الصفوف أو الأعمدة في البيانات والتي تكون "رؤوس". في حال عدم ضبط هذه القيمة، ستتوقّع "جداول بيانات Google" عدد الصفوف التي تتضمّن عناوين استنادًا إلى البيانات.

(يُرجى العِلم أنّه BasicChartAxis.title قد تلغي عنوان المحور المستنِد إلى قيم العناوين).

threeDimensional

boolean

صحيح لإنشاء رسم بياني ثلاثي الأبعاد. ينطبق على الرسوم البيانية الشريطية والعمودية.

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 مساءً تتم ترجمة رمزَي AM/PM استنادًا إلى لغة جدول البيانات.
DAY_OF_WEEK يمكنك تجميع التواريخ حسب أيام الأسبوع، مثل الأحد. ستتم ترجمة أيام الأسبوع استنادًا إلى لغة جدول البيانات.
DAY_OF_YEAR تجميع التواريخ حسب اليوم من السنة، من 1 إلى 366 تجدر الإشارة إلى أنّ التواريخ التي تلي 29 شباط (فبراير) تندرج ضمن مجموعات مختلفة في السنوات الكبيسة مقارنةً بالسنوات غير الكبيسة.
DAY_OF_MONTH تجميع التواريخ حسب اليوم من الشهر، من 1 إلى 31
DAY_MONTH تجميع التواريخ حسب اليوم والشهر، على سبيل المثال 22 تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات.
MONTH تجميع التواريخ حسب الشهر، على سبيل المثال تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات.
QUARTER يمكنك تجميع التواريخ حسب الربع، على سبيل المثال الربع الأول (الذي يمثّل الفترة من كانون الثاني/يناير إلى آذار/مارس).
YEAR تجميع التواريخ حسب السنة، على سبيل المثال 2008.
YEAR_MONTH تجميع التواريخ حسب السنة والشهر، على سبيل المثال ‎2008-تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات.
YEAR_QUARTER تجميع التواريخ حسب السنة والربع، على سبيل المثال، الربع الرابع من عام 2008
YEAR_MONTH_DAY تجميع التواريخ حسب السنة والشهر واليوم، على سبيل المثال ‎22-11-2008

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 هي COMBO. سيؤدي استخدام أنواع مختلفة إلى تغيير طريقة عرض السلسلة. يمكن استخدام LINE AREA COLUMN فقط.

lineStyle

object (LineStyle)

نمط الخط لهذه السلسلة. لا تكون صالحة إلا إذا كان chartType هو AREA أو LINE أو SCATTER. يمكن أيضًا استخدام الرسوم البيانية COMBO إذا كان series chart type هو AREA أو LINE.

dataLabel

object (DataLabel)

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

color
(deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

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

pointStyle

object (PointStyle)

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

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

تتجاهل إعدادات النمط نقاط بيانات السلسلة.

LineStyle

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

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

integer

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

type

enum (LineDashType)

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

LineDashType

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

عمليات التعداد
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 هي AREA أو LINE أو SCATTER. يمكن أيضًا استخدام COMBO الرسوم البيانية إذا كان series chart type هو 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

صحيح إذا كانت قطعة الكعكة ثلاثية الأبعاد.

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)

البيانات التي تحتوي على قيم x للفقاعات تحدِّد هذه القيم موضع الفقاعات في الرسم البياني أفقيًا.

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

صحيح لعكس ترتيب قيم النطاق (المحور الأفقي).

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

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

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

تمثيل JSON 
{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}
الحقول
nodeSize

enum (OrgChartNodeSize)

حجم عقد مخطّط الهيكل التنظيمي

nodeColor
(deprecated)

object (Color)

لون عقد الرسم البياني التنظيمي متوقّفة نهائيًا: استخدِم nodeColorStyle.

nodeColorStyle

object (ColorStyle)

لون عقد الرسم البياني التنظيمي إذا تم ضبط nodeColor أيضًا، ستكون الأولوية لهذا الحقل.

selectedNodeColor
(deprecated)

object (Color)

لون عقد الرسم البياني الهيكلي المحدّدة متوقّفة نهائيًا: استخدِم selectedNodeColorStyle.

selectedNodeColorStyle

object (ColorStyle)

لون عقد الرسم البياني الهيكلي المحدّدة إذا تم ضبط selectedNodeColor أيضًا، ستكون الأولوية لهذا الحقل.

labels

object (ChartData)

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

parentLabels

object (ChartData)

البيانات التي تحتوي على تصنيف العنصر الرئيسي للعقدة المقابلة تشير القيمة الفارغة إلى أنّ العقدة لا تحتوي على عقدة رئيسية وأنّها عقدة من المستوى الأعلى. هذا الحقل اختياري.

tooltips

object (ChartData)

البيانات التي تحتوي على التلميح التوضيحي للعقدة المقابلة يؤدي استخدام قيمة فارغة إلى عدم عرض أي نص إرشادي للعقدة. هذا الحقل اختياري.

OrgChartNodeSize

حجم عقد مخطّط الهيكل التنظيمي

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

صحيح لعكس ترتيب قيم النطاق (المحور الأفقي).

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

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

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

WaterfallChartStackedType

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

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

TreemapChartSpec

رسم بياني لخريطة متفرعة

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

object (ChartData)

البيانات التي تحتوي على تصنيفات خلايا المخطّط الهيكلي

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 ، يكون لهذا الحقل الأولوية.