Other

رنگ

یک رنگ را در فضای رنگی RGBA نشان می دهد. این نمایش برای سادگی تبدیل به و از نمایش رنگ در زبان های مختلف بیش از فشرده سازی طراحی شده است. به عنوان مثال، فیلدهای این نمایش را می توان به صورت بی اهمیت در اختیار سازنده java.awt.Color در جاوا قرار داد. همچنین می‌توان آن را به روش UIColor +colorWithRed:green:blue:alpha در iOS ارائه کرد. و فقط با کمی کار می توان آن را به راحتی در یک رشته CSS rgba() در جاوا اسکریپت قالب بندی کرد.

این صفحه مرجع اطلاعاتی درباره فضای رنگ مطلقی که باید برای تفسیر مقدار RGB استفاده شود ندارد - برای مثال، sRGB، Adobe RGB، DCI-P3، و BT.2020. به طور پیش فرض، برنامه ها باید فضای رنگی sRGB را در نظر بگیرند.

هنگامی که نیاز به تصمیم گیری در مورد برابری رنگ است، پیاده سازی ها، مگر اینکه به گونه ای دیگر مستند شده باشد، اگر تمام مقادیر قرمز، سبز، آبی و آلفا هر کدام حداکثر 1e-5 متفاوت باشد، با دو رنگ برابر رفتار می کنند.

مثال (جاوا):

 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;
}
// ...

مثال (جاوا اسکریپت):

// ...

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 )

رنگ تم

نوع رنگ تم

انواع رنگ تم

SpreadsheetProperties حاوی یک SpreadsheetTheme است که نگاشت این انواع رنگ تم را به رنگ های بتن تعریف می کند.

Enums
THEME_COLOR_TYPE_UNSPECIFIED رنگ تم نامشخص
TEXT رنگ متن اصلی را نشان می دهد
BACKGROUND رنگ پس زمینه اصلی را نشان می دهد
ACCENT1 نشان دهنده اولین رنگ تاکیدی است
ACCENT2 نشان دهنده رنگ تاکیدی دوم است
ACCENT3 نشان دهنده رنگ تاکیدی سوم است
ACCENT4 نمایانگر رنگ تاکیدی چهارم است
ACCENT5 نشان دهنده رنگ تاکیدی پنجم است
ACCENT6 نمایانگر رنگ تاکیدی ششم است

Horizontal Align

تراز افقی متن در یک سلول.

Enums
HORIZONTAL_ALIGN_UNSPECIFIED تراز افقی مشخص نشده است. از این استفاده نکنید.
LEFT متن به صراحت در سمت چپ سلول تراز شده است.
CENTER متن به صراحت در مرکز سلول تراز شده است.
RIGHT متن به صراحت در سمت راست سلول تراز شده است.

فرمت متن

قالب اجرای متن در یک سلول. مقادیر وجود ندارد نشان می دهد که فیلد مشخص نشده است.

نمایندگی 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

شمارشی از حالات اجرای داده ها.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
NOT_STARTED اجرای داده ها شروع نشده است.
RUNNING اجرای داده ها شروع شده و در حال اجراست.
SUCCEEDED اجرای داده ها با موفقیت به پایان رسید.
FAILED اجرای داده ها با خطا کامل شده است.

DataExecutionErrorCode

شمارش کد خطای اجرای داده ها.

Enums
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 مشخصات شی منبع داده نامعتبر است.

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 در UI تایپ کند، این به عنوان یک stringValue از "123" نمایش داده می شود.

boolValue

boolean

یک مقدار بولی را نشان می دهد.

formulaValue

string

یک فرمول را نشان می دهد.

errorValue

object ( ErrorValue )

نشان دهنده یک خطا است. این فیلد فقط خواندنی است.

ErrorValue

یک خطا در یک سلول

نمایندگی JSON
{
  "type": enum (ErrorType),
  "message": string
}
زمینه های
type

enum ( ErrorType )

نوع خطا.

message

string

پیامی با اطلاعات بیشتر درباره خطا (در منطقه صفحه گسترده).

نوع خطا

نوع خطا.

Enums
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... است.

شرایط بولی

شرایطی که می تواند درست یا نادرست ارزیابی شود. BooleanConditions با قالب بندی شرطی، اعتبارسنجی داده ها و معیارهای موجود در فیلترها استفاده می شود.

نمایندگی JSON
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
زمینه های
type

enum ( ConditionType )

نوع شرایط.

values[]

object ( ConditionValue )

مقادیر شرط تعداد مقادیر پشتیبانی شده به condition type بستگی دارد. برخی از مقادیر صفر، برخی دیگر از یک یا دو مقدار، و ConditionType.ONE_OF_LIST از تعداد دلخواه مقادیر پشتیبانی می کند.

نوع شرط

نوع شرایط.

Enums
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 مقدار سلول باید 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

مقداری که شرط مبتنی بر آن است. مقدار به گونه ای تجزیه می شود که گویی کاربر در یک سلول تایپ کرده است. فرمول ها پشتیبانی می شوند (و باید با یک = یا '+' شروع شوند).

RelativeDate

نحوه ارزیابی یک شرط تاریخ را کنترل می کند.

Enums
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

شاخص شروع باید همیشه کمتر یا مساوی با شاخص پایان باشد. اگر شاخص شروع با شاخص پایان برابر باشد، محدوده خالی است. محدوده های خالی معمولاً معنی ندارند و معمولاً در UI به صورت #REF! .

نمایندگی JSON
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
زمینه های
sheetId

integer

برگه ای که این محدوده در آن قرار دارد.

startRowIndex

integer

ردیف شروع (شامل) محدوده، یا اگر نامحدود باشد تنظیم نمی شود.

endRowIndex

integer

ردیف پایانی (انحصاری) محدوده، یا اگر نامحدود باشد تنظیم نمی شود.

startColumnIndex

integer

ستون شروع (شامل) محدوده، یا اگر نامحدود باشد تنظیم نمی شود.

endColumnIndex

integer

ستون انتهایی (انحصاری) محدوده، یا اگر نامحدود باشد تنظیم نمی شود.

مرتب سازی

یک دستور مرتب سازی

Enums
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 )

ارجاع به ستون منبع داده

معیارهای فیلتر

معیارهای نمایش/پنهان کردن سطرها در نمای فیلتر یا فیلتر.

نمایندگی JSON
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
زمینه های
hiddenValues[]

string

ارزش هایی که باید پنهان شوند.

condition

object ( BooleanCondition )

شرطی که برای نمایش مقادیر باید درست باشد. (این hiddenValues لغو نمی کند -- اگر مقداری در آنجا فهرست شده باشد، همچنان پنهان خواهد بود.)

visibleBackgroundColor
(deprecated)

object ( Color )

رنگ پر کردن پس‌زمینه برای فیلتر کردن. فقط سلول هایی با این رنگ پر نشان داده می شوند. انحصاری متقابل با visibleForegroundColor . منسوخ شده: از visibleBackgroundColorStyle استفاده کنید.

visibleBackgroundColorStyle

object ( ColorStyle )

رنگ پر کردن پس‌زمینه برای فیلتر کردن. فقط سلول هایی با این رنگ پر نشان داده می شوند. این فیلد با visibleForegroundColor منحصر به فرد است و باید روی رنگی از نوع RGB تنظیم شود. اگر visibleBackgroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

visibleForegroundColor
(deprecated)

object ( Color )

رنگ پیش زمینه برای فیلتر کردن. فقط سلول هایی با این رنگ پیش زمینه نشان داده می شوند. انحصاری متقابل با visibleBackgroundColor . منسوخ شده: از visibleForegroundColorStyle استفاده کنید.

visibleForegroundColorStyle

object ( ColorStyle )

رنگ پیش زمینه برای فیلتر کردن. فقط سلول هایی با این رنگ پیش زمینه نشان داده می شوند. این فیلد با visibleBackgroundColor منحصر به فرد است و باید روی رنگی از نوع RGB تنظیم شود. اگر visibleForegroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

SortSpec

ترتیب مرتب سازی مرتبط با یک ستون یا ردیف خاص.

نمایندگی JSON
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

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

enum ( SortOrder )

داده های سفارش باید مرتب شوند.

foregroundColor
(deprecated)

object ( Color )

رنگ پیش زمینه برای مرتب سازی. سلول های با این رنگ پیش زمینه به بالا مرتب می شوند. متقابلا منحصر به فرد با backgroundColor . منسوخ شده: از foregroundColorStyle استفاده کنید.

foregroundColorStyle

object ( ColorStyle )

رنگ پیش زمینه برای مرتب سازی. سلول های با این رنگ پیش زمینه به بالا مرتب می شوند. با backgroundColor منحصر به فرد است و باید رنگی از نوع RGB باشد. اگر foregroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

backgroundColor
(deprecated)

object ( Color )

رنگ پر کردن پس‌زمینه برای مرتب‌سازی. سلول های با این رنگ پر شده به بالا مرتب می شوند. متقابل با foregroundColor . منسوخ شده: از backgroundColorStyle استفاده کنید.

backgroundColorStyle

object ( ColorStyle )

رنگ پر کردن پس‌زمینه برای مرتب‌سازی. سلول های با این رنگ پر شده به بالا مرتب می شوند. با foregroundColor منحصر به فرد است و باید رنگی از نوع RGB باشد. اگر backgroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

reference فیلد اتحادیه ارجاع به بعد مرتب شده. reference فقط می تواند یکی از موارد زیر باشد:
dimensionIndex

integer

ابعادی که مرتب سازی باید روی آن اعمال شود.

dataSourceColumnReference

object ( DataSourceColumnReference )

ارجاع به ستون منبع داده

EmbeddedObjectPosition

موقعیت یک شی جاسازی شده مانند نمودار.

نمایندگی JSON
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
زمینه های
location میدان اتحادیه محل قرارگیری جسم. دقیقاً یک مقدار باید تنظیم شود. location فقط می تواند یکی از موارد زیر باشد:
sheetId

integer

برگه ای که روی آن است. فقط در صورتی تنظیم کنید که شی جاسازی شده روی صفحه خودش باشد. باید غیر منفی باشد.

overlayPosition

object ( OverlayPosition )

موقعیتی که در آن شیء در بالای یک شبکه قرار می گیرد.

newSheet

boolean

اگر درست باشد، شی جاسازی شده در برگه جدیدی قرار می گیرد که شناسه آن برای شما انتخاب شده است. فقط هنگام نوشتن استفاده می شود.

Overlay Position

مکانی که یک شی در بالای یک شبکه قرار گرفته است.

نمایندگی 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

نمایه ستون مختصات.