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, הערך של startRow‏/startColumn ב-GridData הראשון יהיה 0, והערך של startRow 14 (שורה 15 שמתחילה באפס) ו-startColumn 3 (עמודה D שמתחילה באפס) ב-GridData השני יהיה 0.

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

כלי החיתוך בגיליון הזה.

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)

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

gradientRule

object (GradientRule)

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

BooleanRule

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

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

object (BooleanCondition)

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

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

ProtectedRange

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

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

כשכותבים: אם השדה הזה הוא 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)
  },
  "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 מאוכלסים בתשובות. אם שני השדות מצוינים בבקשת עדכון, השדה הזה יקבל עדיפות.

BandedRange

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

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

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