Sheets

Trang tính

Một trang tính trong bảng tính.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Trường
properties

object (SheetProperties)

Các thuộc tính của trang tính.

data[]

object (GridData)

Dữ liệu trong lưới, nếu đây là một trang tính dạng lưới.

Số lượng đối tượng GridData được trả về phụ thuộc vào số lượng dải ô được yêu cầu trên trang tính này. Ví dụ: nếu đây là Sheet1 và bảng tính được yêu cầu có các dải ô Sheet1!A1:C10 và Sheet1!D15:E20, thì GridData đầu tiên sẽ có startRow/startColumn là 0, trong khi GridData thứ hai sẽ có startRow 14 (hàng 15 dựa trên 0) và startColumn 3 (cột D dựa trên 0).

Đối với trang DATA_SOURCE, bạn không thể yêu cầu một dải ô cụ thể, GridData chứa tất cả các giá trị.

merges[]

object (GridRange)

Các dải ô được hợp nhất với nhau.

conditionalFormats[]

object (ConditionalFormatRule)

Các quy tắc định dạng có điều kiện trong trang tính này.

filterViews[]

object (FilterView)

Các chế độ xem bộ lọc trong trang tính này.

protectedRanges[]

object (ProtectedRange)

Dải ô được bảo vệ trong trang tính này.

basicFilter

object (BasicFilter)

Bộ lọc trên trang tính này (nếu có).

charts[]

object (EmbeddedChart)

Thông số kỹ thuật của mọi biểu đồ trên trang tính này.

bandedRanges[]

object (BandedRange)

Các dải ô có màu xen kẽ trên trang tính này.

developerMetadata[]

object (DeveloperMetadata)

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

rowGroups[]

object (DimensionGroup)

Tất cả các nhóm hàng trên trang tính này, được sắp xếp theo chỉ mục bắt đầu dải ô tăng dần, sau đó theo độ sâu của nhóm.

columnGroups[]

object (DimensionGroup)

Tất cả các nhóm cột trên trang tính này, được sắp xếp theo chỉ mục bắt đầu dải ô tăng dần, sau đó theo độ sâu của nhóm.

slicers[]

object (Slicer)

Các bộ chọn trên trang tính này.

tables[]

object (Table)

Các bảng trên trang tính này.

SheetProperties

Thuộc tính của trang tính.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Trường
sheetId

integer

Mã nhận dạng của trang tính. Phải là số không âm. Bạn không thể thay đổi trường này sau khi thiết lập.

title

string

Tên của trang tính.

index

integer

Chỉ mục của trang tính trong bảng tính. Khi thêm hoặc cập nhật các thuộc tính của trang tính, nếu bạn loại trừ trường này thì trang tính sẽ được thêm hoặc di chuyển đến cuối danh sách trang tính. Khi cập nhật chỉ mục trang tính hoặc chèn trang tính, thao tác di chuyển sẽ được xem xét trong chỉ mục "trước khi di chuyển". Ví dụ: nếu có 3 trang tính (S1, S2, S3) để di chuyển S1 lên trước S2, thì bạn phải đặt chỉ mục thành 2. Yêu cầu cập nhật chỉ mục trang tính sẽ bị bỏ qua nếu chỉ mục được yêu cầu giống với chỉ mục hiện tại của trang tính hoặc nếu chỉ mục mới được yêu cầu bằng với chỉ mục hiện tại của trang tính + 1.

sheetType

enum (SheetType)

Loại trang tính. Giá trị mặc định là GRID. Bạn không thể thay đổi trường này sau khi thiết lập.

gridProperties

object (GridProperties)

Các thuộc tính bổ sung của trang tính nếu trang tính này là một lưới. (Nếu trang tính là một trang tính đối tượng, có chứa biểu đồ hoặc hình ảnh, thì trường này sẽ không xuất hiện.) Khi ghi, bạn không được đặt bất kỳ thuộc tính lưới nào trên các trang tính không phải là lưới.

Nếu trang này là trang DATA_SOURCE, thì trường này chỉ được xuất nhưng chứa các thuộc tính phản ánh cách trang nguồn dữ liệu được hiển thị trong giao diện người dùng, ví dụ: rowCount.

hidden

boolean

True nếu trang tính bị ẩn trong giao diện người dùng, false nếu trang tính hiển thị.

tabColor
(deprecated)

object (Color)

Màu của thẻ trong giao diện người dùng. Không dùng nữa: Sử dụng tabColorStyle.

tabColorStyle

object (ColorStyle)

Màu của thẻ trong giao diện người dùng. Nếu bạn cũng đặt tabColor, thì trường này sẽ được ưu tiên.

rightToLeft

boolean

True nếu trang tính là trang tính RTL thay vì trang tính LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Chỉ có đầu ra. Nếu có, trường này chứa các thuộc tính cụ thể của trang tính DATA_SOURCE.

SheetType

Loại trang tính.

Enum
SHEET_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
GRID Trang tính là một lưới.
OBJECT Trang tính không có lưới mà có một đối tượng như biểu đồ hoặc hình ảnh.
DATA_SOURCE Trang tính kết nối với một DataSource bên ngoài và cho thấy bản xem trước dữ liệu.

GridProperties

Thuộc tính của lưới.

Biểu diễn dưới dạng JSON 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
Trường
rowCount

integer

Số hàng trong lưới.

columnCount

integer

Số cột trong lưới.

frozenRowCount

integer

Số hàng được cố định trong lưới.

frozenColumnCount

integer

Số cột được cố định trong lưới.

hideGridlines

boolean

Đúng nếu lưới không hiển thị đường lưới trong giao diện người dùng.

rowGroupControlAfter

boolean

Đúng nếu nút bật/tắt điều khiển nhóm hàng xuất hiện sau nhóm.

columnGroupControlAfter

boolean

Đúng nếu nút bật/tắt điều khiển nhóm cột xuất hiện sau nhóm.

DataSourceSheetProperties

Các thuộc tính bổ sung của trang DATA_SOURCE.

Biểu diễn dưới dạng JSON 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Trường
dataSourceId

string

Mã nhận dạng của DataSource mà trang tính được kết nối.

columns[]

object (DataSourceColumn)

Các cột xuất hiện trên trang tính, tương ứng với các giá trị trong RowData.

dataExecutionStatus

object (DataExecutionStatus)

Trạng thái thực thi dữ liệu.

GridData

Dữ liệu trong lưới, cũng như siêu dữ liệu về các phương diện.

Biểu diễn dưới dạng JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Trường
startRow

integer

Hàng đầu tiên mà GridData này đề cập đến, được tính từ 0.

startColumn

integer

Cột đầu tiên mà GridData này đề cập đến, được tính từ 0.

rowData[]

object (RowData)

Dữ liệu trong lưới, mỗi mục nhập trên một hàng, bắt đầu bằng hàng trong startRow. Các giá trị trong RowData sẽ tương ứng với các cột bắt đầu từ startColumn.

rowMetadata[]

object (DimensionProperties)

Siêu dữ liệu về các hàng được yêu cầu trong lưới, bắt đầu bằng hàng trong startRow.

columnMetadata[]

object (DimensionProperties)

Siêu dữ liệu về các cột được yêu cầu trong lưới, bắt đầu bằng cột trong startColumn.

RowData

Dữ liệu về từng ô trong một hàng.

Biểu diễn dưới dạng JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Trường
values[]

object (CellData)

Các giá trị trong hàng, mỗi giá trị cho một cột.

DimensionProperties

Các thuộc tính về một phương diện.

Biểu diễn dưới dạng JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Trường
hiddenByFilter

boolean

Đúng nếu phương diện này đang được lọc. Trường này ở chế độ chỉ đọc.

hiddenByUser

boolean

True nếu phương diện này bị ẩn một cách rõ ràng.

pixelSize

integer

Chiều cao (nếu là hàng) hoặc chiều rộng (nếu là cột) của phương diện tính bằng pixel.

developerMetadata[]

object (DeveloperMetadata)

Siêu dữ liệu nhà phát triển được liên kết với một hàng hoặc cột duy nhất.

dataSourceColumnReference

object (DataSourceColumnReference)

Chỉ có đầu ra. Nếu được đặt, đây là một cột trong trang nguồn dữ liệu.

ConditionalFormatRule

Một quy tắc mô tả định dạng có điều kiện.

Biểu diễn dưới dạng JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Trường
ranges[]

object (GridRange)

Các dải ô được định dạng nếu điều kiện là đúng. Tất cả các dải ô phải nằm trên cùng một lưới.

Trường nhóm rule. Bạn phải đặt chính xác một quy tắc kiểm soát định dạng có điều kiện này. rule chỉ có thể là một trong những trạng thái sau:
booleanRule

object (BooleanRule)

Định dạng là "bật" hoặc "tắt" theo quy tắc.

gradientRule

object (GradientRule)

Định dạng sẽ thay đổi tuỳ theo các chuyển màu trong quy tắc.

BooleanRule

Một quy tắc có thể khớp hoặc không khớp, tuỳ thuộc vào điều kiện.

Biểu diễn dưới dạng JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Trường
condition

object (BooleanCondition)

Điều kiện của quy tắc. Nếu điều kiện được đánh giá là đúng, thì định dạng sẽ được áp dụng.

format

object (CellFormat)

Định dạng cần áp dụng. Định dạng có điều kiện chỉ có thể áp dụng một số định dạng: bold, italic, strikethrough, foreground color và, background color.

GradientRule

Một quy tắc áp dụng định dạng thang màu chuyển màu, dựa trên các điểm nội suy được liệt kê. Định dạng của một ô sẽ thay đổi dựa trên nội dung của ô đó so với giá trị của các điểm nội suy.

Biểu diễn dưới dạng JSON 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Trường
minpoint

object (InterpolationPoint)

Điểm nội suy bắt đầu.

midpoint

object (InterpolationPoint)

Một điểm nội suy ở giữa (không bắt buộc).

maxpoint

object (InterpolationPoint)

Điểm nội suy cuối cùng.

InterpolationPoint

Một điểm nội suy duy nhất trong định dạng có điều kiện theo độ dốc. Các chân này sẽ ghim thang màu chuyển sắc theo màu sắc, loại và giá trị đã chọn.

Biểu diễn dưới dạng JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Trường
color
(deprecated)

object (Color)

Màu mà điểm nội suy này sẽ dùng. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu mà điểm nội suy này sẽ dùng. Nếu bạn cũng đặt color, thì trường này sẽ được ưu tiên.

type

enum (InterpolationPointType)

Cách diễn giải giá trị.

value

string

Giá trị mà điểm nội suy này sử dụng. Có thể là một công thức. Không dùng nếu type là MIN hoặc MAX.

InterpolationPointType

Loại điểm nội suy.

Enum
INTERPOLATION_POINT_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
MIN Điểm nội suy sử dụng giá trị tối thiểu trong các ô trên phạm vi của định dạng có điều kiện.
MAX Điểm nội suy sử dụng giá trị tối đa trong các ô trên phạm vi của định dạng có điều kiện.
NUMBER Điểm nội suy sử dụng chính xác giá trị trong InterpolationPoint.value.
PERCENT

Điểm nội suy là tỷ lệ phần trăm đã cho trên tất cả các ô trong phạm vi của định dạng có điều kiện. Điều này tương đương với NUMBER nếu giá trị là =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (trong đó các lỗi trong dải ô sẽ bị bỏ qua khi làm phẳng).

PERCENTILE Điểm nội suy là phân vị số đã cho trên tất cả các ô trong phạm vi của định dạng có điều kiện. Điều này tương đương với NUMBER nếu giá trị là: =PERCENTILE(FLATTEN(range), value / 100) (trong đó các lỗi trong dải ô sẽ bị bỏ qua khi làm phẳng).

FilterView

Chế độ xem bộ lọc. Để biết thêm thông tin, hãy xem bài viết Quản lý chế độ hiển thị dữ liệu bằng bộ lọc.

Biểu diễn dưới dạng JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Trường
filterViewId

integer

Mã nhận dạng của chế độ xem bộ lọc.

title

string

Tên của chế độ xem bộ lọc.

range

object (GridRange)

Dải ô mà chế độ xem bộ lọc này bao gồm.

Khi ghi, bạn chỉ có thể đặt một trong các tham số range, namedRangeId hoặc tableId.

namedRangeId

string

Dải ô được đặt tên mà chế độ xem bộ lọc này dựa vào (nếu có).

Khi ghi, bạn chỉ có thể đặt một trong các tham số range, namedRangeId hoặc tableId.

tableId

string

Bảng mà chế độ xem bộ lọc này dựa vào (nếu có).

Khi ghi, bạn chỉ có thể đặt một trong các tham số range, namedRangeId hoặc tableId.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp theo cột. Các quy cách sau này được sử dụng khi các giá trị bằng nhau trong các quy cách trước đó.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Tiêu chí để hiện/ẩn giá trị cho mỗi cột. Khoá của bản đồ là chỉ mục cột và giá trị là tiêu chí cho cột đó.

Trường này không còn dùng nữa mà thay bằng filterSpecs.

filterSpecs[]

object (FilterSpec)

Tiêu chí lọc để hiện hoặc ẩn giá trị theo cột.

Cả criteria và filterSpecs đều được điền vào các phản hồi. Nếu bạn chỉ định cả hai trường trong một yêu cầu cập nhật, thì trường này sẽ được ưu tiên.

ProtectedRange

Dải ô được bảo vệ.

Biểu diễn dưới dạng JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Trường
protectedRangeId

integer

Mã nhận dạng của dải ô được bảo vệ. Trường này ở chế độ chỉ đọc.

range

object (GridRange)

Dải ô đang được bảo vệ. Phạm vi có thể hoàn toàn không có giới hạn. Trong trường hợp đó, đây được coi là một trang tính được bảo vệ.

Khi ghi, bạn chỉ có thể đặt một trong các giá trị range, namedRangeId hoặc tableId.

namedRangeId

string

Phạm vi đã đặt tên mà dải ô được bảo vệ này dựa vào (nếu có).

Khi ghi, bạn chỉ có thể đặt một trong các giá trị range, namedRangeId hoặc tableId.

tableId

string

Bảng mà dải ô được bảo vệ này hỗ trợ (nếu có).

Khi ghi, bạn chỉ có thể đặt một trong các giá trị range, namedRangeId hoặc tableId.

description

string

Nội dung mô tả về dải ô được bảo vệ này.

warningOnly

boolean

True nếu dải ô được bảo vệ này sẽ hiển thị cảnh báo khi chỉnh sửa. Chế độ bảo vệ dựa trên cảnh báo có nghĩa là mọi người dùng đều có thể chỉnh sửa dữ liệu trong dải ô được bảo vệ, ngoại trừ việc chỉnh sửa sẽ nhắc người dùng xác nhận nội dung chỉnh sửa.

Khi ghi: nếu trường này là true, thì editors sẽ bị bỏ qua. Ngoài ra, nếu trường này thay đổi từ true thành false và trường editors không được đặt (cũng không có trong mặt nạ trường), thì người chỉnh sửa sẽ được đặt thành tất cả người chỉnh sửa trong tài liệu.

requestingUserCanEdit

boolean

True nếu người dùng yêu cầu dải ô được bảo vệ này có thể chỉnh sửa vùng được bảo vệ. Trường này ở chế độ chỉ đọc.

unprotectedRanges[]

object (GridRange)

Danh sách các dải ô không được bảo vệ trong một trang tính được bảo vệ. Dải ô không được bảo vệ chỉ được hỗ trợ trên các trang tính được bảo vệ.

editors

object (Editors)

Những người dùng và nhóm có quyền chỉnh sửa dải ô được bảo vệ. Chỉ những người dùng có quyền chỉnh sửa dải ô được bảo vệ và tài liệu mới nhìn thấy trường này. Không hỗ trợ người chỉnh sửa có chế độ bảo vệ warningOnly.

Trình chỉnh sửa

Người chỉnh sửa của một dải ô được bảo vệ.

Biểu diễn dưới dạng JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Trường
users[]

string

Địa chỉ email của những người dùng có quyền chỉnh sửa dải ô được bảo vệ.

groups[]

string

Địa chỉ email của các nhóm có quyền chỉnh sửa dải ô được bảo vệ.

domainUsersCanEdit

boolean

Trả về giá trị true nếu bất kỳ ai trong miền của tài liệu đều có quyền chỉnh sửa dải ô được bảo vệ. Tính năng bảo vệ miền chỉ được hỗ trợ trên các tài liệu trong một miền.

BasicFilter

Bộ lọc mặc định được liên kết với một trang tính. Để biết thêm thông tin, hãy xem bài viết Quản lý chế độ hiển thị dữ liệu bằng bộ lọc.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Trường
range

object (GridRange)

Phạm vi mà bộ lọc bao phủ.

tableId

string

Bảng mà bộ lọc này dựa vào (nếu có). Khi ghi, bạn chỉ có thể đặt một trong range hoặc tableId.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp theo cột. Các quy cách sau này được sử dụng khi các giá trị bằng nhau trong các quy cách trước đó.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Tiêu chí để hiện/ẩn giá trị cho mỗi cột. Khoá của bản đồ là chỉ mục cột và giá trị là tiêu chí cho cột đó.

Trường này không còn dùng nữa mà thay bằng filterSpecs.

filterSpecs[]

object (FilterSpec)

Tiêu chí lọc cho mỗi cột.

Cả criteria và filterSpecs đều được điền vào các phản hồi. Nếu bạn chỉ định cả hai trường trong một yêu cầu cập nhật, thì trường này sẽ được ưu tiên.

BandedRange

Một dải ô có màu xen kẽ trong trang tính.

Biểu diễn dưới dạng JSON 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Trường
bandedRangeId

integer

Mã nhận dạng của dải tần. Nếu bạn không đặt, hãy tham khảo bandedRangeReference.

bandedRangeReference

string

Chỉ có đầu ra. Giá trị tham chiếu của dải có phân cấp, dùng để xác định mã nhận dạng không được bandedRangeId hỗ trợ.

range

object (GridRange)

Phạm vi áp dụng các thuộc tính này.

rowProperties

object (BandingProperties)

Thuộc tính cho các dải hàng. Các thuộc tính này được áp dụng theo từng hàng trong tất cả các hàng của dải ô. Bạn phải chỉ định ít nhất một trong hai thuộc tính rowProperties hoặc columnProperties.

columnProperties

object (BandingProperties)

Thuộc tính cho dải cột. Các thuộc tính này được áp dụng theo từng cột trong tất cả các cột trong dải ô. Bạn phải chỉ định ít nhất một trong hai thuộc tính rowProperties hoặc columnProperties.

BandingProperties

Các thuộc tính đề cập đến một phương diện duy nhất (hàng hoặc cột). Nếu bạn đặt cả BandedRange.row_properties và BandedRange.column_properties, thì màu nền sẽ được áp dụng cho các ô theo các quy tắc sau:

Ví dụ: màu của hàng đầu tiên sẽ được ưu tiên hơn màu của cột đầu tiên, nhưng màu của cột đầu tiên sẽ được ưu tiên hơn màu của hàng thứ hai. Tương tự, tiêu đề hàng sẽ được ưu tiên hơn tiêu đề cột trong ô trên cùng bên trái, nhưng tiêu đề cột sẽ được ưu tiên hơn màu của hàng đầu tiên nếu bạn không đặt tiêu đề hàng.

Biểu diễn dưới dạng JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Trường
headerColor
(deprecated)

object (Color)

Màu của hàng hoặc cột đầu tiên. Nếu bạn đặt trường này, hàng hoặc cột đầu tiên sẽ được điền bằng màu này và các màu sẽ thay đổi giữa firstBandColor và secondBandColor, bắt đầu từ hàng hoặc cột thứ hai. Nếu không, hàng hoặc cột đầu tiên sẽ được điền bằng firstBandColor và các màu sẽ tiếp tục thay đổi như bình thường. Không dùng nữa: Sử dụng headerColorStyle.

headerColorStyle

object (ColorStyle)

Màu của hàng hoặc cột đầu tiên. Nếu bạn đặt trường này, hàng hoặc cột đầu tiên sẽ được điền bằng màu này và các màu sẽ thay đổi giữa firstBandColor và secondBandColor, bắt đầu từ hàng hoặc cột thứ hai. Nếu không, hàng hoặc cột đầu tiên sẽ được điền bằng firstBandColor và các màu sẽ tiếp tục thay đổi như bình thường. Nếu bạn cũng đặt headerColor, thì trường này sẽ được ưu tiên.

firstBandColor
(deprecated)

object (Color)

Màu đầu tiên được xen kẽ. (Bắt buộc) Không dùng nữa: Sử dụng firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Màu đầu tiên được xen kẽ. (Bắt buộc) Nếu bạn cũng đặt firstBandColor, thì trường này sẽ được ưu tiên.

secondBandColor
(deprecated)

object (Color)

Màu thứ hai được xen kẽ. (Bắt buộc) Không dùng nữa: Sử dụng secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Màu thứ hai được xen kẽ. (Bắt buộc) Nếu bạn cũng đặt secondBandColor, thì trường này sẽ được ưu tiên.

footerColor
(deprecated)

object (Color)

Màu của hàng hoặc cột cuối cùng. Nếu bạn không đặt trường này, hàng hoặc cột cuối cùng sẽ được điền bằng firstBandColor hoặc secondBandColor, tuỳ thuộc vào màu của hàng hoặc cột trước đó. Không dùng nữa: Sử dụng footerColorStyle.

footerColorStyle

object (ColorStyle)

Màu của hàng hoặc cột cuối cùng. Nếu bạn không đặt trường này, hàng hoặc cột cuối cùng sẽ được điền bằng firstBandColor hoặc secondBandColor, tuỳ thuộc vào màu của hàng hoặc cột trước đó. Nếu bạn cũng đặt footerColor, thì trường này sẽ được ưu tiên.

DimensionGroup

Một nhóm trên một khoảng hàng hoặc cột trong trang tính, có thể chứa hoặc được chứa trong các nhóm khác. Bạn có thể thu gọn hoặc mở rộng một nhóm dưới dạng một đơn vị trên trang tính.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Trường
range

object (DimensionRange)

Phạm vi mà nhóm này tồn tại.

depth

integer

Độ sâu của nhóm, biểu thị số lượng nhóm có một phạm vi chứa toàn bộ phạm vi của nhóm này.

collapsed

boolean

Trường này có giá trị true nếu nhóm này bị thu gọn. Một nhóm thu gọn vẫn ở trạng thái thu gọn nếu một nhóm trùng lặp ở độ sâu nông hơn được mở rộng.

Giá trị true không ngụ ý rằng tất cả các phương diện trong nhóm đều bị ẩn, vì chế độ hiển thị của một phương diện có thể thay đổi độc lập với thuộc tính nhóm này. Tuy nhiên, khi thuộc tính này được cập nhật, tất cả các phương diện trong thuộc tính đó sẽ được đặt thành ẩn nếu trường này là true hoặc được đặt thành hiển thị nếu trường này là false.

Bộ cắt

Một bộ lọc cắt trong trang tính.

Biểu diễn dưới dạng JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Trường
slicerId

integer

Mã nhận dạng của bộ cắt.

spec

object (SlicerSpec)

Quy cách của bộ cắt.

position

object (EmbeddedObjectPosition)

Vị trí của bộ chọn lát cắt. Xin lưu ý rằng bạn chỉ có thể đặt bộ lọc trên trang tính hiện có. Ngoài ra, chiều rộng và chiều cao của bộ chọn có thể được điều chỉnh tự động để nằm trong giới hạn cho phép.

SlicerSpec

Quy cách của bộ cắt.

Biểu diễn dưới dạng JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Trường
dataRange

object (GridRange)

Phạm vi dữ liệu của bộ cắt.

filterCriteria

object (FilterCriteria)

Tiêu chí lọc của bộ cắt.

columnIndex

integer

Chỉ mục cột dựa trên 0 trong bảng dữ liệu mà bộ lọc được áp dụng.

applyToPivotTables

boolean

True nếu bộ lọc sẽ áp dụng cho bảng tổng hợp. Nếu không được thiết lập, giá trị mặc định sẽ là True.

title

string

Tiêu đề của bộ lọc.

textFormat

object (TextFormat)

Định dạng văn bản của tiêu đề trong bộ chọn lát. Trường liên kết không được hỗ trợ.

backgroundColor
(deprecated)

object (Color)

Màu nền của bộ chọn lát. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Màu nền của bộ chọn lát. Nếu bạn cũng đặt backgroundColor, thì trường này sẽ được ưu tiên.

horizontalAlignment

enum (HorizontalAlign)

Hướng căn chỉnh ngang của tiêu đề trong bộ chọn. Nếu bạn không chỉ định, giá trị mặc định sẽ là LEFT

Bảng

Một bảng.

Biểu diễn dưới dạng JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Trường
tableId

string

Mã của bảng.

name

string

Tên bảng. Giá trị này là duy nhất đối với tất cả các bảng trong cùng một bảng tính.

range

object (GridRange)

Dải ô của bảng.

rowsProperties

object (TableRowsProperties)

Thuộc tính của hàng trong bảng.

columnProperties[]

object (TableColumnProperties)

Thuộc tính cột của bảng.

TableRowsProperties

Thuộc tính của hàng trong bảng.

Biểu diễn dưới dạng JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Trường
headerColorStyle

object (ColorStyle)

Màu của hàng tiêu đề. Nếu bạn đặt trường này, hàng tiêu đề sẽ được tô màu đã chỉ định. Nếu không, hàng tiêu đề sẽ được tô bằng màu mặc định.

firstBandColorStyle

object (ColorStyle)

Màu đầu tiên được xen kẽ. Nếu bạn đặt trường này, hàng có dải màu đầu tiên sẽ được tô bằng màu đã chỉ định. Nếu không, hàng có dải màu đầu tiên sẽ được điền bằng màu mặc định.

secondBandColorStyle

object (ColorStyle)

Màu thứ hai được xen kẽ. Nếu bạn đặt trường này, hàng có dải màu thứ hai sẽ được tô bằng màu đã chỉ định. Nếu không, hàng có sọc thứ hai sẽ được tô bằng màu mặc định.

footerColorStyle

object (ColorStyle)

Màu của hàng cuối cùng. Nếu bạn không đặt trường này, thì chân trang sẽ không được thêm, hàng cuối cùng sẽ được điền bằng firstBandColorStyle hoặc secondBandColorStyle, tuỳ thuộc vào màu của hàng trước đó. Nếu bạn cập nhật một bảng hiện có không có chân trang để có chân trang, thì phạm vi sẽ được mở rộng thêm 1 hàng. Nếu bạn đang cập nhật một bảng hiện có có chân trang và xoá chân trang, thì dải ô sẽ giảm đi 1 hàng.

TableColumnProperties

Cột của bảng.

Biểu diễn dưới dạng JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Trường
columnIndex

integer

Chỉ mục cột bắt đầu từ 0. Chỉ mục này tương ứng với vị trí của chỉ mục trong bảng và không nhất thiết phải giống với chỉ mục cột trong trang tính.

columnName

string

Tên cột.

columnType

enum (ColumnType)

Loại cột.

dataValidationRule

object (TableColumnDataValidationRule)

Quy tắc xác thực dữ liệu cột. Chỉ đặt cho loại cột trình đơn thả xuống.

ColumnType

Loại cột cho một cột nhất định trong bảng.

Enum
COLUMN_TYPE_UNSPECIFIED Một loại cột chưa chỉ định.
DOUBLE Loại cột số.
CURRENCY Loại cột đơn vị tiền tệ.
PERCENT Loại cột phần trăm.
DATE Loại cột ngày.
TIME Loại cột thời gian.
DATE_TIME Loại cột ngày và giờ.
TEXT Loại cột văn bản.
BOOLEAN Loại cột boolean.
DROPDOWN Loại cột trình đơn thả xuống.
FILES_CHIP Loại cột khối tệp
PEOPLE_CHIP Loại cột khối người dùng
FINANCE_CHIP Loại cột khối tài chính
PLACE_CHIP Loại cột là khối địa điểm
RATINGS_CHIP Loại cột khối xếp hạng

TableColumnDataValidationRule

Một quy tắc xác thực dữ liệu cho một cột trong bảng.

Biểu diễn dưới dạng JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
Trường
condition

object (BooleanCondition)

Điều kiện mà dữ liệu trong ô phải đáp ứng. Chỉ hợp lệ nếu [BooleanCondition.type] là ONE_OF_LIST.