REST Resource: spreadsheets

משאב: גיליון אלקטרוני

משאב שמייצג גיליון אלקטרוני.

ייצוג JSON 
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
שדות
spreadsheetId

string

המזהה של הגיליון האלקטרוני. השדה הזה הוא לקריאה בלבד.
properties

object (SpreadsheetProperties)

המאפיינים הכוללים של גיליון אלקטרוני.
sheets[]

object (Sheet)

הגיליונות בגיליון האלקטרוני.
namedRanges[]

object (NamedRange)

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

string

כתובת ה-URL של הגיליון האלקטרוני. השדה הזה הוא לקריאה בלבד.
developerMetadata[]

object (DeveloperMetadata)

המטא-נתונים של המפתח שמשויכים לגיליון אלקטרוני.
dataSources[]

object (DataSource)

רשימה של מקורות נתונים חיצוניים שמחוברים לגיליון האלקטרוני.
dataSourceSchedules[]

object (DataSourceRefreshSchedule)

פלט בלבד. רשימת לוחות זמנים לרענון של מקורות נתונים.

SpreadsheetProperties

המאפיינים של גיליון אלקטרוני.

ייצוג JSON 
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
שדות
title

string

הכותרת של הגיליון האלקטרוני.
locale

string

המיקום של הגיליון האלקטרוני באחד מהפורמטים הבאים:

  • קוד שפה לפי תקן ISO 639-1, כמו en

  • קוד שפה לפי תקן ISO 639-2 כמו fil, אם לא קיים קוד 639-1

  • שילוב של קוד השפה לפי תקן ISO וקוד המדינה, כמו en_US

הערה: כשמעדכנים את השדה הזה, לא כל הלוקאלים/השפות נתמכים.
autoRecalc

enum (RecalculationInterval)

משך הזמן שצריך להמתין לפני חישוב מחדש של פונקציות תנודתיות.
timeZone

string

אזור הזמן בגיליון האלקטרוני, בפורמט CLDR, למשל America/New_York. אם אזור הזמן לא מזוהה, יכול להיות שמדובר באזור זמן מותאם אישית, כמו GMT-07:00.
defaultFormat

object (CellFormat)

פורמט ברירת המחדל של כל התאים בגיליון האלקטרוני. הערך CellData.effectiveFormat לא יוגדר אם פורמט התא שווה לפורמט ברירת המחדל הזה. השדה הזה הוא לקריאה בלבד.
iterativeCalculationSettings

object (IterativeCalculationSettings)

קובע אם הפניות מעגליות נפתרות באמצעות חישובים חוזרים, ובאיזה אופן. אם השדה הזה לא קיים, המשמעות היא שהפניות מעגליות גורמות לשגיאות חישוב.
spreadsheetTheme

object (SpreadsheetTheme)

העיצוב הוחל על הגיליון האלקטרוני.
importFunctionsExternalUrlAccessAllowed

boolean

הגדרה שקובעת אם לאפשר גישה לכתובת URL חיצונית לפונקציות של תמונות וייבוא. יש לקרוא רק אם הערך הוא True. אם הערך הוא False, אפשר להגדיר את הערך כ-true.

RecalculationInterval

מספור האפשרויות של מרווחי הזמן לחישוב מחדש.

טיפוסים בני מנייה (enum)
RECALCULATION_INTERVAL_UNSPECIFIED ערך ברירת המחדל. אסור להשתמש בערך הזה.
ON_CHANGE הפונקציות התנודתיות מתעדכנות בכל שינוי.
MINUTE הפונקציות התנודתיות מתעדכנות בכל שינוי ובכל דקה.
HOUR הפונקציות התנודתיות מתעדכנות בכל שעה ובכל שעה.

IterativeCalculationSettings

הגדרות לקביעת האופן שבו ניתן לפתור יחסי תלות מעגליים באמצעות חישובים חוזרים.

ייצוג JSON 
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
שדות
maxIterations

integer

כאשר חישוב איטרטיבי מופעל, המספר המקסימלי של סבבי חישוב שיש לבצע.
convergenceThreshold

number

כאשר החישוב האיטרטיבי מופעל והתוצאות העוקבות שונות בשיעור נמוך מערך הסף הזה, סבבי החישוב מפסיקים.

SpreadsheetTheme

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

ייצוג JSON 
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
שדות
primaryFontFamily

string

השם של משפחת הגופנים הראשית.
themeColors[]

object (ThemeColorPair)

זוגות הצבעים של הגיליון האלקטרוני. כדי לעדכן, צריך לספק את כל זוגות הצבע של העיצוב.

ThemeColorPair

זוג מיפוי של סוג צבע העיצוב של הגיליון האלקטרוני לצבע הבטון שהוא מייצג.

ייצוג JSON 
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
שדות
colorType

enum (ThemeColorType)

סוג צבע העיצוב של הגיליון האלקטרוני.
color

object (ColorStyle)

צבע הבטון שתואם לסוג צבע העיצוב.

NamedRange

טווח בעל שם.

ייצוג JSON 
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
שדות
namedRangeId

string

המזהה של טווח התאים בעל השם.
name

string

השם של טווח התאים בעל השם.
range

object (GridRange)

הטווח הזה.

DataSource

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

ייצוג JSON 
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
שדות
dataSourceId

string

המזהה הייחודי ברמת הגיליון האלקטרוני שמזהה את מקור הנתונים. דוגמה: 1080547365.
spec

object (DataSourceSpec)

השדה DataSourceSpec של מקור הנתונים שמקושר לגיליון האלקטרוני הזה.
calculatedColumns[]

object (DataSourceColumn)

כל העמודות המחושבות במקור הנתונים.
sheetId

integer

המזהה של Sheet שמקושר למקור הנתונים. לא ניתן לשנות את השדה לאחר שהוגדר.

כשיוצרים מקור נתונים, נוצר גם גיליון משויך מסוג DATA_SOURCE. אם לא מציינים את השדה, המזהה של הגיליון שנוצר יופק באופן אקראי.

DataSourceSpec

מציינים את הפרטים של מקור הנתונים. לדוגמה, ב-BigQuery מצוין מידע על המקור ב-BigQuery.

ייצוג JSON 
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
שדות
parameters[]

object (DataSourceParameter)

הפרמטרים של מקור הנתונים, שמשמשים לשליחת שאילתות לגבי מקור הנתונים.
שדה איחוד spec. המפרט בפועל לפי סוג של מקור נתונים. spec יכול להיות רק אחת מהאפשרויות הבאות:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

LookerDataSourceSpec.

BigQueryDataSourceSpec

המפרט של מקור נתונים ב-BigQuery שמחובר לגיליון.

ייצוג JSON 
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
שדות
projectId

string

המזהה של פרויקט ב-Google Cloud שהופעל בו BigQuery, שאליו מצורף חשבון לחיוב. כל שאילתות שמבוצעות מול מקור הנתונים מחוייבות בפרויקט.
שדה איחוד spec. המפרט בפועל. spec יכול להיות רק אחת מהאפשרויות הבאות:
querySpec

object (BigQueryQuerySpec)

BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec.

BigQueryQuerySpec

מציינת שאילתת BigQuery בהתאמה אישית.

ייצוג JSON 
{
  "rawQuery": string
}
שדות
rawQuery

string

מחרוזת השאילתה הגולמית.

BigQueryTableSpec

מציין הגדרת טבלה ב-BigQuery. מותר להשתמש רק בטבלאות מקוריות.

ייצוג JSON 
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
שדות
tableProjectId

string

המזהה של פרויקט BigQuery שאליו הטבלה שייכת. אם לא מציינים זאת, ההנחה היא שהמאפיין projectId.
tableId

string

מזהה הטבלה ב-BigQuery.
datasetId

string

מזהה מערך הנתונים ב-BigQuery.

LookerDataSourceSpec

המפרט של מקור נתונים של Looker.

ייצוג JSON 
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
שדות
instanceUri

string

כתובת ה-URL של המכונה של Looker.
model

string

שם המודל של Looker.
explore

string

השם של ניתוח מודל Looker.

DataSourceParameter

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

ייצוג JSON 
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד identifier. מזהה הפרמטר. identifier יכול להיות רק אחת מהאפשרויות הבאות:
name

string

פרמטר בעל שם. נדרש מזהה לגיטימי של DataSource שתומך בו. לדוגמה, מזהה BigQuery.
שדה איחוד value. ערך הפרמטר. value יכול להיות רק אחת מהאפשרויות הבאות:
namedRangeId

string

מזהה של NamedRange. הגודל שלה צריך להיות 1x1.
range

object (GridRange)

טווח שמכיל את הערך של הפרמטר. הגודל שלה צריך להיות 1x1.

DataSourceRefreshSchedule

תזמון של רענון מקור הנתונים.

מקורות נתונים בגיליון האלקטרוני מתעדכנים בפרק זמן מסוים. כדי לציין את שעת ההתחלה, לוחצים על הלחצן 'רענון מתוזמן' בעורך Sheets, אבל מרווח הזמן קבוע לאחר 4 שעות. לדוגמה, אם מציינים את שעת ההתחלה היא 8:00 , הרענון יתבצע בין 8:00 ל-12:00 מדי יום.

ייצוג JSON 
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
שדות
enabled

boolean

הערך הוא True אם לוח הזמנים לרענון מופעל. אחרת, הערך הוא False.
refreshScope

enum (DataSourceRefreshScope)

היקף הרענון. חייב להיות ALL_DATA_SOURCES.
nextRun

object (Interval)

פלט בלבד. מרווח הזמן של ההפעלה הבאה.
שדה איחוד schedule_config. הגדרות התזמון schedule_config יכולות להיות רק אחת מהאפשרויות הבאות:
dailySchedule

object (DataSourceRefreshDailySchedule)

לוח הזמנים לרענון יומי.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

לוח זמנים שבועי לרענון.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

לוח זמנים חודשי לרענון.

DataSourceRefreshScope

היקפי הרענון של מקור הנתונים.

טיפוסים בני מנייה (enum)
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED ערך ברירת המחדל, אין להשתמש בו.
ALL_DATA_SOURCES רענון של כל מקורות הנתונים והאובייקטים של מקור הנתונים שמשויכים אליהם בגיליון האלקטרוני.

DataSourceRefreshDailySchedule

לוח זמנים לרענון הנתונים כל יום במרווח זמן נתון.

ייצוג JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
שדות
startTime

object (TimeOfDay)

שעת ההתחלה של פרק זמן שבו מתוזמן רענון של מקור נתונים. רק חלק אחד (hours) נמצא בשימוש. הגודל של מרווח הזמן מוגדר כברירת מחדל בעורך Sheets.

TimeOfDay

מייצג שעה ביום. התאריך ואזור הזמן לא משמעותיים או שהם מצוינים במקום אחר. יכול להיות ש-API יבחר לאפשר שניות מדלגות. הסוגים הקשורים הם google.type.Date ו-google.protobuf.Timestamp.

ייצוג JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
שדות
hours

integer

שעות ביום בפורמט 24 שעות. צריך להיות מספר בין 0 ל-23. ממשק API עשוי לבחור לאפשר את הערך '24:00:00' לתרחישים כמו שעת הסגירה של העסק.
minutes

integer

דקות בשעה ביום. חייב להיות בין 0 ל-59.
seconds

integer

שניות של זמן. בדרך כלל הערך צריך להיות בין 0 ל-59. ה-API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות מדלגות.
nanos

integer

שברי שניות בננו-שניות. חייב להיות בין 0 ל-999,999,999.

DataSourceRefreshWeeklySchedule

לוח זמנים שבועי לרענון הנתונים בימים ספציפיים במרווח זמן נתון.

ייצוג JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
שדות
startTime

object (TimeOfDay)

שעת ההתחלה של פרק זמן שבו מתוזמן רענון של מקור נתונים. רק חלק אחד (hours) נמצא בשימוש. הגודל של מרווח הזמן מוגדר כברירת מחדל בעורך Sheets.
daysOfWeek[]

enum (DayOfWeek)

הימים בשבוע לרענון. יש לציין יום אחד לפחות.

DayOfWeek

מייצג יום בשבוע.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_UNSPECIFIED היום בשבוע לא צוין.
MONDAY שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

DataSourceRefreshMonthlySchedule

לוח זמנים חודשי לרענון נתונים בימים ספציפיים בחודש בפרק זמן נתון.

ייצוג JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
שדות
startTime

object (TimeOfDay)

שעת ההתחלה של פרק זמן שבו מתוזמן רענון של מקור נתונים. רק חלק אחד (hours) נמצא בשימוש. הגודל של מרווח הזמן מוגדר כברירת מחדל בעורך Sheets.
daysOfMonth[]

integer

הימים בחודש לרענון. יש תמיכה רק במספר 1-28, מתבצע מיפוי ליום הראשון ליום ה-28. צריך לציין לפחות יום אחד.

מרווח

מייצג פרק זמן שמקודד כהתחלה של חותמת זמן (כולל) וכסיום של חותמת זמן (לא כולל).

ההתחלה חייבת להיות קטנה מהסוף או שווה לו. כאשר ההתחלה שווה לסיום, המרווח ריק (לא תואם לזמן). אם לא צוינו תאריך התחלה וסיום, מרווח הזמן תואם לנקודת זמן כלשהי.

ייצוג JSON 
{
  "startTime": string,
  "endTime": string
}
שדות
startTime

string (Timestamp format)

זה שינוי אופציונלי. תחילת המרווח הכולל.

אם מציינים חותמת זמן שתואמת למרווח הזמן הזה, חותמת הזמן תואמת למרווח הזמן הזה צריכה להיות זהה לחותמת הזמן או אחריה.
endTime

string (Timestamp format)

זה שינוי אופציונלי. סיום בלעדי של המרווח.

אם צוין, חותמת זמן שתואמת למרווח הזמן הזה צריכה להופיע לפני הסוף.

שיטות

batchUpdate

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

create

 יצירת גיליון אלקטרוני, החזרת הגיליון האלקטרוני החדש שנוצר.

get

 מחזירה את הגיליון האלקטרוני עם המזהה הנתון.

getByDataFilter

 מחזירה את הגיליון האלקטרוני עם המזהה הנתון.