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() ملاحظة: يتم تمثيل التواريخ والأوقات والتواريخ والساعات بتنسيق مزدوج في 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

عرض الحدود، بالبكسل تم الإيقاف؛ يتم تحديد العرض من خلال حقل "النمط".

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. تكون الزوايا الموجبة متجهة للأعلى، وتكون الزوايا السالبة متجهة للأسفل.

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

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 إذا كان يجب تخصيص واجهة المستخدم بناءً على نوع الشرط. في حال الضبط على "صحيح"، ستعرض شروط "القائمة" قائمة منسدلة.

DataSourceTable

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

تمثيل 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)

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