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

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

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

True if the column grouping control toggle is shown after the group.

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)
    }
  ],

  // 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)

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

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.