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)

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

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

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