Sheets

גיליון

גיליון בגיליון אלקטרוני.

ייצוג ב-JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ],
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ]
}
שדות
properties

object (SheetProperties)

מאפייני הגיליון.

data[]

object (GridData)

הנתונים ברשת, אם זה גיליון רשת.

מספר האובייקטים של GridData שמוחזר תלוי במספר הטווחים שנדרשו בגיליון הזה. לדוגמה, אם הערך הזה מייצג את Sheet1, והגיליון האלקטרוני התבקש עם טווחים Sheet1!A1:C10 ו- Sheet1!D15:E20, אז ל-GridData הראשון יהיה startRow / startColumn של 0, ואילו ל-GridData השני יהיה startRow 14 (שורה 15 מבוססת-אפס), ו- startColumn 3 (עמודה D מבוססת-אפס).

בגיליון DATA_SOURCE אי אפשר לבקש טווח ספציפי, כי GridData מכיל את כל הערכים.

merges[]

object (GridRange)

הטווחים שממוזגים.

conditionalFormats[]

object (ConditionalFormatRule)

כללי העיצוב המותנה בגיליון הזה.

filterViews[]

object (FilterView)

תצוגות הסינון בגיליון הזה.

protectedRanges[]

object (ProtectedRange)

הטווחים המוגנים בגיליון הזה.

basicFilter

object (BasicFilter)

המסנן בגיליון הזה, אם יש כזה.

charts[]

object (EmbeddedChart)

המפרטים של כל תרשים בגיליון הזה.

bandedRanges[]

object (BandedRange)

הטווחים עם פסים (צבעים מתחלפים) בגיליון הזה.

developerMetadata[]

object (DeveloperMetadata)

מטא-נתונים של מפתח שמשויכים לגיליון.

rowGroups[]

object (DimensionGroup)

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

columnGroups[]

object (DimensionGroup)

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

slicers[]

object (Slicer)

הפילטרים בגיליון הזה.

tables[]

object (Table)

הטבלאות בגיליון הזה.

commentAnchors[]

object (CommentAnchor)

העוגנים של התגובות בגיליון הזה.

SheetProperties

מאפיינים של גיליון.

ייצוג ב-JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
שדות
sheetId

integer

המזהה של הגיליון. הערך לא יכול להיות שלילי. אי אפשר לשנות את השדה הזה אחרי שמגדירים אותו.

title

string

שם הגיליון.

index

integer

האינדקס של הגיליון בגיליון האלקטרוני. כשמוסיפים או מעדכנים מאפיינים של גיליון, אם לא כוללים את השדה הזה, הגיליון מתווסף או מועבר לסוף רשימת הגיליונות. כשמעדכנים את האינדקסים של הגיליונות או מוסיפים גיליונות, התנועה נכללת באינדקסים של 'לפני ההעברה'. לדוגמה, אם יש שלושה גיליונות (S1, ‏ S2 ו-S3) ואתם רוצים להעביר את S1 לפני S2, צריך להגדיר את האינדקס ל-2. המערכת מתעלמת מבקשה לעדכון אינדקס של גיליון אם האינדקס המבוקש זהה לאינדקס הנוכחי של הגיליון, או אם האינדקס החדש המבוקש שווה לאינדקס הנוכחי של הגיליון + 1.

sheetType

enum (SheetType)

סוג הגיליון. ברירת המחדל היא GRID. אי אפשר לשנות את השדה הזה אחרי שמגדירים אותו.

gridProperties

object (GridProperties)

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

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

hidden

boolean

הערך הוא True אם הגיליון מוסתר בממשק המשתמש, ו-False אם הוא גלוי.

tabColor
(deprecated)

object (Color)

הצבע של הכרטיסייה בממשק המשתמש. הוצא משימוש: צריך להשתמש ב-tabColorStyle.

tabColorStyle

object (ColorStyle)

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

rightToLeft

boolean

הערך הוא True אם הגיליון הוא גיליון RTL ולא גיליון LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

פלט בלבד. אם השדה קיים, הוא מכיל מאפיינים ספציפיים של הגיליון.DATA_SOURCE

SheetType

סוג הגיליון.

טיפוסים בני מנייה (enum)
SHEET_TYPE_UNSPECIFIED ערך ברירת מחדל, אין להשתמש.
GRID הגיליון הוא רשת.
OBJECT בגיליון אין רשת, אלא אובייקט כמו תרשים או תמונה.
DATA_SOURCE הגיליון מתחבר למקור חיצוני DataSource ומציג את התצוגה המקדימה של הנתונים.

GridProperties

מאפיינים של רשת.

ייצוג ב-JSON 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
שדות
rowCount

integer

מספר השורות ברשת.

columnCount

integer

מספר העמודות ברשת.

frozenRowCount

integer

מספר השורות שמוקפאות ברשת.

frozenColumnCount

integer

מספר העמודות שמוקפאות ברשת.

hideGridlines

boolean

הערך הוא True אם לא מוצגים קווי רשת בממשק המשתמש.

rowGroupControlAfter

boolean

הערך הוא True אם המתג של אמצעי הבקרה של קיבוץ השורות מוצג אחרי הקבוצה.

columnGroupControlAfter

boolean

הערך הוא True אם המתג של אמצעי הבקרה לקבוצת העמודות מוצג אחרי הקבוצה.

DataSourceSheetProperties

מאפיינים נוספים של DATA_SOURCE גיליון.

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

string

המזהה של DataSource שאליו הגיליון מחובר.

columns[]

object (DataSourceColumn)

העמודות שמוצגות בגיליון, בהתאם לערכים ב-RowData.

dataExecutionStatus

object (DataExecutionStatus)

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

GridData

נתונים ברשת, וגם מטא-נתונים לגבי המאפיינים.

ייצוג ב-JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
שדות
startRow

integer

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

startColumn

integer

העמודה הראשונה שאליה מתייחס GridData, מתחיל מאפס.

rowData[]

object (RowData)

הנתונים ברשת, רשומה אחת בכל שורה, החל מהשורה שצוינה ב-startRow. הערכים ב-RowData יתאימו לעמודות שמתחילות ב-startColumn.

rowMetadata[]

object (DimensionProperties)

מטא-נתונים על השורות המבוקשות ברשת, החל מהשורה ב-startRow.

columnMetadata[]

object (DimensionProperties)

מטא-נתונים על העמודות המבוקשות ברשת, החל מהעמודה ב-startColumn.

RowData

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

ייצוג ב-JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
שדות
values[]

object (CellData)

הערכים בשורה, ערך אחד לכל עמודה.

DimensionProperties

מאפיינים של מאפיין.

ייצוג ב-JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
שדות
hiddenByFilter

boolean

הערך הוא True אם המאפיין הזה מסונן. השדה הזה הוא לקריאה בלבד.

hiddenByUser

boolean

הערך הוא True אם המאפיין הזה מוסתר באופן מפורש.

pixelSize

integer

הגובה (אם מדובר בשורה) או הרוחב (אם מדובר בעמודה) של המאפיין בפיקסלים.

developerMetadata[]

object (DeveloperMetadata)

המטא-נתונים למפתחים שמשויכים לשורה או לעמודה יחידה.

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

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

ייצוג ב-JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
}
שדות
ranges[]

object (GridRange)

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

שדה איחוד rule. הכלל ששולט בעיצוב המותנה הזה, צריך להיות מוגדר בדיוק אחד. ‫rule יכול להיות רק אחד מהבאים:
booleanRule

object (BooleanRule)

העיצוב הוא 'on' או 'off' בהתאם לכלל.

gradientRule

object (GradientRule)

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

BooleanRule

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

ייצוג ב-JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
שדות
condition

object (BooleanCondition)

התנאי של הכלל. אם התנאי מתקיים, הפורמט מוחל.

format

object (CellFormat)

הפורמט להחלה. עיצוב מותנה יכול להחיל רק קבוצת משנה של עיצובים: bold, italic, strikethrough, foreground color ו- background color.

GradientRule

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

ייצוג ב-JSON 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
שדות
minpoint

object (InterpolationPoint)

נקודת ההתחלה של האינטרפולציה.

midpoint

object (InterpolationPoint)

נקודת אינטרפולציה אופציונלית באמצע.

maxpoint

object (InterpolationPoint)

נקודת האינטרפולציה הסופית.

InterpolationPoint

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

ייצוג ב-JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
שדות
color
(deprecated)

object (Color)

הצבע שנקודת האינטרפולציה הזו צריכה להשתמש בו. הוצא משימוש: צריך להשתמש ב-colorStyle.

colorStyle

object (ColorStyle)

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

type

enum (InterpolationPointType)

איך צריך לפרש את הערך.

value

string

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

InterpolationPointType

סוג נקודת האינטרפולציה.

טיפוסים בני מנייה (enum)
INTERPOLATION_POINT_TYPE_UNSPECIFIED ערך ברירת המחדל, לא לשימוש.
MIN נקודת האינטרפולציה משתמשת בערך המינימלי בתאים בטווח של העיצוב המותנה.
MAX נקודת האינטרפולציה משתמשת בערך המקסימלי בתאים בטווח של העיצוב המותנה.
NUMBER נקודת האינטרפולציה משתמשת בדיוק בערך שבשדה InterpolationPoint.value.
PERCENT

נקודת האינטרפולציה היא האחוז שצוין מתוך כל התאים בטווח של העיצוב המותנה. הפונקציה הזו שוות ערך לפונקציה NUMBER אם הערך היה: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (כאשר המערכת מתעלמת משגיאות בטווח בזמן השטחה).

PERCENTILE נקודת האינטרפולציה היא האחוזון הנתון של כל התאים בטווח של העיצוב המותנה. הפונקציה הזו שוות ערך לפונקציה NUMBER אם הערך היה: =PERCENTILE(FLATTEN(range), value / 100) (כאשר מתעלמים משגיאות בטווח כשמבצעים החלקה).

FilterView

תצוגה מסוננת. מידע נוסף זמין במאמר בנושא ניהול נראות הנתונים באמצעות מסננים.

ייצוג ב-JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
שדות
filterViewId

integer

המזהה של תצוגת המסנן.

title

string

השם של התצוגה המסוננת.

range

object (GridRange)

הטווח שתצוגה מסוננת זו מכסה.

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range, namedRangeId או tableId.

namedRangeId

string

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

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range, namedRangeId או tableId.

tableId

string

הטבלה שתומכת בתצוגת המסנן הזו, אם יש כזו.

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range, namedRangeId או tableId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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

השדה הזה הוצא משימוש והוחלף על ידי filterSpecs.

filterSpecs[]

object (FilterSpec)

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

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

ProtectedRange

טווח תאים מוגן.

ייצוג ב-JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
שדות
protectedRangeId

integer

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

range

object (GridRange)

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

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range או namedRangeId או tableId

namedRangeId

string

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

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range או namedRangeId או tableId

tableId

string

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

כשכותבים, אפשר להגדיר רק אחד מהערכים הבאים: range או namedRangeId או tableId

description

string

התיאור של טווח התאים המוגן.

warningOnly

boolean

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

בכתיבה: אם הערך בשדה הזה הוא true, המערכת מתעלמת מהשדות editors. בנוסף, אם הערך של השדה הזה משתנה מ-true ל-false והשדה editors לא מוגדר (או לא נכלל במסכת השדות), אז העורכים יוגדרו לכל העורכים במסמך.

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

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

editors

object (Editors)

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

עורכים

העורכים של טווח תאים מוגן.

ייצוג ב-JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
שדות
users[]

string

כתובות האימייל של המשתמשים שיש להם גישת עריכה בטווח התאים המוגן.

groups[]

string

כתובות האימייל של קבוצות עם גישת עריכה לטווח התאים המוגן.

domainUsersCanEdit

boolean

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

BasicFilter

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

ייצוג ב-JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
שדות
range

object (GridRange)

הטווח שהמסנן מכסה.

tableId

string

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

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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

השדה הזה הוצא משימוש והוחלף על ידי filterSpecs.

filterSpecs[]

object (FilterSpec)

קריטריוני הסינון לכל עמודה.

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

BandedRange

טווח עם פסים (צבעים מתחלפים) בגיליון.

ייצוג ב-JSON 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
שדות
bandedRangeId

integer

המזהה של הטווח המדורג. אם לא מוגדר, אפשר לעיין בbandedRangeReference.

bandedRangeReference

string

פלט בלבד. ההפניה לטווח המדורג, שמשמשת לזיהוי המזהה שלא נתמך על ידי bandedRangeId.

range

object (GridRange)

הטווח שבו המאפיינים האלה חלים.

rowProperties

object (BandingProperties)

מאפיינים של פסי שורות. המאפיינים האלה מוחלים על כל שורה בנפרד בכל השורות בטווח. צריך לציין לפחות אחד מהערכים הבאים: rowProperties או columnProperties

columnProperties

object (BandingProperties)

מאפיינים של פסי עמודות. המאפיינים האלה מוחלים על כל העמודות בטווח, אחת אחרי השנייה. צריך לציין לפחות אחד מהערכים הבאים: rowProperties או columnProperties

BandingProperties

מאפיינים שמתייחסים למאפיין יחיד (שורה או עמודה). אם גם BandedRange.row_properties וגם BandedRange.column_properties מוגדרים, צבעי המילוי מוחלים על התאים לפי הכללים הבאים:

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

ייצוג ב-JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
שדות
headerColor
(deprecated)

object (Color)

הצבע של השורה או העמודה הראשונה. אם השדה הזה מוגדר, השורה או העמודה הראשונות נצבעות בצבע הזה, והצבעים מתחלפים בין firstBandColor לבין secondBandColor החל מהשורה או העמודה השנייה. אחרת, השורה או העמודה הראשונות ימולאו בערך firstBandColor והצבעים ימשיכו להתחלף כרגיל. הוצא משימוש: צריך להשתמש ב-headerColorStyle.

headerColorStyle

object (ColorStyle)

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

firstBandColor
(deprecated)

object (Color)

הצבע הראשון שמתחלף. (חובה) הוצא משימוש: צריך להשתמש ב-firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

הצבע הראשון שמתחלף. (חובה) אם גם firstBandColor מוגדר, השדה הזה מקבל עדיפות.

secondBandColor
(deprecated)

object (Color)

הצבע השני שמתחלף. (חובה) הוצא משימוש: צריך להשתמש ב-secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

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

footerColor
(deprecated)

object (Color)

הצבע של השורה או העמודה האחרונות. אם השדה הזה לא מוגדר, השורה או העמודה האחרונות ימולאו ב-firstBandColor או ב-secondBandColor, בהתאם לצבע של השורה או העמודה הקודמות. הוצא משימוש: צריך להשתמש ב-footerColorStyle.

footerColorStyle

object (ColorStyle)

הצבע של השורה או העמודה האחרונות. אם השדה הזה לא מוגדר, השורה או העמודה האחרונות ימולאו ב-firstBandColor או ב-secondBandColor, בהתאם לצבע של השורה או העמודה הקודמות. אם גם footerColor מוגדר, השדה הזה מקבל עדיפות.

DimensionGroup

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

ייצוג ב-JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
שדות
range

object (DimensionRange)

הטווח שבו הקבוצה הזו קיימת.

depth

integer

העומק של הקבוצה, שמייצג כמה קבוצות מכילות טווח שכולל את הטווח של הקבוצה הזו.

collapsed

boolean

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

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

כלי סינון

כלי סינון בגיליון.

ייצוג ב-JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
שדות
slicerId

integer

המזהה של הכלי לפילוח נתונים.

spec

object (SlicerSpec)

המפרט של כלי הפילוח.

position

object (EmbeddedObjectPosition)

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

SlicerSpec

המפרטים של כלי סינון.

ייצוג ב-JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
שדות
dataRange

object (GridRange)

טווח הנתונים של כלי הסינון.

filterCriteria

object (FilterCriteria)

קריטריוני הסינון של כלי הסינון.

columnIndex

integer

אינדקס העמודה (מתחיל מאפס) בטבלת הנתונים שהמסנן מוחל עליה.

applyToPivotTables

boolean

הערך True אם המסנן צריך לחול על טבלאות צירים. אם לא מגדירים את המדיניות, ברירת המחדל היא True.

title

string

הכותרת של הכלי לפילוח הנתונים.

textFormat

object (TextFormat)

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

backgroundColor
(deprecated)

object (Color)

צבע הרקע של הכלי לפילוח הנתונים. הוצא משימוש: צריך להשתמש ב-backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

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

טבלה

טבלה.

ייצוג ב-JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
שדות
tableId

string

המזהה של הטבלה.

name

string

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

range

object (GridRange)

הטווח של הטבלה.

rowsProperties

object (TableRowsProperties)

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

columnProperties[]

object (TableColumnProperties)

מאפייני העמודה בטבלה.

TableRowsProperties

מאפייני השורה בטבלה.

ייצוג ב-JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
שדות
headerColorStyle

object (ColorStyle)

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

firstBandColorStyle

object (ColorStyle)

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

secondBandColorStyle

object (ColorStyle)

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

footerColorStyle

object (ColorStyle)

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

TableColumnProperties

העמודה בטבלה.

ייצוג ב-JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
שדות
columnIndex

integer

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

columnName

string

שם העמודה.

columnType

enum (ColumnType)

סוג העמודה.

dataValidationRule

object (TableColumnDataValidationRule)

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

ColumnType

סוג העמודה של עמודה מסוימת בטבלה.

טיפוסים בני מנייה (enum)
COLUMN_TYPE_UNSPECIFIED סוג עמודה שלא צוין.
DOUBLE סוג העמודה 'מספר'.
CURRENCY סוג העמודה 'מטבע'.
PERCENT סוג העמודה 'אחוזים'.
DATE סוג העמודה של התאריך.
TIME סוג העמודה 'זמן'.
DATE_TIME סוג העמודה 'תאריך ושעה'.
TEXT סוג העמודה של הטקסט.
BOOLEAN סוג העמודה הבוליאנית.
DROPDOWN סוג העמודה 'תפריט נפתח'.
FILES_CHIP סוג העמודה 'צ'יפ של קובץ'
PEOPLE_CHIP סוג העמודה 'צ'יפ של אדם'
FINANCE_CHIP עמודה מסוג 'צ'יפ של מידע פיננסי'
PLACE_CHIP העמודה מסוג צ'יפ של מקום
RATINGS_CHIP העמודה מסוג צ'יפ של דירוג

TableColumnDataValidationRule

כלל לאימות נתונים בעמודה בטבלה.

ייצוג ב-JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
שדות
condition

object (BooleanCondition)

התנאי שהנתונים בתא צריכים לעמוד בו. המאפיין הזה תקף רק אם הערך של [BooleanCondition.type] הוא ONE_OF_LIST.

CommentAnchor

מיקום בגיליון האלקטרוני שמקושר ל CommentThread עם אותו anchorId. הערה: יכול להיות שכמה עוגנים יפנו לאותו מיקום.

ייצוג ב-JSON 
{
  "anchorId": string,
  "range": {
    object (GridRange)
  }
}
שדות
anchorId

string

המזהה הייחודי של עוגן התגובה. פלט בלבד.

range

object (GridRange)

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