این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Other

رنگ

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

این صفحه مرجع اطلاعاتی در مورد فضای رنگی مطلق که باید برای تفسیر مقدار 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)` این بدان معناست که مقدار ۱.۰ مربوط به یک رنگ ثابت است، در حالی که مقدار ۰.۰ مربوط به یک رنگ کاملاً شفاف است. این روش به جای یک عدد اعشاری ساده، از یک پیام پوششی استفاده می‌کند تا بتوان بین مقدار پیش‌فرض و مقداری که تنظیم نشده است، تمایز قائل شد. در صورت حذف، این شیء رنگ به صورت یک رنگ ثابت رندر می‌شود (گویی به مقدار آلفا به صراحت مقدار ۱.۰ داده شده است).

سبک رنگ

یک مقدار رنگ.

نمایش 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`. }

فیلدها

فیلدها
فیلد Union `kind` . نوع مقدار رنگ. `kind` فقط می‌تواند یکی از موارد زیر باشد:
`rgbColor`	`object ( Color )` رنگ RGB. مقدار `alpha` در شیء `Color` به طور کلی پشتیبانی نمی‌شود.
`themeColor`	`enum ( ThemeColorType )` رنگ تم.

فیلد Union kind . نوع مقدار رنگ. kind فقط می‌تواند یکی از موارد زیر باشد:

rgbColor

object ( Color )

رنگ RGB. مقدار alpha در شیء Color به طور کلی پشتیبانی نمی‌شود.

themeColor

enum ( ThemeColorType )

رنگ تم.

نوع رنگ قالب

انواع رنگ‌های تم

SpreadsheetProperties شامل یک SpreadsheetTheme است که نگاشت این انواع رنگ‌های تم را به رنگ‌های مشخص تعریف می‌کند.

انوم‌ها
`THEME_COLOR_TYPE_UNSPECIFIED`	رنگ تم نامشخص
`TEXT`	رنگ متن اصلی را نشان می‌دهد
`BACKGROUND`	نشان دهنده رنگ اصلی پس زمینه است
`ACCENT1`	اولین رنگ تاکیدی را نشان می‌دهد
`ACCENT2`	نشان دهنده رنگ تاکیدی دوم است
`ACCENT3`	نشان دهنده سومین رنگ تاکیدی است
`ACCENT4`	نشان دهنده چهارمین رنگ تاکیدی است
`ACCENT5`	نشان دهنده پنجمین رنگ تاکیدی است
`ACCENT6`	نشان دهنده ششمین رنگ تاکیدی است
`LINK`	رنگی را که برای هایپرلینک‌ها استفاده می‌شود، نشان می‌دهد.

تراز افقی

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

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

قالب متن

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

نمایش 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` اگر متن پررنگ باشد، درست است.
`italic`	`boolean` اگر متن ایتالیک شده باشد، صحیح است.
`strikethrough`	`boolean` اگر متن خط خورده باشد، صحیح است.
`underline`	`boolean` اگر متن زیرخط‌دار باشد، درست است.
`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`. }

فیلدها

فیلدها
فیلد Union `destination` . لینک destination. `destination` فقط می‌تواند یکی از موارد زیر باشد:
`uri`	`string` شناسه لینک.

فیلد Union destination . لینک destination. destination فقط می‌تواند یکی از موارد زیر باشد:

uri

string

شناسه لینک.

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

یک ستون در یک منبع داده.

نمایش JSON
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

فیلدها

فیلدها
`reference`	`object ( DataSourceColumnReference )` مرجع ستون.
`formula`	`string` فرمول ستون محاسبه شده.

reference

object ( DataSourceColumnReference )

مرجع ستون.

formula

string

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

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

یک شناسه منحصر به فرد که به یک ستون منبع داده اشاره می‌کند.

نمایش JSON
{ "name": string }

فیلدها

فیلدها
`name`	`string` نام نمایشی ستون. این نام باید در یک منبع داده منحصر به فرد باشد.

name

string

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

وضعیت اجرای داده

وضعیت اجرای داده‌ها

یک اجرای داده برای همگام‌سازی یک شیء منبع داده با آخرین داده‌های یک 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)` آخرین باری که داده‌ها با موفقیت به‌روزرسانی شده‌اند را برمی‌گرداند.

وضعیت اجرای داده

شمارشی از وضعیت‌های اجرای داده‌ها.

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

کد خطای اجرای داده

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

انوم‌ها
`DATA_EXECUTION_ERROR_CODE_UNSPECIFIED`	مقدار پیش‌فرض، استفاده نکنید.
`TIMED_OUT`	زمان اجرای داده به پایان رسید.
`TOO_MANY_ROWS`	اجرای داده‌ها، ردیف‌های بیشتری از حد مجاز را برمی‌گرداند.
`TOO_MANY_COLUMNS`	اجرای داده‌ها، ستون‌های بیشتری از حد مجاز را برمی‌گرداند.
`TOO_MANY_CELLS`	اجرای داده‌ها، سلول‌های بیشتری از حد مجاز را برمی‌گرداند.
`ENGINE`	خطا از موتور اجرای داده‌های backend (مثلاً 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`	اجرای داده‌ها لغو شده است.

مقدار توسعه‌یافته

انواع مقادیری که یک سلول در یک صفحه گسترده می‌تواند داشته باشد.

نمایش 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` فیلد Union. نوع مقدار در یک سلول. اگر هیچ فیلدی تنظیم نشده باشد، سلول هیچ داده‌ای ندارد. `value` می‌تواند فقط یکی از موارد زیر باشد:
`numberValue`	`number` نشان دهنده یک مقدار double است. توجه: تاریخ، زمان و DateTimes به صورت double و با فرمت `SERIAL_NUMBER` نمایش داده می‌شوند.
`stringValue`	`string` نشان دهنده یک مقدار رشته‌ای است. علامت نقل قول (') در ابتدای عبارت لحاظ نشده است. برای مثال، اگر کاربر عدد `'123` را در رابط کاربری تایپ کند، این عدد به صورت یک `stringValue` با مقدار `"123"` نمایش داده می‌شود.
`boolValue`	`boolean` نشان دهنده یک مقدار بولی است.
`formulaValue`	`string` نشان دهنده یک فرمول است.
`errorValue`	`object ( ErrorValue )` نشان دهنده یک خطا است. این فیلد فقط خواندنی است.

مقدار خطا

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

نمایش JSON
{ "type": enum (`ErrorType`), "message": string }

فیلدها

فیلدها
`type`	`enum ( ErrorType )` نوع خطا.
`message`	`string` پیامی با اطلاعات بیشتر در مورد خطا (در محل فایل اکسل).

type

enum ( ErrorType )

نوع خطا.

message

string

پیامی با اطلاعات بیشتر در مورد خطا (در محل فایل اکسل).

نوع خطا

نوع خطا.

انوم‌ها
`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` از تعداد دلخواهی از مقادیر پشتیبانی می‌کند.

type

enum ( ConditionType )

نوع شرط.

values[]

object ( ConditionValue )

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

نوع وضعیت

نوع شرط.

انوم‌ها
`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` واحد نیاز دارد.

شرط مقدار

ارزش شرط.

نمایش 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` فیلد Union. مقدار شرط، دقیقاً باید یکی باشد. `value` می‌تواند فقط یکی از موارد زیر باشد:
`relativeDate`	`enum ( RelativeDate )` یک تاریخ نسبی (بر اساس تاریخ فعلی). فقط در صورتی معتبر است که `type` آن `DATE_BEFORE` ، `DATE_AFTER` ، `DATE_ON_OR_BEFORE` یا `DATE_ON_OR_AFTER` باشد. تاریخ‌های نسبی در اعتبارسنجی داده‌ها پشتیبانی نمی‌شوند. آن‌ها فقط در قالب‌بندی شرطی و فیلترهای شرطی پشتیبانی می‌شوند.
`userEnteredValue`	`string` مقداری که شرط بر اساس آن محاسبه می‌شود. این مقدار طوری تجزیه و تحلیل می‌شود که انگار کاربر در یک سلول تایپ کرده است. فرمول‌ها پشتیبانی می‌شوند (و باید با `=` یا '+' شروع شوند).

value فیلد Union. مقدار شرط، دقیقاً باید یکی باشد. value می‌تواند فقط یکی از موارد زیر باشد:

relativeDate

enum ( RelativeDate )

یک تاریخ نسبی (بر اساس تاریخ فعلی). فقط در صورتی معتبر است که type آن DATE_BEFORE ، DATE_AFTER ، DATE_ON_OR_BEFORE یا DATE_ON_OR_AFTER باشد.

تاریخ‌های نسبی در اعتبارسنجی داده‌ها پشتیبانی نمی‌شوند. آن‌ها فقط در قالب‌بندی شرطی و فیلترهای شرطی پشتیبانی می‌شوند.

userEnteredValue

string

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

تاریخ نسبی

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

انوم‌ها
`RELATIVE_DATE_UNSPECIFIED`	مقدار پیش‌فرض، استفاده نکنید.
`PAST_YEAR`	ارزش مربوط به یک سال قبل از امروز است.
`PAST_MONTH`	ارزش مربوط به یک ماه قبل از امروز است.
`PAST_WEEK`	قیمت مربوط به یک هفته قبل از امروز است.
`YESTERDAY`	ارزش دیروز است.
`TODAY`	ارزش امروز است.
`TOMORROW`	ارزش فردا است.

گریدرنج

یک محدوده روی یک برگه. همه شاخص‌ها مبتنی بر صفر هستند. شاخص‌ها نیمه‌باز هستند، یعنی شاخص شروع شامل و شاخص پایان منحصر است -- [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` ستون انتهایی (منحصراً) محدوده، یا اگر نامحدود باشد، تنظیم نشده است.

مرتب‌سازی

یک ترتیب مرتب‌سازی.

انوم‌ها
`SORT_ORDER_UNSPECIFIED`	مقدار پیش‌فرض، از این استفاده نکنید.
`ASCENDING`	مرتب سازی صعودی.
`DESCENDING`	مرتب سازی نزولی.

مشخصات فیلتر

معیارهای فیلتر مرتبط با یک ستون خاص.

نمایش 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` فیلد Union. ارجاع به ستون فیلتر شده. `reference` می‌تواند فقط یکی از موارد زیر باشد:
`columnIndex`	`integer` شاخص ستون مبتنی بر صفر.
`dataSourceColumnReference`	`object ( DataSourceColumnReference )` ارجاع به یک ستون منبع داده.

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

معیارهای نمایش یا پنهان کردن ردیف‌ها در یک فیلتر یا نمای فیلتر.

نمایش 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` نیز تنظیم شده باشد، این فیلد اولویت دارد.

مرتب‌سازی

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

نمایش 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 )` ارجاع به یک ستون منبع داده.

موقعیت شیء جاسازی‌شده

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

نمایش 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.
}

فیلدها
فیلد Union `location` . موقعیت شیء. دقیقاً یک مقدار باید تنظیم شود. `location` فقط می‌تواند یکی از موارد زیر باشد:
`sheetId`	`integer` برگه‌ای که این در آن قرار دارد. فقط در صورتی تنظیم می‌شود که شیء جاسازی‌شده در برگه خودش باشد. باید غیرمنفی باشد.
`overlayPosition`	`object ( OverlayPosition )` موقعیتی که در آن شیء روی یک شبکه قرار می‌گیرد.
`newSheet`	`boolean` اگر درست باشد، شیء جاسازی‌شده در یک برگه جدید که شناسه آن برای شما انتخاب شده است، قرار می‌گیرد. فقط هنگام نوشتن استفاده می‌شود.

موقعیت روی هم قرار دادن

مکانی که یک شیء روی یک شبکه قرار می‌گیرد.

نمایش JSON
{ "anchorCell": { object (`GridCoordinate`) }, "offsetXPixels": integer, "offsetYPixels": integer, "widthPixels": integer, "heightPixels": integer }

فیلدها
`anchorCell`	`object ( GridCoordinate )` سلولی که شیء به آن متصل شده است.
`offsetXPixels`	`integer` فاصله افقی (برحسب پیکسل) که شیء از سلول لنگر فاصله دارد.
`offsetYPixels`	`integer` فاصله عمودی (برحسب پیکسل) که شیء از سلول لنگر فاصله دارد.
`widthPixels`	`integer` عرض شیء، بر حسب پیکسل. مقدار پیش‌فرض ۶۰۰ است.
`heightPixels`	`integer` ارتفاع شیء، بر حسب پیکسل. مقدار پیش‌فرض ۳۷۱ است.

مختصات شبکه‌ای

یک مختصات در یک برگه. همه شاخص‌ها مبتنی بر صفر هستند.

نمایش JSON
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

فیلدها

فیلدها
`sheetId`	`integer` صفحه‌ای که این مختصات روی آن قرار دارد.
`rowIndex`	`integer` شاخص ردیف مختصات.
`columnIndex`	`integer` شاخص ستون مختصات.

sheetId

integer

صفحه‌ای که این مختصات روی آن قرار دارد.

rowIndex

integer

شاخص ردیف مختصات.

columnIndex

integer

شاخص ستون مختصات.

Other با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

رنگ

سبک رنگ

نوع رنگ قالب

تراز افقی

قالب متن

پیوند

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

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

وضعیت اجرای داده

وضعیت اجرای داده

کد خطای اجرای داده

مقدار توسعه‌یافته

مقدار خطا

نوع خطا

شرط بولی

نوع وضعیت

شرط مقدار

تاریخ نسبی

گریدرنج

مرتب‌سازی

مشخصات فیلتر

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

مرتب‌سازی

موقعیت شیء جاسازی‌شده

موقعیت روی هم قرار دادن

مختصات شبکه‌ای

Other