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

Mã của bảng tính. Trường này ở chế độ chỉ đọc.

object (SpreadsheetProperties)

Thuộc tính tổng thể của một bảng tính.

object (Sheet)

Các trang tính là một phần của bảng tính.

object (NamedRange)

Dải ô được đặt tên được xác định trong một bảng tính.

string

URL của bảng tính. Trường này ở chế độ chỉ đọc.

object (DeveloperMetadata)

Siêu dữ liệu nhà phát triển được liên kết với một bảng tính.

object (DataSource)

Danh sách các nguồn dữ liệu bên ngoài được kết nối với bảng tính.

object (DataSourceRefreshSchedule)

Chỉ có đầu ra. Danh sách lịch làm mới nguồn dữ liệu.

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

string

Tiêu đề của bảng tính.

string

Ngôn ngữ của bảng tính ở một trong các định dạng sau:

• mã ngôn ngữ theo tiêu chuẩn ISO 639-1 như en

• mã ngôn ngữ ISO 639-2 như fil, nếu không có mã 639-1

• tổ hợp mã ngôn ngữ ISO và mã quốc gia, chẳng hạn như en_US

Lưu ý: khi cập nhật trường này, không phải tất cả ngôn ngữ/ngôn ngữ đều được hỗ trợ.

enum (RecalculationInterval)

Khoảng thời gian phải chờ trước khi các hàm biến động được tính toán lại.

string

Múi giờ của bảng tính, ở định dạng CLDR, chẳng hạn như America/New_York. Nếu không nhận dạng được múi giờ này, đây có thể là múi giờ tùy chỉnh, chẳng hạn như GMT-07:00.

object (CellFormat)

Định dạng mặc định của tất cả các ô trong bảng tính. CellData.effectiveFormat sẽ không được đặt nếu định dạng của ô bằng với định dạng mặc định này. Trường này ở chế độ chỉ đọc.

object (IterativeCalculationSettings)

Xác định xem các tham chiếu vòng tròn có được giải quyết hay không và giải quyết bằng phép tính lặp lại. Nếu không có trường này có nghĩa là các tham chiếu vòng tròn dẫn đến lỗi tính toán.

object (SpreadsheetTheme)

Đã áp dụng giao diện cho bảng tính.

boolean

Liệu có cho phép truy cập URL bên ngoài đối với các hàm nhập và hình ảnh hay không. Chỉ đọc khi đúng. Khi đặt là false, bạn có thể đặt thành true.

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

integer

Khi bật tính năng tính toán lặp lại, số vòng tính toán tối đa cần thực hiện.

number

Khi bật tính năng tính toán lặp lại và các kết quả liên tiếp chênh lệch ít hơn giá trị ngưỡng này, thì các vòng tính toán sẽ dừng lại.

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

string

Tên của bộ phông chữ chính.

object (ThemeColorPair)

Cặp màu giao diện của bảng tính. Để cập nhật, bạn phải cung cấp tất cả cặp màu giao diện.

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

enum (ThemeColorType)

Loại màu giao diện của bảng tính.

object (ColorStyle)

Màu cụ thể tương ứng với loại màu giao diện.

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

string

Mã của dải ô được đặt tên.

string

Tên của dải ô được đặt tên.

object (GridRange)

Dải ô mà mảnh này biểu thị.

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

string

Mã nhận dạng duy nhất trong phạm vi bảng tính giúp xác định nguồn dữ liệu. Ví dụ: 1080547365.

object (DataSourceSpec)

DataSourceSpec cho nguồn dữ liệu được kết nối với bảng tính này.

object (DataSourceColumn)

Tất cả các cột đã tính toán trong nguồn dữ liệu.

integer

Mã của Sheet được kết nối với nguồn dữ liệu. Bạn không thể thay đổi trường này sau khi thiết lập.

Khi bạn tạo nguồn dữ liệu, trang tính DATA_SOURCE được liên kết cũng được tạo. Nếu bạn không chỉ định trường này, mã của trang tính đã tạo sẽ được tạo ngẫu nhiên.

{
  "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)

Các tham số của nguồn dữ liệu, được dùng khi truy vấn nguồn dữ liệu.

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

Mã của một dự án trên Google Cloud hỗ trợ BigQuery với một tài khoản thanh toán được đính kèm. Đối với mọi truy vấn được thực thi dựa trên nguồn dữ liệu, dự án sẽ bị tính phí.

object (BigQueryQuerySpec)

BigQueryQuerySpec.

object (BigQueryTableSpec)

BigQueryTableSpec.

{
  "rawQuery": string
}

string

Chuỗi truy vấn thô.

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

string

Mã của dự án BigQuery chứa bảng này. Nếu bạn không chỉ định, projectId sẽ được giả định.

string

Mã bảng BigQuery.

string

Mã tập dữ liệu BigQuery.

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

string

URL thực thể Looker.

string

Tên của một mô hình Looker.

string

Tên của dữ liệu khám phá mô hình 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

Tham số được đặt tên. Phải là giá trị nhận dạng hợp lệ của DataSource hỗ trợ giá trị nhận dạng đó. Ví dụ: Mã nhận dạng BigQuery.

string

Mã nhận dạng của NamedRange. Kích thước của hình ảnh phải là 1x1.

object (GridRange)

Dải ô chứa giá trị của tham số. Kích thước của hình ảnh phải là 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

Đúng nếu lịch làm mới được bật hoặc false nếu không bật lịch làm mới.

enum (DataSourceRefreshScope)

Phạm vi làm mới. Phải là ALL_DATA_SOURCES.

object (Interval)

Chỉ có đầu ra. Khoảng thời gian của lần chạy tiếp theo.

object (DataSourceRefreshDailySchedule)

Lịch làm mới hằng ngày.

object (DataSourceRefreshWeeklySchedule)

Lịch làm mới hằng tuần.

object (DataSourceRefreshMonthlySchedule)

Lịch làm mới hằng tháng.

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

object (TimeOfDay)

Thời gian bắt đầu của một khoảng thời gian mà theo đó một quá trình làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng phần hours. Kích thước khoảng thời gian được đặt mặc định là kích thước trong Trình chỉnh sửa Trang tính.

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

integer

Giờ trong ngày ở định dạng 24 giờ. Nên ở từ 0 đến 23. Một API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp.

integer

Số phút trong ngày. Phải từ 0 đến 59.

integer

Số giây của thời gian. Giá trị thường phải từ 0 đến 59. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây.

integer

Phân số giây tính bằng nano giây. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999.

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

object (TimeOfDay)

Thời gian bắt đầu của một khoảng thời gian mà theo đó một quá trình làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng phần hours. Kích thước khoảng thời gian được đặt mặc định là kích thước trong Trình chỉnh sửa Trang tính.

enum (DayOfWeek)

Ngày trong tuần để làm mới. Bạn phải chỉ định ít nhất một ngày.

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

object (TimeOfDay)

Thời gian bắt đầu của một khoảng thời gian mà theo đó một quá trình làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng phần hours. Kích thước khoảng thời gian được đặt mặc định là kích thước trong Trình chỉnh sửa Trang tính.

integer

Số ngày trong tháng cần làm mới. Chỉ hỗ trợ 1-28, ánh xạ từ ngày 1 đến ngày 28. Bạn phải chỉ định ít nhất một ngày.

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

string (Timestamp format)

Không bắt buộc. Bắt đầu khoảng thời gian.

Nếu được chỉ định, thì Dấu thời gian khớp với khoảng thời gian này sẽ phải giống nhau hoặc sau điểm bắt đầu.

string (Timestamp format)

Không bắt buộc. Loại trừ điểm kết thúc của khoảng thời gian.

Nếu được chỉ định, thì Dấu thời gian khớp với khoảng thời gian này sẽ phải trước thời điểm kết thúc.