צבע
צבע במרחב הצבעים 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
|
כמות הצבע האדום בצבע כערך בטווח [0, 1]. |
green
|
כמות הצבע הירוק כערך בערך במרווח [0, 1]. |
blue
|
כמות הצבע הכחול כערך בערך במרווח [0, 1]. |
alpha
|
החלק של הצבע שיש להחיל על הפיקסל. כלומר, צבע הפיקסל הסופי מוגדר על ידי המשוואה:
המשמעות היא שהערך 1.0 מייצג צבע אחיד, ואילו ערך 0.0 מייצג צבע שקוף לחלוטין. אפשרות זו משתמשת בהודעת wrapper ולא בסקלרי צף פשוט, כדי שניתן יהיה להבחין בין ערך ברירת מחדל לבין הערך שלא מוגדר. אם לא צוין, אובייקט הצבע הזה מעובד כצבע מלא (כאילו לערך האלפא ניתן באופן מפורש ערך 1.0). |
ColorStyle
ערך צבע.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
kind . סוג ערך הצבע.
kind
יכול להיות רק אחד מהבאים:
|
|
rgbColor
|
צבע RGB. באופן כללי, אין תמיכה בערך של |
themeColor
|
צבע העיצוב. |
ThemeColorType
סוגי הצבעים של העיצוב.
SpreadsheetProperties
מכילים SpreadsheetTheme
שמגדיר מיפוי של סוגי צבע העיצוב האלה לצבעי בטון.
טיפוסים בני מנייה (enums) | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
לא צוין צבע עיצוב |
TEXT
|
מייצג את הצבע הראשי של הטקסט |
BACKGROUND
|
מייצג את צבע הרקע הראשי |
ACCENT1
|
מייצג את הצבע המשני הראשון |
ACCENT2
|
מייצג את הצבע המשני השני |
ACCENT3
|
מייצג את הצבע המשני השלישי |
ACCENT4
|
מייצג את הצבע המשני הרביעי |
ACCENT5
|
מייצג את הצבע המשני החמישי |
ACCENT6
|
מייצג את הצבע המשני השישי |
LINK
|
מייצג את הצבע של היפר-קישורים |
HorizontalAlign
היישור האופקי של טקסט בתא.
טיפוסים בני מנייה (enums) | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
היישור האופקי לא צוין. אין להשתמש בזה. |
LEFT
|
הטקסט מיושר במפורש לשמאל התא. |
CENTER
|
הטקסט מיושר במפורש למרכז התא. |
RIGHT
|
הטקסט מיושר במפורש לשמאל התא. |
TextFormat
הפורמט של רצף טקסט בתא. ערכים חסרים מציינים שהשדה לא צוין.
ייצוג JSON |
---|
{ "foregroundColor": { object ( |
שדות | |
---|---|
foregroundColor
|
הצבע הקדמי של הטקסט. הוצא משימוש: יש להשתמש
ב- |
foregroundColorStyle
|
הצבע הקדמי של הטקסט. אם גם
|
fontFamily
|
משפחת הגופנים. |
fontSize
|
גודל הגופן. |
bold
|
True אם הטקסט מודגש. |
italic
|
True אם הטקסט נטוי. |
strikethrough
|
True אם בטקסט יש קו חוצה. |
underline
|
True אם הטקסט מסומן בקו תחתון. |
link
|
יעד הקישור של הטקסט, אם יש כזה. הגדרת שדה הקישור בתוך
|
קישור
קובץ עזר חיצוני או מקומי.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
destination . יעד הקישור.
destination
יכול להיות רק אחד מהבאים:
|
|
uri
|
מזהה הקישור. |
DataSourceColumn
עמודה במקור נתונים.
ייצוג JSON |
---|
{
"reference": {
object (
|
שדות | |
---|---|
reference
|
ההפניה לעמודה. |
formula
|
הנוסחה של העמודה המחושבת. |
DataSourceColumnReference
מזהה ייחודי שמפנה לעמודה של מקור נתונים.
ייצוג JSON |
---|
{ "name": string } |
שדות | |
---|---|
name
|
השם המוצג של העמודה. המזהה צריך להיות ייחודי במקור נתונים. |
DataExecutionStatus
סטטוס ביצוע הנתונים.
המערכת יוצרת הפעלה של נתונים כדי לסנכרן אובייקט של מקור נתונים עם הנתונים העדכניים ביותר מ-DataSource
. בדרך כלל היא מתוזמנת לפעול ברקע. אפשר לבדוק
state
כדי לדעת אם הפעלה הושלמה
יש מספר תרחישים שבהם מופעלת הפעלה של נתונים:
-
Adding a data source
יוצרת גיליון משויך של מקור נתונים וגם הפעלה של נתונים כדי לסנכרן את הנתונים ממקור הנתונים לגיליון. -
הפונקציה
Updating a data source
יוצרת הפעלת נתונים כדי לרענן את הגיליון של מקור הנתונים המשויך באופן דומה. -
אפשר לשלוח
refresh request
כדי לרענן באופן מפורש אובייקט מקור נתונים אחד או יותר.
ייצוג JSON |
---|
{ "state": enum ( |
שדות | |
---|---|
state
|
מצב ביצוע הנתונים. |
errorCode
|
קוד השגיאה. |
errorMessage
|
הודעת השגיאה, שעשויה להיות ריקה. |
lastRefreshTime
|
קבלת השעה שבה הנתונים רועננו לאחרונה. |
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 . סוג הערך בתא. אם לא מגדירים שדה, התא לא יכלול נתונים.
value
יכול להיות רק אחד מהבאים:
|
|
numberValue
|
מייצג ערך כפול. הערה: תאריכים, שעות ו-DateTimes מיוצגים ככפולים בפורמט
|
stringValue
|
מייצג ערך מחרוזת. ציטוטים יחידים מובילים לא נכללים. לדוגמה, אם המשתמש הקליד
|
boolValue
|
מייצג ערך בוליאני. |
formulaValue
|
מייצג נוסחה. |
errorValue
|
מייצג שגיאה. השדה הזה הוא לקריאה בלבד. |
ErrorValue
שגיאה בתא.
ייצוג JSON |
---|
{
"type": enum (
|
שדות | |
---|---|
type
|
סוג השגיאה. |
message
|
הודעה עם מידע נוסף על השגיאה (בלוקאל של הגיליון האלקטרוני). |
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 ( |
שדות | |
---|---|
type
|
סוג התנאי. |
values[]
|
הערכים של התנאי. מספר הערכים הנתמכים תלוי בשדה |
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 . הערך של התנאי, צריך להגדיר בדיוק אחד.
value
יכול להיות רק אחד מהבאים:
|
|
relativeDate
|
תאריך יחסי (על סמך התאריך הנוכחי). תקף רק אם
תאריכים יחסיים אינם נתמכים באימות נתונים. הם נתמכים רק בעיצוב מותנה ובמסננים מותנה. |
userEnteredValue
|
הערך שעליו מבוסס התנאי. הערך מנותח כאילו המשתמש הזין בתא. יש תמיכה בנוסחאות (והן צריכות להתחיל ב-
|
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
|
הגיליון שבו הטווח הזה נמצא. |
startRowIndex
|
השורה הראשונה (כולל) של הטווח, או לא מוגדרת אם היא לא מוגבלת. |
endRowIndex
|
השורה האחרונה (לא בלעדית) של הטווח, או שאינה מוגדרת אם אין גבולות. |
startColumnIndex
|
העמודה הראשונה (כולל) של הטווח, או לא מוגדרת אם היא לא מוגבלת. |
endColumnIndex
|
עמודת הסיום (בלעדית) של הטווח, או שאינה מוגדרת אם אין גבולות. |
SortOrder
סדר מיון.
טיפוסים בני מנייה (enums) | |
---|---|
SORT_ORDER_UNSPECIFIED
|
ערך ברירת המחדל, אין להשתמש בו. |
ASCENDING
|
מיון בסדר עולה. |
DESCENDING
|
מיון בסדר יורד. |
FilterSpec
הקריטריונים של הסינון שמשויכים לעמודה מסוימת.
ייצוג JSON |
---|
{ "filterCriteria": { object ( |
שדות | |
---|---|
filterCriteria
|
הקריטריונים של העמודה. |
שדה איחוד
reference . הפניה לעמודה שסוננה.
reference
יכול להיות רק אחד מהבאים:
|
|
columnIndex
|
אינדקס העמודות המבוסס על אפס. |
dataSourceColumnReference
|
הפניה לעמודה של מקור נתונים. |
FilterCriteria
קריטריונים להצגה/הסתרה של שורות בתצוגת מסנן או מסנן.
ייצוג JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
שדות | |
---|---|
condition
|
תנאי שחייב להתקיים כדי שהערכים יוצגו. (הפעולה הזו לא מבטלת את
|
visibleBackgroundColor
|
צבע המילוי של הרקע שלפיו רוצים לסנן; מוצגים רק תאים עם צבע מילוי זה. בלעדי הדדית עם
|
visibleBackgroundColorStyle
|
צבע המילוי של הרקע שלפיו רוצים לסנן; מוצגים רק תאים עם צבע מילוי זה. השדה הזה בלעדי ל- |
visibleForegroundColor
|
צבע החזית שלפיו רוצים לסנן. יוצגו רק תאים עם צבע החזית הזה. בלעדי הדדית עם
|
visibleForegroundColorStyle
|
צבע החזית שלפיו רוצים לסנן. יוצגו רק תאים עם צבע החזית הזה. השדה הזה בלעדי ל- |
SortSpec
סדר מיון שמשויך לעמודה או לשורה ספציפית.
ייצוג JSON |
---|
{ "sortOrder": enum ( |
שדות | |
---|---|
sortOrder
|
נתוני הסדר צריכים להיות ממוינים. |
foregroundColor
|
צבע החזית שלפיו רוצים למיין. תאים עם צבע החזית הזה ממוינים למעלה. בלעדי הדדית עם
|
foregroundColorStyle
|
צבע החזית שלפיו רוצים למיין. תאים עם צבע החזית הזה ממוינים למעלה. בלעדי בו-זמנית עם
|
backgroundColor
|
צבע המילוי של הרקע שלפיו רוצים למיין. תאים עם צבע מילוי זה ממוינים למעלה. בלעדי הדדית עם
|
backgroundColorStyle
|
צבע המילוי של הרקע שלפיו רוצים למיין. תאים עם צבע מילוי זה ממוינים למעלה. בלעדי בו-זמנית עם
|
שדה איחוד
reference . הפניה למאפיין הממוין.
reference
יכול להיות רק אחד מהבאים:
|
|
dimensionIndex
|
המאפיין שעליו יש להחיל את המיון. |
dataSourceColumnReference
|
הפניה לעמודה של מקור נתונים. |
EmbeddedObjectPosition
המיקום של אובייקט מוטמע, כמו תרשים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
location . מיקום האובייקט. יש להגדיר ערך אחד בדיוק.
location
יכול להיות רק אחד מהבאים:
|
|
sheetId
|
הגיליון שבו נמצאים. יש להגדיר רק אם האובייקט המוטמע נמצא בגיליון משלו. חייב להיות מספר לא שלילי. |
overlayPosition
|
המיקום שבו האובייקט מוצב בשכבת-על על רשת. |
newSheet
|
אם הערך הוא True, האובייקט המוטמע יוצב בגיליון חדש שהמזהה שלו נבחר עבורכם. משמש רק לכתיבה. |
OverlayPosition
המיקום של אובייקט בשכבת-על מעל לרשת.
ייצוג JSON |
---|
{
"anchorCell": {
object (
|
שדות | |
---|---|
anchorCell
|
התא שאליו האובייקט מעוגן. |
offsetXPixels
|
ההיסט האופקי, בפיקסלים, שבו האובייקט מתקזז מתא העוגן. |
offsetYPixels
|
ההיסט האנכי, בפיקסלים, שבו האובייקט מתקזז מתא העוגן. |
widthPixels
|
רוחב האובייקט, בפיקסלים. ברירת המחדל היא 600. |
heightPixels
|
גובה האובייקט, בפיקסלים. ברירת המחדל היא 371. |
GridCoordinate
קואורדינטה בגיליון. כל האינדקסים מבוססים על אפסים.
ייצוג JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
שדות | |
---|---|
sheetId
|
הגיליון שבו נמצאת הקואורדינטות. |
rowIndex
|
אינדקס השורה של הקואורדינטה. |
columnIndex
|
אינדקס העמודה של הקואורדינטה. |