- משאב: גיליון אלקטרוני
- SpreadsheetProperties
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- צבע
- ColorStyle
- ThemeColorType
- גבולות
- גבול
- סגנון
- ריפוי
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- קישור
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- גיליון
- SheetProperties
- SheetType
- GridProperties
- DataSourceSheetProperties
- 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
- LookerDataSourceSpec
- 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. אם האדמין הפעיל את התכונה של הוספה לרשימת ההיתרים, הערך הזה יתעקף ותמיד יוחזר true. |
RecalculationInterval
מספור האפשרויות של מרווחי הזמן לחישוב מחדש.
טיפוסים בני מנייה (enum) | |
---|---|
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 |
|
looker |
A [LookerDatasourceSpec][]. |
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. |
LookerDataSourceSpec
המפרט של מקור נתונים של Looker.
ייצוג JSON |
---|
{ "instanceUri": string, "model": string, "explore": string } |
שדות | |
---|---|
instanceUri |
כתובת URL של מכונה ב-Looker. |
model |
השם של מודל Looker. |
explore |
השם של ניתוח של מודל Looker. |
DataSourceParameter
פרמטר בשאילתה של מקור נתונים. הפרמטר מאפשר למשתמש להעביר ערכים מהגיליון האלקטרוני לשאילתה.
ייצוג ב-JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד identifier . מזהה הפרמטר. identifier יכול להיות רק אחת מהאפשרויות הבאות: |
|
name |
פרמטר בעל שם. נדרש מזהה לגיטימי של |
שדה האיחוד value . ערך הפרמטר. הערך של value יכול להיות רק אחת מהאפשרויות הבאות: |
|
namedRangeId |
מזהה של |
range |
טווח שמכיל את הערך של הפרמטר. הגודל שלה צריך להיות 1x1. |
DataSourceRefreshSchedule
תזמון לרענון מקור הנתונים.
מקורות נתונים בגיליון האלקטרוני מתעדכנים בפרק זמן מסוים. כדי לציין את שעת ההתחלה, לוחצים על הלחצן 'רענון מתוזמן' בעורך Sheets, אבל מרווח הזמן קבוע לאחר 4 שעות. לדוגמה, אם מציינים את שעת ההתחלה היא 8:00 , הרענון יתבצע בין 8:00 ל-12:00 מדי יום.
ייצוג JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
שדות | |
---|---|
enabled |
הערך הוא True אם לוח הזמנים לרענון מופעל. אחרת, הערך הוא False. |
refreshScope |
היקף הרענון. הערך חייב להיות |
nextRun |
פלט בלבד. מרווח הזמן של ההפעלה הבאה. |
שדה האיחוד schedule_config . ההגדרות של לוח הזמנים schedule_config יכולות להיות רק אחת מהאפשרויות הבאות: |
|
dailySchedule |
תזמון רענון יומי. |
weeklySchedule |
לוח זמנים שבועי לרענון. |
monthlySchedule |
לוח זמנים חודשי לרענון. |
DataSourceRefreshScope
היקפי הרענון של מקור הנתונים.
טיפוסים בני מנייה (enum) | |
---|---|
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
מייצג יום בשבוע.
טיפוסים בני מנייה (enum) | |
---|---|
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 |
זה שינוי אופציונלי. סיום בלעדי של המרווח. אם צוין, חותמת זמן שתואמת למרווח הזמן הזה צריכה להופיע לפני הסוף. |
שיטות |
|
---|---|
|
החלת עדכון אחד או יותר על הגיליון האלקטרוני. |
|
יצירת גיליון אלקטרוני, החזרת הגיליון האלקטרוני החדש שנוצר. |
|
מחזירה את הגיליון האלקטרוני עם המזהה הנתון. |
|
הפונקציה מחזירה את הגיליון האלקטרוני במזהה הנתון. |