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)

لون المظهر

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

تُمثل قيمة مزدوجة. ملاحظة: يتم تمثيل التواريخ، والأوقات، و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

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

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

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

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)

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

backgroundColor
(deprecated)

object (Color)

لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا ذات لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع foregroundColor مهملة: استخدام backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا ذات لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع foregroundColor، ويجب أن يكون اللون من النوع RGB. في حال حذف 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

إذا كانت القيمة 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

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