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 Chart.
newColumnChart()	ColumnChartBuilder	يبدأ في إنشاء رسم بياني عمودي، كما هو موضّح في مستندات أدوات الرسوم البيانية من Google.
newDataTable()	DataTableBuilder	تُنشئ هذه الدالة جدول بيانات فارغًا يمكن ضبط قيمه يدويًا.
newDataViewDefinition()	DataViewDefinitionBuilder	تنشئ هذه الطريقة تعريفًا جديدًا لعرض البيانات.
newLineChart()	LineChartBuilder	يبدأ في إنشاء رسم بياني خطي، كما هو موضّح في مستندات أدوات Google Chart.
newPieChart()	PieChartBuilder	يبدأ في إنشاء رسم بياني دائري، كما هو موضّح في مستندات أدوات الرسوم البيانية من Google.
newScatterChart()	ScatterChartBuilder	يبدأ في إنشاء رسم بياني بالنقاط المبعثرة، كما هو موضّح في مستندات أدوات Google Chart.
newTableChart()	TableChartBuilder	يبدأ في إنشاء رسم بياني جدولي، كما هو موضّح في مستندات أدوات الرسوم البيانية من Google.
newTextStyle()	TextStyleBuilder	تنشئ أداة إنشاء جديدة لأنماط النصوص.

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

newAreaChart()

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

الإرجاع

‫AreaChartBuilder: أداة إنشاء AreaChartBuilder، والتي يمكن استخدامها لإنشاء رسم بياني مساحي.

---

newBarChart()

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

الإرجاع

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

---

newColumnChart()

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

الإرجاع

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

---

newDataTable()

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

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

الإرجاع

‫DataTableBuilder: أداة إنشاء DataTableBuilder يمكنها الاحتفاظ ببيانات الرسوم البيانية.

---

newDataViewDefinition()

تنشئ هذه الطريقة تعريفًا جديدًا لعرض البيانات.

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

الإرجاع

‫DataViewDefinitionBuilder: أداة إنشاء DataViewDefinitionBuilder، ويمكن استخدامها لإنشاء تعريف لعرض البيانات.

---

newLineChart()

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

الإرجاع

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

---

newPieChart()

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

الإرجاع

‫PieChartBuilder: أداة إنشاء رسم بياني دائري، يمكن استخدامها لإنشاء رسم بياني دائري.

---

newScatterChart()

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

الإرجاع

‫ScatterChartBuilder: أداة إنشاء ScatterChartBuilder، ويمكن استخدامها لإنشاء رسم بياني بالنقاط المبعثرة.

---

newTableChart()

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

الإرجاع

‫TableChartBuilder: أداة إنشاء TableChartBuilder، ويمكن استخدامها لإنشاء رسم بياني على شكل جدول.

---

newTextStyle()

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

لتغيير القيم التلقائية، استخدِم دوال الضبط.

الإرجاع

‫TextStyleBuilder: أداة إنشاء TextStyleBuilder، ويمكن استخدامها لإنشاء عنصر إعدادات نمط النص.