Cells

{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}

object (ExtendedValue)

القيمة التي أدخلها المستخدم في الخلية. مثلاً: 1234, 'Hello'، أو =NOW() ملاحظة: يتم تمثيل التواريخ، والأوقات، وDateTimes، في صورة مضاعفات في serial number .

object (ExtendedValue)

القيمة الفعالة للخلية. بالنسبة للخلايا التي تحتوي على صيغ، تكون هذه هي القيمة المحسوبة. بالنسبة للخلايا التي تحتوي على قيم حرفية، ينطبق ذلك على نفس userEnteredValue. هذا الحقل للقراءة فقط.

string

القيمة المنسَّقة للخلية. وهذه هي القيمة التي تظهر للمستخدم. هذا الحقل للقراءة فقط.

object (CellFormat)

التنسيق الذي أدخله المستخدم للخلية.

عند الكتابة، سيتم دمج التنسيق الجديد مع التنسيق الحالي.

object (CellFormat)

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

string

رابط تشعّبي تشير إليه هذه الخلية، إن وجد. إذا كانت الخلية تحتوي على روابط تشعبية متعددة، فسيكون هذا الحقل فارغًا. هذا الحقل للقراءة فقط. لضبطها، استخدِم =HYPERLINK في userEnteredValue.formulaValue . يمكن أيضًا تعيين رابط على مستوى الخلية من userEnteredFormat.textFormat . وبدلاً من ذلك، يمكنك تعيين ارتباط تشعبي في textFormatRun.format.link الذي يمتد إلى الخلية بأكملها.

string

أي ملاحظة على الخلية.

object (TextFormatRun)

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

عند الكتابة، ستحل عمليات التشغيل الجديدة محل أي عمليات تشغيل سابقة. عند كتابة رسالة userEnteredValue، تم محو عمليات التشغيل السابقة.

object (DataValidationRule)

قاعدة للتحقق من صحة البيانات على الخلية، إن وجدت.

عند الكتابة، ستحل قاعدة التحقق من صحة البيانات الجديدة محل أي قاعدة سابقة.

object (PivotTable)

جدول محوري تم تثبيته في هذه الخلية. يتم حساب حجم الجدول المحوري نفسه ديناميكيًا بناءً على بياناته وتجميعه وفلاتره وقيمه وما إلى ذلك. فقط الخلية العلوية اليسرى من الجدول المحوري تحتوي على تعريف الجدول المحوري. ستحتوي الخلايا الأخرى على القيم المحسوبة لنتائج المحور في effectiveValue الحقول.

object (DataSourceTable)

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

object (DataSourceFormula)

النتائج فقط. معلومات حول صيغة مصدر بيانات في الخلية. يتم تعيين الحقل إذا userEnteredValue هي معادلة تشير إلى بعض DATA_SOURCE ورقة، على سبيل المثال =SUM(DataSheet!Column)

{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}

object (NumberFormat)

تنسيق يصف كيف يجب تمثيل القيم الرقمية للمستخدم.

object (Color)

لون خلفية الخلية. مهملة: استخدام backgroundColorStyle

object (ColorStyle)

لون خلفية الخلية. في حال حذف backgroundColor يتم أيضًا، تكون الأولوية لهذا الحقل.

object (Borders)

حدود الخلية.

object (Padding)

المساحة المتروكة للخلية.

enum (HorizontalAlign)

المحاذاة الأفقية للقيمة في الخلية.

enum (VerticalAlign)

المحاذاة العمودية للقيمة في الخلية.

enum (WrapStrategy)

استراتيجية الالتفاف للقيمة في الخلية.

enum (TextDirection)

اتجاه النص في الخلية.

object (TextFormat)

تنسيق النص في الخلية (ما لم يتم تجاوزه من خلال تشغيل تنسيق). يؤدي ضبط رابط على مستوى الخلية هنا إلى محو روابط الخلية الحالية. يمكن أن يؤدي تعيين حقل الرابط في TextFormatRun على الرابط على مستوى الخلية.

enum (HyperlinkDisplayType)

إذا كان موجودًا، فكيف يجب عرض الرابط التشعبي في الخلية.

object (TextRotation)

يتم تطبيق التدوير على النص في الخلية.

{
  "type": enum (NumberFormatType),
  "pattern": string
}

enum (NumberFormatType)

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

string

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

{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}

object (Border)

الحد العلوي للخلية.

object (Border)

الحد السفلي للخلية.

object (Border)

الحد الأيسر للخلية.

object (Border)

الحد الأيمن للخلية.

{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}

enum (Style)

نمط الحد.

integer

عرض الحدود بالبكسل. متوقّفة نهائيًا: يتم تحديد العرض بواسطة "style" .

object (Color)

لون الحدود مهملة: استخدام colorStyle

object (ColorStyle)

لون الحدود في حال حذف color يتم أيضًا، تكون الأولوية لهذا الحقل.

{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}

integer

المساحة المتروكة العلوية للخلية.

integer

المساحة المتروكة اليمنى للخلية.

integer

المساحة المتروكة السفلية للخلية.

integer

المساحة المتروكة اليسرى للخلية.

{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}

integer

الزاوية بين الاتجاه القياسي والاتجاه المطلوب. قياس بالدرجات تتراوح القيم الصالحة بين -90 و90. تكون الزوايا الموجبة مائلة للأعلى، والزوايا السالبة للأسفل.

ملاحظة: بالنسبة إلى الزوايا الموجبة لاتجاه LTR، تكون الزوايا الموجبة عكس اتجاه عقارب الساعة، بينما تكون الزوايا من ناحية اتجاه عقارب الساعة في اتجاه عقارب الساعة.

boolean

إذا كانت القيمة true، سيظهر النص من الأعلى إلى الأسفل، ولكن لن يتغيّر اتجاه الأحرف الفردية. مثلاً:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}

integer

تمثّل هذه السمة فهرس الأحرف المستند إلى صفر حيث يبدأ عملية التشغيل هذه بوحدات رمز UTF-16.

object (TextFormat)

تمثّل هذه السمة تنسيق عملية التشغيل هذه. ترث القيم غير الموجودة تنسيق الخلية.

{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}

object (BooleanCondition)

الشرط الذي يجب أن تتطابق معه البيانات في الخلية.

string

رسالة يتم عرضها للمستخدم عند إضافة بيانات إلى الخلية.

boolean

صحيح إذا تم رفض البيانات غير الصالحة.

boolean

True إذا كان يجب تخصيص واجهة المستخدم بناءً على نوع الشرط. إذا كانت القيمة هي true، يجب إدخال القيمة "List" (القائمة). الشروط إلى إظهار قائمة منسدلة.

{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

رقم تعريف مصدر البيانات المرتبط به جدول مصدر البيانات.

enum (DataSourceTableColumnSelectionType)

النوع المراد اختيار أعمدة لجدول مصدر البيانات. الإعدادات التلقائية على SELECTED

object (DataSourceColumnReference)

الأعمدة المحدّدة لجدول مصدر البيانات تشير رسالة الأشكال البيانية columnSelectionType يجب أن يكون SELECTED

object (FilterSpec)

فلترة المواصفات في جدول مصدر البيانات

object (SortSpec)

ترتيب المواصفات في جدول مصدر البيانات يتمّ ترتيب نتائج جدول مصدر البيانات حسب مواصفات الترتيب بالترتيب.

integer

حد الصفوف المطلوب عرضها. وفي حال تم ترك السياسة بدون ضبط، يتم تطبيق حدّ تلقائي. يُرجى الرجوع إلى محرِّر "جداول بيانات Google" لمعرفة الحدّ الأقصى والتلقائي.

object (DataExecutionStatus)

النتائج فقط. حالة تنفيذ البيانات.

{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

رقم تعريف مصدر البيانات الذي ترتبط به الصيغة.

object (DataExecutionStatus)

النتائج فقط. حالة تنفيذ البيانات.