Other

اللون

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

لا تحتوي هذه الصفحة المرجعية على معلومات حول مساحة اللون المطلقة التي يجب استخدامها لتفسير قيمة RGB، مثل 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).

نمط الألوان

قيمة لون.

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

لون المظهر

نوع اللون

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

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

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

محاذاة أفقية

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

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

تنسيق نصي

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

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

صحيح إذا كان النص غامقًا

italic

boolean

صحيح إذا كان النص مائلاً.

strikethrough

boolean

صحيح إذا كان النص يتوسطه خط.

underline

boolean

صحيح إذا كان النص تحته خط.

عمود DataSource

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

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

object (DataSourceColumnReference)

مرجع العمود.

formula

string

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

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

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

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

string

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

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

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

يتم إنشاء تنفيذ البيانات لمزامنة عنصر مصدر البيانات مع أحدث البيانات من 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)

الحصول على الوقت الذي تم فيه تحديث البيانات بنجاح

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

تعداد لحالات تنفيذ البيانات

عمليات التعداد
DATA_EXECUTION_STATE_UNSPECIFIED القيمة التلقائية هي "عدم الاستخدام".
NOT_STARTED لم تبدأ عملية تنفيذ البيانات.
RUNNING بدأ تنفيذ البيانات قيد التشغيل.
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 مواصفات عنصر مصدر البيانات غير صالحة.

قيمة موسّعة

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

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

يمثل خطأً. هذا الحقل للقراءة فقط.

قيمة الخطأ

حدث خطأ في خلية.

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

enum (ErrorType)

نوع الخطأ

message

string

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

نوع الخطأ

نوع الخطأ

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

شرط منطقي

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

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

enum (ConditionType)

تمثّل هذه السمة نوع الشرط.

values[]

object (ConditionValue)

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

نوع الشرط

تمثّل هذه السمة نوع الشرط.

عمليات التعداد
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 يجب أن تكون قيمة الخلية TRUE/FALSE أو في قائمة قيم الشرط. متوافق مع عملية التحقق من البيانات. يظهر كمربّع اختيار خلية. ويمكن استخدام صفر أو واحد أو اثنتين من ConditionValues. لا تتوفّر أي قيم تشير إلى أنّ الخلية يجب أن تكون TRUE أو FALSE، حيث يتم عرض "صحيح" على أنّه "تم التحقّق" وعرض "خطأ" على أنّه غير محدد. تشير قيمة واحدة إلى أنّه سيتم عرض الخلية على أنّها محدّدة عندما تحتوي على تلك القيمة وتمّ إزالة العلامة منها عندما تكون فارغة. تشير قيمتان إلى أنّ الخلية سيتم عرضها على أنها محدّدة عندما تحتوي على القيمة الأولى وتتم إزالة العلامة من المربّع عندما تحتوي على القيمة الثانية. على سبيل المثال، تشير القيمة ["Yes", No"] إلى أنّ الخلية ستُظهر مربّع اختيار عندما تحتوي على القيمة "نعم" ومربّع لم يتم وضع علامة فيه عندما تحتوي على القيمة "لا".
TEXT_NOT_EQ يجب ألا تكون قيمة الخلية هي قيمة الشرط بالضبط. متوافقة مع الفلاتر في عناصر مصدر البيانات ويلزم توفير سمة ConditionValue واحدة على الأقل.
DATE_NOT_EQ يجب ألا تكون قيمة الخلية هي قيمة الشرط بالضبط. متوافقة مع الفلاتر في عناصر مصدر البيانات ويلزم توفير سمة ConditionValue واحدة على الأقل.
FILTER_EXPRESSION يجب أن تتبع قيمة الخلية النمط المحدد. ويجب استخدام سمة 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

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

التاريخ النسبي

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

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

نطاق الشبكة

نطاق في ورقة البيانات. جميع الفهارس صفر. المؤشرات نصف مفتوحة، أي أن فهرس البداية شامل، ويكون الفهرس النهائي حصريًا -- [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 ترتيب تنازلي.

مواصفات الفلتر

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

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

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

معايير الفلاتر

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

تمثيل 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 أيضًا، تكون الأولوية لهذا الحقل.

المواصفات

نظام ترتيب مرتبط بعمود أو صف محدّد

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

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

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

integer

السمة التي يجب تطبيق التصنيف عليها.

dataSourceColumnReference

object (DataSourceColumnReference)

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

موضع عنصر مضمّن

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

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

وفي حال ضبطها على "صحيح"، يتم وضع العنصر المضمّن في ورقة جديدة يتم اختيار معرِّفها لك. يُستخدم فقط عند الكتابة.

موضع على سطح الصفحة

يظهر الموقع فوق العنصر على سطح الشبكة.

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

تنسيق الشبكة

تنسيق في ورقة بيانات. جميع الفهارس صفر.

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

integer

ورقة البيانات التي تم تطبيق هذا التنسيق عليها.

rowIndex

integer

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

columnIndex

integer

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