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)

لون 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

صحيح إذا كان النص غليظًا.

italic

boolean

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

strikethrough

boolean

تعرض القيمة "صحيح" إذا كان النص يتضمّن خطًا يتوسطه.

underline

boolean

تعرض القيمة "صحيح" إذا كان النص مسطّرًا.

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

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

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

هي شرط يجب أن يكون true لكي يتم عرض القيم. (لا يؤدي ذلك إلى إلغاء 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

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

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

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