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