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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
الحقول
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).

chipRuns[]

object (ChipRun)

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

عند القراءة، يتم تضمين جميع عمليات التشغيل التي تتضمّن شرائح ذاكرة وتلك التي لا تتضمّن شرائح. ستحتوي عمليات التشغيل غير المُعدَّلة على Chip فارغ.

عند الكتابة، لا يتم تضمين سوى عمليات التشغيل التي تحتوي على شرائح. تكون عمليات التشغيل التي تحتوي على شرائح بطول 1 ويتم تمثيلها في النص الذي يدخله المستخدم برمز العنصر النائب "@". ستحلّ عمليات التشغيل الجديدة محلّ أيّ عمليات تشغيل سابقة. سيؤدي كتابة ملف userEnteredValue جديد إلى محو عمليات التشغيل السابقة.

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

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

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

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

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)

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

ChipRun

تشغيل شريحة يستمرّ الرقاقة إلى فهرس بدء التشغيل التالي.

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

integer

مطلوب. فهرس الأحرف بالاستناد إلى الصفر الذي يبدأ عنده هذا الإجراء، بوحدات ترميز UTF-16

chip

object (Chip)

اختيارية: شريحة هذا الإجراء

شريحة

الشريحة الذكية

تمثيل JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
الحقول
حقل الربط properties. خصائص الشريحة properties يمكن أن تكون إحدى القيم التالية فقط:
personProperties

object (PersonProperties)

خصائص شخص مرتبط

PersonProperties

الخصائص الخاصة بشخص مرتبط

تمثيل JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
الحقول
email

string

مطلوب. عنوان البريد الإلكتروني المرتبط بهذا الشخص هذا الحقل متوفّر دائمًا.

displayFormat

enum (DisplayFormat)

اختيارية: تنسيق عرض شريحة المستخدم في حال عدم ضبط هذه القيمة، يتم استخدام تنسيق العرض التلقائي.

DisplayFormat

تنسيق العرض المفضّل عند توفّره

عمليات التعداد
DISPLAY_FORMAT_UNSPECIFIED القيمة التلقائية، لا تستخدمها.
DEFAULT تنسيق العرض التلقائي
LAST_NAME_COMMA_FIRST_NAME تنسيق عرض اسم العائلة والاسم الأول
EMAIL تنسيق عرض البريد الإلكتروني

RichLinkProperties

سمات رابط يؤدي إلى مورد في Google (مثل ملف في Drive أو فيديو على YouTube أو عنوان على "خرائط Google" أو حدث في "تقويم Google") لا يمكن كتابة سوى ملفات Drive كشرائح. وجميع أنواع الروابط الغنية الأخرى للقراءة فقط.

لا يمكن أن تتجاوز عناوين URL 2000 بايت عند الكتابة.

ملاحظة: تتطلّب كتابة شرائح ملفات Drive توفُّر نطاق OAuth واحد على الأقل من بين drive.file أو drive.readonly أو drive.

تمثيل JSON 
{
  "uri": string,
  "mimeType": string
}
الحقول
uri

string

مطلوب. معرّف الموارد المنتظم للرابط هذا الخيار متاح دائمًا.

mimeType

string

النتائج فقط. نوع MIME للرابط، إذا كان هناك رابط (على سبيل المثال، عندما يكون ملفًا في Drive)