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

object (SheetProperties)

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

data[]

object (GridData)

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

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

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

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

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

תכונות של גיליון.

ייצוג 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 מאפיינים ספציפיים של הגיליון.

סוג הגיליון

סוג הגיליון.

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

מאפייני רשת

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

ייצוג 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 אם מתג הבקרה של קיבוץ העמודות מוצג אחרי הקבוצה.

נכסי מקור נתונים

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

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

string

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

columns[]

object (DataSourceColumn)

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

dataExecutionStatus

object (DataExecutionStatus)

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

נתוני רשת

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

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

נתוני שורות

נתונים לגבי כל תא ברצף.

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

object (CellData)

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

מאפייני המימדים

נכסים שקשורים למאפיין.

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

לפי הכלל, הפורמט צריך להיות "מופעל" או "כבוי".

gradientRule

object (GradientRule)

העיצוב ישתנה בהתאם לגרדיאנטים בכלל.

בוליאני

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

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

object (BooleanCondition)

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

format

object (CellFormat)

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

מדרגות

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

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

object (InterpolationPoint)

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

midpoint

object (InterpolationPoint)

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

maxpoint

object (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.

סוג אינטרפולציה

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

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

מסנן תצוגה מפורטת

תצוגת סינון.

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

integer

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

title

string

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

range

object (GridRange)

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

בזמן כתיבה, ניתן להגדיר רק אחד range או namedRangeId.

namedRangeId

string

הטווח שצוין עבור תצוגת הסינון הזו, אם הוא קיים.

בזמן כתיבה, ניתן להגדיר רק אחד range או namedRangeId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

השדה הזה הוצא משימוש והוקצה לטובת filterSpecs.

filterSpecs[]

object (FilterSpec)

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

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

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

טווח מוגן.

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

integer

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

range

object (GridRange)

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

בזמן כתיבה, ניתן להגדיר רק אחד range או namedRangeId.

namedRangeId

string

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

בזמן כתיבה, ניתן להגדיר רק אחד range או namedRangeId.

description

string

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

warningOnly

boolean

הערך הוא 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 אם יש לאנשים בדומיין של המסמך גישת עריכה לטווח המוגן. הגנה על דומיינים נתמכת רק במסמכים בתוך דומיין.

סינון בסיסי

מסנן ברירת המחדל שמשויך לגיליון.

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

object (GridRange)

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

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

השדה הזה הוצא משימוש והוקצה לטובת filterSpecs.

filterSpecs[]

object (FilterSpec)

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

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

טווח תדרים

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

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

integer

המזהה של טווח התדרים.

range

object (GridRange)

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

rowProperties

object (BandingProperties)

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

columnProperties

object (BandingProperties)

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

מוצרי צביעה

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

קבוצת מאפיינים

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

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

object (DimensionRange)

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

depth

integer

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

collapsed

boolean

השדה הזה מקבל את הערך True אם הקבוצה הזו מכווצת. קבוצה מכווצת נשארת במצב מכווץ אם קבוצה חופפת בעומק רדוד מתרחבת.

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

כלי סינון

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

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

integer

המזהה של כלי הסינון.

spec

object (SlicerSpec)

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

position

object (EmbeddedObjectPosition)

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

כלי סינון

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

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