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)
    }
  ]
}
שדות
properties

object (SheetProperties)

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

data[]

object (GridData)

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

מספר האובייקטים של GridData שמוחזר תלוי במספר הטווחים שהתבקשו בגיליון הזה. לדוגמה, אם הערך הזה מייצג את Sheet1, והגיליון האלקטרוני התבקש עם טווחים Sheet1!A1:C10 ו-Sheet1!D15:E20, אז ל-GridData הראשון יהיה startRow / startColumn של 0, ולשני יהיה 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)

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

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)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
שדות
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.