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

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

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

نطاق CandlestickChart.

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

سلسلة CandlestickData.

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

object (ChartData)

بيانات CandlestickSeries.

OrgChartSpec

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

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

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

enum (OrgChartNodeSize)

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

nodeColor
(deprecated)

object (Color)

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

nodeColorStyle

object (ColorStyle)

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

selectedNodeColor
(deprecated)

object (Color)

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

selectedNodeColorStyle

object (ColorStyle)

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

labels

object (ChartData)

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

parentLabels

object (ChartData)

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

tooltips

object (ChartData)

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

OrgChartNodeSize

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

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

بيانات WaterfallChartDomain

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

صحيح لإخفاء عمود "المجموع الفرعي" من نهاية السلسلة. سيظهر عمود المجموع الفرعي تلقائيًا في نهاية كل سلسلة. سيؤدي ضبط هذا الحقل على 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 هي true، تكون نقطة البيانات في هذا الفهرس هي المجموع الفرعي. بخلاف ذلك، يظهر المجموع الفرعي بعد نقطة البيانات التي تحتوي على هذا الفهرس. يمكن أن تحتوي السلسلة على عدة أقسام فرعية في فهارس عشوائية، ولكنّ الأقسام الفرعية لا تؤثّر في فهارس نقاط البيانات. على سبيل المثال، إذا كانت السلسلة تحتوي على ثلاث نقاط بيانات، ستكون مؤشراتها دائمًا 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

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

تمثيل JSON 
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
الحقول
keyValueData

object (ChartData)

بيانات قيمة مفتاح بطاقة قياس الأداء

baselineValueData

object (ChartData)

بيانات القيمة الأساسية لبطاقة قياس الأداء هذا الحقل اختياري.

aggregateType

enum (ChartAggregateType)

نوع التجميع لبيانات الرسم البياني الرئيسي والرسم البياني الأساسي في رسم بياني بطاقة قياس الأداء لا يمكن استخدام هذا الحقل في الرسوم البيانية لمصدر البيانات. استخدِم الحقل ChartData.aggregateType في جدول الاطِّلاع keyValueData أو baselineValueData بدلاً من ذلك للرسوم البيانية لمصدر البيانات. هذا الحقل اختياري.

keyValueFormat

object (KeyValueFormat)

خيارات تنسيق قيمة المفتاح

baselineValueFormat

object (BaselineValueFormat)

خيارات تنسيق القيمة الأساسية لا يلزم استخدام هذا الحقل إلا في حال تحديد baselineValueData.

scaleFactor

number

القيمة لتوسيع نطاق مفتاح بطاقة قياس الأداء والقيمة الأساسية على سبيل المثال، يمكن استخدام عامل 10 لقسمة جميع القيم في الرسم البياني على 10. هذا الحقل اختياري.

numberFormatSource

enum (ChartNumberFormatSource)

مصدر تنسيق الأرقام المستخدَم في الرسم البياني لبطاقة الأداء. هذا الحقل اختياري.

customFormatOptions

object (ChartCustomNumberFormatOptions)

خيارات التنسيق المخصّصة للقيم الرقمية للمفتاح/القيمة الأساسية في الرسم البياني لبطاقة قياس الأداء لا يتم استخدام هذا الحقل إلا عند ضبط numberFormatSource على CUSTOM. هذا الحقل اختياري.

KeyValueFormat

خيارات تنسيق قيمة المفتاح

تمثيل JSON 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
الحقول
textFormat

object (TextFormat)

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

position

object (TextPosition)

تُحدِّد موضع النص الأفقي لقيمة المفتاح. هذا الحقل اختياري. إذا لم يتم تحديد موضع، يتم استخدام موضع التلقائي.

BaselineValueFormat

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

تمثيل JSON 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
الحقول
comparisonType

enum (ComparisonType)

نوع المقارنة بين قيمة المفتاح والقيمة الأساسية

textFormat

object (TextFormat)

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

position

object (TextPosition)

تُحدِّد موضع النص الأفقي للقيمة الأساسية. هذا الحقل اختياري. إذا لم يتم تحديد موضع، يتم استخدام موضع التلقائي.

description

string

الوصف الذي يتم إلحاقه بعد القيمة الأساسية هذا الحقل اختياري.

positiveColor
(deprecated)

object (Color)

اللون الذي سيتم استخدامه في حال كانت القيمة الأساسية تمثّل تغييرًا إيجابيًا لقيمة المفتاح هذا الحقل اختياري. متوقّفة نهائيًا: استخدِم positiveColorStyle.

positiveColorStyle

object (ColorStyle)

اللون الذي سيتم استخدامه في حال كانت القيمة الأساسية تمثّل تغييرًا إيجابيًا لقيمة المفتاح هذا الحقل اختياري. إذا تم أيضًا ضبط positiveColor ، يكون لهذا الحقل الأولوية.

negativeColor
(deprecated)

object (Color)

اللون الذي سيتم استخدامه في حال كانت القيمة الأساسية تمثّل تغييرًا سلبيًا لقيمة المفتاح هذا الحقل اختياري. متوقّفة نهائيًا: استخدِم negativeColorStyle.

negativeColorStyle

object (ColorStyle)

اللون الذي سيتم استخدامه في حال كانت القيمة الأساسية تمثّل تغييرًا سلبيًا لقيمة المفتاح هذا الحقل اختياري. إذا تم أيضًا ضبط negativeColor ، يكون لهذا الحقل الأولوية.

ComparisonType

نوع المقارنة بين قيمة المفتاح والقيمة الأساسية

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