REST Resource: spreadsheets

{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}

string

試算表 ID。這是唯讀欄位。

object (SpreadsheetProperties)

試算表的整體屬性。

object (Sheet)

試算表中的工作表。

object (NamedRange)

試算表中定義的已命名範圍。

string

試算表的網址。這是唯讀欄位。

object (DeveloperMetadata)

與試算表相關聯的開發人員中繼資料。

object (DataSource)

與試算表連結的外部資料來源清單。

object (DataSourceRefreshSchedule)

僅供輸出。資料來源重新整理時間表的清單。

{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}

string

試算表的標題。

string

試算表語言代碼，格式如下：

• 採用 ISO 639-1 語言代碼，例如 en

• 如果沒有 639-1 代碼，則採用 ISO 639-2 語言代碼，例如 fil

• 由 ISO 語言代碼和國家/地區代碼的組合，例如 en_US

注意：更新這個欄位時，並非所有語言代碼/語言都受到支援。

enum (RecalculationInterval)

重新計算易變函式之前要等待的時間長度。

string

試算表的時區，採 CLDR 格式，例如 America/New_York。無法識別的時區時，可能會是自訂時區，例如 GMT-07:00。

object (CellFormat)

試算表中所有儲存格的預設格式。如果儲存格的格式與這個預設格式相同，則不會設定「CellData.effectiveFormat」。這是唯讀欄位。

object (IterativeCalculationSettings)

確認是否以反覆計算的方式解析循環參照，以及解析方式。如未設定這個欄位，表示採用圓形參照會導致計算錯誤。

object (SpreadsheetTheme)

已套用至試算表的主題。

boolean

是否允許外部網址存取圖片和匯入函式。為 true 時僅可讀取。如果為 false，您可以將設為 true。

{
  "maxIterations": integer,
  "convergenceThreshold": number
}

integer

在啟用疊代計算時，要執行的計算次數上限。

number

如果已啟用疊代計算，連續結果低於這個門檻值時，系統會停止計算。

{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}

string

主要字型系列的名稱。

object (ThemeColorPair)

試算表主題色彩組合。如要更新，必須提供所有主題色彩組合。

{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}

enum (ThemeColorType)

試算表主題顏色的類型。

object (ColorStyle)

與主題顏色類型對應的具體顏色。

{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}

string

已命名範圍的 ID。

string

已命名範圍的名稱。

object (GridRange)

代表的範圍。

{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}

string

用於識別資料來源的試算表範圍專屬 ID。範例：1080547365。

object (DataSourceSpec)

與這份試算表連結的資料來源 DataSourceSpec。

object (DataSourceColumn)

資料來源中的所有計算結果欄。

integer

與資料來源連結的 Sheet ID。設定這個欄位後即無法變更。

建立資料來源時，系統也會建立相關聯的 DATA_SOURCE 工作表；如未指定該欄位，系統會隨機產生所建工作表的 ID。

{
  "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.
}

object (DataSourceParameter)

資料來源參數，在查詢資料來源時使用。

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec。

object (LookerDataSourceSpec)

LookerDataSourceSpec。

{
  "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.
}

string

已啟用 BigQuery 且已連結帳單帳戶的 Google Cloud 專案 ID。系統會針對資料來源執行的任何查詢收取專案費用。

object (BigQueryQuerySpec)

BigQueryQuerySpec。

object (BigQueryTableSpec)

BigQueryTableSpec。

{
  "rawQuery": string
}

string

原始查詢字串。

{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}

string

資料表所屬的 BigQuery 專案的 ID。如果未指定，系統會假設使用 projectId。

string

BigQuery 資料表 ID。

string

BigQuery 資料集 ID。

{
  "instanceUri": string,
  "model": string,
  "explore": string
}

string

Looker 執行個體網址。

string

Looker 模型名稱。

string

Looker 模型探索項目的名稱。

{

  // 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.
}

string

已命名參數。必須是支援該函式的 DataSource 的合法 ID。例如 BigQuery ID。

string

NamedRange 的 ID。大小必須為 1x1。

object (GridRange)

包含參數值的範圍。大小必須為 1x1。

{
  "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.
}

boolean

如果已啟用重新整理時間表，則為「是」；否則傳回「否」。

enum (DataSourceRefreshScope)

重新整理的範圍。必須為 ALL_DATA_SOURCES。

object (Interval)

僅供輸出。下次執行作業的時間間隔。

object (DataSourceRefreshDailySchedule)

每日重新整理時間表。

object (DataSourceRefreshWeeklySchedule)

每週重新整理時間表。

object (DataSourceRefreshMonthlySchedule)

每月重新整理時間表。

{
  "startTime": {
    object (TimeOfDay)
  }
}

object (TimeOfDay)

排定資料來源重新整理作業的時間間隔開始時間。只使用 hours 部分。時間間隔的預設大小在試算表編輯器中。

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

一天的營業時間，以 24 小時製表示。值應介於 0 到 23 之間。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。

integer

一天內的分鐘數。值必須介於 0 到 59 之間。

integer

時間的秒數。正常情況下，值必須介於 0 到 59 之間。如果 API 允許閏秒，則可允許值為 60。

integer

秒數的小數，以奈秒表示。值必須介於 0 到 999,999,999 之間。

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}

object (TimeOfDay)

排定資料來源重新整理作業的時間間隔開始時間。只使用 hours 部分。時間間隔的預設大小在試算表編輯器中。

enum (DayOfWeek)

一週中要重新整理的天數。至少須指定一天。

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}

object (TimeOfDay)

排定資料來源重新整理作業的時間間隔開始時間。只使用 hours 部分。時間間隔的預設大小在試算表編輯器中。

integer

當月要重新整理的天數。系統只支援 1 到 28 這個字串，對應至第 1 天到第 28 天。至少須指定一天。

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

選用設定。包括該區間的開始時間 (包括在內)。

如有指定，這個間隔的時間戳記必須等於或晚於開始時間。

string (Timestamp format)

選用設定。排除時段的排除範圍結束。

如有指定，這個間隔的時間戳記必須早於結束時間。