Cells

بيانات شبكة الجوّال

البيانات المتعلقة بخلية معيّنة.

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

تنسيق الخلية

تنسيق خلية

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

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

تنسيق Number

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

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

enum (NumberFormatType)

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

pattern

string

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

تنسيق التنسيق

تنسيق الأرقام للخلية في هذا المستند، يُفترض أن تكون اللغة هي 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)

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

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

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

محاذاة عمودية

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

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

استراتيجية الالتفاف

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

عمليات التعداد
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.  |

توجيه النص

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

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

نوع الرابط التشعبي

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

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

تدوير النص

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

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

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

vertical

boolean

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

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

تشغيل التنسيق النصي

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

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

integer

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

format

object (TextFormat)

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

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

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

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

object (BooleanCondition)

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

inputMessage

string

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

strict

boolean

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

showCustomUi

boolean

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

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

هو جدول مصدر بيانات يسمح للمستخدم باستيراد جدول بيانات ثابت من DataSource إلى "جداول بيانات 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

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

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

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

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

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

الإخراج فقط. حالة تنفيذ البيانات.