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، عندئذٍ ستحتوي السمة الأولى على شبكة الشبكة على startRow / startColumn من 0، في حين سيحتوي الصف الثاني على startRow 14 (الصف 15 المستند إلى الصفر) وstartColumn 3 (العمود D) على الصفر.

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

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)

أدوات تقسيم البيانات في هذه الورقة.

خصائص الورقة

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

تمثيل 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) لنقل S1 قبل S2، يجب ضبط الفهرس على 2. يتم تجاهل طلب تعديل فهرس الورقة إذا كان الفهرس المطلوب مطابقًا للفهرس الحالي لأوراق البيانات أو إذا كان الفهرس الجديد المطلوب يساوي فهرس الورقة الحالي + 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 سمات خاصة بكل ورقة.

نوع الورقة

نوع الورقة.

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

خصائص الشبكة

خصائص الشبكة.

تمثيل 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)

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

بيانات الشبكة

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

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

integer

الصف الأول الذي تشير إليه شبكة GridData هذا استنادًا إلى الصفر.

startColumn

integer

العمود الأول الذي تشير إليه شبكة الشبكة هذه هو الصفر.

rowData[]

object (RowData)

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

rowMetadata[]

object (DimensionProperties)

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

columnMetadata[]

object (DimensionProperties)

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

بيانات الصفوف

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

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

object (CellData)

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

خصائص السمة

المواقع المتعلقة بسمة معيّنة

تمثيل 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)

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

القاعدة الشرطية

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

تمثيل 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)

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

القاعدة المنطقية

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

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

object (BooleanCondition)

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

format

object (CellFormat)

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

قاعدة متدرجة

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

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

object (InterpolationPoint)

نقطة البداية.

midpoint

object (InterpolationPoint)

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

maxpoint

object (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) (حيث يتم تجاهل الأخطاء في النطاق عند تسوية العرض).

عرض الفلتر

عرض فلتر

تمثيل 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 في الردود. في حال تحديد كلا الحقلين في طلب التعديل، تكون الأولوية لهذا الحقل.

نطاق محمي

نطاق محمي.

تمثيل 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. بالإضافة إلى ذلك، إذا تم تغيير هذا الحقل من "صحيح" إلى "خطأ" ولم يتم ضبط الحقل editors (ولا يتم تضمينه في قناع الحقل)، سيتم ضبط أدوات التحرير على جميع المحرِّرين في المستند.

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

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

editors

object (Editors)

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

المحررون

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

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

string

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

groups[]

string

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

domainUsersCanEdit

boolean

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

الفلتر الأساسي

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

تمثيل 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 في الردود. في حال تحديد كلا الحقلين في طلب التعديل، تكون الأولوية لهذا الحقل.

باندرانج

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

تمثيل 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.

خصائص التباين

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

مجموعة السمات

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

تمثيل 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)

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

مواصفات شرائح الجمهور

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

تمثيل 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.