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)
    }
  ]
}
الحقول
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)

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

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

صحيح إذا كانت الورقة هي ورقة باتجاه RTL بدلاً من ورقة باتجاه LTR.

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

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

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)

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

حقل الاتحاد 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)

نقطة البداية للإ interpolation

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,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
الحقول
filterViewId

integer

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

title

string

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

range

object (GridRange)

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

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

namedRangeId

string

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

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

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,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
الحقول
protectedRangeId

integer

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

range

object (GridRange)

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

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

namedRangeId

string

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

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

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)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
الحقول
range

object (GridRange)

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

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 إذا كان يجب تطبيق عامل التصفية على الجداول المحورية. إذا لم يتم ضبطه، يتم ضبطه تلقائيًا على True.

title

string

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

textFormat

object (TextFormat)

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

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