Other

اللون

يمثّل لونًا في مساحة ألوان RGBA. تم تصميم هذا التمثيل لتسهيل التحويل من تمثيلات الألوان وإليها بلغات مختلفة بدلاً من جعله أكثر كثافة. على سبيل المثال، يمكن تقديم حقول هذا التمثيل بسهولة إلى طريقة الإنشاء الخاصة بملف java.awt.Color في Java، ويمكن أيضًا تقديمها بسهولة إلى أسلوب +colorWithRed:green:blue:alpha في 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 صراحةً).

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

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

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

ConditionValue

قيمة الشرط.

تمثيل JSON 
{

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

enum (RelativeDate)

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

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

userEnteredValue

string

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

RelativeDate

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

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

GridRange

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

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

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

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

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

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

Sheet1 == sheetId: 123456

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

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

integer

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

startRowIndex

integer

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

endRowIndex

integer

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

startColumnIndex

integer

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

endColumnIndex

integer

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

SortOrder

نظام ترتيب

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

FilterSpec

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

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

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

object (FilterCriteria)

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

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

integer

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

FilterCriteria

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

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

string

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

condition

object (BooleanCondition)

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

visibleBackgroundColor
(deprecated)

object (Color)

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

visibleBackgroundColorStyle

object (ColorStyle)

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

visibleForegroundColor
(deprecated)

object (Color)

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

visibleForegroundColorStyle

object (ColorStyle)

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

SortSpec

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

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

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

enum (SortOrder)

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

foregroundColor
(deprecated)

object (Color)

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

foregroundColorStyle

object (ColorStyle)

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

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

integer

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

EmbeddedObjectPosition

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

تمثيل JSON 
{

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

integer

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

overlayPosition

object (OverlayPosition)

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

newSheet

boolean

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

OverlayPosition

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

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

object (GridCoordinate)

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

offsetXPixels

integer

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

offsetYPixels

integer

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

widthPixels

integer

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

heightPixels

integer

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

GridCoordinate

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

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

integer

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

rowIndex

integer

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

columnIndex

integer

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