تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Other

اللون

يمثل لونًا في مساحة ألوان RGBA. تم تصميم هذا التمثيل لتبسيط عملية التحويل من وإلى تمثيلات الألوان بلغات مختلفة على مدى الاكتفاء. على سبيل المثال، يمكن تقديم حقول هذا التمثيل بشكل بسيط إلى الدالة الإنشائية java.awt.Color في Java؛ يمكن أيضًا تقديمه بشكل تافه إلى ألوان UIColor +colorWithRed:green:blue:alpha في iOS؛ ومن خلال القليل من العمل، يمكن تنسيقها بسهولة في CSS rgba() سلسلة في 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)` ألوان النموذج اللوني أحمر أخضر أزرق (RGB). تشير رسالة الأشكال البيانية `alpha` في `Color` غير متوافق بشكل عام.
`themeColor`	`enum (ThemeColorType)` لون المظهر

حقل الاتحاد kind نوع قيمة اللون. kind واحد فقط مما يلي:

rgbColor

object (Color)

ألوان النموذج اللوني أحمر أخضر أزرق (RGB). تشير رسالة الأشكال البيانية alpha في Color غير متوافق بشكل عام.

themeColor

enum (ThemeColorType)

لون المظهر

ThemeColorType

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

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

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

HorizontalAlign

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

عمليات التعداد
`HORIZONTAL_ALIGN_UNSPECIFIED`	لم يتم تحديد المحاذاة الأفقية. لا تستخدم هذه المعلومات.
`LEFT`	تتم محاذاة النص بوضوح إلى يسار الخلية.
`CENTER`	تتم محاذاة النص بوضوح إلى مركز الخلية.
`RIGHT`	تتم محاذاة النص بوضوح إلى يمين الخلية.

TextFormat

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

تمثيل JSON

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

{
  "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 إذا كان النص مسطرًا.
`link`	`object (Link)` تمثّل هذه السمة وجهة الرابط للنص، في حال توفّرها. يمكن أن يؤدي تعيين حقل الرابط في `TextFormatRun` سيؤدي إلى محو الروابط الحالية للخلية أو أي رابط على مستوى الخلية تم تعيينه في الطلب نفسه. وعند ضبط رابط، سيتم ضبط لون واجهة النص على لون الرابط التلقائي وسيتم وضع خط تحت النص. إذا تم تعديل هذه الحقول في الطلب نفسه، سيتم استخدام هذه القيم بدلاً من الإعدادات التلقائية للروابط.

رابط

مرجع خارجي أو محلي

تمثيل JSON
{ // Union field `destination` can be only one of the following: "uri": string // End of list of possible types for union field `destination`. }

الحقول

الحقول
حقل الاتحاد `destination` وجهة الرابط. `destination` واحد فقط مما يلي:
`uri`	`string` معرِّف الرابط.

حقل الاتحاد destination وجهة الرابط. destination واحد فقط مما يلي:

uri

string

معرِّف الرابط.

DataSourceColumn

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

تمثيل JSON
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

الحقول

الحقول
`reference`	`object (DataSourceColumnReference)` مرجع العمود.
`formula`	`string` صيغة العمود المحسوب.

reference

object (DataSourceColumnReference)

مرجع العمود.

formula

string

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

DataSourceColumnReference

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

تمثيل JSON
{ "name": string }

الحقول

الحقول
`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

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

{

  // 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` تُمثل قيمة مزدوجة. ملاحظة: يتم تمثيل التواريخ، والأوقات، وDateTimes، في صورة مضاعفات في `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` رسالة تحتوي على مزيد من المعلومات حول الخطأ (بلغة جدول البيانات).

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` وتدعم عددًا عشوائيًا من القيم.

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`، 1 لكل عنصر في القائمة. الصيغ غير متاحة في القيم.
`BLANK`	يجب أن تكون قيمة الخلية فارغة. هذا الخيار مدعوم من خلال التنسيق الشرطي والفلاتر. يتطلب لا `ConditionValues`
`NOT_BLANK`	يجب ألا تكون قيمة الخلية فارغة. هذا الخيار مدعوم من خلال التنسيق الشرطي والفلاتر. يتطلب لا `ConditionValues`
`CUSTOM_FORMULA`	يجب تقييم صيغة الشرط على true. يعتمد هذا الإعداد على التحقّق من صحة البيانات والتنسيق الشرطي والفلاتر. هذه السمة غير متاحة في فلاتر أوراق مصدر البيانات. تتطلب `ConditionValue`
`BOOLEAN`	يجب أن تكون قيمة الخلية TRUE/FALSE أو في قائمة قيم الشرط. مدعومة بإثبات صحة البيانات. يتم عرضه كمربّع اختيار خلية. يدعم صفر أو واحد أو اثنين `ConditionValues` لا تشير أي قيم إلى أن الخلية يجب أن تكون TRUE أو FALSE، حيث يتم عرض TRUE كمحددة ويتم عرض FALSE على أنها غير محددة. تشير قيمة واحدة إلى أنه سيتم عرض الخلية على أنها محددة عندما تحتوي على هذه القيمة ويتم إلغاء تحديدها عندما تكون فارغة. تشير قيمتان إلى أنّه سيتم عرض الخلية على النحو المحدَّد عندما تحتوي على القيمة الأولى، وتتم إزالة العلامة منها عندما تحتوي على القيمة الثانية. على سبيل المثال، تشير ["Yes","No"] إلى أن الخلية ستعرض مربعًا محددًا عندما تكون القيمة "Yes" (نعم). ومربّعًا بدون علامة عندما تحتوي على القيمة "لا".
`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` CANNOT TRANSLATE `DATE_BEFORE`, `DATE_AFTER`, `DATE_ON_OR_BEFORE` أو `DATE_ON_OR_AFTER` لا تتوفر التواريخ النسبية في عملية التحقق من صحة البيانات. وهي متاحة فقط في التنسيق الشرطي والفلاتر الشرطية.
`userEnteredValue`	`string` قيمة يعتمد عليها الشرط. ويتم تحليل القيمة كما لو كتب المستخدم في خلية. إنّ الصيغ متاحة (ويجب أن تبدأ بـ `=` أو "+").

حقل الاتحاد value قيمة الشرط، وهي سمة واحدة بالضبط يجب ضبطها. value واحد فقط مما يلي:

relativeDate

enum (RelativeDate)

تاريخ نسبي (استنادًا إلى التاريخ الحالي). صالح فقط إذا كانت type CANNOT TRANSLATE 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

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

  // 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

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

{
  "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

تمثيل 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": {
    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)` لون المقدّمة المطلوب الترتيب حسبه يتم فرز الخلايا التي لها لون المقدمة إلى الأعلى. الأحداث المتنافية مع `backgroundColor`، ويجب أن يكون اللون من النوع RGB. في حال حذف `foregroundColor` يتم أيضًا، تكون الأولوية لهذا الحقل.
`backgroundColor (deprecated)`	`object (Color)` تم إيقاف هذا العنصر نهائيًا. لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا ذات لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع `foregroundColor` مهملة: استخدام `backgroundColorStyle`
`backgroundColorStyle`	`object (ColorStyle)` لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا ذات لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع `foregroundColor`، ويجب أن يكون اللون من النوع RGB. في حال حذف `backgroundColor` يتم أيضًا، تكون الأولوية لهذا الحقل.
حقل الاتحاد `reference` مرجع إلى السمة التي تم ترتيب البيانات فيها. `reference` واحد فقط مما يلي:
`dimensionIndex`	`integer` السمة التي يجب تطبيق الترتيب عليها.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` الإشارة إلى عمود مصدر بيانات

EmbeddedObjectPosition

تمثّل هذه السمة موضع عنصر مضمّن، مثل الرسم البياني.

تمثيل JSON

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

{

  // 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` إذا كانت القيمة true، يتمّ وضع الكائن المضمّن في ورقة جديدة يتم اختيار رقم التعريف الخاص بها لك. يُستخدم فقط عند الكتابة.

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` فهرس عمود الإحداثي.

sheetId

integer

الورقة التي يوجد بها هذا الإحداثي.

rowIndex

integer

فهرس الصف للإحداثي.

columnIndex

integer

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