بيانات شبكة الجوّال
البيانات المتعلقة بخلية معيّنة.
تمثيل JSON |
---|
{ "userEnteredValue": { object ( |
الحقول | |
---|---|
userEnteredValue
|
القيمة التي أدخلها المستخدم في الخلية، على سبيل المثال
|
effectiveValue
|
القيمة الفعّالة للخلية. بالنسبة إلى الخلايا التي تحتوي على صيغ، هذه هي القيمة المحسوبة. بالنسبة إلى الخلايا التي تتضمّن قيمًا حرفية، يكون هذا الحقل مطابقًا للاسم userEnteredValue. هذا الحقل للقراءة فقط. |
formattedValue
|
يشير إلى القيمة المنسّقة للخلية. هذه هي القيمة كما تظهر للمستخدم. هذا الحقل للقراءة فقط. |
userEnteredFormat
|
الصيغة التي أدخلها المستخدم في الخلية. وعند الكتابة، سيتم دمج التنسيق الجديد مع التنسيق الحالي. |
effectiveFormat
|
التنسيق الفعّال الذي تستخدمه الخلية. ويتضمن ذلك نتائج تطبيق أي تنسيق شرطي، وإذا كانت الخلية تحتوي على صيغة، يكون تنسيقها محسوبًا. إذا كان التنسيق الفعّال هو التنسيق التلقائي، لن تتم كتابة التنسيق الفعّال. هذا الحقل للقراءة فقط. |
hyperlink
|
رابط تشعّبي يشير إليه هذا الخلية، إن توفّر. إذا كانت الخلية تحتوي على روابط تشعّبية متعددة، سيكون هذا الحقل فارغًا. هذا الحقل للقراءة فقط. لضبط هذه السمة، يمكنك استخدام صيغة
|
note
|
أي ملاحظة على الخلية. |
textFormatRuns[]
|
تشغيل النصوص المنسّقة التي يتم تطبيقها على الأقسام الفرعية من الخلية. لا يمكن استخدام الجولات إلا في السلاسل التي يُدخلها المستخدمون، وليس في الصيغ أو قيم منطقية أو أرقام. تبدأ خصائص الجري في فهرس محدّد في النص وتستمر حتى السباق التالي. ستكتسب التشغيلات خصائص الخلية ما لم يتم تغييرها بشكل صريح.
وعند الكتابة، سيتم استبدال أي عمليات تشغيل جديدة بأي عمليات تشغيل سابقة. وعند كتابة |
dataValidation
|
قاعدة التحقق من صحة البيانات في الخلية، إن وجدت. عند الكتابة، ستحل قاعدة التحقق من صحة البيانات الجديدة محل أي قاعدة سابقة. |
pivotTable
|
جدول ثابت مثبَّت في هذه الخلية يتم احتساب حجم الجدول المحوري نفسه ديناميكيًا بناءً على بياناته وتجميعه وفلاتره وقيمه وما إلى ذلك. تحتوي الخلية العلوية فقط على تعريف الجدول المحوري على تعريف الجدول المحوري. ستحتوي الخلايا الأخرى على القيم المحسوبة لنتائج المحور في حقول |
dataSourceTable
|
جدول مصدر بيانات ثابت على هذه الخلية يتم احتساب حجم جدول مصدر البيانات نفسه ديناميكيًا بناءً على إعداده. تحتوي الخلية الأولى فقط من جدول مصدر البيانات على تعريف جدول مصدر البيانات. ستحتوي الخلايا الأخرى على قيم عرض نتيجة جدول مصدر البيانات في حقول |
dataSourceFormula
|
الإخراج فقط. معلومات حول صيغة مصدر البيانات في الخلية يتم ضبط الحقل إذا كانت
|
تنسيق الخلية
تنسيق خلية
تمثيل JSON |
---|
{ "numberFormat": { object ( |
الحقول | |
---|---|
numberFormat
|
تنسيق يصف كيفية تمثيل قيم الأرقام للمستخدم. |
backgroundColor
|
لون خلفية الخلية متوقفة: استخدِم
|
backgroundColorStyle
|
لون خلفية الخلية وفي حال ضبط السمة |
borders
|
حدود الخلية |
padding
|
المساحة المتروكة في الخلية |
horizontalAlignment
|
المحاذاة الأفقية للقيمة في الخلية. |
verticalAlignment
|
المحاذاة العمودية للقيمة في الخلية. |
wrapStrategy
|
استراتيجية الالتفاف للقيمة في الخلية. |
textDirection
|
اتجاه النص في الخلية. |
textFormat
|
تنسيق النص في الخلية (ما لم يتم تجاوزه عن طريق تشغيل تنسيق) يؤدي ضبط رابط على مستوى الخلية هنا إلى محو الروابط الحالية للخلية. يكون لإعداد حقل الرابط في
|
hyperlinkDisplayType
|
في حال توفّرها، كيف يجب عرض الرابط التشعّبي في الخلية. |
textRotation
|
يتم تطبيق التدوير على النص في الخلية. |
تنسيق Number
تنسيق الأرقام للخلية
تمثيل JSON |
---|
{
"type": enum (
|
الحقول | |
---|---|
type
|
تمثّل هذه السمة نوع تنسيق الرقم. عند الكتابة، يجب ضبط هذا الحقل. |
pattern
|
سلسلة النقش المستخدمة للتنسيق. في حال ترك السياسة بدون ضبط، سيتم استخدام نمط تلقائي استنادًا إلى لغة المستخدم، إذا لزم الأمر للنوع المحدّد. اطّلِع على دليل تنسيقات الأرقام والأرقام للحصول على مزيد من المعلومات حول الأنماط المتوافقة. |
تنسيق التنسيق
تنسيق الأرقام للخلية في هذا المستند، يُفترض أن تكون اللغة هي 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 ( |
الحقول | |
---|---|
top
|
الحد العلوي للخلية |
bottom
|
الحد السفلي للخلية |
left
|
الحد الأيسر للخلية |
right
|
الحد الأيمن للخلية |
Border
حد على طول خلية.
تمثيل JSON |
---|
{ "style": enum ( |
الحقول | |
---|---|
style
|
نمط الحدود. |
width
|
عرض الحدود بالبكسل. متوقّف نهائيًا، ويتم تحديد العرض بواسطة الحقل "style". |
color
|
لون الحدود متوقفة: استخدِم
|
colorStyle
|
لون الحدود وفي حال ضبط السمة |
النمط
نمط الحدود.
عمليات التعداد | |
---|---|
STYLE_UNSPECIFIED
|
لم يتم تحديد النمط. ويجب عدم استخدامها. |
DOTTED
|
تمت إضافة الحدّ إلى حدّ أقصى. |
DASHED
|
يكون الحد متقطّعًا. |
SOLID
|
الحد هو خط متصل رفيع. |
SOLID_MEDIUM
|
الحدود عبارة عن خط متصل متوسط. |
SOLID_THICK
|
الحد هو خط متصل سميك. |
NONE
|
بلا حدود. يُستخدم فقط عند تعديل الحدود لمحوها. |
DOUBLE
|
الحد هو خطان متصلان. |
مساحة متروكة
مقدار المساحة المتروكة حول الخلية بالبكسل. عند تعديل المساحة المتروكة، يجب تحديد كل حقل.
تمثيل JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
الحقول | |
---|---|
top
|
المساحة المتروكة العليا في الخلية |
right
|
المساحة المتروكة اليمنى من الخلية |
bottom
|
المساحة المتروكة في الخلية |
left
|
المساحة المتروكة اليسرى في الخلية |
محاذاة عمودية
المحاذاة العمودية للنص في خلية.
عمليات التعداد | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
لم يتم تحديد المحاذاة العمودية. ويجب عدم استخدامها. |
TOP
|
تتم محاذاة النص بشكل صريح إلى أعلى الخلية. |
MIDDLE
|
تتم محاذاة النص بشكلٍ صريح إلى منتصف الخلية. |
BOTTOM
|
تمت محاذاة النص بوضوح إلى أسفل الخلية. |
استراتيجية الالتفاف
كيفية التفاف النص في خلية
عمليات التعداد | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
ولا يتم استخدام القيمة التلقائية. |
OVERFLOW_CELL
|
ستتم كتابة الأسطر التي يزيد عرضها عن الخلية في الخلية التالية، طالما أنّ الخلية فارغة. إذا كانت الخلية التالية التي تم إنشاؤها غير فارغة، ستطابق هذه النتيجة سلوك
|
LEGACY_WRAP
|
تمثل استراتيجية الالتفاف هذه استراتيجية التفاف "جداول بيانات Google" القديمة حيث يتم قص الكلمات التي أطول من السطر بدلاً من تقسيمها. لا تتوفّر هذه الاستراتيجية على جميع المنصات، ويتم حاليًا إيقافها بشكل تدريجي. مثال:
|
CLIP
|
سيتم اقتصاص الأسطر التي يزيد عرضها عن الخلية. لن يمتد النص إلى السطر التالي مطلقًا ما لم يدرج المستخدم سطرًا جديدًا يدويًا. مثال:
|
WRAP
|
ويتم التفاف الكلمات التي أطول من السطر على مستوى الحرف بدلاً من اقتصاصها. مثال:
|
توجيه النص
اتجاه النص في خلية.
عمليات التعداد | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
لم يتم تحديد اتجاه النص. ويجب عدم استخدامها. |
LEFT_TO_RIGHT
|
تم ضبط اتجاه النص من اليسار إلى اليمين بواسطة المستخدم. |
RIGHT_TO_LEFT
|
تم ضبط اتجاه النص من اليمين إلى اليسار. |
نوع الرابط التشعبي
لتحديد ما إذا كان سيتم عرض رابط تشعّبي بشكل صريح أم لا. إذا لم يتم تحديد ذلك، سيتم ربط الرابط التشعّبي.
عمليات التعداد | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
القيمة التلقائية: يتم عرض الرابط التشعّبي. ويجب عدم استخدامها. |
LINKED
|
ويجب عرض رابط تشعّبي بشكل صريح. |
PLAIN_TEXT
|
يجب عدم عرض رابط تشعّبي. |
تدوير النص
يتم تطبيق التدوير على النص في خلية.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
type . تمثّل هذه السمة نوع التدوير أو العمودي أو الزاوية.
يمكن أن تكون السمة type
واحدة فقط من العناصر التالية:
|
|
angle
|
الزاوية بين الاتجاه العادي والاتجاه المطلوب. يتم قياسها بالدرجات. تتراوح القيم الصالحة بين -90 و90. الزوايا الإيجابية مع زاوية لأعلى، والسالبة بزاوية. ملاحظة: بالنسبة إلى الزوايا الإيجابية في اتجاه النص من اليسار إلى اليمين في اتجاه عقارب الساعة، بالنسبة إلى RTL، فهي في اتجاه عقارب الساعة |
vertical
|
إذا تم ضبط السياسة على "صحيح"، تتم قراءة النص من أعلى إلى أسفل، ولكن لا يتغيّر اتجاه الأحرف الفردية. على سبيل المثال:
|
تشغيل التنسيق النصي
يشير إلى تنسيق نصي. يستمر تنسيق هذا التشغيل حتى فهرس البدء للتشغيل التالي. عند التعديل، يجب ضبط جميع الحقول.
تمثيل JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
الحقول | |
---|---|
startIndex
|
فهرس الأحرف المستند إلى الصفر حيث يبدأ هذا التشغيل، بوحدات رموز UTF-16. |
format
|
تمثّل هذه السمة تنسيق التشغيل. تكتسب القيم غير الموجودة تنسيق الخلية. |
قاعدة التحقق من صحة البيانات
قاعدة التحقّق من صحة البيانات.
تمثيل JSON |
---|
{
"condition": {
object (
|
الحقول | |
---|---|
condition
|
الشرط الذي يجب أن تتطابق معه البيانات في الخلية. |
inputMessage
|
رسالة لعرض المستخدم عند إضافة بيانات إلى الخلية. |
strict
|
صحيح إذا كان يجب رفض البيانات غير الصالحة. |
showCustomUi
|
صحيح إذا كان يجب تخصيص واجهة المستخدم على أساس نوع الشرط. إذا كانت القيمة "صحيح"، ستعرض شروط "القائمة" قائمة منسدلة. |
جدول مصادر البيانات
هو جدول مصدر بيانات يسمح للمستخدم باستيراد جدول بيانات ثابت من DataSource
إلى "جداول بيانات Google". ويُعرف هذا أيضًا باسم "استخراج" في محرر جداول البيانات.
تمثيل JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
الحقول | |
---|---|
dataSourceId
|
رقم تعريف مصدر البيانات الذي يرتبط به جدول مصدر البيانات |
columnSelectionType
|
تمثّل هذه السمة النوع لاختيار الأعمدة لجدول مصدر البيانات. يكون الإعداد التلقائي في
|
columns[]
|
الأعمدة المُختارة لجدول مصدر البيانات ويجب أن تكون السمة |
filterSpecs[]
|
فلترة المواصفات في جدول مصدر البيانات |
sortSpecs[]
|
ترتيب المواصفات في جدول مصدر البيانات يتم ترتيب نتائج جدول مصدر البيانات استنادًا إلى مواصفات الترتيب بالترتيب. |
rowLimit
|
الحدّ الأقصى للصفوف التي سيتم عرضها. وفي حال تم ترك هذه السياسة بدون ضبط، سيتم تطبيق حد تلقائي. يُرجى الرجوع إلى محرِّر "جداول بيانات Google" لمعرفة الحد الأقصى والحد الأقصى التلقائي. |
dataExecutionStatus
|
الإخراج فقط. حالة تنفيذ البيانات. |
DataSourceTableColumnSelectionType
أنواع اختيار عمود جدول مصدر البيانات
عمليات التعداد | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
نوع اختيار العمود التلقائي هو "عدم الاستخدام". |
SELECTED
|
اختَر الأعمدة المحدّدة في حقل
columns .
|
SYNC_ALL
|
مزامنة جميع الأعمدة الحالية والمستقبلية في مصدر البيانات في حال ضبط هذه السمة، يجلب جدول مصدر البيانات جميع الأعمدة في مصدر البيانات في وقت إعادة التحميل. |
صيغة مصدر البيانات
صيغة مصدر بيانات
تمثيل JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
الحقول | |
---|---|
dataSourceId
|
رقم تعريف مصدر البيانات المرتبط بالصيغة. |
dataExecutionStatus
|
الإخراج فقط. حالة تنفيذ البيانات. |