Other

צבע

מייצג צבע במרחב הצבעים RGBA. הייצוג הזה נועד לאפשר פשטות המרה אל ומתוך ייצוגי צבע בשפות שונות, על-פני קומפקטיות. לדוגמה, ניתן לספק את השדות של הייצוג הזה באופן טריוויאלי ל-constructor של java.awt.Color ב-Java; אפשר לספק אותו גם באופן טריוויאלי +colorWithRed:green:blue:alpha method ב-iOS; ובמאמץ קטן, אפשר לעצב אותו בקלות rgba() ב-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 שמגדיר מיפוי של סוגי צבעי העיצוב האלה לצבעי בטון.

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

HorizontalAlign

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

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

ספירה של מצבי הפעלת נתונים.

טיפוסים בני מנייה (enum)
DATA_EXECUTION_STATE_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
NOT_STARTED הפעלת הנתונים לא התחילה.
RUNNING הפעלת הנתונים התחילה ופועלת.
CANCELLING הפעלת הנתונים מבוטלת עכשיו.
SUCCEEDED הפעלת הנתונים הסתיימה בהצלחה.
FAILED הפעלת הנתונים הסתיימה עם שגיאות.

DataExecutionErrorCode

ספירה של קוד שגיאה בביצוע נתונים.

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

מייצג ערך כפול. הערה: תאריכים, שעות ו-DateTime מיוצגים ככפולים ב- 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

סוג השגיאה.

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

סוג התנאי.

טיפוסים בני מנייה (enum)
CONDITION_TYPE_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
NUMBER_GREATER ערך התא צריך להיות גדול מהערך של התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
NUMBER_GREATER_THAN_EQ ערך התא צריך להיות גדול מהערך של התנאי או שווה לו. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
NUMBER_LESS ערך התא צריך להיות קטן מערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
NUMBER_LESS_THAN_EQ ערך התא צריך להיות קטן מערך התנאי או שווה לו. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
NUMBER_EQ ערך התא חייב להיות שווה לערך של התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue לאימות נתונים, לעיצוב מותנה ולמסננים של אובייקטים שאינם מסוג מקור נתונים, ולפחות אובייקט אחד ConditionValue למסננים של אובייקטים של מקור הנתונים.
NUMBER_NOT_EQ הערך בתא לא יכול להיות שווה לערך של התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue לאימות נתונים, לעיצוב מותנה ולמסננים של אובייקטים שאינם מסוג מקור נתונים, ולפחות אובייקט אחד ConditionValue למסננים של אובייקטים של מקור הנתונים.
NUMBER_BETWEEN ערך התא צריך להיות בין שני ערכי התנאים. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשים בדיוק שניים ConditionValues
NUMBER_NOT_BETWEEN ערך התא לא יכול להיות בין שני ערכי התנאים. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשים בדיוק שניים ConditionValues
TEXT_CONTAINS ערך התא צריך להכיל את ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
TEXT_NOT_CONTAINS ערך התא לא יכול להכיל את ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
TEXT_STARTS_WITH ערך התא צריך להתחיל בערך של התנאי. נתמך על ידי עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
TEXT_ENDS_WITH ערך התא חייב להסתיים בערך התנאי. נתמך על ידי עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue
TEXT_EQ ערך התא צריך להיות בדיוק ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue לאימות נתונים, לעיצוב מותנה ולמסננים של אובייקטים שאינם מסוג מקור נתונים, ולפחות אובייקט אחד ConditionValue למסננים של אובייקטים של מקור הנתונים.
TEXT_IS_EMAIL הערך בתא חייב להיות כתובת אימייל חוקית. נתמכת על ידי אימות נתונים. לא נדרש ConditionValues
TEXT_IS_URL ערך התא חייב להיות כתובת URL חוקית. נתמך על ידי אימות נתונים. לא נדרש ConditionValues
DATE_EQ ערך התא צריך להיות זהה לתאריך של ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue לאימות נתונים, לעיצוב מותנה ולמסננים של אובייקטים שאינם מסוג מקור נתונים, ולפחות אובייקט אחד ConditionValue למסננים של אובייקטים של מקור הנתונים.
DATE_BEFORE ערך התא צריך להיות לפני התאריך של ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue שיכול להיות relative date.
DATE_AFTER ערך התא צריך להיות אחרי התאריך של ערך התנאי. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. נדרשת בדיקה אחת ConditionValue שיכול להיות relative date.
DATE_ON_OR_BEFORE ערך התא צריך להיות זהה לתאריך של הערך של התנאי או מוקדם ממנו. נתמכת על ידי אימות נתונים. נדרשת בדיקה אחת ConditionValue שיכול להיות relative date.
DATE_ON_OR_AFTER ערך התא צריך להיות זהה לתאריך של הערך של התנאי או מאוחר ממנו. נתמכת על ידי אימות נתונים. נדרשת בדיקה אחת ConditionValue שיכול להיות relative date.
DATE_BETWEEN ערך התא צריך להיות בין התאריכים של שני ערכי התנאים. נתמכת על ידי אימות נתונים. נדרשים בדיוק שניים ConditionValues
DATE_NOT_BETWEEN ערך התא צריך להיות מחוץ לתאריכים של שני ערכי התנאים. נתמכת על ידי אימות נתונים. נדרשים בדיוק שניים ConditionValues
DATE_IS_VALID ערך התא חייב להיות תאריך. נתמכת על ידי אימות נתונים. לא נדרש ConditionValues
ONE_OF_RANGE ערך התא צריך להופיע ברשת בטווח של ערך התנאי. נתמכת על ידי אימות נתונים. נדרשת בדיקה אחת ConditionValue, והערך חייב להיות טווח חוקי בסימון A1.
ONE_OF_LIST ערך התא צריך להיכלל ברשימת ערכי התנאים. נתמכת על ידי אימות נתונים. תומך בכל מספר של condition values, אחד לכל פריט ברשימה. הערכים לא נתמכים בנוסחאות.
BLANK צריך להשאיר את ערך התא ריק. נתמך על ידי עיצוב מותנה ומסננים. לא נדרש ConditionValues
NOT_BLANK ערך התא לא יכול להיות ריק. נתמך על ידי עיצוב מותנה ומסננים. לא נדרש ConditionValues
CUSTOM_FORMULA הנוסחה של התנאי חייבת לקבל את הערך True. נתמך באמצעות אימות נתונים, עיצוב מותנה ומסננים. לא נתמך על ידי המסננים בגיליון של מקור הנתונים. נדרשת בדיקה אחת ConditionValue
BOOLEAN הערך של התא צריך להיות TRUE/FALSE או ברשימת ערכי התנאים. נתמכת על ידי אימות נתונים. מוצג כתיבת סימון של תא. אפשר להזין אפס, אחד או שניים ConditionValues אין ערכים מציינים שהתא חייב להיות TRUE או FALSE, כאשר TRUE מוצג כמסומן ו-FALSE מוצג כלא מסומן. ערך אחד מציין שהתא יוצג כמסומן כשהוא מכיל את הערך הזה ולא מסומן כשהוא ריק. שני ערכים מציינים שהתא יוצג כמסומן כשהוא מכיל את הערך הראשון, ולא מסומן כשהתא מכיל את הערך השני. לדוגמה, הכיתוב ["כן","לא"] מציין שהתא יציג תיבה מסומנת אם הערך שלו הוא 'כן'. ותיבה לא מסומנת כאשר הערך שלה הוא 'לא'.
TEXT_NOT_EQ ערך התא צריך להיות לא ערך התנאי. נתמך על ידי מסננים של אובייקטים במקור הנתונים. נדרשת לפחות אפשרות אחת ConditionValue
DATE_NOT_EQ ערך התא צריך להיות לא ערך התנאי. נתמך על ידי מסננים של אובייקטים במקור הנתונים. נדרשת לפחות אפשרות אחת ConditionValue
FILTER_EXPRESSION הערך של התא צריך להתאים לדפוס שצוין. נדרשת בדיקה אחת ConditionValue

ConditionValue

ערך התנאי.

ייצוג JSON 
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value ערך התנאי, יש להגדיר אחד בלבד. value יכול להיות רק אחת מהאפשרויות הבאות:
relativeDate

enum (RelativeDate)

תאריך יחסי (על סמך התאריך הנוכחי). תקף רק אם type תואם לערך DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE או DATE_ON_OR_AFTER

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

userEnteredValue

string

ערך שהתנאי מבוסס עליו. הערך מנותח כאילו המשתמש הקליד בתא. יש תמיכה בנוסחאות (והן חייבות להתחיל ב = או '+').

RelativeDate

המדיניות הזו קובעת את אופן ההערכה של תנאי מסוג תאריך.

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

סדר מיון.

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

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