Cells

{
  "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)
  }
}

object (ExtendedValue)

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

object (ExtendedValue)

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

string

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

object (CellFormat)

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

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

object (CellFormat)

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

string

היפר-קישור שהתא הזה מפנה אליו, אם יש כזה. אם התא מכיל כמה היפר-קישורים, השדה הזה יהיה ריק. השדה הזה הוא לקריאה בלבד. כדי להגדיר זאת, יש להשתמש =HYPERLINK בנוסחה userEnteredValue.formulaValue השדה הזה. ניתן להגדיר קישור ברמת התא גם דרך userEnteredFormat.textFormat השדה הזה. לחלופין, מגדירים היפר-קישור textFormatRun.format.link שמתפרש על פני כל התא.

string

כל הערה בתא.

object (TextFormatRun)

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

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

object (DataValidationRule)

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

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

object (PivotTable)

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

object (DataSourceTable)

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

object (DataSourceFormula)

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

{
  "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)
  }
}

object (NumberFormat)

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

object (Color)

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

object (ColorStyle)

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

object (Borders)

גבולות התא.

object (Padding)

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

enum (HorizontalAlign)

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

enum (VerticalAlign)

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

enum (WrapStrategy)

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

enum (TextDirection)

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

object (TextFormat)

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

enum (HyperlinkDisplayType)

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

object (TextRotation)

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

{
  "type": enum (NumberFormatType),
  "pattern": string
}

enum (NumberFormatType)

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

string

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

{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}

object (Border)

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

object (Border)

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

object (Border)

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

object (Border)

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

{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}

enum (Style)

סגנון הגבול.

integer

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

object (Color)

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

object (ColorStyle)

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

{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}

integer

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

integer

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

integer

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

integer

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

{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}

integer

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

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

boolean

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

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

{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}

integer

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

object (TextFormat)

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

{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}

object (BooleanCondition)

התנאי שהנתונים בתא צריכים להתאים.

string

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

boolean

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

boolean

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

{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

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

enum (DataSourceTableColumnSelectionType)

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

object (DataSourceColumnReference)

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

object (FilterSpec)

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

object (SortSpec)

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

integer

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

object (DataExecutionStatus)

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

{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

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

object (DataExecutionStatus)

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