- المورد: جدول بيانات
- SpreadsheetProperties (خصائص جدول البيانات)
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- اللون
- ColorStyle
- ThemeColorType
- الحدود الجغرافية
- الحدود
- النمط
- المساحة المتروكة
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- الرابط
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- جدول البيانات
- SheetProperties:
- SheetType
- GridProperties
- DataSourceSheetProperties:
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- ErrorType
- TextFormatRun
- DataValidationRule
- BooleanCondition
- ConditionType
- ConditionValue
- RelativeDate
- PivotTable
- GridRange:
- PivotGroup
- PivotGroupValueMetadata
- SortOrder
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFilterCriteria
- PivotFilterSpec:
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- FilterCriteria
- SortSpec:
- DataSourceFormula
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- المحرِّرون
- BasicFilter
- EmbeddedChart
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec:
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle
- LineDashType
- DataLabel
- DataLabelType
- DataLabelPlacement
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec:
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec:
- CandlestickDomain
- CandlestickData
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec:
- KeyValueFormat
- BaselineValueFormat
- ComparisonType
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition:
- OverlayPosition
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- فلتر نطاق البيانات
- SlicerSpec:
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec:
- BigQueryQuerySpec
- BigQueryTableSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- DataSourceRefreshMonthlySchedule
- الفاصل
- الطُرق
المورد: جدول بيانات
مورد يمثل جدول بيانات.
تمثيل JSON |
---|
{ "spreadsheetId": string, "properties": { object ( |
الحقول | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات. هذا الحقل للقراءة فقط. |
properties |
الخصائص العامة لجدول البيانات. |
sheets[] |
الأوراق التي تشكل جزءًا من جدول بيانات. |
namedRanges[] |
تمثّل هذه السمة النطاقات المُعنونة المحدّدة في جدول بيانات. |
spreadsheetUrl |
تمثّل هذه السمة عنوان URL لجدول البيانات. هذا الحقل للقراءة فقط. |
developerMetadata[] |
تمثّل هذه السمة البيانات الوصفية للمطوِّر المرتبطة بجدول بيانات. |
dataSources[] |
قائمة بمصادر البيانات الخارجية المرتبطة بجدول البيانات. |
dataSourceSchedules[] |
النتائج فقط. قائمة بجداول إعادة تحميل مصدر البيانات. |
SpreadsheetProperties
خصائص جدول البيانات.
تمثيل JSON |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
الحقول | |
---|---|
title |
تمثّل هذه السمة عنوان جدول البيانات. |
locale |
لغة جدول البيانات بأحد التنسيقات التالية:
ملاحظة: عند تحديث هذا الحقل، لا يتم دعم كل اللغات/اللغات. |
autoRecalc |
مقدار الوقت المستغرَق للانتظار قبل إعادة حساب الدوال المتغيّرة. |
timeZone |
تمثّل هذه السمة المنطقة الزمنية لجدول البيانات، بتنسيق CLDR، مثل |
defaultFormat |
التنسيق التلقائي لجميع الخلايا في جدول البيانات. لن يتم ضبط |
iterativeCalculationSettings |
تحدد ما إذا كان يتم حل المراجع الدائرية باستخدام الحساب التكراري وكيف يتم ذلك. يعني عدم وجود هذا الحقل أن المراجع الدائرية تؤدي إلى أخطاء في الحساب. |
spreadsheetTheme |
تم تطبيق المظهر على جدول البيانات. |
importFunctionsExternalUrlAccessAllowed |
ما إذا كان سيتم السماح بالوصول إلى عنوان URL الخارجي لوظائف الاستيراد والصور. اقرأ فقط عند الصواب. عندما تكون القيمة false، يمكنك ضبطها على true. |
RecalculationInterval
عبارة عن تعداد لخيارات الفاصل الزمني لإعادة الاحتساب.
عمليات التعداد | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
القيمة التلقائية. يجب عدم استخدام هذه القيمة. |
ON_CHANGE |
يتم تعديل الدوال المتغيّرة عند كل تغيير. |
MINUTE |
يتم تعديل الدوال المتغيّرة عند كل تغيير وكل دقيقة. |
HOUR |
يتم تعديل الدوال المتغيّرة عند كل تغيير وكل ساعة. |
IterativeCalculationSettings
الإعدادات للتحكم في كيفية حل التبعيات الدائرية باستخدام الحساب التكراري.
تمثيل JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
الحقول | |
---|---|
maxIterations |
عند تفعيل الحساب المكرر، يكون الحد الأقصى لعدد العمليات الحسابية المراد إجراؤها. |
convergenceThreshold |
عند تفعيل الحساب المكرر واختلاف النتائج المتتالية بنسبة أقل من قيمة الحد الأدنى هذه، تتوقف العملية الحسابية. |
SpreadsheetTheme
يمثل مظهر جدول البيانات
تمثيل JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
الحقول | |
---|---|
primaryFontFamily |
اسم مجموعة الخطوط الأساسية |
themeColors[] |
أزواج ألوان مظهر جدول البيانات. للتحديث، عليك توفير جميع أزواج ألوان المظاهر. |
ThemeColorPair
زوج يعين نوع لون مظهر جدول البيانات للون الملموس الذي يمثله.
تمثيل JSON |
---|
{ "colorType": enum ( |
الحقول | |
---|---|
colorType |
نوع لون مظهر جدول البيانات. |
color |
اللون الملموس لنوع لون المظهر. |
NamedRange
نطاق مُعنوَن.
تمثيل JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
الحقول | |
---|---|
namedRangeId |
رقم تعريف النطاق المُعنون. |
name |
اسم النطاق المُعنون. |
range |
النطاق الذي يمثله هذا. |
DataSource
معلومات عن مصدر بيانات خارجي في جدول البيانات.
تمثيل JSON |
---|
{ "dataSourceId": string, "spec": { object ( |
الحقول | |
---|---|
dataSourceId |
المعرّف الفريد على مستوى جدول البيانات الذي يحدّد مصدر البيانات. مثال: 1080547365. |
spec |
تمثّل هذه السمة |
calculatedColumns[] |
جميع الأعمدة المحسوبة في مصدر البيانات |
sheetId |
رقم تعريف عند إنشاء مصدر بيانات، يتم أيضًا إنشاء ورقة بيانات |
DataSourceSpec
تحدّد هذه العلامة تفاصيل مصدر البيانات. على سبيل المثال، بالنسبة إلى BigQuery، يحدِّد هذا المعلومات معلومات عن مصدر BigQuery.
تمثيل JSON |
---|
{ "parameters": [ { object ( |
الحقول | |
---|---|
parameters[] |
معلمات مصدر البيانات، تُستخدم عند إجراء طلب بحث عن مصدر البيانات. |
حقل الاتحاد spec المواصفات الفعلية لكل نوع مصدر بيانات. يمكن أن يكون الحقل "spec " واحدًا فقط مما يلي: |
|
bigQuery |
|
BigQueryDataSourceSpec
مواصفات مصدر بيانات BigQuery المرتبط بورقة.
تمثيل JSON |
---|
{ "projectId": string, // Union field |
الحقول | |
---|---|
projectId |
رقم تعريف مشروع على Google Cloud تم تفعيل BigQuery عليه مع إرفاق حساب فوترة. بالنسبة إلى أي استعلامات يتم تنفيذها ضد مصدر البيانات، يتم تحصيل رسوم المشروع. |
حقل الاتحاد spec المواصفات الفعلية. يمكن أن يكون الحقل "spec " واحدًا فقط مما يلي: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
تُحدِّد هذه السمة طلب بحث BigQuery مخصّصًا.
تمثيل JSON |
---|
{ "rawQuery": string } |
الحقول | |
---|---|
rawQuery |
سلسلة طلب البحث الأولية. |
BigQueryTableSpec
تُحدِّد هذه السياسة تعريف جدول BigQuery. يُسمح فقط باستخدام الجداول الأصلية.
تمثيل JSON |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
الحقول | |
---|---|
tableProjectId |
رقم تعريف مشروع BigQuery الذي ينتمي إليه الجدول. إذا لم يتم تحديدها، يتم استخدام السمة |
tableId |
معرّف جدول BigQuery |
datasetId |
رقم تعريف مجموعة بيانات BigQuery. |
DataSourceParameter
مَعلمة في طلب بحث لمصدر بيانات. تسمح المعلمة للمستخدم بتمرير القيم من جدول البيانات إلى طلب بحث.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد identifier معرِّف المَعلمة. يمكن أن يكون الحقل "identifier " واحدًا فقط مما يلي: |
|
name |
المَعلمة المُسمّاة. يجب أن يكون معرّفًا صالحًا لـ |
حقل الاتحاد value تمثّل هذه السمة قيمة المَعلمة. يمكن أن يكون الحقل "value " واحدًا فقط مما يلي: |
|
namedRangeId |
رقم تعريف |
range |
يشير ذلك إلى نطاق يحتوي على قيمة المَعلمة. يجب أن يكون حجمها 1x1. |
DataSourceRefreshSchedule
يمكنك جدولة إعادة تحميل مصدر البيانات.
وتتم إعادة تحميل مصادر البيانات في جدول البيانات خلال فترة زمنية معيّنة. يمكنك تحديد وقت البدء من خلال النقر على زر "إعادة التحميل المجدولة" في محرّر "جداول بيانات Google"، ولكن يتم تثبيت الفاصل الزمني عند 4 ساعات. على سبيل المثال، إذا حددت وقت بدء الساعة 8 صباحًا، سيتم إجراء عملية التحديث بين الساعة 8 صباحًا و12 ظهرًا كل يوم.
تمثيل JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
الحقول | |
---|---|
enabled |
صحيح في حال تفعيل جدول إعادة التحميل، أو خطأ آخر. |
refreshScope |
نطاق إعادة التحميل. يجب أن يكون |
nextRun |
النتائج فقط. الفاصل الزمني للتشغيل التالي. |
حقل الاتحاد schedule_config يمكن أن تكون إعدادات الجدول الزمني "schedule_config " واحدة فقط من الحالات التالية: |
|
dailySchedule |
الجدول الزمني لإعادة التحميل يوميًا |
weeklySchedule |
الجدول الزمني لإعادة التحميل أسبوعيًا |
monthlySchedule |
الجدول الزمني لإعادة التحميل شهريًا |
DataSourceRefreshScope
نطاقات إعادة تحميل مصدر البيانات.
عمليات التعداد | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
القيمة التلقائية، يُرجى عدم استخدامها. |
ALL_DATA_SOURCES |
إعادة تحميل جميع مصادر البيانات وكائنات مصدر البيانات المرتبطة بها في جدول البيانات. |
DataSourceRefreshDailySchedule
جدول زمني لإعادة تحميل البيانات كل يوم خلال فاصل زمني محدّد
تمثيل JSON |
---|
{
"startTime": {
object ( |
الحقول | |
---|---|
startTime |
وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يُستخدم جزء |
TimeOfDay
تمثل وقتًا من اليوم. قد يكون التاريخ والمنطقة الزمنية غير مهمَّين أو تم تحديدهما في مكان آخر. وقد تختار واجهة برمجة التطبيقات السماح بالثواني الكبيسة. النوعان ذوا الصلة هما google.type.Date
وgoogle.protobuf.Timestamp
.
تمثيل JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
الحقول | |
---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة يجب أن يتراوح الرقم بين 0 و23. قد تسمح واجهة برمجة التطبيقات بالقيمة "24:00:00" في سيناريوهات مثل وقت إغلاق النشاط التجاري. |
minutes |
دقائق من الساعة من اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثواني من الدقائق من الوقت. يجب أن يتراوح الرقم عادةً من 0 إلى 59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تتيح الثواني الكبيسة. |
nanos |
كسور الثواني بالنانوثانية. يجب أن تتراوح القيمة بين 0 و999,999,999. |
DataSourceRefreshWeeklySchedule
جدول أسبوعي لإعادة تحميل البيانات في أيام محدّدة خلال فترة زمنية معيّنة.
تمثيل JSON |
---|
{ "startTime": { object ( |
الحقول | |
---|---|
startTime |
وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يُستخدم جزء |
daysOfWeek[] |
أيام الأسبوع المطلوب إعادة تحميلها يجب تحديد يوم واحد على الأقل. |
DayOfWeek
يمثّل أحد أيام الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
لم يتم تحديد يوم من الأسبوع. |
MONDAY |
الاثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
DataSourceRefreshMonthlySchedule
جدول شهري لإعادة تحميل البيانات في أيام محدّدة من الشهر خلال فترة زمنية معيّنة
تمثيل JSON |
---|
{
"startTime": {
object ( |
الحقول | |
---|---|
startTime |
وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يُستخدم جزء |
daysOfMonth[] |
أيام الشهر المطلوب إعادة تحميلها يمكن استخدام من 1 إلى 28 فقط، مع الربط بين اليوم الأول واليوم الثامن والعشرين. يجب تحديد يوم واحد على الأقل. |
الفاصل الزمني
تمثّل هذه السمة فاصلاً زمنيًا مرمَّزًا كبداية طابع زمني (شاملًا) ونهاية طابع زمني (حصريًا).
يجب أن تكون البداية أقل من النهاية أو مساوية لها. عندما تساوي البداية النهاية، يكون الفاصل الزمني فارغًا (لا يتطابق أي وقت). عندما لا يتم تحديد كل من البداية والنهاية، يتطابق الفاصل الزمني في أي وقت.
تمثيل JSON |
---|
{ "startTime": string, "endTime": string } |
الحقول | |
---|---|
startTime |
اختياريّ. بداية شاملة للفاصل الزمني. يجب أن يكون الطابع الزمني الذي يتطابق مع هذا الفاصل الزمني هو نفسه في البداية أو بعده، في حال تحديد ذلك. |
endTime |
اختياريّ. نهاية حصرية للفاصل الزمني يجب أن يكون الطابع الزمني الذي يتطابق مع هذا الفاصل الزمني قبل النهاية، في حال تحديده. |
الطُرق |
|
---|---|
|
يتم تطبيق تعديل واحد أو أكثر على جدول البيانات. |
|
لإنشاء جدول بيانات، وعرض جدول البيانات الذي تم إنشاؤه حديثًا. |
|
يؤدي ذلك إلى عرض جدول البيانات على المعرّف المحدّد. |
|
يؤدي ذلك إلى عرض جدول البيانات على المعرّف المحدّد. |