נתונים סלולריים
נתונים על תא ספציפי.
ייצוג JSON |
---|
{ "userEnteredValue": { object ( |
שדות | |
---|---|
userEnteredValue
|
הערך שהמשתמש הזין בתא, למשל,
|
effectiveValue
|
הערך בפועל של התא. בתאים עם הנוסחאות, זהו הערך המחושב. בתאים עם ליטרלים, זה זהה ל-userEnteredValue. השדה הזה הוא לקריאה בלבד. |
formattedValue
|
ערך העיצוב של התא. זהו הערך כפי שהוא מוצג למשתמש. השדה הזה הוא לקריאה בלבד. |
userEnteredFormat
|
הפורמט שהמשתמש הזין בתא. בזמן הכתיבה, הפורמט החדש ימוזג עם הפורמט הקיים. |
effectiveFormat
|
העיצוב הפעיל של התא. כולל התוצאות של החלת כל עיצוב מותנה, ואם התא מכיל נוסחה, פורמט המספר המחושב. אם הפורמט בפועל הוא פורמט ברירת המחדל, הפורמט היעיל לא יכתב. השדה הזה הוא לקריאה בלבד. |
hyperlink
|
היפר-קישור שהתא הזה מפנה אליו, אם יש כזה. אם התא מכיל מספר היפר-קישורים, השדה הזה יהיה ריק. השדה הזה הוא לקריאה בלבד. כדי להגדיר אותה, צריך להשתמש בנוסחה |
note
|
כל הערה בתא. |
textFormatRuns[]
|
הפעלות של טקסט עשיר המוחל על קטעי משנה של התא. ההפעלות תקפות רק במחרוזות שהמשתמשים מזינים, ולא בנוסחאות, בבוליאניים או במספרים. מאפיינים של ריצה מתחילים באינדקס ספציפי בטקסט וממשיכים עד ההפעלה הבאה. הפעלות יירשו את מאפייני התא, אלא אם הם שונו במפורש.
כשכותבים נתונים חדשים, ההפעלות החדשות יחליפו את כל ההפעלות הקודמות. כשכותבים
|
dataValidation
|
כלל אימות נתונים בתא, אם קיים. בכתיבה, הכלל החדש לאימות נתונים יחליף כל כלל קודם. |
pivotTable
|
טבלת צירים מעוגנת לתא זה. הגודל של טבלת הצירים עצמה מחושב באופן דינמי על סמך הנתונים, הקיבוץ, המסננים, הערכים וכו'. רק התא השמאלי העליון של טבלת הצירים מכיל את ההגדרה של טבלת הצירים. התאים האחרים יכילו את הערכים המחושבים של תוצאות הצירים בשדות |
dataSourceTable
|
טבלה של מקור נתונים מעוגנת בתא הזה. הגודל של טבלת מקור הנתונים עצמה מחושב באופן דינמי על סמך התצורה שלה. רק התא הראשון בטבלה של מקור הנתונים מכיל את ההגדרה של הטבלה של מקור הנתונים. התאים האחרים יכילו את הערכים לתצוגה של התוצאה בטבלה של מקור הנתונים בשדות |
dataSourceFormula
|
פלט בלבד. מידע על נוסחה של מקור נתונים בתא. השדה הזה מוגדר אם
|
תא
הפורמט של תא.
ייצוג JSON |
---|
{ "numberFormat": { object ( |
שדות | |
---|---|
numberFormat
|
פורמט שמתאר את אופן לייצג ערכי מספרים למשתמש. |
backgroundColor
|
צבע הרקע של התא. הוצאה משימוש: |
backgroundColorStyle
|
צבע הרקע של התא. אם הערך
|
borders
|
גבולות התא. |
padding
|
המרווח הפנימי של התא. |
horizontalAlignment
|
היישור האופקי של הערך בתא. |
verticalAlignment
|
היישור האנכי של הערך בתא. |
wrapStrategy
|
אסטרטגיית האריזה של הערך בתא. |
textDirection
|
כיוון הטקסט בתא. |
textFormat
|
הפורמט של הטקסט בתא (אלא אם בוטלה על ידי פורמט). הגדרה של קישור ברמת התא כאן מנקה את הקישורים הקיימים של התא. הגדרת שדה הקישור
ב- |
hyperlinkDisplayType
|
אם קיים היפר-קישור, כך הוא אמור להופיע בתא. |
textRotation
|
הסבב הוחל על הטקסט בתא. |
פורמט מספר
פורמט המספר של תא.
ייצוג JSON |
---|
{
"type": enum (
|
שדות | |
---|---|
type
|
הסוג של פורמט המספר. צריך לכתוב את השדה הזה בזמן הכתיבה. |
pattern
|
מחרוזת של קו ביטול נעילה המשמשת לעיצוב. אם המדיניות לא מוגדרת, ייעשה שימוש בדפוס ברירת מחדל שמבוסס על הלוקאל של המשתמש, אם יש צורך בסוג הנתון. למידע נוסף על תבניות נתמכות, אפשר לעיין במדריך לפורמטים של תאריכים ומספרים. |
סוג פורמט
פורמט המספר של התא. במסמך הזה ההנחה היא שהלוקאל הוא en_US, אבל הפורמט בפועל תלוי במקום של הגיליון האלקטרוני.
טיפוסים בני מנייה (enum) | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED
|
פורמט המספר לא צוין והוא מבוסס על תוכן התא. אין להשתמש במפורש. |
TEXT
|
עיצוב טקסט, לדוגמה
1000.12
|
NUMBER
|
עיצוב מספר, למשל 1,000.12
|
PERCENT
|
פורמט העיצוב, למשל 10.12%
|
CURRENCY
|
עיצוב המטבע, למשל $1,000.12
|
DATE
|
עיצוב תאריך, למשל
9/26/2008
|
TIME
|
עיצוב השעה, למשל
3:59:00 PM
|
DATE_TIME
|
פורמט תאריך ושעה, לדוגמה
9/26/08 15:59:00
|
SCIENTIFIC
|
עיצוב מספרים מדעיים, לדוגמה
1.01E+03
|
גבולות
גבולות התא.
ייצוג JSON |
---|
{ "top": { object ( |
שדות | |
---|---|
top
|
הגבול העליון של התא. |
bottom
|
הגבול התחתון של התא. |
left
|
הגבול השמאלי של התא. |
right
|
הגבול הימני של התא. |
סקוטיש בורדרס
גבול לאורך תא.
ייצוג JSON |
---|
{ "style": enum ( |
שדות | |
---|---|
style
|
סגנון הגבול. |
width
|
רוחב הגבול, בפיקסלים. הוצא משימוש. הרוחב נקבע באמצעות השדה "סגנון". |
color
|
צבע הגבול. הוצאה משימוש: |
colorStyle
|
צבע הגבול. אם הערך
|
סגנון
סגנון של גבול.
טיפוסים בני מנייה (enum) | |
---|---|
STYLE_UNSPECIFIED
|
הסגנון לא צוין. אין להשתמש באפשרות הזו. |
DOTTED
|
הגבול מקווקו. |
DASHED
|
הגבול מקווקו. |
SOLID
|
הגבול הוא קו רצוף דק. |
SOLID_MEDIUM
|
הגבול הוא קו רצוף בינוני. |
SOLID_THICK
|
הגבול הוא קו רצוף עבה. |
NONE
|
ללא גבול. משמש רק כשמעדכנים גבול כדי למחוק אותו. |
DOUBLE
|
הגבול הוא שתי שורות רצופות. |
מרווח
כמות המרווח הפנימי שמסביב לתא, בפיקסלים. כשמעדכנים את המרווח הפנימי, יש לציין כל שדה.
ייצוג JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
שדות | |
---|---|
top
|
המרווח העליון של התא. |
right
|
המרווח הפנימי של התא. |
bottom
|
המרווח הפנימי התחתון של התא. |
left
|
המרווח הפנימי של התא. |
יישור אנכי
היישור האנכי של הטקסט בתא.
טיפוסים בני מנייה (enum) | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
לא צוינה יישור אנכי. אין להשתמש באפשרות הזו. |
TOP
|
הטקסט מיושר באופן מפורש לחלק העליון של התא. |
MIDDLE
|
הטקסט מיושר באופן מפורש לאמצע התא. |
BOTTOM
|
הטקסט מיושר באופן מפורש לחלק התחתון של התא. |
אסטרטגיית אריזה
כיצד לעטוף טקסט בתא.
טיפוסים בני מנייה (enum) | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
ערך ברירת המחדל, אין להשתמש בו. |
OVERFLOW_CELL
|
קווים שאורכם עולה על רוחב התא נכתבים בתא הבא, כל עוד התא ריק. אם התא הבא לא ריק, ההתנהגות שלו תהיה זהה לזו של
|
LEGACY_WRAP
|
אסטרטגיית האריזה הזו מייצגת את אסטרטגיית גלישת הנתונים הישנה של Google Sheets, שבה מתבצעת חיתוך של מילים ארוכות יותר מאשר קו. האסטרטגיה הזו לא נתמכת בכל הפלטפורמות, ואנחנו מוציאים אותה משימוש. דוגמה:
|
CLIP
|
קווים שאורכם יהיה יותר מרוחב התא ייחתכו. הטקסט לעולם לא יגלוש לשורה הבאה, אלא אם המשתמש יוסיף שורה חדשה באופן ידני. דוגמה:
|
WRAP
|
מילים שאורכן עולה על שורה עוטפות ברמת התו, ולא נחתכות. דוגמה:
|
כיוון טקסט
כיוון הטקסט בתא.
טיפוסים בני מנייה (enum) | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
כיוון הטקסט לא צוין. אין להשתמש באפשרות הזו. |
LEFT_TO_RIGHT
|
כיוון הטקסט משמאל לימין הוגדר על ידי המשתמש. |
RIGHT_TO_LEFT
|
כיוון הטקסט הוגדר מימין לשמאל על ידי המשתמש. |
היפר-קישור של סוג התצוגה
האם לעבד היפר-קישור באופן מפורש. אם לא צוין אחרת, ההיפר-קישור מקושר.
טיפוסים בני מנייה (enum) | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
ערך ברירת המחדל: ההיפר-קישור עבר עיבוד. אין להשתמש באפשרות הזו. |
LINKED
|
יש לעבד היפר-קישור באופן מפורש. |
PLAIN_TEXT
|
אין לעבד היפר-קישור. |
סיבוב טקסט
הסבב מופעל על טקסט בתא.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
type . סוג הסבב, האנכי או הזווית.
type
יכול להיות רק אחד מהבאים:
|
|
angle
|
הזווית בין הכיוון הרגיל לבין הכיוון הרצוי. נמדד במעלות. הערכים החוקיים הם בין 90- ל-90. זוויות חיוביות נוטות כלפי מעלה, זווית שלילית מופנית כלפי מטה. הערה: בכיוון הטקסט של LTR, הזווית החיובית היא בכיוון השעון, בעוד של-RTL היא בכיוון השעון |
vertical
|
אם True, הטקסט מוקרא מלמעלה למטה, אבל הכיוון של תווים בודדים אינו משתנה. לדוגמה:
|
TextFormatRun
ריצה בפורמט טקסט. הפורמט של ההפעלה הזו נמשך עד שאינדקס ההתחלה של ההפעלה הבאה מתחיל. צריך לעדכן את כל השדות.
ייצוג JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
שדות | |
---|---|
startIndex
|
אינדקס תווים מבוסס אפס שבו מתחילה הריצה הזו, ביחידות קוד UTF-16. |
format
|
הפורמט של הריצה הזו. ערכים חסרים יורשים את הפורמט של התא. |
כלל לאימות נתונים
כלל לאימות נתונים.
ייצוג JSON |
---|
{
"condition": {
object (
|
שדות | |
---|---|
condition
|
התנאי חייב להתאים לתנאי התא. |
inputMessage
|
הודעה שמוצגת למשתמשים כשמוסיפים נתונים לתא. |
strict
|
הערך הוא True אם יש לדחות נתונים לא חוקיים. |
showCustomUi
|
הערך הוא True אם יש להתאים אישית את ממשק המשתמש בהתאם לסוג המצב. אם True, התנאים של "רשימה" יציגו תפריט נפתח. |
טבלה של מקור הנתונים
טבלה של מקור נתונים, שמאפשרת למשתמש לייבא ל-Sheets טבלת נתונים סטטית מתוך
DataSource
. הפעולה הזו נקראת גם "חילוץ" בעורך ה-Sheets.
ייצוג JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
שדות | |
---|---|
dataSourceId
|
המזהה של מקור הנתונים שאליו משויכת הטבלה של מקורות הנתונים. |
columnSelectionType
|
הסוג שבו יש לבחור עמודות לטבלת הנתונים. ברירת המחדל היא
|
columns[]
|
העמודות שנבחרו עבור הטבלה של מקור הנתונים. הערך של
|
filterSpecs[]
|
מפרטי הסינון בטבלה של מקור הנתונים. |
sortSpecs[]
|
למיין מפרטים בטבלה של מקור הנתונים. התוצאה של הטבלה של מקור הנתונים ממוינת לפי מפרטי המיון לפי הסדר. |
rowLimit
|
מגבלת השורות שיש להחזיר. אם המדיניות לא מוגדרת, חלה מגבלת ברירת מחדל. מידע על מגבלת ברירת המחדל ועל המגבלה המקסימלית מופיעים בעורך Sheets. |
dataExecutionStatus
|
פלט בלבד. סטטוס ביצוע הנתונים. |
סוג מקור הנתוניםTableColumn
סוגי העמודות שנבחרו בטבלה של מקור הנתונים.
טיפוסים בני מנייה (enum) | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
סוג ברירת המחדל לבחירת עמודה, לא להשתמש. |
SELECTED
|
בחירת העמודות לפי השדה columns .
|
SYNC_ALL
|
סנכרון כל העמודות הנוכחיות והעתידיות במקור הנתונים. אם היא מוגדרת, טבלת מקור הנתונים מאחזרת את כל העמודות במקור הנתונים בזמן הרענון. |
נוסחת מקור הנתונים
נוסחה של מקור נתונים.
ייצוג JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
שדות | |
---|---|
dataSourceId
|
המזהה של מקור הנתונים שאליו הנוסחה משויכת. |
dataExecutionStatus
|
פלט בלבד. סטטוס ביצוע הנתונים. |