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)

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

عند القراءة، يتم تضمين جميع عمليات التشغيل التي تم فيها استخدام شريحة NFC وتلك التي لم يتم فيها استخدامها. ستحتوي عمليات التشغيل غير المزوّدة بشريحة على 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

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

النتائج فقط. تمثّل هذه السمة حالة تنفيذ البيانات.

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 فقط على شكل رقائق. جميع أنواع الروابط الغنية بصريًا الأخرى تكون للقراءة فقط.

لا يمكن أن تتجاوز معرّفات الموارد الموحّدة 2000 بايت عند الكتابة.

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

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

string

الحقل مطلوب. تمثّل هذه السمة معرّف الموارد المنتظم (URI) للرابط. وهو متوفّر دائمًا.

mimeType

string

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