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à trang tính 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 giá trị này đại diện cho Sheet1 và bảng tính được yêu cầu với 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 tính 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)

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

filterViews[]

object (FilterView)

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 ô (xen kẽ màu) 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 của dải ô tăng dần, sau đó theo chiều 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 của dải ô tăng dần, sau đó theo chiều sâu của nhóm.

slicers[]

object (Slicer)

Các công cụ lọc 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 một 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ã 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 đặt.

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 thuộc tính 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 vào 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), thì để di chuyển S1 lên trước S2, 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 trang tính hiện tại + 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 đặt.

gridProperties

object (GridProperties)

Các thuộc tính bổ sung của trang tính nếu trang tính này là lưới. (Nếu trang tính là trang tính đối tượng, 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 sẽ gặp lỗi nếu đặt bất kỳ thuộc tính lưới nào trên các trang tính không phải lưới.

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

hidden

boolean

Đúng nếu trang tính bị ẩn trong giao diện người dùng, sai 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

Đúng 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 sẽ 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à thay vào đó là một đối tượng như biểu đồ hoặc hình ảnh.
DATA_SOURCE Trang tính này kết nối với một DataSource bên ngoài và hiển thị 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 tính DATA_SOURCE.

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

string

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

columns[]

object (DataSourceColumn)

Các cột hiển thị 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 tham chiếu đến, dựa trên số 0.

startColumn

integer

Cột đầu tiên mà GridData tham chiếu đến, dựa trên số 0.

rowData[]

object (RowData)

Dữ liệu trong lưới, mỗi hàng có một mục, 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 cột một giá trị.

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ỉ có thể đọc.

hiddenByUser

boolean

Đúng nếu phương diện này bị ẩn 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.

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

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 hợp hợp nhất rule. Quy tắc kiểm soát định dạng có điều kiện này, bạn phải đặt đúng một quy tắc. rule chỉ có thể là một trong những loạ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 độ dốc 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 đánh giá là đúng, đị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 tập hợp con định dạng: bold, italic, strikethrough, foreground color và background color.

GradientRule

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 tuỳ theo 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 chừng 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 trên định dạng có điều kiện chuyển màu. Các điểm này ghim thang màu chuyển màu theo màu, 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ẽ 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ẽ 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 sử 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 ô trong 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 ô trong 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à tỷ lệ phần trăm nhất định 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ể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ã của chế độ xem bộ lọc.

title

string

Tên của thành phần hiển thị 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 giá trị 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 giá trị range, namedRangeId hoặc tableId.

tableId

string

Bảng mà chế độ xem bộ lọc này được sao lưu (nếu có).

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

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp theo từng cột. Các thông số kỹ thuật sau được sử dụng khi các giá trị bằng nhau trong các thông số kỹ thuật trước đó.

criteria
(deprecated)

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

Tiêu chí hiển thị/ẩn giá trị theo 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 được dùng nữa mà thay bằng filterSpecs.

filterSpecs[]

object (FilterSpec)

Tiêu chí bộ lọc để hiển thị/ẩn giá trị theo cột.

Cả criteria và filterSpecs đều được điền sẵn trong 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

Một 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ã của dải ô được bảo vệ. Trường này chỉ có thể đọc.

range

object (GridRange)

Dải ô đang được bảo vệ. Phạm vi có thể không có giới hạn nào, trong trường hợp này, trang tính được coi là 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 được đặt tên mà dải ô được bảo vệ này được sao lưu, 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 chứa dải ô được bảo vệ này (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

Đúng 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 phạm vi được bảo vệ, ngoại trừ việc chỉnh sửa sẽ đưa ra cảnh báo yêu cầu người dùng xác nhận việc 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 được thay đổi từ true thành false và trường editors không được đặt (cũng không được đưa vào mặt nạ trường), thì trình chỉnh sửa sẽ được đặt thành tất cả trình chỉnh sửa trong tài liệu.

requestingUserCanEdit

boolean

Đúng 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ỉ có thể đọ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 đối với dải ô được bảo vệ. Chỉ những người dùng có quyền chỉnh sửa đối với dải ô được bảo vệ và tài liệu mới nhìn thấy trường này. Trình chỉnh sửa không được hỗ trợ tính năng bảo vệ warningOnly.

Trình chỉnh sửa

Người chỉnh sửa 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 đối với dải ô được bảo vệ.

groups[]

string

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

domainUsersCanEdit

boolean

Đúng nếu bất kỳ ai trong miền của tài liệu đều có quyền chỉnh sửa đối với 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ể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 gồm.

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 hai giá trị range hoặc tableId.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp theo từng cột. Các thông số kỹ thuật sau được sử dụng khi các giá trị bằng nhau trong các thông số kỹ thuật trước đó.

criteria
(deprecated)

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

Tiêu chí hiển thị/ẩn giá trị theo 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 được 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 sẵn trong 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

Dải ô (xen kẽ màu) trong một 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ã của dải ô. Nếu không đặt, hãy tham khảo bandedRangeReference.

bandedRangeReference

string

Chỉ có đầu ra. Tham chiếu của dải ô, 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 dải hàng. Các thuộc tính này được áp dụng theo từng hàng trên tất cả các hàng trong 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 tham chiếu đến một phương diện (hàng hoặc cột). Nếu bạn đặt cả BandedRange.row_properties và BandedRange.column_properties, thì màu tô 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 đượ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 được ưu tiên hơn màu của hàng thứ hai. Tương tự, tiêu đề hàng đượ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 đượ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 tô màu này và các màu sẽ thay thế nhau 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 tô màu này và các màu sẽ thay thế nhau 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 xen kẽ. (Bắt buộc) Không dùng nữa: Sử dụng firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Màu đầu tiên 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 xen kẽ. (Bắt buộc) Không dùng nữa: Sử dụng secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Màu thứ hai 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 tô 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 tô 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 các hàng hoặc cột trên một 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 tồn tại của nhóm này.

depth

integer

Độ sâu của nhóm, thể hiện số lượng nhóm có 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 có nghĩa là 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ả phương diện trong thuộc tính đó sẽ được đặt thành ẩn nếu trường này có giá trị true hoặc được đặt thành hiển thị nếu trường này có giá trị false.

Bộ cắt

Một công cụ lọc 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ã của công cụ cắt.

spec

object (SlicerSpec)

Thông số kỹ thuật của công cụ cắt.

position

object (EmbeddedObjectPosition)

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

SlicerSpec

Thông số kỹ thuật của một công cụ lọc.

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ộ lọc.

filterCriteria

object (FilterCriteria)

Tiêu chí lọc của công cụ cắt.

columnIndex

integer

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

applyToPivotTables

boolean

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

title

string

Tiêu đề của công cụ cắt.

textFormat

object (TextFormat)

Định dạng văn bản của tiêu đề trong công cụ cắt. Không hỗ trợ trường đường liên kết.

backgroundColor
(deprecated)

object (Color)

Màu nền của công cụ cắt. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Màu nền của công cụ cắt. Nếu bạn cũng đặt backgroundColor, thì trường này sẽ được ưu tiên.

horizontalAlignment

enum (HorizontalAlign)

Cách căn chỉnh tiêu đề theo chiều ngang trong công cụ cắt. Nếu 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. Đây là giá trị duy nhất cho 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 bảng.

TableRowsProperties

Thuộc tính 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ô màu mặc định.

firstBandColorStyle

object (ColorStyle)

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

secondBandColorStyle

object (ColorStyle)

Màu thứ hai xen kẽ. Nếu bạn đặt trường này, hàng dải màu thứ hai sẽ được tô màu đã chỉ định. Nếu không, hàng dải màu thứ hai sẽ được tô 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 thành có chân trang, thì dải ô sẽ được mở rộng thêm 1 hàng. Nếu bạn cập nhật một bảng hiện có có chân trang và xoá chân trang, thì dải ô sẽ bị thu hẹp 1 hàng.

TableColumnProperties

Cột trong 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 hàng 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ủa 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 Loại cột không xác đị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 khối địa điểm
RATINGS_CHIP Loại cột khối điểm xếp hạng

TableColumnDataValidationRule

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 khớp. Chỉ hợp lệ nếu [BooleanCondition.type] là ONE_OF_LIST.