Other

צבע

צבע במרחב הצבעים RGBA. הייצוג הזה נועד לפשט את ההמרה של ייצוגי צבע בשפות שונות על פני קומפקטיות. לדוגמה, אפשר לספק באופן טריוויאלי את השדות של הייצוג הזה ל-builder של java.awt.Color ב-Java. אפשר גם לספק אותם באופן טריוויאלי ל-method +colorWithRed:green:blue:alpha של UIColor ב-iOS. ועם מעט עבודה, אפשר לעצב אותם בקלות למחרוזת rgba() של CSS ב-JavaScript.

דף העזר הזה לא מכיל מידע על מרחב הצבעים המוחלט שצריך להשתמש בו כדי לפרש את ערך ה-RGB. לדוגמה, sRGB, Adobe RGB, DCI-P3 ו-BT.2020. כברירת מחדל, האפליקציות צריכות לקבל את מרחב הצבעים sRGB.

במקרים שבהם צריך לקבוע שוויון צבעים, ההטמעה של שני צבעים, אלא אם צוין אחרת, מתייחסת לשני צבעים כשווים אם כל הערכים של אדום, ירוק, כחול ואלפא נבדלים זה מזה ב-1e-5 לכל היותר.

דוגמה (Java): 

 import com.google.type.Color;

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

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

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

דוגמה (iOS / Obj-C): 

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

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

דוגמה (JavaScript): 

// ...

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

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

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

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

// ...
ייצוג JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
שדות
red

number

כמות הצבע האדום בצבע כערך בטווח [0, 1].

green

number

כמות הצבע הירוק כערך בערך במרווח [0, 1].

blue

number

כמות הצבע הכחול כערך בערך במרווח [0, 1].

alpha

number

החלק של הצבע שיש להחיל על הפיקסל. כלומר, צבע הפיקסל הסופי מוגדר על ידי המשוואה:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

המשמעות היא שהערך 1.0 מייצג צבע אחיד, ואילו ערך 0.0 מייצג צבע שקוף לחלוטין. אפשרות זו משתמשת בהודעת wrapper ולא בסקלרי צף פשוט, כדי שניתן יהיה להבחין בין ערך ברירת מחדל לבין הערך שלא מוגדר. אם לא צוין, אובייקט הצבע הזה מעובד כצבע מלא (כאילו לערך האלפא ניתן באופן מפורש ערך 1.0).

ColorStyle

ערך צבע.

ייצוג JSON 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג ערך הצבע. kind יכול להיות רק אחד מהבאים:
rgbColor

object (Color)

צבע RGB. באופן כללי, אין תמיכה בערך של alpha באובייקט Color.

themeColor

enum (ThemeColorType)

צבע העיצוב.

ThemeColorType

סוגי הצבעים של העיצוב.

SpreadsheetProperties מכילים SpreadsheetTheme שמגדיר מיפוי של סוגי צבע העיצוב האלה לצבעי בטון.

טיפוסים בני מנייה (enums)
THEME_COLOR_TYPE_UNSPECIFIED לא צוין צבע עיצוב
TEXT מייצג את הצבע הראשי של הטקסט
BACKGROUND מייצג את צבע הרקע הראשי
ACCENT1 מייצג את הצבע המשני הראשון
ACCENT2 מייצג את הצבע המשני השני
ACCENT3 מייצג את הצבע המשני השלישי
ACCENT4 מייצג את הצבע המשני הרביעי
ACCENT5 מייצג את הצבע המשני החמישי
ACCENT6 מייצג את הצבע המשני השישי

HorizontalAlign

היישור האופקי של טקסט בתא.

טיפוסים בני מנייה (enums)
HORIZONTAL_ALIGN_UNSPECIFIED היישור האופקי לא צוין. אין להשתמש בזה.
LEFT הטקסט מיושר במפורש לשמאל התא.
CENTER הטקסט מיושר במפורש למרכז התא.
RIGHT הטקסט מיושר במפורש לשמאל התא.

TextFormat

הפורמט של רצף טקסט בתא. ערכים חסרים מציינים שהשדה לא צוין.

ייצוג JSON 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
שדות
foregroundColor
(deprecated)

object (Color)

הצבע הקדמי של הטקסט. הוצא משימוש: יש להשתמש ב-foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

הצבע הקדמי של הטקסט. אם גם foregroundColor מוגדר, השדה הזה מקבל עדיפות.

fontFamily

string

משפחת הגופנים.

fontSize

integer

גודל הגופן.

bold

boolean

True אם הטקסט מודגש.

italic

boolean

True אם הטקסט נטוי.

strikethrough

boolean

True אם בטקסט יש קו חוצה.

underline

boolean

True אם הטקסט מסומן בקו תחתון.

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 הפעלת הנתונים התחילה והיא פועלת.
CANCELLING הפעלת הנתונים מבוטלת כרגע.
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 מפרט האובייקט של מקור הנתונים לא חוקי.
DATA_EXECUTION_CANCELLED הפעלת הנתונים בוטלה.

ExtendedValue

סוגי הערכים שיכולים להיות לתא בגיליון אלקטרוני.

ייצוג JSON 
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. סוג הערך בתא. אם לא מגדירים שדה, התא לא יכלול נתונים. value יכול להיות רק אחד מהבאים:
numberValue

number

מייצג ערך כפול. הערה: תאריכים, שעות ו-DateTimes מיוצגים ככפולים בפורמט SERIAL_NUMBER.

stringValue

string

מייצג ערך מחרוזת. ציטוטים יחידים מובילים לא נכללים. לדוגמה, אם המשתמש הקליד '123 בממשק המשתמש, הן ייוצגו כ-stringValue של "123".

boolValue

boolean

מייצג ערך בוליאני.

formulaValue

string

מייצג נוסחה.

errorValue

object (ErrorValue)

מייצג שגיאה. השדה הזה הוא לקריאה בלבד.

ErrorValue

שגיאה בתא.

ייצוג JSON 
{
  "type": enum (ErrorType),
  "message": string
}
שדות
type

enum (ErrorType)

סוג השגיאה.

message

string

הודעה עם מידע נוסף על השגיאה (בלוקאל של הגיליון האלקטרוני).

ErrorType

סוג השגיאה.

טיפוסים בני מנייה (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....

BooleanCondition

תנאי שיכול לקבל את הערך True או False. תנאים בוליאניים משמשים לעיצוב מותנה, לאימות נתונים ולקריטריונים במסננים.

ייצוג JSON 
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
שדות
type

enum (ConditionType)

סוג התנאי.

values[]

object (ConditionValue)

הערכים של התנאי. מספר הערכים הנתמכים תלוי בשדה condition type. יש תמיכה בערכי אפס, באחרים אפשר להגדיר ערך אחד או שניים, ו-ConditionType.ONE_OF_LIST תומך במספר שרירותי של ערכים.

ConditionType

סוג התנאי.

טיפוסים בני מנייה (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 הנוסחה של התנאי צריכה לקבל את הערך True. נתמך על ידי אימות נתונים, עיצוב מותנה ומסננים. הפעולה לא נתמכת על ידי מסנני הגיליון של מקור הנתונים. נדרש שדה ConditionValue אחד.
BOOLEAN ערך התא חייב להיות TRUE/FALSE או ברשימת ערכי התנאים. נתמכת על ידי אימות נתונים. מוצג כתיבת סימון של תא. אפשר להגדיר תמיכה באפס, אחד או שניים מסוג ConditionValues. אף ערך לא מציין שהתא חייב להיות TRUE או FALSE, כאשר TRUE מעובד כמסומן ו-FALSE מעובד כלא מסומן. ערך אחד מציין שהתא יעובד כמסומן כשהוא מכיל את הערך, ואם הוא לא מסומן, הוא יוצג ללא סימון. שני ערכים מציינים שהתא יוצג כמסומן כשהוא מכיל את הערך הראשון, ולא יוצג כשהוא מכיל את הערך השני. לדוגמה, ["Yes","No"] מציין שהתא יציג תיבה מסומנת כאשר הערך שלה הוא 'Yes' (כן) ותיבה לא מסומנת כשהיא מכילה את הערך No (לא).
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

אינדקס ההתחלה חייב תמיד להיות קטן מאינדקס הסיום, או שווה לו. אם אינדקס ההתחלה שווה לאינדקס הסיום, הטווח ריק. טווחים ריקים בדרך כלל אין משמעות, והם בדרך כלל מעובדים בממשק המשתמש כ-#REF!.

ייצוג JSON 
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
שדות
sheetId

integer

הגיליון שבו הטווח הזה נמצא.

startRowIndex

integer

השורה הראשונה (כולל) של הטווח, או לא מוגדרת אם היא לא מוגבלת.

endRowIndex

integer

השורה האחרונה (לא בלעדית) של הטווח, או שאינה מוגדרת אם אין גבולות.

startColumnIndex

integer

העמודה הראשונה (כולל) של הטווח, או לא מוגדרת אם היא לא מוגבלת.

endColumnIndex

integer

עמודת הסיום (בלעדית) של הטווח, או שאינה מוגדרת אם אין גבולות.

SortOrder

סדר מיון.

טיפוסים בני מנייה (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)

הפניה לעמודה של מקור נתונים.

FilterCriteria

קריטריונים להצגה/הסתרה של שורות בתצוגת מסנן או מסנן.

ייצוג JSON 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
שדות
hiddenValues[]

string

ערכים שצריך להסתיר.

condition

object (BooleanCondition)

תנאי שחייב להתקיים כדי שהערכים יוצגו. (הפעולה הזו לא מבטלת את hiddenValues – אם מופיע שם ערך, הוא עדיין יוסתר).

visibleBackgroundColor
(deprecated)

object (Color)

צבע המילוי של הרקע שלפיו רוצים לסנן; מוצגים רק תאים עם צבע מילוי זה. בלעדי הדדית עם visibleForegroundColor. הוצא משימוש: יש להשתמש ב-visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

צבע המילוי של הרקע שלפיו רוצים לסנן; מוצגים רק תאים עם צבע מילוי זה. השדה הזה בלעדי ל-visibleForegroundColor, וצריך להגדיר אותו כצבע מסוג RGB. אם גם visibleBackgroundColor מוגדר, השדה הזה מקבל עדיפות.

visibleForegroundColor
(deprecated)

object (Color)

צבע החזית שלפיו רוצים לסנן. יוצגו רק תאים עם צבע החזית הזה. בלעדי הדדית עם visibleBackgroundColor. הוצא משימוש: יש להשתמש ב-visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

צבע החזית שלפיו רוצים לסנן. יוצגו רק תאים עם צבע החזית הזה. השדה הזה בלעדי ל-visibleBackgroundColor, וצריך להגדיר אותו כצבע מסוג RGB. אם גם visibleForegroundColor מוגדר, השדה הזה מקבל עדיפות.

SortSpec

סדר מיון שמשויך לעמודה או לשורה ספציפית.

ייצוג JSON 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

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

enum (SortOrder)

נתוני הסדר צריכים להיות ממוינים.

foregroundColor
(deprecated)

object (Color)

צבע החזית שלפיו רוצים למיין. תאים עם צבע החזית הזה ממוינים למעלה. בלעדי הדדית עם backgroundColor. הוצא משימוש: יש להשתמש ב-foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

צבע החזית שלפיו רוצים למיין. תאים עם צבע החזית הזה ממוינים למעלה. בלעדי בו-זמנית עם 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

אם הערך הוא 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

אינדקס העמודה של הקואורדינטה.