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, הערך של 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)

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

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

מספר העמודות שמושהות (frozen) בתצוגת הרשת.

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,
  "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,
  "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

טבלה

טבלה.

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