Other

اللون

يمثل لونًا في مساحة ألوان RGBA. تم تصميم هذا التمثيل لتبسيط عملية التحويل من وإلى تمثيلات الألوان بلغات مختلفة على مدى الاكتفاء. على سبيل المثال، يمكن تقديم حقول هذا التمثيل بشكل بسيط إلى أداة إنشاء java.awt.Color في Java، ويمكن أيضًا تقديمها بطريقة تافهة باستخدام طريقة +colorWithRed:green:blue:alpha في UIColor على نظام التشغيل iOS، مع بذل مجهود قليل، يمكنك تنسيقها بسهولة على شكل سلسلة rgba() CSS في JavaScript.

لا تحتوي هذه الصفحة المرجعية على معلومات عن مساحة اللون المطلقة التي يجب استخدامها لتفسير قيمة النموذج اللوني أحمر أخضر أزرق، على سبيل المثال، sRGB وAdobe RGB وDCI-P3 وBT.2020. وبشكل تلقائي، يجب أن تفترض التطبيقات مساحة اللون sRGB.

عند الحاجة إلى تحديد مساواة الألوان، يجب التعامل مع لونَين متساويَين في عمليات التنفيذ، ما لم يرِد خلاف ذلك إذا كانت جميع قيم الأحمر والأخضر والأزرق وألفا تختلف على الأكثر 1e-5.

مثال (Java): 

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

مثال (iOS / Obj-C): 

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

مثال (JavaScript): 

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
تمثيل JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
الحقول
red

number

مقدار اللون الأحمر في اللون كقيمة في النطاق [0, 1]

green

number

مقدار اللون الأخضر في اللون كقيمة في النطاق [0, 1]

blue

number

مقدار اللون الأزرق في اللون كقيمة في النطاق [0, 1]

alpha

number

جزء هذا اللون الذي يجب تطبيقه على البكسل. وهذا يعني أنّ لون البكسل النهائي يتم تحديده من خلال المعادلة التالية:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

وهذا يعني أن القيمة 1.0 تتجاوب مع لون خالص، في حين تتجاوب القيمة 0.0 مع لون شفاف تمامًا. ويستخدم هذا الإجراء رسالة غلاف بدلاً من عدد صحيح عادي حتى يصبح من الممكن التمييز بين القيمة التلقائية والقيمة التي لم يتم ضبطها. وعند إسقاطه، يتم عرض كائن اللون هذا كلون ثابت (كما لو تم إعطاء قيمة ألفا بوضوح قيمة 1.0).

ColorStyle

قيمة لون.

تمثيل JSON 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
الحقول
حقل الربط kind. نوع قيمة اللون kind يمكن أن تكون إحدى القيم التالية فقط:
rgbColor

object (Color)

اللون الأحمر والأخضر والأزرق لا يُسمَح بشكل عام باستخدام القيمة alpha في عنصر Color.

themeColor

enum (ThemeColorType)

لون المظهر

ThemeColorType

أنواع ألوان المظهر

SpreadsheetProperties تحتوي على SpreadsheetTheme الذي يحدّد تعيينًا لأنواع ألوان المظهر هذه إلى ألوان محدّدة.

عمليات التعداد
THEME_COLOR_TYPE_UNSPECIFIED لون مظهر غير محدّد
TEXT يمثّل لون النص الأساسي
BACKGROUND يمثّل لون الخلفية الأساسي
ACCENT1 يمثّل لون التمييز الأول
ACCENT2 يمثّل لون التمييز الثاني
ACCENT3 يمثّل لون التمييز الثالث
ACCENT4 تشغيل لون التمييز الرابع
ACCENT5 يمثّل لون التمييز الخامس
ACCENT6 يمثّل لون التمييز السادس

HorizontalAlign

المحاذاة الأفقية للنص في خلية

عمليات التعداد
HORIZONTAL_ALIGN_UNSPECIFIED لم يتم تحديد المحاذاة الأفقية. لا تستخدِم هذا الإجراء.
LEFT تتم محاذاة النص صراحةً إلى يمين الخلية.
CENTER يتمّ محاذاة النص بوضوح في وسط الخلية.
RIGHT تتم محاذاة النص بشكل صريح على يسار الخلية.

TextFormat

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

تمثيل JSON 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
الحقول
foregroundColor
(deprecated)

object (Color)

لون المقدّمة للنص متوقّفة نهائيًا: استخدِم foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

لون المقدّمة للنص إذا تم أيضًا ضبط foregroundColor ، يكون لهذا الحقل الأولوية.

fontFamily

string

مجموعة الخطوط

fontSize

integer

حجم الخط.

bold

boolean

True إذا كان النص غامقًا.

italic

boolean

True إذا كان النص مائلاً.

strikethrough

boolean

صحيح إذا كان النص مشطوبًا.

underline

boolean

True إذا كان النص مسطرًا.

DataSourceColumn

عمود في مصدر بيانات

تمثيل JSON 
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
الحقول
reference

object (DataSourceColumnReference)

مرجع العمود.

formula

string

صيغة العمود المحسوب

DataSourceColumnReference

معرّف فريد يشير إلى عمود مصدر بيانات

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

الاسم المعروض للعمود. يجب أن يكون فريدًا في مصدر البيانات.

DataExecutionStatus

حالة تنفيذ البيانات.

يتمّ إنشاء عملية تنفيذ بيانات لمزامنة عنصر مصدر بيانات مع أحدث البيانات من DataSource. يتم عادةً جدولة تنفيذه في الخلفية، ويمكنك التحقّق من state لمعرفة ما إذا اكتملت عملية التنفيذ.

هناك عدة سيناريوهات يتم فيها بدء تنفيذ البيانات:

  • Adding a data source تؤدّي إلى إنشاء ورقة بيانات مرتبطة بمصدر البيانات بالإضافة إلى تنفيذ بيانات لمزامنة البيانات من مصدر البيانات إلى ورقة البيانات.
  • Updating a data source تؤدّي إلى إنشاء عملية تنفيذ بيانات لإعادة تحميل ورقة مصدر البيانات المرتبطة بالطريقة نفسها.
  • يمكنك إرسال refresh request لإعادة تحميل عنصر واحد أو عدّة عناصر لمصدر البيانات بشكل صريح.
تمثيل JSON 
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
الحقول
state

enum (DataExecutionState)

حالة تنفيذ البيانات.

errorCode

enum (DataExecutionErrorCode)

رمز الخطأ

errorMessage

string

رسالة الخطأ، والتي قد تكون فارغة.

lastRefreshTime

string (Timestamp format)

تحصل على وقت آخر تحديث ناجح للبيانات.

DataExecutionState

قائمة بحالات تنفيذ البيانات

عمليات التعداد
DATA_EXECUTION_STATE_UNSPECIFIED القيمة التلقائية، لا تستخدمها.
NOT_STARTED لم تبدأ عملية تنفيذ البيانات.
RUNNING بدأت عملية تنفيذ البيانات وهي قيد التنفيذ.
CANCELLING يتم حاليًا إلغاء تنفيذ البيانات.
SUCCEEDED اكتملت عملية تنفيذ البيانات بنجاح.
FAILED اكتملت عملية تنفيذ البيانات مع حدوث أخطاء.

DataExecutionErrorCode

قائمة برموز خطأ تنفيذ البيانات

عمليات التعداد
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED القيمة التلقائية، لا تستخدمها.
TIMED_OUT انتهت مهلة تنفيذ البيانات.
TOO_MANY_ROWS تؤدي عملية تنفيذ البيانات إلى إرجاع صفوف أكثر من الحد المسموح به.
TOO_MANY_COLUMNS تؤدي عملية تنفيذ البيانات إلى إرجاع عدد من الأعمدة أكبر من الحد المسموح به.
TOO_MANY_CELLS تؤدي عملية تنفيذ البيانات إلى إرجاع خلايا أكثر من الحد المسموح به.
ENGINE تم تلقّي الخطأ من محرّك تنفيذ البيانات في الخلفية (مثل BigQuery). يُرجى الاطّلاع على errorMessage للاطّلاع على التفاصيل.
PARAMETER_INVALID هناك مَعلمة واحدة أو بعض مَعلمات مصدر البيانات المقدَّمة غير صالحة.
UNSUPPORTED_DATA_TYPE يعرض تنفيذ البيانات نوع بيانات غير متوافق.
DUPLICATE_COLUMN_NAMES خلال تنفيذ البيانات، تم عرض أسماء أو أسماء بديلة مكررة لبعض الأعمدة.
INTERRUPTED تمّت مقاطعة تنفيذ البيانات. يُرجى إعادة تحميل الصفحة لاحقًا.
CONCURRENT_QUERY لا يمكن حاليًا تحديث البيانات لأنّ عملية تنفيذها لا تزال جارية.
OTHER أخطاء أخرى
TOO_MANY_CHARS_PER_CELL يؤدي تنفيذ البيانات إلى عرض قيم تتجاوز الحد الأقصى لعدد الأحرف المسموح به في خلية واحدة.
DATA_NOT_FOUND لم يتم العثور على قاعدة البيانات التي يشير إليها مصدر البيانات. */
PERMISSION_DENIED لا يملك المستخدم إذن الوصول إلى قاعدة البيانات التي يشير إليها مصدر البيانات.
MISSING_COLUMN_ALIAS خلال تنفيذ البيانات، يتم عرض أعمدة تفتقد لأسماء بديلة.
OBJECT_NOT_FOUND عنصر مصدر البيانات غير موجود.
OBJECT_IN_ERROR_STATE عنصر مصدر البيانات في حالة خطأ. لفرض إعادة التحميل، يجب ضبط force في RefreshDataSourceRequest.
OBJECT_SPEC_INVALID مواصفات عنصر مصدر البيانات غير صالحة.
DATA_EXECUTION_CANCELLED تم إلغاء تنفيذ البيانات.

ExtendedValue

أنواع القيمة التي يمكن أن تحتوي عليها خلية في جدول بيانات.

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value. نوع القيمة في خلية. إذا لم يتم ضبط أي حقل، لن تحتوي الخلية على أي بيانات. يمكن أن تكون القيمة value واحدًا فقط مما يلي:
numberValue

number

يمثّل قيمة مزدوجة. ملاحظة: يتم تمثيل التواريخ والأوقات والتاريخ والوقت بتنسيق مزدوج بالتنسيق SERIAL_NUMBER.

stringValue

string

يمثل قيمة سلسلة. ولا يتم تضمين علامات الاقتباس المفردة في بداية السلسلة. على سبيل المثال، إذا كتب المستخدم '123 في واجهة المستخدم، سيتم تمثيل ذلك على أنّه stringValue من "123".

boolValue

boolean

يمثّل قيمة منطقية.

formulaValue

string

يمثّل صيغة.

errorValue

object (ErrorValue)

يشير إلى خطأ. هذا الحقل للقراءة فقط.

ErrorValue

خطأ في خلية.

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

enum (ErrorType)

نوع الخطأ.

message

string

رسالة تتضمّن مزيدًا من المعلومات عن الخطأ (باللغة المحدّدة في جدول البيانات)

ErrorType

نوع الخطأ

عمليات التعداد
ERROR_TYPE_UNSPECIFIED نوع الخطأ التلقائي، لا تستخدِمه.
ERROR يتوافق مع الخطأ #ERROR!.
NULL_VALUE يتوافق مع خطأ #NULL!.
DIVIDE_BY_ZERO يتوافق مع الخطأ #DIV/0.
VALUE يتوافق مع خطأ #VALUE!.
REF يتوافق مع خطأ #REF!.
NAME يتوافق مع الخطأ #NAME?.
NUM يتوافق مع خطأ #NUM!.
N_A يتوافق مع خطأ #N/A.
LOADING تشير إلى حالة Loading....

BooleanCondition

شرط يمكن تقييمه إلى true أو false. يتم استخدام الشروط المنطقية عن طريق التنسيق الشرطي والتحقق من صحة البيانات والمعايير في عوامل التصفية.

تمثيل JSON 
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
الحقول
type

enum (ConditionType)

نوع الشرط

values[]

object (ConditionValue)

قيم الشرط يعتمد عدد القيم المسموح بها على condition type. يسمح بعضها بقيم صفرية، والبعض الآخر بقيمة واحدة أو قيمتَين، ويسمح ConditionType.ONE_OF_LIST بعدد عشوائي من القيم.

ConditionType

نوع الشرط

عمليات التعداد
CONDITION_TYPE_UNSPECIFIED القيمة التلقائية، لا تستخدِمها.
NUMBER_GREATER يجب أن تكون قيمة الخلية أكبر من قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلب سمة ConditionValue واحدة.
NUMBER_GREATER_THAN_EQ يجب أن تكون قيمة الخلية أكبر من أو تساوي قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب ConditionValue واحدة.
NUMBER_LESS يجب أن تكون قيمة الخلية أقل من قيمة الشرط. يعتمد هذا الإعداد على التحقّق من صحة البيانات والتنسيق الشرطي والفلاتر. تتطلّب ConditionValue واحدة.
NUMBER_LESS_THAN_EQ يجب أن تكون قيمة الخلية أقل من أو مساوية لقيمة الشرط. يعتمد هذا الإعداد على التحقّق من صحة البيانات والتنسيق الشرطي والفلاتر. تتطلب سمة ConditionValue واحدة.
NUMBER_EQ يجب أن تكون قيمة الخلية مساوية لقيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب قاعدة واحدة ConditionValue للتحقق من صحة البيانات والتنسيق المشروط والفلاتر على عناصر غير مصدر البيانات، ويجب أن تتضمّن قاعدة واحدة على الأقل ConditionValue للفلاتر على عناصر مصدر البيانات.
NUMBER_NOT_EQ يجب ألا تكون قيمة الخلية مساوية لقيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب قاعدة واحدة ConditionValue للتحقق من صحة البيانات والتنسيق المشروط والفلاتر على عناصر غير مصدر البيانات، ويجب أن تتضمّن قاعدة واحدة على الأقل ConditionValue للفلاتر على عناصر مصدر البيانات.
NUMBER_BETWEEN يجب أن تكون قيمة الخلية بين قيمتَي الشرط. يعتمد هذا الإعداد على التحقّق من صحة البيانات والتنسيق الشرطي والفلاتر. يتطلب تحديد قيمتَين بالضبط ConditionValues.
NUMBER_NOT_BETWEEN يجب ألا تكون قيمة الخلية بين قيمتَي الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلب سمة ConditionValues على وجه التحديد.
TEXT_CONTAINS يجب أن تحتوي قيمة الخلية على قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلب سمة ConditionValue واحدة.
TEXT_NOT_CONTAINS يجب ألّا تحتوي قيمة الخلية على قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب ConditionValue واحدة.
TEXT_STARTS_WITH يجب أن تبدأ قيمة الخلية بقيمة الشرط. تتيح هذه الميزة استخدام التنسيق الشرطي والفلاتر. تتطلّب ConditionValue واحدة.
TEXT_ENDS_WITH يجب أن تنتهي قيمة الخلية بقيمة الشرط. تتيح هذه الميزة استخدام التنسيق الشرطي والفلاتر. تتطلب سمة ConditionValue واحدة.
TEXT_EQ يجب أن تكون قيمة الخلية هي قيمة الشرط بالضبط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب قاعدة واحدة ConditionValue للتحقق من صحة البيانات والتنسيق المشروط والفلاتر على عناصر غير مصدر البيانات، ويجب أن تتضمّن قاعدة واحدة على الأقل ConditionValue للفلاتر على عناصر مصدر البيانات.
TEXT_IS_EMAIL يجب أن تكون قيمة الخلية عنوان بريد إلكتروني صالحًا. مدعومة بالتحقق من صحة البيانات. لا يتطلب ConditionValues.
TEXT_IS_URL يجب أن تكون قيمة الخلية عنوان URL صالحًا. مدعومة بالتحقق من صحة البيانات. لا يتطلب ConditionValues.
DATE_EQ يجب أن تكون قيمة الخلية هي التاريخ نفسه لقيمة الشرط. يعتمد هذا الإعداد على التحقّق من صحة البيانات والتنسيق الشرطي والفلاتر. تتطلّب قاعدة واحدة ConditionValue للتحقق من صحة البيانات والتنسيق المشروط والفلاتر على عناصر غير مصدر البيانات، ويجب أن تتضمّن قاعدة واحدة على الأقل ConditionValue للفلاتر على عناصر مصدر البيانات.
DATE_BEFORE يجب أن تكون قيمة الخلية قبل تاريخ قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب ConditionValue واحدة قد تكون relative date.
DATE_AFTER يجب أن تكون قيمة الخلية بعد تاريخ قيمة الشرط. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. تتطلّب ConditionValue واحدة قد تكون relative date.
DATE_ON_OR_BEFORE يجب أن تكون قيمة الخلية في تاريخ قيمة الشرط أو قبله. مدعومة بالتحقق من صحة البيانات. تتطلب سمة ConditionValue واحدة قد تكون relative date.
DATE_ON_OR_AFTER يجب أن تكون قيمة الخلية في تاريخ قيمة الشرط أو بعده. مدعومة بإثبات صحة البيانات. تتطلب سمة ConditionValue واحدة قد تكون relative date.
DATE_BETWEEN يجب أن تكون قيمة الخلية بين تاريخَي قيم الشرطَين. مدعومة بالتحقق من صحة البيانات. يتطلب اثنين بالضبط ConditionValues.
DATE_NOT_BETWEEN يجب أن تكون قيمة الخلية خارج تواريخ قيمتَي الشرط. مدعومة بالتحقق من صحة البيانات. يتطلب تحديد قيمتَين بالضبط ConditionValues.
DATE_IS_VALID يجب أن تكون قيمة الخلية تاريخًا. مدعومة بالتحقق من صحة البيانات. لا يتطلب ConditionValues.
ONE_OF_RANGE يجب إدراج قيمة الخلية في الشبكة ضمن نطاق قيمة الحالة. مدعومة بإثبات صحة البيانات. تتطلّب علامة واحدة ConditionValue، ويجب أن تكون القيمة نطاقًا صالحًا بترميز A1.
ONE_OF_LIST يجب أن تكون قيمة الخلية مضمّنة في قائمة قيم الحالة. مدعومة بالتحقق من صحة البيانات. يتيح إدخال أي عدد من condition values، واحد لكل عنصر في القائمة. الصِيَغ غير متاحة في القيم.
BLANK يجب أن تكون قيمة الخلية فارغة. تتيح هذه الميزة استخدام التنسيق الشرطي والفلاتر. لا يتطلب ConditionValues.
NOT_BLANK يجب ألا تكون قيمة الخلية فارغة. هذا الخيار مدعوم من خلال التنسيق الشرطي والفلاتر. لا يتطلب ConditionValues.
CUSTOM_FORMULA يجب أن يتم تقييم صيغة الشرط على أنّها صحيحة. تتوفّر ميزة التحقّق من صحة البيانات والتنسيق الشرطي وفلاتر البيانات. لا تتيح فلاتر ورقة بيانات مصدر البيانات ذلك. تتطلّب ConditionValue واحدة.
BOOLEAN يجب أن تكون قيمة الخلية صحيحة/خطأ أو في قائمة قيم الشرط. مدعومة بالتحقق من صحة البيانات. يتم عرضها كمربّع اختيار في خلية. يقبل القيمة صفر أو واحد أو سمتَين ConditionValues. لا تشير أي قيم إلى أن الخلية يجب أن تكون TRUE أو FALSE، حيث يتم عرض TRUE كمحددة ويتم عرض FALSE على أنها غير محددة. تشير قيمة واحدة إلى أنّه سيتم عرض القيمة على أنّها محدّدة عندما تحتوي على تلك القيمة وغير محدّدة عندما تكون فارغة. تشير القيمتان إلى أنّه سيتم عرض الخلية على أنّها محدّدة عندما تحتوي على القيمة الأولى وغير محدّدة عندما تحتوي على القيمة الثانية. على سبيل المثال، يشير ["نعم","لا"] إلى أنّ الخلية ستعرض مربّع اختيار تم وضع علامة فيه عندما تكون القيمة "نعم" ومربّع اختيار لم يتم وضع علامة فيه عندما تكون القيمة "لا".
TEXT_NOT_EQ يجب أن تكون قيمة الخلية مختلفة تمامًا عن قيمة الشرط. متاح من خلال الفلاتر على عناصر مصدر البيانات. يلزم توفير ConditionValue واحدة على الأقل.
DATE_NOT_EQ يجب ألا تكون قيمة الخلية هي قيمة الشرط بالضبط. تتوفّر في الفلاتر على عناصر مصادر البيانات. يلزم توفير ConditionValue واحدة على الأقل.
FILTER_EXPRESSION يجب أن تتّبع قيمة الخلية النمط المحدّد. تتطلّب ConditionValue واحدة.

ConditionValue

قيمة الشرط.

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value. يجب ضبط قيمة الحالة، واحدة بالضبط. يمكن أن تكون القيمة value واحدًا فقط مما يلي:
relativeDate

enum (RelativeDate)

تاريخ نسبي (استنادًا إلى التاريخ الحالي) لا تكون صالحة إلا إذا كان type هو DATE_BEFORE أو DATE_AFTER أو DATE_ON_OR_BEFORE أو DATE_ON_OR_AFTER.

لا تتوفّر التواريخ النسبية في ميزة "التحقّق من صحة البيانات". ولا يمكن استخدامها إلا في التنسيق الشرطي والفلاتر الشَرطية.

userEnteredValue

string

قيمة يعتمد عليها الشرط. ويتم تحليل القيمة كما لو كان المستخدم قد كتبها في خلية. يمكن استخدام الصيغ (ويجب أن تبدأ برمز = أو علامة "+").

RelativeDate

تتحكّم هذه السياسة في كيفية تقييم شرط التاريخ.

عمليات التعداد
RELATIVE_DATE_UNSPECIFIED القيمة التلقائية، لا تستخدمها.
PAST_YEAR القيمة هي قبل عام واحد من اليوم.
PAST_MONTH القيمة قبل شهر واحد من اليوم.
PAST_WEEK القيمة قبل أسبوع واحد من اليوم.
YESTERDAY القيمة هي أمس.
TODAY القيمة هي اليوم.
TOMORROW القيمة هي غدًا.

GridRange

نطاق في ورقة بيانات تبدأ جميع الفهارس من الصفر. الفهارس مفتوحة جزئيًا، أي أنّ فهرس البدء شامل وفهرس النهاية حصري: [startIndex, endIndex). تشير الفهارس المفقودة إلى أن النطاق غير محدود على هذا الجانب.

على سبيل المثال، إذا كان "Sheet1" هو معرّف ورقة البيانات 123456، عندئذٍ:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

يجب أن يكون فهرس البداية دائمًا أقل من أو يساوي فهرس النهاية. إذا كان فهرس البداية يساوي فهرس النهاية، يكون النطاق فارغًا. عادةً ما تكون النطاقات الفارغة غير ذات معنى ويتم عرضها عادةً في واجهة المستخدم على النحو #REF!.

تمثيل JSON 
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
الحقول
sheetId

integer

ورقة البيانات التي يقع فيها هذا النطاق

startRowIndex

integer

صف بداية النطاق (شاملاً) أو غير محدّد إذا كان النطاق غير محدود

endRowIndex

integer

الصف الأخير (الحصري) للنطاق، أو لا يتم ضبطه إذا كان غير محدود.

startColumnIndex

integer

عمود البداية (شامل) للنطاق، أو لم يتم ضبطه إذا كان غير محدد.

endColumnIndex

integer

عمود النهاية (الحصري) للنطاق، أو لا يتم ضبطه إذا كان غير محدود.

SortOrder

نظام ترتيب

عمليات التعداد
SORT_ORDER_UNSPECIFIED القيمة التلقائية، يُرجى عدم استخدام هذه القيمة.
ASCENDING ترتيب تصاعدي
DESCENDING ترتيب تنازلي

FilterSpec

معايير الفلتر المرتبطة بعمود معيّن

تمثيل JSON 
{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
الحقول
filterCriteria

object (FilterCriteria)

معايير العمود.

حقل الاتحاد reference. إشارة إلى العمود الذي تمّت فلترته reference يمكن أن تكون إحدى القيم التالية فقط:
columnIndex

integer

فهرس العمود الذي يبدأ من الصفر

dataSourceColumnReference

object (DataSourceColumnReference)

إشارة إلى عمود مصدر بيانات

FilterCriteria

معايير عرض/إخفاء الصفوف في فلتر أو عرض فلتر

تمثيل JSON 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
الحقول
hiddenValues[]

string

القيم التي يجب إخفاؤها

condition

object (BooleanCondition)

شرط يجب أن يكون صحيحًا لعرض القيم. (لا تلغي هذه القيمة الإعداد hiddenValues ، فإذا تم إدراج قيمة هناك، ستظل مخفية).

visibleBackgroundColor
(deprecated)

object (Color)

لون تعبئة الخلفية للفلترة حسبه، ولا يتم عرض سوى الخلايا التي تحتوي على لون التعبئة هذا. متعارض مع visibleForegroundColor. متوقّفة نهائيًا: استخدِم visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

لون تعبئة الخلفية للفلترة حسبه، ولا يتم عرض سوى الخلايا التي تحتوي على لون التعبئة هذا. هذا الحقل حصري مع visibleForegroundColor، ويجب ضبطه على لون من نوع RGB. إذا تم ضبط visibleBackgroundColor أيضًا، ستكون الأولوية لهذا الحقل.

visibleForegroundColor
(deprecated)

object (Color)

لون المقدّمة للفلترة حسبه، ولا يتم عرض سوى الخلايا التي تتضمّن هذا اللون. متعارض مع visibleBackgroundColor. متوقّفة نهائيًا: استخدِم visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

لون المقدّمة للفلترة حسبه، ولا يتم عرض سوى الخلايا التي تتضمّن هذا اللون. هذا الحقل حصري مع visibleBackgroundColor، ويجب ضبطه على لون من نوع RGB. إذا تم أيضًا ضبط visibleForegroundColor ، يكون لهذا الحقل الأولوية.

SortSpec

يشير ذلك المصطلح إلى نظام ترتيب مرتبط بعمود أو صف محدّد.

تمثيل JSON 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
الحقول
sortOrder

enum (SortOrder)

يجب ترتيب بيانات الطلبات.

foregroundColor
(deprecated)

object (Color)

لون المقدّمة الذي يتم الترتيب حسبه، ويتم ترتيب الخلايا التي تحتوي على هذا اللون في أعلى الصفحة. متعارض مع backgroundColor. متوقّفة نهائيًا: استخدِم foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

لون المقدّمة الذي يتم الترتيب حسبه، ويتم ترتيب الخلايا التي تحتوي على هذا اللون في أعلى الصفحة. يجب أن يكون لونًا من نوع RGB، ويجب ألا يكون لونًا مماثلاً لصفيف backgroundColor. إذا تم أيضًا ضبط foregroundColor ، يكون لهذا الحقل الأولوية.

backgroundColor
(deprecated)

object (Color)

لون تعبئة الخلفية الذي يتم الترتيب حسبه، ويتم ترتيب الخلايا التي تحتوي على لون التعبئة هذا في أعلى الصفحة. متعارض مع foregroundColor. متوقّفة نهائيًا: استخدِم backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

لون تعبئة الخلفية الذي يتم الترتيب حسبه، ويتم ترتيب الخلايا التي تحتوي على لون التعبئة هذا في أعلى الصفحة. يجب أن يكون لونًا من نوع RGB، ويجب ألا يكون لونًا مماثلاً لصفيف foregroundColor. إذا تم أيضًا ضبط backgroundColor ، يكون لهذا الحقل الأولوية.

حقل الربط reference. مرجع إلى السمة التي تم ترتيب البيانات فيها. يمكن أن تكون القيمة reference واحدًا فقط مما يلي:
dimensionIndex

integer

السمة التي يجب تطبيق الترتيب عليها.

dataSourceColumnReference

object (DataSourceColumnReference)

إشارة إلى عمود مصدر بيانات

EmbeddedObjectPosition

موضع عنصر مضمّن، مثل رسم بياني

تمثيل JSON 
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
الحقول
حقل الاتحاد location. الموقع الجغرافي للعنصر يجب ضبط قيمة واحدة بالضبط. location يمكن أن تكون إحدى القيم التالية فقط:
sheetId

integer

ورقة البيانات التي يتوفّر فيها هذا الخيار لا يتم ضبط هذا الخيار إلا إذا كان العنصر المضمّن في ورقة بيانات خاصة به. يجب أن تكون غير سالبة.

overlayPosition

object (OverlayPosition)

موضع التراكب للعنصر على شبكة

newSheet

boolean

إذا كانت القيمة صحيحة، يتم وضع العنصر المضمّن في ورقة بيانات جديدة يتم اختيار رقم تعريفها نيابةً عنك. يُستخدَم عند الكتابة فقط.

OverlayPosition

الموقع الجغرافي الذي يتمّ فيه وضع عنصر فوق شبكة

تمثيل JSON 
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
الحقول
anchorCell

object (GridCoordinate)

الخلية التي يتم تثبيت العنصر بها

offsetXPixels

integer

الإزاحة الأفقية بالبكسل التي يتم بها إزاحة العنصر عن خلية الربط

offsetYPixels

integer

الإزاحة العمودية، بالبكسل، التي يتمّ فيها إزاحة الجسم عن خلية الربط

widthPixels

integer

تمثّل هذه السمة عرض العنصر بالبكسل. القيمة التلقائية هي 600.

heightPixels

integer

ارتفاع الجسم، بالبكسل القيمة التلقائية هي 371.

GridCoordinate

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

تمثيل JSON 
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
الحقول
sheetId

integer

ورقة البيانات التي يتوفّر فيها هذا الإحداثي

rowIndex

integer

فهرس الصف للمخطّط

columnIndex

integer

فهرس عمود الإحداثي