דף זה תורגם על ידי Cloud Translation API.

Other

צבע

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

בדף ההפניה הזה אין מידע על מרחב הצבעים המוחלט שיש להשתמש בו כדי לפרש את ערך ה-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 במקום ל-scaler scaler פשוט, כדי שאפשר יהיה להבחין בין ערך ברירת מחדל לערך שאינו מוגדר. אם יושמט, אובייקט הצבע הזה יעובד בצבע אחיד (כאילו ערך האלפא קיבל ערך של 1.0 באופן מפורש).

סגנון עיצוב

ערך צבע.

ייצוג 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)` צבע העיצוב.

שדה איחוד kind. סוג ערך הצבע. kind יכול להיות רק אחד מהבאים:

rgbColor

object (Color)

צבע RGB. הערך alpha באובייקט Color לא נתמך בדרך כלל.

themeColor

enum (ThemeColorType)

צבע העיצוב.

סוג העיצוב

סוגי צבע העיצוב.

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

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

יישור אופקי

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

טיפוסים בני מנייה (enum)
`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` הערך הוא True אם הטקסט מודגש.
`italic`	`boolean` הערך הוא True אם הטקסט נטוי.
`strikethrough`	`boolean` הערך הוא True אם הטקסט מסומן בקו חוצה.
`underline`	`boolean` הערך הוא True אם הטקסט מסומן בקו תחתון.
`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`. }

שדות

שדות
שדה איחוד `destination`. יעד הקישור. `destination` יכול להיות רק אחד מהבאים:
`uri`	`string` מזהה הקישור.

שדה איחוד destination. יעד הקישור. destination יכול להיות רק אחד מהבאים:

uri

string

מזהה הקישור.

DataSourceColumn

עמודה במקור נתונים.

ייצוג JSON
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

שדות

שדות
`reference`	`object (DataSourceColumnReference)` ההפניה לעמודה.
`formula`	`string` הנוסחה של העמודה המחושבת.

reference

object (DataSourceColumnReference)

ההפניה לעמודה.

formula

string

הנוסחה של העמודה המחושבת.

הפניה למקור נתונים

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

ייצוג JSON
{ "name": string }

שדות

שדות
`name`	`string` השם המוצג של העמודה. הוא צריך להיות ייחודי בתוך מקור נתונים.

name

string

השם המוצג של העמודה. הוא צריך להיות ייחודי בתוך מקור נתונים.

סטטוס DataExecution

סטטוס ביצוע הנתונים.

יצירת נתונים נוצרת כדי לסנכרן אובייקט של מקור נתונים עם הנתונים העדכניים ביותר של 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)` מקבל את זמן הרענון האחרון של הנתונים.

מצב ExecutionState

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

טיפוסים בני מנייה (enum)
`DATA_EXECUTION_STATE_UNSPECIFIED`	ערך ברירת המחדל, לא להשתמש.
`NOT_STARTED`	הפעלת הנתונים לא התחילה.
`RUNNING`	הפעלת הנתונים התחילה ופועלת.
`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`	מפרט האובייקט של מקור הנתונים לא חוקי.

ערך מורחב

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

ייצוג 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`. סוג הערך בתא. אם לא הוגדר שדה, אין בתא נתונים. `value` יכול להיות רק אחד מהבאים:
`numberValue`	`number` מייצג ערך כפול. הערה: תאריכים, שעות ותאריכים מוצגים כמכפילים בפורמט `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

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

סוג השגיאה

סוג השגיאה.

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

ערך בוליאני

תנאי שיכול להעריך את הערך True או False. 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 יש תמיכה במספר שרירותי של ערכים.

סוג תנאי

סוג התנאי.

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

ערך תנאי

הערך של התנאי.

ייצוג 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` ערך שעליו מבוסס התנאי. המערכת מנתחת את הערך כאילו המשתמש הקליד בתא. הנוסחאות נתמכות (וחייבות להתחיל ב-`=` או ב-'+').

שדה איחוד value. הערך של התנאי, חייב להיות מוגדר בדיוק. value יכול להיות רק אחד מהבאים:

relativeDate

enum (RelativeDate)

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

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

userEnteredValue

string

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

תאריך יחסי

קביעת האופן שבו תנאי תאריך מוערך.

טיפוסים בני מנייה (enum)
`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` עמודת הסיום (לא כולל) של הטווח, או לא הוגדרה, אם היא לא מוגבלת.

SortOrder

סדר המיון.

טיפוסים בני מנייה (enum)
`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`. הפניה לעמודה המסוננת. `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)` התנאי חייב להתקיים כדי שהערכים יוצגו. (פעולה זו לא מבטלת את `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.
}

שדות
שדה איחוד `location`. מיקום האובייקט. יש להגדיר ערך אחד בלבד. `location` יכול להיות רק אחד מהבאים:
`sheetId`	`integer` הגיליון בגיליון הנוכחי. הגדרה רק אם האובייקט המוטמע נמצא בגיליון משלו. חייב להיות מספר לא שלילי.
`overlayPosition`	`object (OverlayPosition)` המיקום שבו האובייקט מוצב על רשת.
`newSheet`	`boolean` אם True, האובייקט המוטמע מוצב בגיליון חדש שהמזהה שלו נבחר עבורכם. לשימוש רק בזמן כתיבה.

מיקום שכבת-על

המיקום מעליו של האובייקט.

ייצוג 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.

ניהול רשת

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

ייצוג JSON
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

שדות

שדות
`sheetId`	`integer` הגיליון שנמצא בקואורדינטות האלה.
`rowIndex`	`integer` אינדקס השורה של הקואורדינטות.
`columnIndex`	`integer` אינדקס העמודות של הקואורדינטות.

sheetId

integer

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

rowIndex

integer

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

columnIndex

integer

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