تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Charts

نقطة الدخول لإنشاء الرسوم البيانية في النصوص البرمجية

ينشئ هذا المثال جدول بيانات أساسيًا، ويملؤه ببيانات مخطّط مساحي، ويضيفه إلى صفحة ويب كصورة:

function doGet() {
  const data = Charts.newDataTable()
                   .addColumn(Charts.ColumnType.STRING, 'Month')
                   .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                   .addColumn(Charts.ColumnType.NUMBER, 'Online')
                   .addRow(['January', 10, 1])
                   .addRow(['February', 12, 1])
                   .addRow(['March', 20, 2])
                   .addRow(['April', 25, 3])
                   .addRow(['May', 30, 4])
                   .build();

  const chart = Charts.newAreaChart()
                    .setDataTable(data)
                    .setStacked()
                    .setRange(0, 40)
                    .setTitle('Sales per Month')
                    .build();

  const htmlOutput = HtmlService.createHtmlOutput().setTitle('My Chart');
  const imageData = Utilities.base64Encode(chart.getAs('image/png').getBytes());
  const imageUrl = `data:image/png;base64,${encodeURI(imageData)}`;
  htmlOutput.append('Render chart server side: <br/>');
  htmlOutput.append(`<img border="1" src="${imageUrl}">`);
  return htmlOutput;
}

أماكن إقامة

الموقع	النوع	الوصف
`ChartHiddenDimensionStrategy`	`ChartHiddenDimensionStrategy`	قائمة بكيفية التعبير عن السمات المخفية في مصدر معيّن في رسم بياني
`ChartMergeStrategy`	`ChartMergeStrategy`	قائمة بكيفية التعبير عن نطاقات متعددة في المصدر في رسم بياني
`ChartType`	`ChartType`	قائمة بأنواع الرسوم البيانية المتوافقة مع خدمة "الرسوم البيانية"
`ColumnType`	`ColumnType`	قائمة بأنواع البيانات الصالحة للأعمدة في `DataTable`
`CurveStyle`	`CurveStyle`	قائمة بالأنماط للخطوط المنحنية في الرسم البياني
`PointStyle`	`PointStyle`	قائمة بأنماط النقاط في سطر
`Position`	`Position`	قائمة بمواضع وسائل الإيضاح ضمن رسم بياني

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`newAreaChart()`	`AreaChartBuilder`	يبدأ إنشاء رسم بياني خطي، كما هو موضّح في مستندات أدوات رسم Google البياني.
`newBarChart()`	`BarChartBuilder`	يبدأ إنشاء رسم بياني شريطي، كما هو موضّح في مستندات أدوات مخطّط Google البياني.
`newColumnChart()`	`ColumnChartBuilder`	يبدأ إنشاء رسم بياني أعمدة، كما هو موضّح في مستندات أدوات رسم Google البياني.
`newDataTable()`	`DataTableBuilder`	تُنشئ هذه الدالة جدول بيانات فارغًا يمكن ضبط قيمه يدويًا.
`newDataViewDefinition()`	`DataViewDefinitionBuilder`	لإنشاء تعريف جديد لعرض البيانات
`newLineChart()`	`LineChartBuilder`	يبدأ إنشاء مخطّط خطي، كما هو موضّح في مستندات أدوات مخطّط Google البياني.
`newPieChart()`	`PieChartBuilder`	يبدأ إنشاء رسم بياني دائري، كما هو موضّح في مستندات أدوات رسم Google البياني.
`newScatterChart()`	`ScatterChartBuilder`	يبدأ إنشاء مخطّط مبعثر، كما هو موضّح في مستندات أدوات مخطّط Google.
`newTableChart()`	`TableChartBuilder`	يبدأ إنشاء مخطّط بياني للجدول، كما هو موضّح في مستندات أدوات مخطّطات Google.
`newTextStyle()`	`TextStyleBuilder`	لإنشاء أداة إنشاء أنماط نص جديدة.

مستندات تفصيلية

`newAreaChart()`

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

الإرجاع

AreaChartBuilder — عنصر AreaChartBuilder الذي يمكن استخدامه لإنشاء رسم بياني مساحي

`newBarChart()`

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

الإرجاع

BarChartBuilder — BarChartBuilder، الذي يمكن استخدامه لإنشاء مخطّط شريطي

`newColumnChart()`

يبدأ إنشاء رسم بياني أعمدة، كما هو موضّح في مستندات أدوات رسم Google البياني.

الإرجاع

ColumnChartBuilder - ColumnChartBuilder، الذي يمكن استخدامه لإنشاء رسم بياني أعمدة.

`newDataTable()`

تُنشئ هذه الدالة جدول بيانات فارغًا يمكن ضبط قيمه يدويًا.

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

الإرجاع

DataTableBuilder - DataTableBuilder، الذي يمكنه تخزين بيانات الرسوم البيانية

`newDataViewDefinition()`

لإنشاء تعريف جديد لعرض البيانات

استخدِم أدوات الضبط لتحديد السمات المختلفة لعرض البيانات.

الإرجاع

DataViewDefinitionBuilder - عنصر DataViewDefinitionBuilder الذي يمكن استخدامه لإنشاء تعريف لعرض البيانات

`newLineChart()`

يبدأ إنشاء مخطّط خطي، كما هو موضّح في مستندات أدوات مخطّط Google البياني.

الإرجاع

LineChartBuilder - أداة إنشاء الرسوم البيانية الخطية، والتي يمكن استخدامها لإنشاء رسم بياني خطي.

`newPieChart()`

يبدأ إنشاء رسم بياني دائري، كما هو موضّح في مستندات أدوات رسم Google البياني.

الإرجاع

PieChartBuilder — عنصر PieChartBuilder الذي يمكن استخدامه لإنشاء مخطّط دائري

`newScatterChart()`

يبدأ إنشاء مخطّط مبعثر، كما هو موضّح في مستندات أدوات مخطّط Google.

الإرجاع

ScatterChartBuilder - عنصر ScatterChartBuilder الذي يمكن استخدامه لإنشاء مخطّط مبعثر

`newTableChart()`

يبدأ إنشاء مخطّط بياني للجدول، كما هو موضّح في مستندات أدوات مخطّطات Google.

الإرجاع

TableChartBuilder - عنصر TableChartBuilder الذي يمكن استخدامه لإنشاء رسم بياني على شكل جدول

`newTextStyle()`

لإنشاء أداة إنشاء أنماط نص جديدة.

لتغيير القيم التلقائية، استخدِم دوال الإعداد.

الإرجاع

‫TextStyleBuilder: عنصر TextStyleBuilder الذي يمكن استخدامه لإنشاء عنصر إعدادات نمط نص