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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
שדות
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).

chipRuns[]

object (ChipRun)

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

כשקוראים את הנתונים, כל הריצות עם הצ'יפ ובלעדיו נכללות. במקרים שבהם לא נעשה שימוש בשבב, הערך של Chip יהיה ריק.

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

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

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

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. זוויות חיוביות מוטות כלפי מעלה, וזוויות שליליות מוטות כלפי מטה.

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

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. הפעולה הזו נקראת גם 'חילוץ' בכלי לעריכת גיליונות אלקטרוניים.

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

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

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)

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

ChipRun

הפעלה של צ'יפ. הצ'יפ ממשיך עד לאינדקס ההתחלה של ההפעלה הבאה.

ייצוג ב-JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
שדות
startIndex

integer

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

chip

object (Chip)

אופציונלי. הצ'יפ של ההפעלה הזו.

Chip

הצ'יפ החכם.

ייצוג ב-JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
שדות
שדה איחוד properties. מאפייני הצ'יפ. ‫properties יכול להיות רק אחד מהבאים:
personProperties

object (PersonProperties)

מאפיינים של אדם מקושר.

PersonProperties

מאפיינים ספציפיים שקשורים לאדם מקושר.

ייצוג ב-JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
שדות
email

string

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

displayFormat

enum (DisplayFormat)

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

DisplayFormat

פורמט התצוגה המועדף, אם הוא זמין.

טיפוסים בני מנייה (enum)
DISPLAY_FORMAT_UNSPECIFIED ערך ברירת מחדל, אין להשתמש.
DEFAULT פורמט התצוגה שמוגדר כברירת מחדל.
LAST_NAME_COMMA_FIRST_NAME פורמט התצוגה של שם המשפחה והשם הפרטי.
EMAIL פורמט התצוגה של האימייל.

RichLinkProperties

מאפיינים של קישור למשאב של Google (למשל, קובץ ב-Drive, סרטון ב-YouTube, כתובת במפות Google או אירוע ביומן). אפשר לכתוב רק קבצים ב-Drive כצ'יפים. כל שאר הסוגים של קישורים מתקדמים הם לקריאה בלבד.

כשכותבים כתובות URI, הן לא יכולות להיות ארוכות מ-2,000 בייט.

הערה: כדי לכתוב צ'יפים של קבצים ב-Drive, צריך לפחות אחד מהיקפי ההרשאות הבאים של OAuth: drive.file, drive.readonly או drive.

ייצוג ב-JSON 
{
  "uri": string,
  "mimeType": string
}
שדות
uri

string

חובה. ה-URI של הקישור. האפשרות הזו תמיד מוצגת.

mimeType

string

פלט בלבד. סוג ה-MIME של הקישור, אם יש כזה (לדוגמה, כשמדובר בקובץ ב-Drive).