Sheets

جدول بيانات

ورقة في جدول بيانات

تمثيل JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
الحقول
properties

object (SheetProperties)

خصائص الورقة

data[]

object (GridData)

البيانات في الشبكة، إذا كانت هذه ورقة شبكة

يعتمد عدد عناصر GridData التي يتم عرضها على عدد النطاقات المطلوبة في هذه الورقة. على سبيل المثال، إذا كان هذا يمثّل Sheet1، وتم طلب جدول البيانات باستخدام النطاقين Sheet1!A1:C10 و Sheet1!D15:E20، سيكون لخدمة GridData الأولى قيمة startRow / startColumn تساوي 0، بينما سيكون لخدمة GridData الثانية قيمة startRow 14 (الصف 15 بالاستناد إلى الصفر) و startColumn 3 (العمود D بالاستناد إلى الصفر).

بالنسبة إلى جدول DATA_SOURCE ، لا يمكنك طلب نطاق معيّن، لأنّ GridData يحتوي على جميع القيم.

merges[]

object (GridRange)

النطاقات التي تم دمجها معًا

conditionalFormats[]

object (ConditionalFormatRule)

قواعد التنسيق الشرطي في هذه الورقة

filterViews[]

object (FilterView)

عروض الفلاتر في هذه الورقة

protectedRanges[]

object (ProtectedRange)

النطاقات المحمية في هذه الورقة

basicFilter

object (BasicFilter)

الفلتر على ورقة البيانات هذه، إن توفّر.

charts[]

object (EmbeddedChart)

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

bandedRanges[]

object (BandedRange)

النطاقات المخططة (بألوان بديلة) في هذه الورقة

developerMetadata[]

object (DeveloperMetadata)

البيانات الوصفية للمطوّر المرتبطة بورقة بيانات

rowGroups[]

object (DimensionGroup)

جميع مجموعات الصفوف في هذه الورقة، مرتبة حسب فهرس بداية النطاق المتزايد، ثم حسب عمق المجموعة.

columnGroups[]

object (DimensionGroup)

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

slicers[]

object (Slicer)

أقسام الشرائح في ورقة البيانات هذه

tables[]

object (Table)

الجداول في ورقة البيانات هذه

SheetProperties

خصائص ورقة البيانات

تمثيل JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
الحقول
sheetId

integer

رقم تعريف ورقة البيانات يجب أن تكون غير سالبة. لا يمكن تغيير هذا الحقل بعد ضبطه.

title

string

اسم ورقة البيانات

index

integer

فهرس الورقة ضمن جدول البيانات. عند إضافة سمات ورقة البيانات أو تعديلها، إذا تم استبعاد هذا الحقل، تتم إضافة ورقة البيانات أو نقلها إلى نهاية قائمة أوراق البيانات. عند تعديل فهارس الأوراق أو إدراج أوراق، يتمّ احتساب الحركة في فهارس "قبل النقل". على سبيل المثال، إذا كانت هناك ثلاث أوراق بيانات (S1 وS2 وS3)، يجب ضبط الفهرس على 2 لنقل S1 قبل S2. يتم تجاهل طلب تعديل فهرس جدول البيانات إذا كان الفهرس المطلوب مطابقًا للفهرس الحالي للجدول أو إذا كان الفهرس الجديد المطلوب يساوي فهرس الجدول الحالي + 1.

sheetType

enum (SheetType)

نوع الورقة الإعداد التلقائي هو GRID. لا يمكن تغيير هذا الحقل بعد ضبطه.

gridProperties

object (GridProperties)

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

إذا كانت هذه الورقة هي جدول DATA_SOURCE ، يتم عرض هذا الحقل فقط، ولكنه يحتوي على السمات التي تعكس كيفية عرض جدول مصدر البيانات في واجهة المستخدم، مثل rowCount.

hidden

boolean

صحيح إذا كانت ورقة البيانات مخفية في واجهة المستخدم، وخطأ إذا كانت مرئية.

tabColor
(deprecated)

object (Color)

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

tabColorStyle

object (ColorStyle)

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

rightToLeft

boolean

صحيح إذا كانت الورقة من اليمين إلى اليسار بدلاً من اليسار إلى اليمين.

dataSourceSheetProperties

object (DataSourceSheetProperties)

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

SheetType

نوع الورقة

عمليات التعداد
SHEET_TYPE_UNSPECIFIED القيمة التلقائية، لا تستخدمها.
GRID الورقة هي شبكة.
OBJECT لا تحتوي الورقة على شبكة بل تحتوي بدلاً من ذلك على عنصر مثل رسم بياني أو صورة.
DATA_SOURCE تتصل ورقة البيانات بأحد المواقع الخارجية DataSource وتعرض معاينة البيانات.

GridProperties

خصائص الشبكة

تمثيل JSON 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
الحقول
rowCount

integer

عدد الصفوف في الشبكة

columnCount

integer

عدد الأعمدة في الشبكة

frozenRowCount

integer

عدد الصفوف التي تم تجميدها في الشبكة

frozenColumnCount

integer

عدد الأعمدة التي تم تجميدها في الشبكة

hideGridlines

boolean

صحيح إذا كانت الشبكة لا تعرض خطوط الشبكة في واجهة المستخدم.

rowGroupControlAfter

boolean

صحيح إذا كان زر التحكّم في تجميع الصفوف يظهر بعد المجموعة.

columnGroupControlAfter

boolean

صحيح إذا كان زر التحكّم في تجميع الأعمدة يظهر بعد المجموعة.

DataSourceSheetProperties

سمات إضافية لجدول DATA_SOURCE.

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

string

معرّف DataSource التي تم ربط ورقة البيانات بها.

columns[]

object (DataSourceColumn)

الأعمدة المعروضة في ورقة البيانات، والتي تتوافق مع القيم الواردة في RowData.

dataExecutionStatus

object (DataExecutionStatus)

حالة تنفيذ البيانات

GridData

البيانات في الشبكة، بالإضافة إلى البيانات الوصفية عن السمات

تمثيل JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
الحقول
startRow

integer

الصف الأول الذي تشير إليه GridData، وهو مستند إلى الصفر.

startColumn

integer

العمود الأول الذي تشير إليه GridData، وهو مستند إلى الصفر

rowData[]

object (RowData)

البيانات في الشبكة، إدخال واحد لكل صف، بدءًا من الصف في startRow ستتوافق القيم في RowData مع الأعمدة التي تبدأ من startColumn.

rowMetadata[]

object (DimensionProperties)

بيانات التعريف حول الصفوف المطلوبة في الشبكة، بدءًا من الصف في startRow.

columnMetadata[]

object (DimensionProperties)

بيانات التعريف عن الأعمدة المطلوبة في الشبكة، بدءًا من العمود في startColumn.

RowData

بيانات عن كل خلية في صف

تمثيل JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
الحقول
values[]

object (CellData)

القيم في الصف، واحدة لكل عمود

DimensionProperties

خصائص عن سمة

تمثيل JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
الحقول
hiddenByFilter

boolean

صحيح إذا كانت هذه السمة تتم فلترتها. هذا الحقل للقراءة فقط.

hiddenByUser

boolean

صحيح إذا كانت هذه السمة مخفية بشكل صريح.

pixelSize

integer

ارتفاع السمة (إذا كانت صفًا) أو عرضها (إذا كانت عمودًا) بالبكسل

developerMetadata[]

object (DeveloperMetadata)

البيانات الوصفية للمطوّر المرتبطة بصف أو عمود واحد

dataSourceColumnReference

object (DataSourceColumnReference)

النتائج فقط. إذا تم ضبطه، يكون هذا العمود في ورقة بيانات مصدر.

ConditionalFormatRule

قاعدة تصف تنسيقًا شرطيًا

تمثيل JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
الحقول
ranges[]

object (GridRange)

النطاقات التي يتم تنسيقها إذا كان الشرط صحيحًا يجب أن تكون جميع النطاقات في الشبكة نفسها.

حقل الربط rule. القاعدة التي تتحكّم في هذا التنسيق الشرطي، يجب ضبط قاعدة واحدة بالضبط. rule يمكن أن تكون إحدى القيم التالية فقط:
booleanRule

object (BooleanRule)

يكون التنسيق إما "مفعّلاً" أو "غير مفعّل" وفقًا للقاعدة.

gradientRule

object (GradientRule)

سيختلف التنسيق استنادًا إلى التدرجات في القاعدة.

BooleanRule

قاعدة قد تتطابق أو لا تتطابق، حسب الشرط.

تمثيل JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
الحقول
condition

object (BooleanCondition)

شرط القاعدة. إذا كان تقييم الشرط صحيحًا، يتم تطبيق التنسيق.

format

object (CellFormat)

التنسيق المطلوب تطبيقه لا يمكن للتنسيق الشرطي تطبيق سوى مجموعة فرعية من التنسيقات: bold، italic، strikethrough، foreground color و، background color.

GradientRule

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

تمثيل JSON 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
الحقول
minpoint

object (InterpolationPoint)

نقطة بدء الاستقراء

midpoint

object (InterpolationPoint)

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

maxpoint

object (InterpolationPoint)

نقطة الاستبدال النهائية

InterpolationPoint

نقطة تداخل واحدة في تنسيق شَرطي متدرّج وتثبِّت هذه المقاييس مقياس الألوان المتدرّجة وفقًا للون والنوع والقيمة المحدّدة.

تمثيل JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
الحقول
color
(deprecated)

object (Color)

اللون الذي يجب أن تستخدمه نقطة الاستبدال هذه. متوقّفة نهائيًا: استخدِم colorStyle.

colorStyle

object (ColorStyle)

اللون الذي يجب أن تستخدمه نقطة الاستبدال هذه. إذا تم أيضًا ضبط color ، يكون لهذا الحقل الأولوية.

type

enum (InterpolationPointType)

كيفية تفسير القيمة

value

string

القيمة التي تستخدمها نقطة الاستقراء هذه. قد تكون صيغة. لا يتم استخدامها إذا كان type هو MIN أو MAX.

InterpolationPointType

نوع نقطة الاستقراء

عمليات التعداد
INTERPOLATION_POINT_TYPE_UNSPECIFIED القيمة التلقائية، لا تستخدِمها.
MIN تستخدِم نقطة الاستبدال أدنى قيمة في الخلايا على نطاق التنسيق المشروط.
MAX تستخدِم نقطة الاستقراء الحد الأقصى للقيمة في الخلايا على نطاق التنسيق الشرطي.
NUMBER تستخدِم نقطة الاستقراء القيمة الواردة في InterpolationPoint.value بالضبط.
PERCENT

نقطة الاستقراء هي النسبة المئوية المحدّدة على جميع الخلايا في نطاق التنسيق الشرطي. وهذا يعادل NUMBER إذا كانت القيمة: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (حيث يتم تجاهل الأخطاء في النطاق عند تسويته).

PERCENTILE نقطة الاستقراء هي النسبة المئوية المحدّدة على جميع الخلايا في نطاق التنسيق الشرطي. ويعادل ذلك NUMBER إذا كانت القيمة: =PERCENTILE(FLATTEN(range), value / 100) (حيث يتم تجاهل الأخطاء في النطاق عند تسويته).

FilterView

عرض فلتر

تمثيل JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
الحقول
filterViewId

integer

رقم تعريف عرض الفلتر

title

string

اسم عرض الفلتر

range

object (GridRange)

النطاق الذي يغطيه عرض الفلتر هذا

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

namedRangeId

string

النطاق المُعنوَن الذي يستند إليه عرض الفلتر، إن توفّر

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

tableId

string

الجدول الذي يستند إليه عرض الفلتر، إن توفّر

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

معايير عرض/إخفاء القيم لكل عمود مفتاح الخريطة هو فهرس العمود، والقيمة هي معايير هذا العمود.

تم إيقاف هذا الحقل نهائيًا لصالح filterSpecs.

filterSpecs[]

object (FilterSpec)

معايير الفلتر لعرض/إخفاء القيم لكل عمود

تتم تعبئة كل من criteria و filterSpecs في الردود. إذا تم تحديد كلا الحقلين في طلب تعديل، يكون لهذا الحقل الأولوية.

ProtectedRange

نطاق محمي

تمثيل JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
الحقول
protectedRangeId

integer

رقم تعريف النطاق المحمي. هذا الحقل للقراءة فقط.

range

object (GridRange)

النطاق الذي يتم حمايته قد يكون النطاق غير محدود بالكامل، وفي هذه الحالة يُعتبر ورقة محمية.

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

namedRangeId

string

النطاق المُعنوَن الذي يستند إليه هذا النطاق المحمي، إن توفّر.

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

tableId

string

الجدول الذي يستند إليه هذا النطاق المحمي، إن توفّر

عند الكتابة، يمكن ضبط أحد الخيارات التالية فقط: range أو namedRangeId أو tableId.

description

string

وصف هذا النطاق المحمي

warningOnly

boolean

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

عند كتابة: إذا كان هذا الحقل صحيحًا، يتم تجاهل editors. بالإضافة إلى ذلك، إذا تم تغيير هذا الحقل من true إلى false ولم يتم ضبط الحقل editors (أو تضمينه في قناع الحقل)، سيتم ضبط المحرِّرين على جميع المحرِّرين في المستند.

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

قائمة النطاقات غير المحمية ضمن ورقة محمية لا تتوفّر النطاقات غير المحمية إلا في أوراق البيانات المحمية.

editors

object (Editors)

المستخدمون والمجموعات الذين لديهم إذن الوصول للتعديل إلى النطاق المحمي لا يظهر هذا الحقل إلا للمستخدمين الذين لديهم إذن وصول للتعديل إلى النطاق المحمي والمستند. لا يمكن للمحرِّرين استخدام الحماية warningOnly.

المحرّرون

محرِّرو نطاق محمي

تمثيل JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
الحقول
users[]

string

عناوين البريد الإلكتروني للمستخدمين الذين لديهم إذن وصول للتعديل إلى النطاق المحمي

groups[]

string

عناوين البريد الإلكتروني للمجموعات التي لديها إذن وصول للتعديل إلى النطاق المحمي

domainUsersCanEdit

boolean

صحيح إذا كان أي مستخدم في نطاق المستند لديه إذن وصول للتعديل إلى النطاق المحمي. لا تتوفّر ميزة "حماية النطاق" إلا للمستندات ضمن نطاق معيّن.

BasicFilter

الفلتر التلقائي المرتبط بجدول بيانات

تمثيل JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
الحقول
range

object (GridRange)

النطاق الذي يغطيّه الفلتر

tableId

string

الجدول الذي يستند إليه هذا الفلتر، إن توفّر. عند الكتابة، يمكن ضبط أحد الخيارَين التاليَين فقط: range أو tableId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

معايير عرض/إخفاء القيم لكل عمود مفتاح الخريطة هو فهرس العمود، والقيمة هي معايير هذا العمود.

تم إيقاف هذا الحقل نهائيًا لصالح filterSpecs.

filterSpecs[]

object (FilterSpec)

معايير الفلتر لكل عمود

تتم تعبئة كل من criteria و filterSpecs في الردود. إذا تم تحديد كلا الحقلين في طلب تعديل، يكون لهذا الحقل الأولوية.

BandedRange

نطاق مخطط (بألوان متبادلة) في ورقة بيانات

تمثيل JSON 
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
الحقول
bandedRangeId

integer

رقم تعريف النطاق المُجمَّع.

range

object (GridRange)

النطاق الذي يتم تطبيق هذه السمات عليه

rowProperties

object (BandingProperties)

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

columnProperties

object (BandingProperties)

خصائص مجموعات الأعمدة يتم تطبيق هذه السمات على أساس عمود تلو الآخر في جميع الأعمدة في النطاق. يجب تحديد سمة واحدة على الأقل من rowProperties أو columnProperties.

BandingProperties

السمات التي تشير إلى سمة واحدة (إما صف أو عمود) في حال ضبط كل من BandedRange.row_properties و BandedRange.column_properties ، يتم تطبيق ألوان التعبئة على الخلايا وفقًا للقواعد التالية:

على سبيل المثال، يكون لون الصف الأول ذا أولوية على لون العمود الأول، ولكن يكون لون العمود الأول ذا أولوية على لون الصف الثاني. وبالمثل، يُمنَح عنوان الصف الأولوية على عنوان العمود في الخلية العلوية اليمنى، ولكن يُمنَح عنوان العمود الأولوية على لون الصف الأول في حال عدم ضبط عنوان الصف.

تمثيل JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
الحقول
headerColor
(deprecated)

object (Color)

لون الصف أو العمود الأول في حال ضبط هذا الحقل، يتم ملء الصف أو العمود الأول بهذا اللون وتتبدّل الألوان بين firstBandColor و secondBandColor اعتبارًا من الصف أو العمود الثاني. بخلاف ذلك، يتم ملء الصف أو العمود الأول برمز firstBandColor وتستمر الألوان في التبديل كالمعتاد. متوقّفة نهائيًا: استخدِم headerColorStyle.

headerColorStyle

object (ColorStyle)

لون الصف أو العمود الأول في حال ضبط هذا الحقل، يتم ملء الصف أو العمود الأول بهذا اللون وتتبدّل الألوان بين firstBandColor و secondBandColor اعتبارًا من الصف أو العمود الثاني. بخلاف ذلك، يتم ملء الصف أو العمود الأول برمز firstBandColor وتستمر الألوان في التبديل كالمعتاد. إذا تم أيضًا ضبط headerColor ، يكون لهذا الحقل الأولوية.

firstBandColor
(deprecated)

object (Color)

أول لون متغيّر. (سمة مطلوبة) تم إيقافها نهائيًا: استخدِم firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

أول لون متغيّر. (مطلوبة) إذا تم ضبط firstBandColor أيضًا، يكون لهذا الحقل الأولوية.

secondBandColor
(deprecated)

object (Color)

اللون الثاني الذي يتم بدؤه بالتناوب (سمة مطلوبة) تم إيقافها نهائيًا: استخدِم secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

اللون الثاني الذي يتم بدؤه بالتناوب (مطلوبة) إذا تم ضبط secondBandColor أيضًا، يكون لهذا الحقل الأولوية.

footerColor
(deprecated)

object (Color)

لون الصف أو العمود الأخير في حال عدم ضبط هذا الحقل، يتم ملء الصف أو العمود الأخير إما باستخدام firstBandColor أو secondBandColor، استنادًا إلى لون الصف أو العمود السابق. متوقّفة نهائيًا: استخدِم footerColorStyle.

footerColorStyle

object (ColorStyle)

لون الصف أو العمود الأخير في حال عدم ضبط هذا الحقل، يتم ملء الصف أو العمود الأخير إما باستخدام firstBandColor أو secondBandColor، استنادًا إلى لون الصف أو العمود السابق. إذا تم أيضًا ضبط footerColor ، يكون لهذا الحقل الأولوية.

DimensionGroup

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

تمثيل JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
الحقول
range

object (DimensionRange)

النطاق الذي تتوفّر فيه هذه المجموعة.

depth

integer

عمق المجموعة، الذي يمثّل عدد المجموعات التي تحتوي على نطاق يتضمّن نطاق هذه المجموعة بالكامل

collapsed

boolean

يكون هذا الحقل صحيحًا إذا كانت هذه المجموعة مصغّرة. تظل المجموعة المصغّرة مصغّرة إذا تم توسيع مجموعة متداخلة على مستوى أقل.

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

فلتر نطاق البيانات

أداة تقسيم في ورقة بيانات

تمثيل JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
الحقول
slicerId

integer

رقم تعريف أداة التقسيم

spec

object (SlicerSpec)

مواصفات أداة التقطيع

position

object (EmbeddedObjectPosition)

موضع أداة التقسيم يُرجى العلم أنّه لا يمكن وضع أداة التقسيم إلا على ورقة بيانات حالية. يمكن أيضًا تعديل عرض أداة التقسيم وارتفاعها تلقائيًا للحفاظ عليها ضمن الحدود المسموح بها.

SlicerSpec

مواصفات أداة التقطيع

تمثيل JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
الحقول
dataRange

object (GridRange)

نطاق بيانات فلتر نطاق البيانات

filterCriteria

object (FilterCriteria)

معايير الفلترة الخاصة بفلتر النطاق.

columnIndex

integer

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

applyToPivotTables

boolean

صحيح إذا كان يجب تطبيق الفلتر على الجداول المحورية. إذا لم يتم ضبطه، تكون القيمة التلقائية هي True.

title

string

عنوان أداة التقسيم

textFormat

object (TextFormat)

تنسيق نص العنوان في أداة التقسيم حقل الرابط غير متاح.

backgroundColor
(deprecated)

object (Color)

لون خلفية أداة التقسيم متوقّفة نهائيًا: استخدِم backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

المحاذاة الأفقية للعنوان في أداة التقسيم إذا لم يتم تحديد قيمة، يتم ضبط القيمة التلقائية على LEFT

جدول

جدول

تمثيل JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
الحقول
tableId

string

معرّف الجدول.

name

string

اسم الجدول. وهذا العنوان فريد لجميع الجداول في جدول البيانات نفسه.

range

object (GridRange)

نطاق الجدول

rowsProperties

object (TableRowsProperties)

خصائص صفوف الجدول

columnProperties[]

object (TableColumnProperties)

خصائص أعمدة الجدول

TableRowsProperties

خصائص صف الجدول

تمثيل JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
الحقول
headerColorStyle

object (ColorStyle)

لون صف العنوان في حال ضبط هذا الحقل، يتم ملء صف الرأس باللون المحدّد. وإلا، يتم ملء صف الرأس بلون تلقائي.

firstBandColorStyle

object (ColorStyle)

أول لون متغيّر. في حال ضبط هذا الحقل، يتم ملء أول صف مخطط باللون المحدّد. بخلاف ذلك، يتم ملء الصف الأول المفصَّل بلون تلقائي.

secondBandColorStyle

object (ColorStyle)

اللون الثاني الذي يتم بدؤه بالتناوب في حال ضبط هذا الحقل، يتم ملء الصف الثاني المخطط باللون المحدّد. بخلاف ذلك، يتم ملء الصف الثاني المخطط بلون تلقائي.

footerColorStyle

object (ColorStyle)

لون الصف الأخير في حال عدم ضبط هذا الحقل، لن تتم إضافة تذييل، وسيتم ملء الصف الأخير إما باستخدام firstBandColorStyle أو secondBandColorStyle، استنادًا إلى لون الصف السابق. في حال تعديل جدول حالي بدون تذييل لإضافته، سيتم توسيع النطاق بصف واحد. في حال تعديل جدول حالي يحتوي على تذييل وإزالة تذييل، سيتم تصغير النطاق بمقدار صف واحد.

TableColumnProperties

عمود الجدول.

تمثيل JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
الحقول
columnIndex

integer

فهرس العمود الذي يبدأ من 0 يرتبط هذا الفهرس بموقعه في الجدول ولا يتطابق بالضرورة مع فهرس العمود في ورقة البيانات.

columnName

string

اسم العمود

columnType

enum (ColumnType)

نوع العمود

dataValidationRule

object (TableColumnDataValidationRule)

قاعدة التحقّق من صحة بيانات العمود. يتم ضبطه لنوع العمود "قائمة منسدلة" فقط.

ColumnType

نوع عمود معيّن في جدول

عمليات التعداد
COLUMN_TYPE_UNSPECIFIED نوع عمود غير محدّد
DOUBLE نوع عمود الأرقام.
CURRENCY نوع عمود العملة
PERCENT نوع عمود النسبة المئوية
DATE نوع عمود التاريخ.
TIME نوع عمود الوقت
DATE_TIME نوع عمود التاريخ والوقت
TEXT نوع عمود النص
BOOLEAN نوع العمود المنطقي
DROPDOWN نوع عمود القائمة المنسدلة
FILES_CHIP نوع عمود شريحة الملفات
PEOPLE_CHIP نوع عمود شريحة المستخدم
FINANCE_CHIP نوع عمود شريحة الموارد المالية
PLACE_CHIP نوع عمود شريحة المكان
RATINGS_CHIP نوع عمود شريحة التقييمات

TableColumnDataValidationRule

قاعدة للتحقّق من صحة البيانات لعمود في جدول

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

object (BooleanCondition)

الشرط الذي يجب أن تتطابق معه البيانات في الخلية لا يكون صالحًا إلا إذا كان [BooleanCondition.type] هو ONE_OF_LIST.