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

Other

اللون

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

لا تحتوي هذه الصفحة المرجعية على معلومات عن مساحة اللون المطلقة التي يجب استخدامها لتفسير قيمة نموذج أحمر أخضر أزرق، على سبيل المثال، sRGB وAdobe RGB وDCI-P3 وBT.2020. بشكل افتراضي، يجب أن تفترض التطبيقات مساحة اللون sRGB.

عند الحاجة إلى تحديد مساواة الألوان، يجب تطبيق لونَين على مبدأ التساوي، ما لم يرِد خلاف ذلك، إذا كانت قيم كل من اللونَين الأحمر والأخضر والأزرق والألفا مختلفة على الأكثر بنسبة 1e-5.

مثال (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

مثال (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

مثال (JavaScript):

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...

تمثيل JSON
{ "red": number, "green": number, "blue": number, "alpha": number }

الحقول
`red`	`number` مقدار اللون الأحمر في اللون كقيمة في الفاصل الزمني [0، 1].
`green`	`number` مقدار اللون الأخضر في اللون كقيمة في الفاصل الزمني [0، 1].
`blue`	`number` مقدار اللون الأزرق في اللون كقيمة في الفاصل الزمني [0، 1].
`alpha`	`number` جزء هذا اللون الذي يجب تطبيقه على البكسل. بمعنى، يتم تحديد لون البكسل النهائي من خلال المعادلة: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` هذا يعني أن القيمة 1.0 تتجاوب مع اللون الخالص، في حين أن القيمة 0.0 تتجاوب مع لون شفاف تمامًا. ويستخدم هذا الأمر رسالة برنامج تضمين بدلاً من قيمة عددية عائمة بسيطة، بحيث يمكن التمييز بين القيمة الافتراضية والقيمة التي يتم تركها بدون ضبط. في حال حذفه، يتم عرض كائن اللون هذا كلون ثابت (كما لو تم تحديد قيمة ألفا بشكل صريح للقيمة 1.0).

ColorStyle

قيمة اللون.

تمثيل JSON
{ // Union field `kind` can be only one of the following: "rgbColor": { object (`Color`) }, "themeColor": enum (`ThemeColorType`) // End of list of possible types for union field `kind`. }

الحقول

الحقول
حقل الاتحاد `kind`. نوع قيمة اللون. يمكن أن تكون السمة `kind` واحدًا فقط مما يلي:
`rgbColor`	`object (Color)` اللون RGB لا يمكن استخدام القيمة `alpha` في العنصر `Color` بشكل عام.
`themeColor`	`enum (ThemeColorType)` لون المظهر

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

rgbColor

object (Color)

اللون RGB لا يمكن استخدام القيمة alpha في العنصر Color بشكل عام.

themeColor

enum (ThemeColorType)

لون المظهر

ThemeColorType

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

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

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

HorizontalAlign

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

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

TextFormat

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

تمثيل JSON

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

{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}

الحقول
`foregroundColor (deprecated)`	`object (Color)` تم إيقاف هذا العنصر نهائيًا. لون المقدّمة للنص. مهملة: تستخدم `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` لون المقدّمة للنص. في حال ضبط السمة `foregroundColor` أيضًا، تكون الأولوية لهذا الحقل.
`fontFamily`	`string` مجموعة الخطوط.
`fontSize`	`integer` حجم الخط.
`bold`	`boolean` True إذا كان النص غامقًا.
`italic`	`boolean` صحيح إذا كان النص مائلاً.
`strikethrough`	`boolean` صحيح إذا كان النص يتوسطه خط.
`underline`	`boolean` True إذا كان النص تحته خط.
`link`	`object (Link)` تمثّل هذه السمة وجهة الرابط في النص، إن توفّرت. وعند ضبط حقل الرابط في `TextFormatRun`، سيتم محو الروابط الحالية في الخلية أو رابط على مستوى الخلية الذي تم ضبطه في الطلب نفسه. عند ضبط رابط، سيتم ضبط لون مقدّمة النص على لون الرابط التلقائي وسيتم وضع خط تحت النص. إذا تم تعديل هذه الحقول في الطلب نفسه، سيتم استخدام هذه القيم بدلاً من الإعدادات التلقائية للرابط.

رابط

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

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

الحقول

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

حقل الاتحاد destination. وجهة الرابط يمكن أن تكون السمة destination واحدًا فقط مما يلي:

uri

string

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

DataSourceColumn

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

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

الحقول

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

reference

object (DataSourceColumnReference)

مرجع العمود.

formula

string

تمثّل هذه السمة صيغة العمود المحسوب.

DataSourceColumnReference

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

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

الحقول

الحقول
`name`	`string` تمثّل هذه السمة الاسم المعروض للعمود. ويجب أن يكون فريدًا داخل مصدر البيانات.

name

string

تمثّل هذه السمة الاسم المعروض للعمود. ويجب أن يكون فريدًا داخل مصدر البيانات.

DataExecutionStatus

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

يتم إنشاء عملية تنفيذ للبيانات لمزامنة عنصر مصدر بيانات مع أحدث البيانات من DataSource. من المقرّر عادةً تشغيله في الخلفية، ويمكنك التحقّق من state لمعرفة ما إذا اكتملت عملية التنفيذ.

هناك عدّة سيناريوهات يتم فيها بدء تنفيذ البيانات:

تنشئ ميزة Adding a data source ورقة بيانات مصدر بيانات مرتبطة بالإضافة إلى عملية تنفيذ للبيانات لمزامنة البيانات من مصدر البيانات مع ورقة البيانات.
تُنشئ Updating a data source عملية تنفيذ للبيانات لإعادة تحميل ورقة مصدر البيانات المرتبطة بالطريقة نفسها.
يمكنك إرسال refresh request لإعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات بشكل صريح.

تمثيل JSON
{ "state": enum (`DataExecutionState`), "errorCode": enum (`DataExecutionErrorCode`), "errorMessage": string, "lastRefreshTime": string }

الحقول
`state`	`enum (DataExecutionState)` حالة تنفيذ البيانات.
`errorCode`	`enum (DataExecutionErrorCode)` رمز الخطأ.
`errorMessage`	`string` رسالة الخطأ التي قد تكون فارغة.
`lastRefreshTime`	`string (Timestamp format)` تتيح لك هذه الميزة معرفة وقت آخر عملية إعادة تحميل للبيانات بنجاح.

DataExecutionState

يشير ذلك المصطلح إلى تعداد حالات تنفيذ البيانات.

عمليات التعداد
`DATA_EXECUTION_STATE_UNSPECIFIED`	القيمة التلقائية، يُرجى عدم استخدامها.
`NOT_STARTED`	لم تبدأ عملية تنفيذ البيانات.
`RUNNING`	بدأت عملية تنفيذ البيانات وهي قيد التشغيل.
`CANCELLING`	يجري حاليًا إلغاء تنفيذ البيانات.
`SUCCEEDED`	اكتملت عملية تنفيذ البيانات بنجاح.
`FAILED`	اكتملت عملية تنفيذ البيانات مع حدوث أخطاء.

DataExecutionErrorCode

تعداد لرمز الخطأ في تنفيذ البيانات.

عمليات التعداد
`DATA_EXECUTION_ERROR_CODE_UNSPECIFIED`	القيمة التلقائية، يُرجى عدم استخدامها.
`TIMED_OUT`	انتهت مهلة تنفيذ البيانات.
`TOO_MANY_ROWS`	تؤدي عملية تنفيذ البيانات إلى إرجاع صفوف أكثر من الحد الأقصى.
`TOO_MANY_COLUMNS`	تؤدي تنفيذ البيانات إلى إرجاع عدد من الأعمدة أكبر من الحد الأقصى.
`TOO_MANY_CELLS`	تؤدي عملية تنفيذ البيانات إلى إرجاع عدد خلايا أكبر من الحد الأقصى.
`ENGINE`	حدث خطأ من محرك تنفيذ البيانات الخلفية (مثل BigQuery). يُرجى الاطّلاع على `errorMessage` للاطّلاع على التفاصيل.
`PARAMETER_INVALID`	هناك مَعلمة واحدة أو بعض مَعلمات مصدر البيانات المقدّمة غير صالحة.
`UNSUPPORTED_DATA_TYPE`	تؤدي تنفيذ البيانات إلى إرجاع نوع بيانات غير متوافق.
`DUPLICATE_COLUMN_NAMES`	تؤدي تنفيذ البيانات إلى إرجاع أسماء أعمدة أو أسماء مستعارة مكررة.
`INTERRUPTED`	تتم مقاطعة تنفيذ البيانات. يُرجى إعادة التحميل لاحقًا.
`CONCURRENT_QUERY`	جارٍ تنفيذ البيانات حاليًا، ولا يمكن إعادة تحميلها حتى تكتمل هذه العملية.
`OTHER`	أخطاء أخرى
`TOO_MANY_CHARS_PER_CELL`	تؤدي عملية تنفيذ البيانات إلى إرجاع القيم التي تتجاوز الحد الأقصى المسموح به لعدد الأحرف في خلية واحدة.
`DATA_NOT_FOUND`	لم يتم العثور على قاعدة البيانات التي تمت الإشارة إليها من خلال مصدر البيانات. */
`PERMISSION_DENIED`	لا يمكن للمستخدم الوصول إلى قاعدة البيانات المشار إليها من خلال مصدر البيانات.
`MISSING_COLUMN_ALIAS`	تؤدي عملية تنفيذ البيانات إلى إرجاع أعمدة ذات أسماء مستعارة مفقودة.
`OBJECT_NOT_FOUND`	عنصر مصدر البيانات غير موجود.
`OBJECT_IN_ERROR_STATE`	عنصر مصدر البيانات في حالة خطأ حاليًا. لفرض إعادة التحميل، يجب ضبط `force` في `RefreshDataSourceRequest`.
`OBJECT_SPEC_INVALID`	مواصفات عنصر مصدر البيانات غير صالحة.
`DATA_EXECUTION_CANCELLED`	تم إلغاء تنفيذ البيانات.

ExtendedValue

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

تمثيل JSON

تمثيل JSON
{ // Union field `value` can be only one of the following: "numberValue": number, "stringValue": string, "boolValue": boolean, "formulaValue": string, "errorValue": { object (`ErrorValue`) } // End of list of possible types for union field `value`. }

{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}

الحقول
حقل الاتحاد `value`. نوع القيمة في خلية. إذا لم يتم ضبط أي حقل، لن تحتوي الخلية على أي بيانات. يمكن أن تكون السمة `value` واحدًا فقط مما يلي:
`numberValue`	`number` تمثّل قيمة مزدوجة. ملاحظة: يتم تمثيل التواريخ والأوقات وتواريخ التاريخ في شكل مزدوج بالتنسيق `SERIAL_NUMBER`.
`stringValue`	`string` تمثل قيمة سلسلة. لا يتم تضمين علامات الاقتباس المفردة البادئة. على سبيل المثال، إذا كتب المستخدم `'123` في واجهة المستخدم، سيتم تمثيله على أنّه `stringValue` من `"123"`.
`boolValue`	`boolean` تمثل قيمة منطقية.
`formulaValue`	`string` تمثل هذه السمة صيغة.
`errorValue`	`object (ErrorValue)` يمثل خطأ. هذا الحقل للقراءة فقط.

ErrorValue

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

تمثيل JSON
{ "type": enum (`ErrorType`), "message": string }

الحقول

الحقول
`type`	`enum (ErrorType)` نوع الخطأ
`message`	`string` رسالة تحتوي على مزيد من المعلومات حول الخطأ (بلغة جدول البيانات).

type

enum (ErrorType)

نوع الخطأ

message

string

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

ErrorType

نوع الخطأ

عمليات التعداد
`ERROR_TYPE_UNSPECIFIED`	إنّه نوع الخطأ التلقائي، لذا لا تستخدِمه.
`ERROR`	يتطابق مع الخطأ `#ERROR!`.
`NULL_VALUE`	يتطابق مع الخطأ `#NULL!`.
`DIVIDE_BY_ZERO`	يتطابق مع الخطأ `#DIV/0`.
`VALUE`	يتطابق مع الخطأ `#VALUE!`.
`REF`	يتطابق مع الخطأ `#REF!`.
`NAME`	يتطابق مع الخطأ `#NAME?`.
`NUM`	يتطابق مع الخطأ `#NUM!`.
`N_A`	يتطابق مع الخطأ `#N/A`.
`LOADING`	يتطابق مع الولاية `Loading...`.

BooleanCondition

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

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

الحقول

الحقول
`type`	`enum (ConditionType)` نوع الشرط.
`values[]`	`object (ConditionValue)` قيم الشرط. ويعتمد عدد القيم المسموح بها على `condition type`. ويتيح بعضها استخدام القيم الصفرية، بينما يتيح البعض الآخر استخدام قيمة واحدة أو اثنتين، ويتيح السمة `ConditionType.ONE_OF_LIST` استخدام عدد عشوائي من القيم.

type

enum (ConditionType)

نوع الشرط.

values[]

object (ConditionValue)

قيم الشرط. ويعتمد عدد القيم المسموح بها على condition type. ويتيح بعضها استخدام القيم الصفرية، بينما يتيح البعض الآخر استخدام قيمة واحدة أو اثنتين، ويتيح السمة ConditionType.ONE_OF_LIST استخدام عدد عشوائي من القيم.

ConditionType

نوع الشرط.

عمليات التعداد
`CONDITION_TYPE_UNSPECIFIED`	القيمة التلقائية، لا تستخدمها.
`NUMBER_GREATER`	يجب أن تكون قيمة الخلية أكبر من قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`NUMBER_GREATER_THAN_EQ`	يجب أن تكون قيمة الخلية أكبر من قيمة الشرط أو مساوية لها. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`NUMBER_LESS`	يجب أن تكون قيمة الخلية أقل من قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`NUMBER_LESS_THAN_EQ`	يجب أن تكون قيمة الخلية أقل من قيمة الشرط أو مساوية لها. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`NUMBER_EQ`	يجب أن تكون قيمة الخلية مساوية لقيمة الشرط. مدعوم من التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يتطلب توفّر عنصر `ConditionValue` واحدًا للتحقّق من صحة البيانات والتنسيق الشرطي والفلاتر على العناصر غير التابعة لمصدر البيانات وعنصر `ConditionValue` واحد على الأقل للفلاتر على عناصر مصدر البيانات.
`NUMBER_NOT_EQ`	يجب ألا تكون قيمة الخلية مساوية لقيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يتطلب توفّر عنصر `ConditionValue` واحدًا للتحقّق من صحة البيانات والتنسيق الشرطي والفلاتر على العناصر غير التابعة لمصدر البيانات وعنصر `ConditionValue` واحد على الأقل للفلاتر على عناصر مصدر البيانات.
`NUMBER_BETWEEN`	يجب أن تكون قيمة الخلية بين قيمتي الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. تتطلّب الميزة نوعَي `ConditionValues` بالضبط.
`NUMBER_NOT_BETWEEN`	يجب ألا تكون قيمة الخلية بين قيمتي الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. تتطلّب الميزة نوعَي `ConditionValues` بالضبط.
`TEXT_CONTAINS`	يجب أن تحتوي قيمة الخلية على قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`TEXT_NOT_CONTAINS`	يجب ألا تحتوي قيمة الخلية على قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`TEXT_STARTS_WITH`	يجب أن تبدأ قيمة الخلية بقيمة الشرط. متوافق مع التنسيق الشرطي والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`TEXT_ENDS_WITH`	يجب أن تنتهي قيمة الخلية بقيمة الشرط. متوافق مع التنسيق الشرطي والفلاتر. ويجب استخدام سمة `ConditionValue` واحدة.
`TEXT_EQ`	يجب أن تكون قيمة الخلية هي قيمة الشرط بالضبط. مدعوم من التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يتطلب توفّر عنصر `ConditionValue` واحدًا للتحقّق من صحة البيانات والتنسيق الشرطي والفلاتر على العناصر غير التابعة لمصدر البيانات وعنصر `ConditionValue` واحد على الأقل للفلاتر على عناصر مصدر البيانات.
`TEXT_IS_EMAIL`	يجب أن تكون قيمة الخلية عنوان بريد إلكتروني صالحًا. يدعمه التحقق من صحة البيانات. لا يتطلب ذلك `ConditionValues`.
`TEXT_IS_URL`	يجب أن تكون قيمة الخلية عنوان URL صالحًا. يدعمه التحقق من صحة البيانات. لا يتطلب ذلك `ConditionValues`.
`DATE_EQ`	يجب أن تكون قيمة الخلية هي نفس تاريخ قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يتطلب توفّر عنصر `ConditionValue` واحدًا للتحقّق من صحة البيانات والتنسيق الشرطي والفلاتر على العناصر غير التابعة لمصدر البيانات وعنصر `ConditionValue` واحد على الأقل للفلاتر على عناصر مصدر البيانات.
`DATE_BEFORE`	يجب أن تكون قيمة الخلية قبل تاريخ قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يجب إدخال `ConditionValue` واحد قد يكون `relative date`.
`DATE_AFTER`	يجب أن تكون قيمة الخلية بعد تاريخ قيمة الشرط. مدعوم من خلال التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. يجب إدخال `ConditionValue` واحد قد يكون `relative date`.
`DATE_ON_OR_BEFORE`	يجب أن تكون قيمة الخلية في تاريخ قيمة الشرط أو قبله. يدعمه التحقق من صحة البيانات. يجب إدخال `ConditionValue` واحد قد يكون `relative date`.
`DATE_ON_OR_AFTER`	يجب أن تكون قيمة الخلية في تاريخ قيمة الشرط أو بعده. يدعمه التحقق من صحة البيانات. يجب إدخال `ConditionValue` واحد قد يكون `relative date`.
`DATE_BETWEEN`	يجب أن تكون قيمة الخلية بين تواريخ قيمتي الشرط. يدعمه التحقق من صحة البيانات. تتطلّب الميزة نوعَي `ConditionValues` بالضبط.
`DATE_NOT_BETWEEN`	يجب أن تكون قيمة الخلية خارج تواريخ قيمتي الشرط. يدعمه التحقق من صحة البيانات. تتطلّب الميزة نوعَي `ConditionValues` بالضبط.
`DATE_IS_VALID`	يجب أن تكون قيمة الخلية تاريخًا. يدعمه التحقق من صحة البيانات. لا يتطلب ذلك `ConditionValues`.
`ONE_OF_RANGE`	يجب أن يتم إدراج قيمة الخلية في الشبكة في نطاق قيمة الشرط. يدعمه التحقق من صحة البيانات. تتطلّب سمة `ConditionValue` واحدة، ويجب أن تكون القيمة نطاقًا صالحًا في ترميز A1.
`ONE_OF_LIST`	يجب أن تكون قيمة الخلية في قائمة قيم الشرط. يدعمه التحقق من صحة البيانات. ويمكن استخدام أي عدد من السمة `condition values`، بمعدل رمز واحد لكل عنصر في القائمة. الصيغ غير متاحة في القيم.
`BLANK`	يجب أن تكون قيمة الخلية فارغة. متوافق مع التنسيق الشرطي والفلاتر. لا يتطلب ذلك `ConditionValues`.
`NOT_BLANK`	يجب ألا تكون قيمة الخلية فارغة. متوافق مع التنسيق الشرطي والفلاتر. لا يتطلب ذلك `ConditionValues`.
`CUSTOM_FORMULA`	يجب تقييم صيغة الشرط إلى true. مدعوم من التحقق من صحة البيانات، والتنسيق الشرطي، والفلاتر. لا تتوفّر هذه الميزة في فلاتر ورقة مصدر البيانات. ويجب استخدام سمة `ConditionValue` واحدة.
`BOOLEAN`	يجب أن تكون قيمة الخلية TRUE/FALSE أو في قائمة قيم الشروط. يدعمه التحقق من صحة البيانات. يتم العرض كمربّع اختيار لخلية. ويمكن استخدام صفر أو واحد أو اثنتين `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` قيمة تستند إلى الشرط. يتم تحليل القيمة كما لو أنّ المستخدم كتب في خلية. يمكن استخدام الصيغ (ويجب أن تبدأ بعلامة `=` أو علامة "+").

حقل الاتحاد 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

تمثيل JSON
{ "filterCriteria": { object (`FilterCriteria`) }, // Union field `reference` can be only one of the following: "columnIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "filterCriteria": {
    object (FilterCriteria)
  },

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

الحقول
`filterCriteria`	`object (FilterCriteria)` تمثّل هذه السمة معايير العمود.
حقل الاتحاد `reference`. مرجع إلى العمود الذي تمت تصفيته. يمكن أن تكون السمة `reference` واحدًا فقط مما يلي:
`columnIndex`	`integer` فهرس العمود المستند إلى صفر.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` الإشارة إلى عمود مصدر بيانات

FilterCriteria

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

تمثيل JSON

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

{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}

الحقول
`hiddenValues[]`	`string` القيم التي يجب إخفاؤها.
`condition`	`object (BooleanCondition)` شرط يجب أن يكون 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

تمثيل JSON
{ "sortOrder": enum (`SortOrder`), "foregroundColor": { object (`Color`) }, "foregroundColorStyle": { object (`ColorStyle`) }, "backgroundColor": { object (`Color`) }, "backgroundColorStyle": { object (`ColorStyle`) }, // Union field `reference` can be only one of the following: "dimensionIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

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

الحقول
`sortOrder`	`enum (SortOrder)` يجب ترتيب بيانات الطلب.
`foregroundColor (deprecated)`	`object (Color)` تم إيقاف هذا العنصر نهائيًا. لون المقدّمة المطلوب الترتيب حسبه، ويتم ترتيب الخلايا التي تتضمّن لون المقدّمة هذا إلى الأعلى. الأحداث المتنافية مع `backgroundColor`. مهملة: تستخدم `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` لون المقدّمة المطلوب الترتيب حسبه، ويتم ترتيب الخلايا التي تتضمّن لون المقدّمة هذا إلى الأعلى. ويمكن استخدام السمة `backgroundColor` بشكل تبادلي، ويجب أن يكون لونها من النوع RGB. في حال ضبط السمة `foregroundColor` أيضًا، تكون الأولوية لهذا الحقل.
`backgroundColor (deprecated)`	`object (Color)` تم إيقاف هذا العنصر نهائيًا. لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا التي تحتوي على لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع `foregroundColor`. مهملة: تستخدم `backgroundColorStyle`.
`backgroundColorStyle`	`object (ColorStyle)` لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا التي تحتوي على لون التعبئة هذا إلى الأعلى. ويمكن استخدام السمة `foregroundColor` بشكل تبادلي، ويجب أن يكون لونها من النوع RGB. في حال ضبط السمة `backgroundColor` أيضًا، تكون الأولوية لهذا الحقل.
حقل الاتحاد `reference`. الإشارة إلى السمة التي تم ترتيبها يمكن أن تكون السمة `reference` واحدًا فقط مما يلي:
`dimensionIndex`	`integer` السمة التي يجب تطبيق الترتيب عليها.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` الإشارة إلى عمود مصدر بيانات

EmbeddedObjectPosition

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

تمثيل JSON

تمثيل JSON
{ // Union field `location` can be only one of the following: "sheetId": integer, "overlayPosition": { object (`OverlayPosition`) }, "newSheet": boolean // End of list of possible types for union field `location`. }

{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}

الحقول
حقل الاتحاد `location`. تمثّل هذه السمة موقع العنصر. يجب ضبط قيمة واحدة بالضبط. يمكن أن تكون السمة `location` واحدًا فقط مما يلي:
`sheetId`	`integer` ورقة البيانات التي تم تفعيلها لا يتم الضبط إلا إذا كان العنصر المضمّن في ورقته الخاصة. يجب ألا تكون القيمة سلبية.
`overlayPosition`	`object (OverlayPosition)` الموضع الذي يكون فيه العنصر مركّبًا على شبكة.
`newSheet`	`boolean` إذا كانت القيمة true، يتم وضع الكائن المضمّن في ورقة بيانات جديدة يتم اختيار معرّفها لك. لا يُستخدم إلا عند الكتابة.

OverlayPosition

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

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

الحقول
`anchorCell`	`object (GridCoordinate)` الخلية التي يرتبط بها الكائن.
`offsetXPixels`	`integer` الإزاحة الأفقية، بالبكسل، التي تتم إزاحة الكائن من خلية الارتساء.
`offsetYPixels`	`integer` الإزاحة الرأسية بالبكسل التي تتم إزاحة الكائن من خلية الارتساء.
`widthPixels`	`integer` عرض الكائن بالبكسل. وتكون القيم التلقائية 600.
`heightPixels`	`integer` ارتفاع الكائن بالبكسل. يكون الإعداد التلقائي بالقيمة 371.

GridCoordinate

إحداثي في الورقة. جميع الفهارس قائمة على صفر.

تمثيل JSON
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

الحقول

الحقول
`sheetId`	`integer` الورقة التي توجد فيها هذه الإحداثيات.
`rowIndex`	`integer` فهرس صف الإحداثي.
`columnIndex`	`integer` فهرس عمود الإحداثي.

sheetId

integer

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

rowIndex

integer

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

columnIndex

integer

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