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، في حين سيكون للجزء الثاني 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) لنقل 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

True إذا كانت الورقة هي ورقة من اليمين إلى اليسار بدلاً من ورقة 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)

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

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 CANNOT TRANSLATE 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

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

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