Cells

CellData

נתונים לגבי תא ספציפי.

ייצוג ב-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(). הערה: תאריכים, שעות ותאריכי זמן מיוצגים כמספרים כפולים בפורמט 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).

CellFormat

הפורמט של תא.

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

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

NumberFormat

תבנית המספרים של תא.

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

enum (NumberFormatType)

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

pattern

string

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

NumberFormatType

פורמט המספר של התא. במסמך הזה, ההנחה היא שהשפה היא 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

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

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

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

VerticalAlign

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

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

WrapStrategy

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

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

TextDirection

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

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

HyperlinkDisplayType

האם להציג היפר-קישור באופן מפורש. אם לא צוין, ההיפר-קישור מקושר.

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

TextRotation

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

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

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

DataValidationRule

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

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

object (BooleanCondition)

התנאי שהנתונים בתא חייבים לעמוד בו.

inputMessage

string

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

strict

boolean

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

showCustomUi

boolean

הערך True (נכון) אם צריך להתאים אישית את ממשק המשתמש על סמך סוג התנאי. אם True, התנאים מסוג 'רשימה' יציגו תפריט נפתח.

DataSourceTable

טבלה של מקור נתונים, שמאפשרת למשתמש לייבא טבלה סטטית של נתונים מ-DataSource אל Sheets. הפעולה הזו נקראת גם 'חילוץ' בעורך של 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)

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

DataSourceTableColumnSelectionType

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

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

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

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

DataSourceFormula

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

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

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