Cells

נתונים סלולריים

נתונים על תא ספציפי.

ייצוג JSON 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
שדות
userEnteredValue

object (ExtendedValue)

הערך שהמשתמש הזין בתא, למשל, 1234, 'Hello' או =NOW() הערה: תאריכים, שעות ו-DateTimes מיוצגים ככפולים בפורמט serial number

effectiveValue

object (ExtendedValue)

הערך בפועל של התא. בתאים עם הנוסחאות, זהו הערך המחושב. בתאים עם ליטרלים, זה זהה ל-userEnteredValue. השדה הזה הוא לקריאה בלבד.

formattedValue

string

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

userEnteredFormat

object (CellFormat)

הפורמט שהמשתמש הזין בתא.

בזמן הכתיבה, הפורמט החדש ימוזג עם הפורמט הקיים.

effectiveFormat

object (CellFormat)

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

note

string

כל הערה בתא.

textFormatRuns[]

object (TextFormatRun)

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

כשכותבים נתונים חדשים, ההפעלות החדשות יחליפו את כל ההפעלות הקודמות. כשכותבים userEnteredValue חדש, הפעלות קודמות נמחקות.

dataValidation

object (DataValidationRule)

כלל אימות נתונים בתא, אם קיים.

בכתיבה, הכלל החדש לאימות נתונים יחליף כל כלל קודם.

pivotTable

object (PivotTable)

טבלת צירים מעוגנת לתא זה. הגודל של טבלת הצירים עצמה מחושב באופן דינמי על סמך הנתונים, הקיבוץ, המסננים, הערכים וכו'. רק התא השמאלי העליון של טבלת הצירים מכיל את ההגדרה של טבלת הצירים. התאים האחרים יכילו את הערכים המחושבים של תוצאות הצירים בשדות effectiveValue שלהם.

dataSourceTable

object (DataSourceTable)

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

dataSourceFormula

object (DataSourceFormula)

פלט בלבד. מידע על נוסחה של מקור נתונים בתא. השדה הזה מוגדר אם userEnteredValue היא נוסחה שמתייחסת לגיליון DATA_SOURCE מסוים, למשל =SUM(DataSheet!Column).

תא

הפורמט של תא.

ייצוג JSON 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
שדות
numberFormat

object (NumberFormat)

פורמט שמתאר את אופן לייצג ערכי מספרים למשתמש.

backgroundColor
(deprecated)

object (Color)

צבע הרקע של התא. הוצאה משימוש: backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

גבולות התא.

padding

object (Padding)

המרווח הפנימי של התא.

horizontalAlignment

enum (HorizontalAlign)

היישור האופקי של הערך בתא.

verticalAlignment

enum (VerticalAlign)

היישור האנכי של הערך בתא.

wrapStrategy

enum (WrapStrategy)

אסטרטגיית האריזה של הערך בתא.

textDirection

enum (TextDirection)

כיוון הטקסט בתא.

textFormat

object (TextFormat)

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

textRotation

object (TextRotation)

הסבב הוחל על הטקסט בתא.

פורמט מספר

פורמט המספר של תא.

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

enum (NumberFormatType)

הסוג של פורמט המספר. צריך לכתוב את השדה הזה בזמן הכתיבה.

pattern

string

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

סוג פורמט

פורמט המספר של התא. במסמך הזה ההנחה היא שהלוקאל הוא 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 (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
שדות
top

object (Border)

הגבול העליון של התא.

bottom

object (Border)

הגבול התחתון של התא.

left

object (Border)

הגבול השמאלי של התא.

right

object (Border)

הגבול הימני של התא.

סקוטיש בורדרס

גבול לאורך תא.

ייצוג JSON 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
שדות
style

enum (Style)

סגנון הגבול.

width
(deprecated)

integer

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

color
(deprecated)

object (Color)

צבע הגבול. הוצאה משימוש: colorStyle.

colorStyle

object (ColorStyle)

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

סגנון

סגנון של גבול.

טיפוסים בני מנייה (enum)
STYLE_UNSPECIFIED הסגנון לא צוין. אין להשתמש באפשרות הזו.
DOTTED הגבול מקווקו.
DASHED הגבול מקווקו.
SOLID הגבול הוא קו רצוף דק.
SOLID_MEDIUM הגבול הוא קו רצוף בינוני.
SOLID_THICK הגבול הוא קו רצוף עבה.
NONE ללא גבול. משמש רק כשמעדכנים גבול כדי למחוק אותו.
DOUBLE הגבול הוא שתי שורות רצופות.

מרווח

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

ייצוג JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
שדות
top

integer

המרווח העליון של התא.

right

integer

המרווח הפנימי של התא.

bottom

integer

המרווח הפנימי התחתון של התא.

left

integer

המרווח הפנימי של התא.

יישור אנכי

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

טיפוסים בני מנייה (enum)
VERTICAL_ALIGN_UNSPECIFIED לא צוינה יישור אנכי. אין להשתמש באפשרות הזו.
TOP הטקסט מיושר באופן מפורש לחלק העליון של התא.
MIDDLE הטקסט מיושר באופן מפורש לאמצע התא.
BOTTOM הטקסט מיושר באופן מפורש לחלק התחתון של התא.

אסטרטגיית אריזה

כיצד לעטוף טקסט בתא.

טיפוסים בני מנייה (enum)
WRAP_STRATEGY_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
OVERFLOW_CELL

קווים שאורכם עולה על רוחב התא נכתבים בתא הבא, כל עוד התא ריק. אם התא הבא לא ריק, ההתנהגות שלו תהיה זהה לזו של CLIP. הטקסט לעולם לא יגלוש לשורה הבאה, אלא אם המשתמש יוסיף שורה חדשה באופן ידני. דוגמה: 

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

אסטרטגיית האריזה הזו מייצגת את אסטרטגיית גלישת הנתונים הישנה של Google Sheets, שבה מתבצעת חיתוך של מילים ארוכות יותר מאשר קו. האסטרטגיה הזו לא נתמכת בכל הפלטפורמות, ואנחנו מוציאים אותה משימוש. דוגמה: 

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

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

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

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

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

כיוון טקסט

כיוון הטקסט בתא.

טיפוסים בני מנייה (enum)
TEXT_DIRECTION_UNSPECIFIED כיוון הטקסט לא צוין. אין להשתמש באפשרות הזו.
LEFT_TO_RIGHT כיוון הטקסט משמאל לימין הוגדר על ידי המשתמש.
RIGHT_TO_LEFT כיוון הטקסט הוגדר מימין לשמאל על ידי המשתמש.

היפר-קישור של סוג התצוגה

האם לעבד היפר-קישור באופן מפורש. אם לא צוין אחרת, ההיפר-קישור מקושר.

טיפוסים בני מנייה (enum)
LINKED יש לעבד היפר-קישור באופן מפורש.
PLAIN_TEXT אין לעבד היפר-קישור.

סיבוב טקסט

הסבב מופעל על טקסט בתא.

ייצוג JSON 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
שדות
שדה איחוד type. סוג הסבב, האנכי או הזווית. type יכול להיות רק אחד מהבאים:
angle

integer

הזווית בין הכיוון הרגיל לבין הכיוון הרצוי. נמדד במעלות. הערכים החוקיים הם בין 90- ל-90. זוויות חיוביות נוטות כלפי מעלה, זווית שלילית מופנית כלפי מטה.

הערה: בכיוון הטקסט של LTR, הזווית החיובית היא בכיוון השעון, בעוד של-RTL היא בכיוון השעון

vertical

boolean

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

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

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

ייצוג JSON 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
שדות
startIndex

integer

אינדקס תווים מבוסס אפס שבו מתחילה הריצה הזו, ביחידות קוד UTF-16.

format

object (TextFormat)

הפורמט של הריצה הזו. ערכים חסרים יורשים את הפורמט של התא.

כלל לאימות נתונים

כלל לאימות נתונים.

ייצוג JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
שדות
condition

object (BooleanCondition)

התנאי חייב להתאים לתנאי התא.

inputMessage

string

הודעה שמוצגת למשתמשים כשמוסיפים נתונים לתא.

strict

boolean

הערך הוא True אם יש לדחות נתונים לא חוקיים.

showCustomUi

boolean

הערך הוא True אם יש להתאים אישית את ממשק המשתמש בהתאם לסוג המצב. אם True, התנאים של "רשימה" יציגו תפריט נפתח.

טבלה של מקור הנתונים

טבלה של מקור נתונים, שמאפשרת למשתמש לייבא ל-Sheets טבלת נתונים סטטית מתוך DataSource. הפעולה הזו נקראת גם "חילוץ" בעורך ה-Sheets.

ייצוג JSON 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
שדות
dataSourceId

string

המזהה של מקור הנתונים שאליו משויכת הטבלה של מקורות הנתונים.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

הסוג שבו יש לבחור עמודות לטבלת הנתונים. ברירת המחדל היא SELECTED.

columns[]

object (DataSourceColumnReference)

העמודות שנבחרו עבור הטבלה של מקור הנתונים. הערך של columnSelectionType חייב להיות SELECTED.

filterSpecs[]

object (FilterSpec)

מפרטי הסינון בטבלה של מקור הנתונים.

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

מגבלת השורות שיש להחזיר. אם המדיניות לא מוגדרת, חלה מגבלת ברירת מחדל. מידע על מגבלת ברירת המחדל ועל המגבלה המקסימלית מופיעים בעורך Sheets.

dataExecutionStatus

object (DataExecutionStatus)

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

סוג מקור הנתוניםTableColumn

סוגי העמודות שנבחרו בטבלה של מקור הנתונים.

טיפוסים בני מנייה (enum)
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED סוג ברירת המחדל לבחירת עמודה, לא להשתמש.
SELECTED בחירת העמודות לפי השדה columns.
SYNC_ALL

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

אם היא מוגדרת, טבלת מקור הנתונים מאחזרת את כל העמודות במקור הנתונים בזמן הרענון.

נוסחת מקור הנתונים

נוסחה של מקור נתונים.

ייצוג JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
שדות
dataSourceId

string

המזהה של מקור הנתונים שאליו הנוסחה משויכת.

dataExecutionStatus

object (DataExecutionStatus)

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