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)
    }
  ],
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ]
}
الحقول
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)

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

tables[]

object (Table)

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

commentAnchors[]

object (CommentAnchor)

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

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

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

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

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

pixelSize

integer

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

developerMetadata[]

object (DeveloperMetadata)

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

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

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

  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
}
الحقول
ranges[]

object (GridRange)

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

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

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

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

editors

object (Editors)

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

المحرّرون

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

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

string

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

groups[]

string

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

domainUsersCanEdit

boolean

تعرض القيمة TRUE إذا كان بإمكان أي مستخدم في نطاق المستند تعديل النطاق المحمي. لا تتوفّر حماية النطاق إلا للمستندات داخل النطاق.

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,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
الحقول
bandedRangeId

integer

معرّف النطاق المصنّف. في حال عدم ضبطها، يُرجى الرجوع إلى bandedRangeReference.

bandedRangeReference

string

النتائج فقط. تمثّل هذه السمة مرجع النطاق المحدود المستخدَم لتحديد المعرّف غير المتوافق مع bandedRangeId.

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.

CommentAnchor

موضع في جدول البيانات مرتبط بـ CommentThread له anchorId نفسه ملاحظة: قد تشير نقاط ارتساء متعدّدة إلى الموقع الجغرافي نفسه.

تمثيل JSON 
{
  "anchorId": string,
  "range": {
    object (GridRange)
  }
}
الحقول
anchorId

string

المعرّف الفريد لمرتكز التعليق النتائج فقط.

range

object (GridRange)

نطاق الإحداثيات داخل ورقة الجداول حيث يتم تثبيت هذا التعليق.