Cells

CellData

يشير ذلك المصطلح إلى بيانات حول خلية معيّنة.

تمثيل JSON 
{
  "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)
  }
}
الحقول
userEnteredValue

object (ExtendedValue)

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

effectiveValue

object (ExtendedValue)

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

formattedValue

string

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

userEnteredFormat

object (CellFormat)

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

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

effectiveFormat

object (CellFormat)

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

note

string

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

textFormatRuns[]

object (TextFormatRun)

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

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

dataValidation

object (DataValidationRule)

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

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

pivotTable

object (PivotTable)

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

dataSourceTable

object (DataSourceTable)

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

dataSourceFormula

object (DataSourceFormula)

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

CellFormat

تنسيق الخلية.

تمثيل JSON 
{
  "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)
  }
}
الحقول
numberFormat

object (NumberFormat)

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

حدود الخلية.

padding

object (Padding)

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

horizontalAlignment

enum (HorizontalAlign)

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

verticalAlignment

enum (VerticalAlign)

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

wrapStrategy

enum (WrapStrategy)

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

textDirection

enum (TextDirection)

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

textFormat

object (TextFormat)

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

textRotation

object (TextRotation)

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

NumberFormat

تنسيق الأرقام لخلية.

تمثيل JSON 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
الحقول
type

enum (NumberFormatType)

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

pattern

string

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

NumberFormatType

تنسيق الأرقام للخلية. في هذه الوثائق، يُفترض أن تكون اللغة en_US، لكن التنسيق الفعلي يعتمد على لغة جدول البيانات.

عمليات التعداد
NUMBER_FORMAT_TYPE_UNSPECIFIED لم يتم تحديد تنسيق الأرقام وهو يستند إلى محتوى الخلية. لا تستخدِم هذه العبارة بشكلٍ صريح.
TEXT تنسيق النص، على سبيل المثال 1000.12
NUMBER تنسيق الأرقام، مثل 1,000.12
PERCENT تنسيق النسبة المئوية، مثلاً 10.12%
CURRENCY تنسيق العملة، على سبيل المثال $1,000.12
DATE تنسيق التاريخ، على سبيل المثال 9/26/2008
TIME تنسيق الوقت، على سبيل المثال 3:59:00 PM
DATE_TIME تنسيق التاريخ والوقت، على سبيل المثال 9/26/08 15:59:00
SCIENTIFIC تنسيق الأرقام العلمية، مثل 1.01E+03

الحدود

حدود الخلية.

تمثيل JSON 
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
الحقول
top

object (Border)

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

bottom

object (Border)

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

left

object (Border)

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

right

object (Border)

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

الحدود

حد على طول خلية.

تمثيل JSON 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
الحقول
style

enum (Style)

نمط الحد.

width
(deprecated)

integer

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

color
(deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

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

النمط

نمط الحدود.

عمليات التعداد
STYLE_UNSPECIFIED لم يتم تحديد النمط. لا تستخدم هذه المعلومات.
DOTTED الحدود منقّطة.
DASHED الحدود متقطعة.
SOLID الحدود خط متصل رفيع.
SOLID_MEDIUM الحدود هي خط متصل متوسط.
SOLID_THICK الحدود خط متصل سميك.
NONE بلا حدود لا يُستخدم إلا عند تعديل الحدود لمحوها.
DOUBLE تتكون الحدود من خطين متصلين.

مساحة متروكة

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

تمثيل JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
الحقول
top

integer

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

right

integer

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

bottom

integer

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

left

integer

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

VerticalAlign

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

عمليات التعداد
VERTICAL_ALIGN_UNSPECIFIED لم يتم تحديد المحاذاة العمودية. لا تستخدم هذه المعلومات.
TOP تتم محاذاة النص بوضوح إلى أعلى الخلية.
MIDDLE تتم محاذاة النص بوضوح إلى منتصف الخلية.
BOTTOM تتم محاذاة النص بوضوح إلى أسفل الخلية.

WrapStrategy

كيفية التفاف النص في خلية.

عمليات التعداد
WRAP_STRATEGY_UNSPECIFIED القيمة التلقائية هي عدم الاستخدام.
OVERFLOW_CELL

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

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

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

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

سيتم قص الأسطر الأطول من عرض الخلية. لن يلتف النص مطلقًا إلى السطر التالي ما لم يدرج المستخدم سطرًا جديدًا يدويًا. مثال: 

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

يتم لف الكلمات الأطول من سطر على مستوى الأحرف بدلاً من اقتصاصها. مثال: 

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

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

عمليات التعداد
TEXT_DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه النص. لا تستخدم هذه المعلومات.
LEFT_TO_RIGHT حدَّد المستخدم اتجاه النص من اليسار إلى اليمين.
RIGHT_TO_LEFT تم تعيين اتجاه النص من اليمين إلى اليسار بواسطة المستخدم.

HyperlinkDisplayType

لتحديد ما إذا كان سيتم عرض رابط تشعّبي بشكل صريح. إذا لم يتم تحديد هذا الخيار، سيتم ربط الرابط التشعبي.

عمليات التعداد
LINKED يجب عرض الرابط التشعّبي بوضوح.
PLAIN_TEXT يجب عدم عرض الرابط التشعّبي.

TextRotation

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

تمثيل JSON 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
الحقول
حقل الاتحاد type يشير ذلك المصطلح إلى نوع الدوران، سواء كان عموديًا أم بزاوية. type واحد فقط مما يلي:
angle

integer

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

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

vertical

boolean

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

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

TextFormatRun

عرض تقديمي بتنسيق نصي ويستمر تنسيق هذا الجري حتى فهرس البداية في عملية التشغيل التالية. عند التحديث، يجب ضبط جميع الحقول.

تمثيل JSON 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
الحقول
startIndex

integer

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

format

object (TextFormat)

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

DataValidationRule

قاعدة التحقق من صحة البيانات.

تمثيل JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
الحقول
condition

object (BooleanCondition)

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

inputMessage

string

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

strict

boolean

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

showCustomUi

boolean

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

DataSourceTable

جدول مصدر بيانات، يسمح للمستخدم باستيراد جدول ثابت للبيانات من DataSource إلى جداول البيانات. يُعرف ذلك أيضًا باسم "استخراج" في محرر جداول البيانات.

تمثيل JSON 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
الحقول
dataSourceId

string

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

columnSelectionType

enum (DataSourceTableColumnSelectionType)

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

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

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

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

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

dataExecutionStatus

object (DataExecutionStatus)

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

DataSourceTableColumnSelectionType

أنواع اختيار أعمدة جدول مصادر البيانات.

عمليات التعداد
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED عدم استخدام الخيار التلقائي لاختيار العمود
SELECTED اختيار الأعمدة المحددة بواسطة columns .
SYNC_ALL

مزامنة جميع الأعمدة الحالية والمستقبلية في مصدر البيانات

وفي حال ضبطها، يسترجع جدول مصدر البيانات جميع الأعمدة في مصدر البيانات عند إعادة التحميل.

DataSourceFormula

صيغة مصدر بيانات.

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

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