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)
    }
  ]
}
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)

Quy cách của mỗi biểu đồ trên trang tính này.

bandedRanges[]

object (BandedRange)

Dải ô dạng dải (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 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 bộ cắt 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 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 viết, xảy ra lỗi khi đặ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

"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 sẽ chứa các thuộc tính dành riêng cho 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 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 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 duy nhấ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 kết hợp 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 có thể là một trong những trạng thái sau đây:
booleanRule

object (BooleanRule)

Định dạng sẽ 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

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 muố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 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)

Đ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 ô 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,
  "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 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 hai giá trị range hoặc namedRangeId.

namedRangeId

string

Dải ô được đặt tên mà chế độ xem bộ lọc này được hỗ trợ (nếu có).

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

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 và thay vào đó là 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 vào 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,
  "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 này có thể không có giới hạn nào, trong trường hợp đó, đây được coi là trang tính được bảo vệ.

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

namedRangeId

string

Dải ô được đặ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 hai giá trị range hoặc namedRangeId.

description

string

Mô tả của 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à đúng, 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 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ệ. Trường này chỉ hiển thị với người dùng có quyền chỉnh sửa dải ô được bảo vệ và tài liệu. 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)
  },
  "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.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp mỗi 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,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Trường
bandedRangeId

integer

Mã của dải ô.

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 cho 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 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 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, 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 trang tính, có thể chứa hoặc nằm 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 sẽ đúng nếu nhóm này được 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

Các thông số kỹ thuật của một 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 công cụ cắt.

columnIndex

integer

Chỉ mục cột từ 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, trường này sẽ được ưu tiên.

horizontalAlignment

enum (HorizontalAlign)

Căn chỉnh theo chiều ngang tiêu đề trong bộ cắt. Nếu bạn không chỉ định, giá trị mặc định sẽ là LEFT