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

sheetType

enum (SheetType)

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

gridProperties

object (GridProperties)

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

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

hidden

boolean

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

tabColor
(deprecated)

object (Color)

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

tabColorStyle

object (ColorStyle)

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

rightToLeft

boolean

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

dataSourceSheetProperties

object (DataSourceSheetProperties)

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

SheetType

نوع ورقة البيانات.

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

GridProperties

خصائص الشبكة

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

integer

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

columnCount

integer

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

frozenRowCount

integer

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

frozenColumnCount

integer

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

hideGridlines

boolean

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

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

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

DataSourceSheetProperties

سمات إضافية لورقة DATA_SOURCE

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

string

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

columns[]

object (DataSourceColumn)

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

dataExecutionStatus

object (DataExecutionStatus)

تمثّل هذه السمة حالة تنفيذ البيانات.

GridData

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

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

integer

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

startColumn

integer

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

rowData[]

object (RowData)

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

rowMetadata[]

object (DimensionProperties)

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

columnMetadata[]

object (DimensionProperties)

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

RowData

بيانات حول كل خلية في صف

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

object (CellData)

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

DimensionProperties

سمات حول أحد المقاييس.

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

boolean

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

hiddenByUser

boolean

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

pixelSize

integer

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

developerMetadata[]

object (DeveloperMetadata)

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

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

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

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

object (GridRange)

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

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

object (BooleanRule)

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

gradientRule

object (GradientRule)

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

BooleanRule

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

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

object (BooleanCondition)

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

format

object (CellFormat)

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

GradientRule

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

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

object (InterpolationPoint)

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

midpoint

object (InterpolationPoint)

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

maxpoint

object (InterpolationPoint)

نقطة الاستيفاء النهائية.

InterpolationPoint

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

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

object (Color)

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

colorStyle

object (ColorStyle)

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

type

enum (InterpolationPointType)

توضّح هذه السمة كيفية تفسير القيمة.

value

string

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

InterpolationPointType

نوع نقطة الاستيفاء.

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

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

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

FilterView

عرض فلتر لمزيد من المعلومات، يُرجى الاطّلاع على إدارة إمكانية الاطّلاع على البيانات باستخدام الفلاتر.

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

integer

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

title

string

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

range

object (GridRange)

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

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

namedRangeId

string

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

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

tableId

string

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

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

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

تم إيقاف العمل بهذا الحقل لصالح filterSpecs.

filterSpecs[]

object (FilterSpec)

معايير الفلتر لإظهار القيم أو إخفائها لكل عمود

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

ProtectedRange

نطاق محمي

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

integer

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

range

object (GridRange)

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

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

namedRangeId

string

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

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

tableId

string

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

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

description

string

تمثّل هذه السمة وصف النطاق المحمي.

warningOnly

boolean

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

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

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

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

editors

object (Editors)

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

المحرّرون

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

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

string

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

groups[]

string

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

domainUsersCanEdit

boolean

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

BasicFilter

الفلتر التلقائي المرتبط بورقة بيانات. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة إمكانية الاطّلاع على البيانات باستخدام الفلاتر.

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

object (GridRange)

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

tableId

string

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

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

تم إيقاف العمل بهذا الحقل لصالح filterSpecs.

filterSpecs[]

object (FilterSpec)

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

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

BandedRange

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

تمثيل JSON 
{
  "bandedRangeId": integer,
  "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)

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