جدول بيانات
ورقة في جدول بيانات
تمثيل JSON |
---|
{ "properties": { object ( |
الحقول | |
---|---|
properties
|
خصائص الورقة |
data[]
|
البيانات في الشبكة، إذا كانت هذه ورقة شبكية.
يعتمد عدد عناصر GridData التي يتم عرضها على عدد النطاقات المطلوبة في هذه الورقة. على سبيل المثال، إذا كان هذا يمثّل
بالنسبة إلى
ورقة |
merges[]
|
النطاقات التي يتم دمجها معًا. |
conditionalFormats[]
|
قواعد التنسيق الشرطي في هذه الورقة |
filterViews[]
|
عروض الفلاتر في هذه الورقة |
protectedRanges[]
|
النطاقات المحمية في هذه الورقة. |
basicFilter
|
الفلتر على ورقة البيانات هذه، إن توفّر. |
charts[]
|
مواصفات كل مخطط في هذه الورقة. |
bandedRanges[]
|
النطاقات المخططة (بألوان بديلة) في هذه الورقة |
developerMetadata[]
|
البيانات الوصفية للمطوّر المرتبطة بورقة بيانات |
rowGroups[]
|
جميع مجموعات الصفوف في هذه الورقة مرتّبة من خلال زيادة فهرس بدء النطاق، ثم حسب عمق المجموعة. |
columnGroups[]
|
جميع مجموعات الأعمدة في هذه الورقة، مرتبة حسب فهرس بداية النطاق المتزايد، ثم حسب عمق المجموعة. |
slicers[]
|
فلاتر نطاقات البيانات في هذه الورقة |
SheetProperties
خصائص ورقة البيانات
تمثيل JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة البيانات يجب أن تكون غير سالبة. لا يمكن تغيير هذا الحقل بعد ضبطه. |
title
|
اسم ورقة البيانات |
index
|
فهرس الورقة ضمن جدول البيانات. عند إضافة خصائص ورقة البيانات أو تعديلها، إذا تم استبعاد هذا الحقل، تتم إضافة ورقة البيانات أو نقلها إلى نهاية قائمة أوراق البيانات. عند تعديل فهارس الأوراق أو إدراج أوراق، يتمّ احتساب الحركة في فهارس "قبل النقل". على سبيل المثال، إذا كانت هناك ثلاث أوراق بيانات (S1 وS2 وS3)، يجب ضبط الفهرس على 2 لنقل S1 قبل S2. يتم تجاهل طلب تعديل فهرس جدول البيانات إذا كان الفهرس المطلوب مطابقًا للفهرس الحالي للجدول أو إذا كان الفهرس الجديد المطلوب يساوي فهرس الجدول الحالي + 1. |
sheetType
|
نوع الورقة الإعداد التلقائي هو
|
gridProperties
|
خصائص إضافية للورقة إذا كانت هذه الورقة شبكة. (إذا كانت الورقة هي ورقة عناصر تحتوي على رسم بياني أو صورة، لن يكون هذا الحقل متوفّرًا). عند الكتابة، يُعدّ ضبط أيّ خصائص شبكة على أوراق البيانات غير المستندة إلى شبكة خطأ.
إذا كانت هذه الورقة هي جدول
|
tabColor
|
لون علامة التبويب في واجهة المستخدم متوقّفة نهائيًا: استخدِم
|
tabColorStyle
|
لون علامة التبويب في واجهة المستخدم إذا تم ضبط |
rightToLeft
|
صحيح إذا كانت الورقة هي ورقة باتجاه RTL بدلاً من ورقة باتجاه LTR. |
dataSourceSheetProperties
|
النتائج فقط. يحتوي الحقل على سمات خاصة بالجدول
|
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
|
عدد الصفوف في الشبكة |
columnCount
|
عدد الأعمدة في الشبكة. |
frozenRowCount
|
عدد الصفوف التي تم تجميدها في الشبكة |
frozenColumnCount
|
عدد الأعمدة التي تم تجميدها في الشبكة. |
hideGridlines
|
صحيح إذا كانت الشبكة لا تعرض خطوط الشبكة في واجهة المستخدم. |
rowGroupControlAfter
|
True إذا كان عنصر التحكم في تجميع الصفوف ظاهرًا بعد المجموعة. |
columnGroupControlAfter
|
صحيح إذا كان عنصر التحكّم في تجميع الأعمدة يظهر بعد المجموعة. |
DataSourceSheetProperties
سمات إضافية لجدول
DATA_SOURCE
.
تمثيل JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
الحقول | |
---|---|
dataSourceId
|
معرّف
|
columns[]
|
الأعمدة المعروضة في ورقة البيانات، والتي تتوافق مع القيم الواردة في
|
dataExecutionStatus
|
حالة تنفيذ البيانات. |
GridData
البيانات في الشبكة، بالإضافة إلى البيانات الوصفية عن السمات
تمثيل JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
الحقول | |
---|---|
startRow
|
الصف الأول الذي تشير إليه GridData، وهو صفر. |
startColumn
|
العمود الأول الذي تشير إليه GridData، وهو مستند إلى الصفر |
rowData[]
|
البيانات في الشبكة، إدخال واحد لكل صف، بدءًا من الصف في startRow ستتوافق القيم في RowData مع الأعمدة التي تبدأ من
|
rowMetadata[]
|
بيانات التعريف حول الصفوف المطلوبة في الشبكة، بدءًا من الصف في
|
columnMetadata[]
|
بيانات التعريف عن الأعمدة المطلوبة في الشبكة، بدءًا من العمود في
|
RowData
بيانات عن كل خلية في صف
تمثيل JSON |
---|
{
"values": [
{
object ( |
الحقول | |
---|---|
values[]
|
القيم في الصف، واحدة لكل عمود |
DimensionProperties
الخصائص المرتبطة بسمة معيّنة.
تمثيل JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
الحقول | |
---|---|
pixelSize
|
ارتفاع السمة (إذا كان صفًا) أو العرض (إذا كان عمودًا) بالبكسل. |
developerMetadata[]
|
البيانات الوصفية لمطوّر البرامج المرتبطة بصف أو عمود واحد |
dataSourceColumnReference
|
النتائج فقط. إذا تم ضبطه، هذا عمود في ورقة بيانات مصدر. |
ConditionalFormatRule
قاعدة تصف تنسيقًا شرطيًا
تمثيل JSON |
---|
{ "ranges": [ { object ( |
الحقول | |
---|---|
ranges[]
|
النطاقات التي يتم تنسيقها إذا كان الشرط true. يجب أن تكون جميع النطاقات في الشبكة نفسها. |
حقل الاتحاد
rule . القاعدة التي تتحكّم في هذا التنسيق الشرطي، يجب ضبط قاعدة واحدة بالضبط.
rule
يمكن أن تكون إحدى القيم التالية فقط:
|
|
booleanRule
|
ويكون التنسيق إما "مفعّلاً" أو "متوقفًا" وفقًا للقاعدة. |
gradientRule
|
سيختلف التنسيق حسب التدرجات في القاعدة. |
BooleanRule
قاعدة قد تتطابق أو لا تتطابق، حسب الشرط.
تمثيل JSON |
---|
{ "condition": { object ( |
الحقول | |
---|---|
condition
|
شرط القاعدة. إذا كان تقييم الشرط صحيحًا، يتم تطبيق التنسيق. |
format
|
تمثّل هذه السمة التنسيق المطلوب تطبيقه. لا يمكن للتنسيق الشرطي تطبيق سوى مجموعة فرعية من التنسيقات:
|
GradientRule
قاعدة تطبّق تنسيق مقياس ألوان متدرّج استنادًا إلى نقاط الاستقراء المدرَجة. سيختلف تنسيق الخلية استنادًا إلى محتوياتها مقارنةً بقيم نقاط الاستقراء.
تمثيل JSON |
---|
{ "minpoint": { object ( |
الحقول | |
---|---|
minpoint
|
نقطة البداية للإ interpolation |
midpoint
|
نقطة إكمال اختيارية في منتصف الطريق. |
maxpoint
|
نقطة الاستيفاء النهائية: |
InterpolationPoint
نقطة تداخل واحدة في تنسيق شرطي متدرّج تؤدي هذه الأزرار إلى تثبيت مقياس لون التدرج وفقًا للون والنوع والقيمة المحددة.
تمثيل JSON |
---|
{ "color": { object ( |
الحقول | |
---|---|
color
|
اللون الذي يجب أن تستخدمه نقطة الاستقراء هذه. متوقّفة نهائيًا: استخدِم
|
colorStyle
|
اللون الذي يجب أن تستخدمه نقطة الاستقراء هذه. إذا تم أيضًا ضبط
|
type
|
كيفية تفسير القيمة |
value
|
القيمة التي تستخدمها نقطة الاستقراء هذه. قد تكون صيغة. لا يتم استخدامها إذا كان
|
InterpolationPointType
نوع نقطة الاستقراء
عمليات التعداد | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
القيمة التلقائية هي عدم الاستخدام. |
MIN
|
تستخدِم نقطة الاستبدال أدنى قيمة في الخلايا على نطاق التنسيق المشروط. |
MAX
|
تستخدِم نقطة الاستقراء الحد الأقصى للقيمة في الخلايا على نطاق التنسيق الشرطي. |
NUMBER
|
تستخدم نقطة الاستكمال القيمة بالضبط في InterpolationPoint.value .
|
PERCENT
|
نقطة الاستبدال هي النسبة المئوية المحدّدة على جميع الخلايا في نطاق التنسيق الشرطي. يعادل ذلك |
PERCENTILE
|
نقطة الاستكمال هي المعدل المئوي المحدد على جميع الخلايا في نطاق التنسيق الشرطي. ويعادل ذلك
NUMBER
إذا كانت القيمة:
=PERCENTILE(FLATTEN(range), value / 100)
(حيث يتم تجاهل الأخطاء في النطاق عند تسويته).
|
FilterView
عرض فلتر
تمثيل JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
الحقول | |
---|---|
filterViewId
|
رقم تعريف عرض الفلتر |
title
|
اسم عرض الفلتر |
range
|
النطاق الذي يغطيه عرض الفلتر هذا
عند الكتابة، يمكن ضبط أحد الخيارَين التاليَين فقط:
|
namedRangeId
|
النطاق المُعنوَن الذي يستند إليه عرض الفلتر هذا، إن توفّر
عند الكتابة، يمكن ضبط أحد الخيارَين التاليَين فقط:
|
sortSpecs[]
|
ترتيب الترتيب لكل عمود يتم استخدام المواصفات اللاحقة عندما تكون القيم متساوية في المواصفات السابقة. |
criteria
|
معايير إظهار/إخفاء القيم لكل عمود مفتاح الخريطة هو فهرس العمود، والقيمة هي معايير هذا العمود.
تم إيقاف هذا الحقل نهائيًا واستبداله بحقل
|
filterSpecs[]
|
معايير الفلترة لعرض/إخفاء القيم لكل عمود
تتم تعبئة كل من
|
ProtectedRange
نطاق محمي
تمثيل JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
الحقول | |
---|---|
protectedRangeId
|
رقم تعريف النطاق المحمي. هذا الحقل للقراءة فقط. |
range
|
النطاق المحمي. قد يكون النطاق غير محدود بالكامل، وفي هذه الحالة يُعتبر ورقة محمية.
عند الكتابة، يمكن ضبط أحد الخيارَين التاليَين فقط:
|
namedRangeId
|
النطاق المعنوَن الذي يدعمه هذا النطاق المحمي، في حال توفّره
عند الكتابة، يمكن ضبط أحد الخيارَين التاليَين فقط:
|
description
|
وصف هذا النطاق المحمي. |
warningOnly
|
صحيح إذا كان هذا النطاق المحمي سيعرض تحذيرًا عند التعديل. تعني الحماية المستندة إلى التحذيرات أنّه يمكن لكل مستخدم تعديل البيانات في النطاق المحمي، إلا أنّ التعديل سيؤدي إلى ظهور تحذير يطلب من المستخدم تأكيد التعديل.
عند الكتابة: إذا كان هذا الحقل صحيحًا، سيتم تجاهل
|
requestingUserCanEdit
|
صحيح إذا كان المستخدم الذي طلب هذا النطاق المحمي يمكنه تعديل المنطقة المحمية. هذا الحقل للقراءة فقط. |
unprotectedRanges[]
|
قائمة النطاقات غير المحمية داخل ورقة محمية. لا تتوفّر النطاقات غير المحمية إلا في أوراق البيانات المحمية. |
editors
|
المستخدمون والمجموعات الذين لديهم إذن الوصول للتعديل إلى النطاق المحمي هذا الحقل مرئي فقط للمستخدمين الذين لديهم الإذن بتعديل النطاق المحمي والمستند. لا يمكن للمحرِّرين استخدام الحماية
|
المحرّرون
محررو النطاق المحمي.
تمثيل JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
الحقول | |
---|---|
users[]
|
عناوين البريد الإلكتروني للمستخدمين الذين لديهم إذن وصول للتعديل إلى النطاق المحمي |
groups[]
|
عناوين البريد الإلكتروني للمجموعات التي لديها إذن وصول للتعديل إلى النطاق المحمي |
domainUsersCanEdit
|
صحيح إذا كان أي مستخدم في نطاق المستند لديه إذن الوصول لتعديل النطاق المحمي. لا تتوفّر ميزة "حماية النطاق" إلا للمستندات ضمن نطاق معيّن. |
BasicFilter
الفلتر التلقائي المرتبط بجدول بيانات
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق الذي يغطيه الفلتر. |
sortSpecs[]
|
ترتيب الترتيب لكل عمود يتم استخدام المواصفات اللاحقة عندما تكون القيم متساوية في المواصفات السابقة. |
criteria
|
معايير عرض/إخفاء القيم لكل عمود مفتاح الخريطة هو فهرس العمود، والقيمة هي معايير هذا العمود.
تم إيقاف هذا الحقل نهائيًا لصالح
|
filterSpecs[]
|
معايير الفلتر لكل عمود
تتم تعبئة كل من
|
BandedRange
نطاق نطاقات (ألوان بديلة) في ورقة.
تمثيل JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
الحقول | |
---|---|
bandedRangeId
|
رقم تعريف نطاق النطاق. |
range
|
النطاق الذي يتم تطبيق هذه السمات عليه |
rowProperties
|
خصائص أشرطة الصفوف يتم تطبيق هذه الخصائص على أساس صف بصف في جميع الصفوف في النطاق. يجب تحديد سمة واحدة على الأقل من |
columnProperties
|
خصائص مجموعات الأعمدة يتم تطبيق هذه السمات على أساس عمود تلو الآخر في جميع الأعمدة في النطاق. يجب تحديد سمة واحدة على الأقل من
|
BandingProperties
السمات التي تشير إلى سمة واحدة (إما صف أو عمود) في حال ضبط كل من
BandedRange.row_properties
و
BandedRange.column_properties
، يتم تطبيق ألوان التعبئة على الخلايا وفقًا للقواعد التالية:
-
تحظى
headerColor
وfooterColor
بالأولوية على ألوان الأشرطة. -
يكون لـ
firstBandColor
الأولوية علىsecondBandColor
. -
وتحظى السمة
rowProperties
بالأولوية علىcolumnProperties
.
على سبيل المثال، يكون لون الصف الأول ذا أولوية على لون العمود الأول، ولكن يكون لون العمود الأول ذا أولوية على لون الصف الثاني. وبالمثل، يُمنَح عنوان الصف الأولوية على عنوان العمود في الخلية العلوية اليمنى، ولكن يُمنَح عنوان العمود الأولوية على لون الصف الأول في حال عدم ضبط عنوان الصف.
تمثيل JSON |
---|
{ "headerColor": { object ( |
الحقول | |
---|---|
headerColor
|
لون الصف أو العمود الأول إذا تم ضبط هذا الحقل، سيتم ملء الصف أو العمود الأول بهذا اللون وتبديل الألوان بين |
headerColorStyle
|
لون الصف أو العمود الأول إذا تم ضبط هذا الحقل، سيتم ملء الصف أو العمود الأول بهذا اللون وتبديل الألوان بين |
firstBandColor
|
أول لون متغيّر. (سمة مطلوبة) تم إيقافها نهائيًا: استخدِم
|
firstBandColorStyle
|
أول لون متغيّر. (مطلوب) في حال ضبط |
secondBandColor
|
اللون الثاني المتبادل. (سمة مطلوبة) تم إيقافها نهائيًا: استخدِم
|
secondBandColorStyle
|
اللون الثاني الذي يتم بدؤه بالتناوب (مطلوبة) إذا تم ضبط
|
footerColor
|
لون الصف أو العمود الأخير في حال عدم ضبط هذا الحقل، يتم ملء الصف أو العمود الأخير إما باستخدام
|
footerColorStyle
|
لون الصف أو العمود الأخير في حال عدم ضبط هذا الحقل، يتم ملء الصف أو العمود الأخير إما باستخدام
|
DimensionGroup
مجموعة على فاصل من الصفوف أو الأعمدة في ورقة بيانات، ويمكن أن تحتوي على مجموعات أخرى أو تكون مضمّنة فيها يمكن تصغير مجموعة أو توسيعها كوحدة في ورقة البيانات.
تمثيل JSON |
---|
{
"range": {
object ( |
الحقول | |
---|---|
range
|
النطاق الذي توجد عليه هذه المجموعة. |
depth
|
عمق المجموعة، الذي يمثّل عدد المجموعات التي تحتوي على نطاق يتضمّن نطاق هذه المجموعة بالكامل |
collapsed
|
يكون هذا الحقل صحيحًا إذا كانت هذه المجموعة مصغّرة. تظل المجموعة الصغيرة مصغّرة إذا تم توسيع مجموعة متداخلة في عمق أكثر سطحية. لا تشير القيمة "صحيح" إلى أنّ جميع السمات ضمن المجموعة مخفية، لأنّ مستوى ظهور السمة يمكن أن يتغيّر بشكل مستقل عن سمة المجموعة هذه. ومع ذلك، عند تعديل هذه السمة، يتم ضبط جميع السمات ضمنها على "مخفية" إذا كانت قيمة هذا الحقل "صحيحة"، أو على "مرئية" إذا كانت قيمة هذا الحقل "خطأ". |
فلتر نطاق البيانات
أداة تقسيم في ورقة بيانات
تمثيل JSON |
---|
{ "slicerId": integer, "spec": { object ( |
الحقول | |
---|---|
slicerId
|
معرّف أداة التقسيم. |
spec
|
مواصفات أداة التقطيع |
position
|
موضع أداة التقسيم يُرجى العلم أنّه لا يمكن وضع أداة التقسيم إلا على ورقة بيانات حالية. بالإضافة إلى ذلك، يمكن ضبط عرض أداة التقسيم وارتفاعها تلقائيًا للحفاظ عليها ضمن الحدود المسموح بها. |
SlicerSpec
مواصفات فلتر نطاق بيانات.
تمثيل JSON |
---|
{ "dataRange": { object ( |
الحقول | |
---|---|
dataRange
|
نطاق بيانات فلتر نطاق البيانات |
filterCriteria
|
معايير الفلترة الخاصة بفلتر النطاق. |
columnIndex
|
فهرس العمود المستند إلى صفر في جدول البيانات الذي يتم تطبيق الفلتر عليه. |
applyToPivotTables
|
True إذا كان يجب تطبيق عامل التصفية على الجداول المحورية. إذا لم يتم ضبطه، يتم ضبطه تلقائيًا على
|
title
|
عنوان أداة التقسيم |
textFormat
|
تنسيق نص العنوان في أداة التقسيم حقل الرابط غير متاح. |
backgroundColor
|
لون خلفية أداة التقسيم متوقّفة نهائيًا: استخدِم
|
backgroundColorStyle
|
لون خلفية فلتر نطاق البيانات إذا تم أيضًا ضبط
|
horizontalAlignment
|
المحاذاة الأفقية للعنوان في أداة التقسيم إذا لم يتم تحديد أي قيمة، يتم ضبط القيمة تلقائيًا على
|