اللون
يمثل لونًا في مساحة لون 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
|
مقدار اللون الأحمر في اللون كقيمة في الفاصل الزمني [0، 1]. |
green
|
مقدار اللون الأخضر في اللون كقيمة في الفاصل الزمني [0، 1]. |
blue
|
مقدار اللون الأزرق في اللون كقيمة في الفاصل الزمني [0، 1]. |
alpha
|
جزء هذا اللون الذي يجب تطبيقه على البكسل. بمعنى، يتم تحديد لون البكسل النهائي من خلال المعادلة:
هذا يعني أن القيمة 1.0 تتجاوب مع اللون الخالص، في حين أن القيمة 0.0 تتجاوب مع لون شفاف تمامًا. ويستخدم هذا الأمر رسالة برنامج تضمين بدلاً من قيمة عددية عائمة بسيطة، بحيث يمكن التمييز بين القيمة الافتراضية والقيمة التي يتم تركها بدون ضبط. في حال حذفه، يتم عرض كائن اللون هذا كلون ثابت (كما لو تم تحديد قيمة ألفا بشكل صريح للقيمة 1.0). |
ColorStyle
قيمة اللون.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
kind . نوع قيمة اللون.
يمكن أن تكون السمة kind واحدًا فقط مما يلي:
|
|
rgbColor
|
اللون RGB لا يمكن استخدام القيمة |
themeColor
|
لون المظهر |
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 |
---|
{ "foregroundColor": { object ( |
الحقول | |
---|---|
foregroundColor
|
لون المقدّمة للنص. مهملة: تستخدم
|
foregroundColorStyle
|
لون المقدّمة للنص. في حال ضبط السمة |
fontFamily
|
مجموعة الخطوط. |
fontSize
|
حجم الخط. |
bold
|
True إذا كان النص غامقًا. |
italic
|
صحيح إذا كان النص مائلاً. |
strikethrough
|
صحيح إذا كان النص يتوسطه خط. |
underline
|
True إذا كان النص تحته خط. |
link
|
تمثّل هذه السمة وجهة الرابط في النص، إن توفّرت. وعند ضبط حقل الرابط في
|
رابط
مرجع خارجي أو محلي
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
destination . وجهة الرابط
يمكن أن تكون السمة destination واحدًا فقط مما يلي:
|
|
uri
|
معرِّف الرابط. |
DataSourceColumn
عمود في مصدر بيانات.
تمثيل JSON |
---|
{
"reference": {
object (
|
الحقول | |
---|---|
reference
|
مرجع العمود. |
formula
|
تمثّل هذه السمة صيغة العمود المحسوب. |
DataSourceColumnReference
معرّف فريد يشير إلى عمود مصدر بيانات.
تمثيل JSON |
---|
{ "name": string } |
الحقول | |
---|---|
name
|
تمثّل هذه السمة الاسم المعروض للعمود. ويجب أن يكون فريدًا داخل مصدر البيانات. |
DataExecutionStatus
حالة تنفيذ البيانات
يتم إنشاء عملية تنفيذ للبيانات لمزامنة عنصر مصدر بيانات مع أحدث البيانات من
DataSource
. من المقرّر عادةً تشغيله في الخلفية، ويمكنك التحقّق من
state
لمعرفة ما إذا اكتملت عملية التنفيذ.
هناك عدّة سيناريوهات يتم فيها بدء تنفيذ البيانات:
-
تنشئ ميزة
Adding a data source
ورقة بيانات مصدر بيانات مرتبطة بالإضافة إلى عملية تنفيذ للبيانات لمزامنة البيانات من مصدر البيانات مع ورقة البيانات. -
تُنشئ
Updating a data source
عملية تنفيذ للبيانات لإعادة تحميل ورقة مصدر البيانات المرتبطة بالطريقة نفسها. -
يمكنك إرسال
refresh request
لإعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات بشكل صريح.
تمثيل JSON |
---|
{ "state": enum ( |
الحقول | |
---|---|
state
|
حالة تنفيذ البيانات. |
errorCode
|
رمز الخطأ. |
errorMessage
|
رسالة الخطأ التي قد تكون فارغة. |
lastRefreshTime
|
تتيح لك هذه الميزة معرفة وقت آخر عملية إعادة تحميل للبيانات بنجاح. |
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 . نوع القيمة في خلية. إذا لم يتم ضبط أي حقل، لن تحتوي الخلية على أي بيانات.
يمكن أن تكون السمة value واحدًا فقط مما يلي:
|
|
numberValue
|
تمثّل قيمة مزدوجة. ملاحظة: يتم تمثيل التواريخ والأوقات وتواريخ التاريخ في شكل مزدوج
بالتنسيق |
stringValue
|
تمثل قيمة سلسلة. لا يتم تضمين علامات الاقتباس المفردة البادئة. على سبيل المثال، إذا كتب المستخدم |
boolValue
|
تمثل قيمة منطقية. |
formulaValue
|
تمثل هذه السمة صيغة. |
errorValue
|
يمثل خطأ. هذا الحقل للقراءة فقط. |
ErrorValue
حدث خطأ في خلية.
تمثيل JSON |
---|
{
"type": enum (
|
الحقول | |
---|---|
type
|
نوع الخطأ |
message
|
رسالة تحتوي على مزيد من المعلومات حول الخطأ (بلغة جدول البيانات). |
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 ( |
الحقول | |
---|---|
type
|
نوع الشرط. |
values[]
|
قيم الشرط. ويعتمد عدد القيم المسموح بها على |
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 . قيمة الشرط، يجب ضبط واحد بالضبط.
يمكن أن تكون السمة value واحدًا فقط مما يلي:
|
|
relativeDate
|
تاريخ نسبي (استنادًا إلى التاريخ الحالي). صالح فقط إذا كانت
السمة لا يُسمح باستخدام التواريخ النسبية في التحقّق من صحة البيانات. ولا يتم دعمها إلا في التنسيق الشرطي والفلاتر الشرطية. |
userEnteredValue
|
قيمة تستند إلى الشرط. يتم تحليل القيمة كما لو أنّ المستخدم كتب في خلية. يمكن استخدام الصيغ (ويجب أن تبدأ بعلامة |
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
|
الورقة التي يتوفّر فيها هذا النطاق. |
startRowIndex
|
صف بداية النطاق (شاملاً) أو لم يتم ضبطه إذا كان غير محدود. |
endRowIndex
|
صف النهاية (حصري) للنطاق، أو لم يتم ضبطه إذا كان غير محدود. |
startColumnIndex
|
عمود البداية (شامل) النطاق، أو لا يتم ضبطه إذا كان غير محدود. |
endColumnIndex
|
عمود النهاية (حصري) للنطاق، أو لم يتم ضبطه إذا كان غير محدود. |
SortOrder
نظام الفرز.
عمليات التعداد | |
---|---|
SORT_ORDER_UNSPECIFIED
|
القيمة التلقائية، يُرجى عدم استخدامها. |
ASCENDING
|
ترتيب تصاعدي |
DESCENDING
|
ترتيب تنازلي |
FilterSpec
معايير الفلترة المرتبطة بعمود محدّد
تمثيل JSON |
---|
{ "filterCriteria": { object ( |
الحقول | |
---|---|
filterCriteria
|
تمثّل هذه السمة معايير العمود. |
حقل الاتحاد
reference . مرجع إلى العمود الذي تمت تصفيته.
يمكن أن تكون السمة reference واحدًا فقط مما يلي:
|
|
columnIndex
|
فهرس العمود المستند إلى صفر. |
dataSourceColumnReference
|
الإشارة إلى عمود مصدر بيانات |
FilterCriteria
معايير إظهار/إخفاء الصفوف في عرض فلتر أو فلتر
تمثيل JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
الحقول | |
---|---|
condition
|
شرط يجب أن يكون true حتى يتم عرض القيم. (لا يؤدي ذلك إلى إلغاء |
visibleBackgroundColor
|
لون تعبئة الخلفية المطلوب الفلترة وفقًا له، ولن يتم عرض سوى الخلايا التي تحتوي على لون التعبئة هذا. الأحداث المتنافية مع |
visibleBackgroundColorStyle
|
لون تعبئة الخلفية المطلوب الفلترة وفقًا له، ولن يتم عرض سوى الخلايا التي تحتوي على لون التعبئة هذا. ولا يمكن استخدام هذا الحقل مع |
visibleForegroundColor
|
لون المقدّمة المطلوب الفلترة حسبه، ولا يتم عرض سوى الخلايا التي تتضمّن لون المقدّمة هذا. الأحداث المتنافية مع |
visibleForegroundColorStyle
|
لون المقدّمة المطلوب الفلترة حسبه، ولا يتم عرض سوى الخلايا التي تتضمّن لون المقدّمة هذا. ولا يمكن استخدام هذا الحقل مع |
SortSpec
يشير ذلك المصطلح إلى نظام ترتيب مرتبط بعمود أو صف محدّد.
تمثيل JSON |
---|
{ "sortOrder": enum ( |
الحقول | |
---|---|
sortOrder
|
يجب ترتيب بيانات الطلب. |
foregroundColor
|
لون المقدّمة المطلوب الترتيب حسبه، ويتم ترتيب الخلايا التي تتضمّن لون المقدّمة هذا إلى الأعلى. الأحداث المتنافية مع |
foregroundColorStyle
|
لون المقدّمة المطلوب الترتيب حسبه، ويتم ترتيب الخلايا التي تتضمّن لون المقدّمة هذا إلى الأعلى. ويمكن استخدام السمة |
backgroundColor
|
لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا التي تحتوي على لون التعبئة هذا إلى الأعلى. الأحداث المتنافية مع |
backgroundColorStyle
|
لون تعبئة الخلفية المطلوب الفرز حسبه؛ يتم فرز الخلايا التي تحتوي على لون التعبئة هذا إلى الأعلى. ويمكن استخدام السمة |
حقل الاتحاد
reference . الإشارة إلى السمة التي تم ترتيبها
يمكن أن تكون السمة reference واحدًا فقط مما يلي:
|
|
dimensionIndex
|
السمة التي يجب تطبيق الترتيب عليها. |
dataSourceColumnReference
|
الإشارة إلى عمود مصدر بيانات |
EmbeddedObjectPosition
تمثّل هذه السمة موضع عنصر مضمّن، مثل الرسم البياني.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
location . تمثّل هذه السمة موقع العنصر. يجب ضبط قيمة واحدة بالضبط.
يمكن أن تكون السمة location واحدًا فقط مما يلي:
|
|
sheetId
|
ورقة البيانات التي تم تفعيلها لا يتم الضبط إلا إذا كان العنصر المضمّن في ورقته الخاصة. يجب ألا تكون القيمة سلبية. |
overlayPosition
|
الموضع الذي يكون فيه العنصر مركّبًا على شبكة. |
newSheet
|
إذا كانت القيمة true، يتم وضع الكائن المضمّن في ورقة بيانات جديدة يتم اختيار معرّفها لك. لا يُستخدم إلا عند الكتابة. |
OverlayPosition
يشير ذلك المصطلح إلى المكان الذي يظهر فيه عنصر فوق شبكة.
تمثيل JSON |
---|
{
"anchorCell": {
object (
|
الحقول | |
---|---|
anchorCell
|
الخلية التي يرتبط بها الكائن. |
offsetXPixels
|
الإزاحة الأفقية، بالبكسل، التي تتم إزاحة الكائن من خلية الارتساء. |
offsetYPixels
|
الإزاحة الرأسية بالبكسل التي تتم إزاحة الكائن من خلية الارتساء. |
widthPixels
|
عرض الكائن بالبكسل. وتكون القيم التلقائية 600. |
heightPixels
|
ارتفاع الكائن بالبكسل. يكون الإعداد التلقائي بالقيمة 371. |
GridCoordinate
إحداثي في الورقة. جميع الفهارس قائمة على صفر.
تمثيل JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
الحقول | |
---|---|
sheetId
|
الورقة التي توجد فيها هذه الإحداثيات. |
rowIndex
|
فهرس صف الإحداثي. |
columnIndex
|
فهرس عمود الإحداثي. |