- משאב: גיליון אלקטרוני
- SpreadsheetProperties
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- צבע
- ColorStyle
- ThemeColorType
- גבולות
- גבול
- סגנון
- מרווח פנימי
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- קישור
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- גיליון
- SheetProperties
- SheetType
- GridProperties
- DataSourceSheetProperties (נתונים מקורSheetProperties)
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- ErrorType
- TextFormatRun
- DataValidationRule
- BooleanCondition
- ConditionType
- ConditionValue
- RelativeDate
- PivotTable
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- SortOrder
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFilterCriteria
- PivotFilterSpec
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- FilterCriteria
- SortSpec
- DataSourceFormula
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- עורכים
- BasicFilter
- EmbeddedChart
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle
- LineDashType
- DataLabel
- DataLabelType
- DataLabelPlacement
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- CandlestickData
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec
- KeyValueFormat
- BaselineValueFormat
- ComparisonType
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition
- OverlayPosition
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- כלי סינון
- SlicerSpec
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- DataSourceRefreshMonthlySchedule
- מרווח
- שיטות
משאב: גיליון אלקטרוני
משאב שמייצג גיליון אלקטרוני.
ייצוג JSON |
---|
{ "spreadsheetId": string, "properties": { object ( |
שדות | |
---|---|
spreadsheetId |
מזהה הגיליון האלקטרוני. השדה הזה הוא לקריאה בלבד. |
properties |
המאפיינים הכוללים של גיליון אלקטרוני. |
sheets[] |
הגיליונות שנכללים בגיליון אלקטרוני. |
namedRanges[] |
הטווחים בעלי השם שמוגדרים בגיליון אלקטרוני. |
spreadsheetUrl |
כתובת ה-URL של הגיליון האלקטרוני. השדה הזה הוא לקריאה בלבד. |
developerMetadata[] |
המטא-נתונים של המפתח שמשויכים לגיליון אלקטרוני. |
dataSources[] |
רשימה של מקורות נתונים חיצוניים שמקושרים לגיליון האלקטרוני. |
dataSourceSchedules[] |
פלט בלבד. רשימת לוחות זמנים לרענון של מקור הנתונים. |
SpreadsheetProperties
תכונות של גיליון אלקטרוני.
ייצוג JSON |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
שדות | |
---|---|
title |
כותרת הגיליון האלקטרוני. |
locale |
המיקום של הגיליון האלקטרוני באחד מהפורמטים הבאים:
הערה: כשמעדכנים את השדה הזה, לא יש תמיכה בכל הלוקאלים/השפות. |
autoRecalc |
משך הזמן שצריך להמתין לפני שפונקציות תנודתיות יחושבו מחדש. |
timeZone |
אזור הזמן של הגיליון האלקטרוני, בפורמט CLDR כמו |
defaultFormat |
פורמט ברירת המחדל של כל התאים בגיליון האלקטרוני. |
iterativeCalculationSettings |
השיטה הזו קובעת אם אפשר לפתור הפניות מעגליות באמצעות חישובים חוזרים, ובאיזה אופן. אם השדה הזה לא מופיע, המשמעות היא שהפניות מעגליות גורמות לשגיאות חישוב. |
spreadsheetTheme |
העיצוב הוחל על הגיליון האלקטרוני. |
importFunctionsExternalUrlAccessAllowed |
האם לאפשר גישה חיצונית לכתובת URL לצורך פונקציות תמונה וייבוא. קריאה בלבד כאשר היא מוגדרת כ-True. כשהערך הוא False, אפשר להגדיר אותו כ-True. |
RecalculationInterval
ספירה של האפשרויות האפשריות למרווחי חישוב מחדש.
טיפוסים בני מנייה (enums) | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
ערך ברירת המחדל. אי אפשר להשתמש בערך הזה. |
ON_CHANGE |
פונקציות תנודתיות מתעדכנות בכל שינוי. |
MINUTE |
פונקציות תנודתיות מתעדכנות בכל שינוי ובכל דקה. |
HOUR |
פונקציות תנודתיות מתעדכנות בכל שינוי ובכל שעה. |
IterativeCalculationSettings
הגדרות שנועדו לקבוע איך פותרים יחסי תלות מעגליים באמצעות חישובים חוזרים.
ייצוג JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
שדות | |
---|---|
maxIterations |
כשחישוב איטרטיבי מופעל, המספר המקסימלי של סבבי חישוב שניתן לבצע. |
convergenceThreshold |
כאשר מפעילים חישוב איטרטיבי והתוצאות של החישובים החוזרות משתנות בשיעור נמוך מערך הסף הזה, סבבי החישוב מופסקים. |
SpreadsheetTheme
מייצג את העיצוב של הגיליון האלקטרוני
ייצוג JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
שדות | |
---|---|
primaryFontFamily |
השם של משפחת הגופנים הראשית. |
themeColors[] |
מתאימים את הצבעים של העיצוב של הגיליון האלקטרוני. כדי לעדכן, צריך לספק את כל צמדי הצבעים של העיצוב. |
ThemeColorPair
זוג שממפה את סוג הצבע של עיצוב בגיליון אלקטרוני לצבע הבטון שהוא מייצג.
ייצוג JSON |
---|
{ "colorType": enum ( |
שדות | |
---|---|
colorType |
סוג צבע העיצוב של הגיליון האלקטרוני. |
color |
צבע הבטון שתואם לסוג הצבע של העיצוב. |
NamedRange
טווח תאים בעל שם.
ייצוג JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
שדות | |
---|---|
namedRangeId |
המזהה של הטווח בעל השם. |
name |
השם של הטווח בעל השם. |
range |
הטווח שמייצג. |
DataSource
מידע על מקור נתונים חיצוני בגיליון האלקטרוני.
ייצוג JSON |
---|
{ "dataSourceId": string, "spec": { object ( |
שדות | |
---|---|
dataSourceId |
המזהה הייחודי ברמת הגיליון האלקטרוני, שמשמש לזיהוי מקור הנתונים. דוגמה: 1080547365. |
spec |
השדה |
calculatedColumns[] |
כל העמודות המחושבות במקור הנתונים. |
sheetId |
המזהה של כשיוצרים מקור נתונים נוצר גם גיליון |
DataSourceSpec
מציין את הפרטים של מקור הנתונים. לדוגמה, ב-BigQuery, מציין מידע על מקור ה-BigQuery.
ייצוג JSON |
---|
{ "parameters": [ { object ( |
שדות | |
---|---|
parameters[] |
הפרמטרים של מקור הנתונים שמשמשים ליצירת שאילתות במקור הנתונים. |
שדה איחוד spec . המפרט בפועל לכל סוג של מקור נתונים. spec יכול להיות רק אחד מהבאים: |
|
bigQuery |
|
BigQueryDataSourceSpec
המפרט של מקור נתונים ב-BigQuery שמחובר לגיליון.
ייצוג JSON |
---|
{ "projectId": string, // Union field |
שדות | |
---|---|
projectId |
המזהה של פרויקט Google Cloud שמופעל ב-BigQuery ומצורף אליו חשבון לחיוב. הפרויקט מחויב על כל השאילתות שמופעלות במקור הנתונים. |
שדה איחוד spec . המפרט בפועל. spec יכול להיות רק אחד מהבאים: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
מציין שאילתת BigQuery בהתאמה אישית.
ייצוג JSON |
---|
{ "rawQuery": string } |
שדות | |
---|---|
rawQuery |
מחרוזת השאילתה הגולמית. |
BigQueryTableSpec
מציינת הגדרה של טבלה ב-BigQuery. מותר להשתמש רק בטבלאות מותאמות.
ייצוג JSON |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
שדות | |
---|---|
tableProjectId |
המזהה של פרויקט BigQuery שאליו שייכת הטבלה. אם לא מציינים שום דבר, ההנחה היא שהשדה |
tableId |
מזהה הטבלה ב-BigQuery. |
datasetId |
מזהה מערך הנתונים ב-BigQuery. |
DataSourceParameter
פרמטר בשאילתה של מקור נתונים. הפרמטר מאפשר למשתמש להעביר ערכים מהגיליון האלקטרוני לתוך שאילתה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד identifier . מזהה הפרמטר identifier יכול להיות רק אחד מהבאים: |
|
name |
פרמטר בעל שם. חייב להיות מזהה חוקי של |
שדה איחוד value . ערך הפרמטר. value יכול להיות רק אחד מהבאים: |
|
namedRangeId |
מזהה של |
range |
טווח שמכיל את הערך של הפרמטר. הגודל צריך להיות 1x1. |
DataSourceRefreshSchedule
תזמון לרענון מקור הנתונים.
המערכת מרעננת את מקורות הנתונים בגיליון האלקטרוני תוך פרק זמן מסוים. כדי לציין את שעת ההתחלה, לוחצים על הלחצן 'רענון מתוזמן' בעורך Sheets, אבל מרווח הזמן קבוע ל-4 שעות. לדוגמה, אם מציינים את שעת ההתחלה 08:00 , הרענון יתבצע מדי יום בין 08:00 ל-12:00.
ייצוג JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
שדות | |
---|---|
enabled |
True אם תזמון הרענון מופעל, או False אם לא. |
refreshScope |
היקף הרענון. חייב להיות |
nextRun |
פלט בלבד. מרווח הזמן של ההפעלה הבאה. |
שדה איחוד schedule_config . הגדרות תזמון schedule_config יכולות להיות רק אחת מהאפשרויות הבאות: |
|
dailySchedule |
לוח זמנים יומי לרענון. |
weeklySchedule |
לוח זמנים שבועי לרענון. |
monthlySchedule |
לוח זמנים לרענון חודשי. |
DataSourceRefreshScope
מקור הנתונים הוא לרענן את ההיקפים.
טיפוסים בני מנייה (enums) | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
ערך ברירת המחדל, אין להשתמש. |
ALL_DATA_SOURCES |
יתבצע רענון של כל מקורות הנתונים והאובייקטים של מקור הנתונים המשויכים אליהם בגיליון האלקטרוני. |
DataSourceRefreshDailySchedule
לוח זמנים לרענון הנתונים מדי יום בפרק זמן נתון.
ייצוג JSON |
---|
{
"startTime": {
object ( |
שדות | |
---|---|
startTime |
שעת ההתחלה של מרווח הזמן שבו מתוזמן רענון של מקור נתונים. נעשה שימוש רק בחלק אחד ( |
TimeOfDay
מייצג שעה ביום. התאריך ואזור הזמן אינם משמעותיים או מצוינים במקום אחר. API עשוי לבחור לאפשר שניות מעבר. הסוגים הקשורים הם google.type.Date
ו-google.protobuf.Timestamp
.
ייצוג JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
שדות | |
---|---|
hours |
שעות ביום בפורמט 24 שעות. צריך להיות מספר בין 0 ל-23. ממשק API עשוי לאפשר את הערך '24:00:00' בתרחישים כמו שעת הסגירה של העסק. |
minutes |
דקות בשעה. חייב להיות בין 0 ל-59. |
seconds |
שניות של זמן. הערך בדרך כלל צריך להיות בין 0 ל-59. ממשק API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות שעברו. |
nanos |
שברים של שניות בננו-שניות. חייב להיות בין 0 ל-999,999,999. |
DataSourceRefreshWeeklySchedule
לוח זמנים שבועי לרענון הנתונים בימים ספציפיים בפרק זמן נתון.
ייצוג JSON |
---|
{ "startTime": { object ( |
שדות | |
---|---|
startTime |
שעת ההתחלה של מרווח הזמן שבו מתוזמן רענון של מקור נתונים. נעשה שימוש רק בחלק אחד ( |
daysOfWeek[] |
ימי השבוע לרענון. יש לציין לפחות יום אחד. |
DayOfWeek
מייצג יום בשבוע.
טיפוסים בני מנייה (enums) | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
היום בשבוע לא צוין. |
MONDAY |
שני |
TUESDAY |
שלישי |
WEDNESDAY |
רביעי |
THURSDAY |
חמישי |
FRIDAY |
שישי |
SATURDAY |
שבת |
SUNDAY |
ראשון |
DataSourceRefreshMonthlySchedule
לוח זמנים חודשי לרענון הנתונים בימים ספציפיים בחודש, בפרק זמן נתון.
ייצוג JSON |
---|
{
"startTime": {
object ( |
שדות | |
---|---|
startTime |
שעת ההתחלה של מרווח הזמן שבו מתוזמן רענון של מקור נתונים. נעשה שימוש רק בחלק אחד ( |
daysOfMonth[] |
ימים בחודש לרענון. יש תמיכה רק בערכים 1-28, והם ממופים ליום הראשון עד ליום ה-28. יש לציין לפחות יום אחד. |
מרווח
מייצג מרווח זמן, מקודד כהתחלה של חותמת זמן (כולל) וכסיום של חותמת זמן (לא כולל).
ההתחלה חייבת להיות שווה לסוף או קטנה ממנו. כשההתחלה זהה לסוף, המרווח ריק (ללא זמן תואם). אם לא נקבעות תאריכי התחלה וסיום, המרווח מתאים לכל זמן.
ייצוג JSON |
---|
{ "startTime": string, "endTime": string } |
שדות | |
---|---|
startTime |
זה שינוי אופציונלי. תחילת מרווח הזמן, כולל. אם צוינה חותמת זמן, חותמת זמן שתואמת למרווח הזמן הזה חייבת להיות זהה להתחלה או אחריה. |
endTime |
זה שינוי אופציונלי. סיום בלעדי של המרווח. אם מציינים חותמת זמן שתואמת למרווח הזמן, צריך לציין אותו לפני הסוף. |
שיטות |
|
---|---|
|
מחיל עדכון אחד או יותר על הגיליון האלקטרוני. |
|
יצירת גיליון אלקטרוני והחזרת הגיליון האלקטרוני החדש שנוצר. |
|
מחזירה את הגיליון האלקטרוני במזהה הנתון. |
|
מחזירה את הגיליון האלקטרוני במזהה הנתון. |