Cells

CellData

Dữ liệu về một ô cụ thể.

Biểu diễn dưới dạng JSON
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Trường
userEnteredValue

object (ExtendedValue)

Giá trị mà người dùng đã nhập vào ô. ví dụ: 1234, 'Hello' hoặc =NOW() Lưu ý: Ngày, Thời gian và Ngày giờ được thể hiện dưới dạng gấp đôi trong serial number .

effectiveValue

object (ExtendedValue)

Giá trị hiệu dụng của ô. Đối với các ô có công thức, đây là giá trị đã tính. Đối với các ô có giá trị cố định, giá trị này giống như giá trị userEnteredValue. Trường này ở chế độ chỉ đọc.

formattedValue

string

Giá trị được định dạng của ô. Đây là giá trị mà người dùng nhìn thấy. Trường này ở chế độ chỉ đọc.

userEnteredFormat

object (CellFormat)

Định dạng mà người dùng đã nhập cho ô.

Khi viết, định dạng mới sẽ được hợp nhất với định dạng hiện có.

effectiveFormat

object (CellFormat)

Định dạng có hiệu lực mà ô đang sử dụng. Điều này bao gồm kết quả của việc áp dụng mọi định dạng có điều kiện và định dạng số được tính nếu ô chứa công thức. Nếu định dạng có hiệu lực là định dạng mặc định, thì định dạng có hiệu lực sẽ không được ghi. Trường này ở chế độ chỉ đọc.

note

string

Bất kỳ ghi chú nào trên ô.

textFormatRuns[]

object (TextFormatRun)

Loạt văn bản đa dạng thức được áp dụng cho các tiểu mục của ô. Các lần chạy chỉ hợp lệ trên các chuỗi do người dùng nhập, không phải công thức, bool hoặc số. Thuộc tính của lần chạy bắt đầu tại một chỉ mục cụ thể trong văn bản và tiếp tục cho đến lần chạy tiếp theo. Các lệnh chạy sẽ kế thừa các thuộc tính của ô trừ phi có thay đổi rõ ràng.

Khi được ghi, các lần chạy mới sẽ ghi đè mọi lần chạy trước đó. Khi viết một userEnteredValue, các lần chạy trước đó sẽ bị xoá.

dataValidation

object (DataValidationRule)

Quy tắc xác thực dữ liệu trên ô, nếu có.

Khi được viết, quy tắc xác thực dữ liệu mới sẽ ghi đè mọi quy tắc trước đó.

pivotTable

object (PivotTable)

Đã neo một bảng tổng hợp tại ô này. Kích thước của bảng tổng hợp được tính tự động dựa trên dữ liệu, nhóm, bộ lọc, giá trị, v.v. Chỉ ô trên cùng bên trái của bảng tổng hợp mới chứa định nghĩa bảng tổng hợp. Các ô khác sẽ chứa giá trị đã được tính toán của kết quả tổng hợp trong effectiveValue mới.

dataSourceTable

object (DataSourceTable)

Đã liên kết một bảng nguồn dữ liệu tại ô này. Kích thước của bảng nguồn dữ liệu được tính toán động dựa trên cấu hình của bảng đó. Chỉ có ô đầu tiên của bảng nguồn dữ liệu chứa định nghĩa bảng nguồn dữ liệu. Các ô khác sẽ chứa giá trị hiển thị của kết quả trong bảng nguồn dữ liệu effectiveValue mới.

dataSourceFormula

object (DataSourceFormula)

Chỉ có đầu ra. Thông tin về một công thức nguồn dữ liệu trên ô. Trường này được đặt nếu userEnteredValue là một công thức tham chiếu đến một số DATA_SOURCE trang tính, ví dụ: =SUM(DataSheet!Column).

CellFormat

Định dạng của một ô.

Biểu diễn dưới dạng JSON
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Trường
numberFormat

object (NumberFormat)

Định dạng mô tả cách biểu thị giá trị số cho người dùng.

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Đường viền của ô.

padding

object (Padding)

Khoảng đệm của ô.

horizontalAlignment

enum (HorizontalAlign)

Căn chỉnh theo chiều ngang của giá trị trong ô.

verticalAlignment

enum (VerticalAlign)

Căn chỉnh theo chiều dọc của giá trị trong ô.

wrapStrategy

enum (WrapStrategy)

Chiến lược bao bọc cho giá trị trong ô.

textDirection

enum (TextDirection)

Hướng của văn bản trong ô.

textFormat

object (TextFormat)

Định dạng của văn bản trong ô (trừ phi bị một lần chạy định dạng ghi đè). Việc thiết lập đường liên kết cấp ô tại đây sẽ xoá các đường liên kết hiện có trong ô. Đặt trường liên kết trong một TextFormatRun sẽ được ưu tiên hơn liên kết cấp ô.

textRotation

object (TextRotation)

Chế độ xoay đã áp dụng cho văn bản trong ô.

NumberFormat

Định dạng số của một ô.

Biểu diễn dưới dạng JSON
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Trường
type

enum (NumberFormatType)

Loại định dạng số. Khi viết, bạn phải đặt trường này.

pattern

string

Chuỗi mẫu dùng để định dạng. Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng mẫu mặc định dựa trên ngôn ngữ của người dùng nếu cần cho loại đã cho. Xem Hướng dẫn về Định dạng ngày và số để biết thêm thông tin về các mẫu được hỗ trợ.

NumberFormatType

Định dạng số của ô. Trong tài liệu này, ngôn ngữ được giả định là en_US nhưng định dạng thực tế phụ thuộc vào ngôn ngữ của bảng tính.

Enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Định dạng số không được chỉ định và dựa trên nội dung của ô. Không sử dụng rõ ràng.
TEXT Định dạng văn bản, ví dụ: 1000.12
NUMBER Định dạng số, ví dụ: 1,000.12
PERCENT Tỷ lệ phần trăm định dạng, ví dụ: 10.12%
CURRENCY Định dạng đơn vị tiền tệ, ví dụ: $1,000.12
DATE Định dạng ngày, ví dụ: 9/26/2008
TIME Định dạng thời gian, ví dụ: 3:59:00 PM
DATE_TIME Định dạng ngày+giờ, ví dụ: 9/26/08 15:59:00
SCIENTIFIC Định dạng số khoa học, ví dụ: 1.01E+03

Đường viền

Đường viền của ô.

Biểu diễn dưới dạng JSON
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Trường
top

object (Border)

Đường viền trên của ô.

bottom

object (Border)

Đường viền dưới cùng của ô.

left

object (Border)

Đường viền trái của ô.

right

object (Border)

Đường viền phải của ô.

Đường viền

Đường viền dọc theo một ô.

Biểu diễn dưới dạng JSON
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Trường
style

enum (Style)

Kiểu đường viền.

width
(deprecated)

integer

Chiều rộng của đường viền, tính bằng pixel. Không dùng nữa; chiều rộng được xác định theo "kiểu" .

color
(deprecated)

object (Color)

Màu của đường viền. Không dùng nữa: Sử dụng colorStyle.

colorStyle

object (ColorStyle)

Màu của đường viền. Nếu color cũng được đặt, trường này sẽ được ưu tiên.

Phong cách

Kiểu đường viền.

Enum
STYLE_UNSPECIFIED Kiểu chưa được chỉ định. Đừng sử dụng thuộc tính này.
DOTTED Đường viền chấm bi.
DASHED Đường viền bị nét đứt.
SOLID Đường viền là một đường liền nét mỏng.
SOLID_MEDIUM Đường viền là một đường liền nét trung bình.
SOLID_THICK Đường viền là một đường liền nét dày.
NONE Không có đường viền. Chỉ được dùng khi cập nhật đường viền để xoá đường viền đó.
DOUBLE Đường viền là 2 đường liền nét.

Khoảng đệm

Số lượng khoảng đệm xung quanh ô, tính bằng pixel. Khi cập nhật khoảng đệm, bạn phải chỉ định mọi trường.

Biểu diễn dưới dạng JSON
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Trường
top

integer

Khoảng đệm trên cùng của ô.

right

integer

Khoảng đệm bên phải của ô.

bottom

integer

Khoảng đệm dưới cùng của ô.

left

integer

Khoảng đệm bên trái của ô.

VerticalAlign

Căn chỉnh văn bản theo chiều dọc trong một ô.

Enum
VERTICAL_ALIGN_UNSPECIFIED Căn dọc không được chỉ định. Đừng sử dụng thuộc tính này.
TOP Văn bản được căn chỉnh rõ ràng vào đầu ô.
MIDDLE Văn bản được căn chỉnh rõ ràng vào giữa ô.
BOTTOM Văn bản được căn chỉnh rõ ràng vào cuối ô.

WrapStrategy

Cách gói văn bản trong một ô.

Enum
WRAP_STRATEGY_UNSPECIFIED Giá trị mặc định, không sử dụng.
OVERFLOW_CELL

Những dòng dài hơn chiều rộng của ô sẽ được ghi vào ô tiếp theo, miễn là ô đó trống. Nếu ô tiếp theo không trống, thì ô này sẽ hoạt động giống như CLIP. Văn bản sẽ không bao giờ xuống dòng tiếp theo trừ phi người dùng tự chèn một dòng mới. Ví dụ:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Chiến lược xuống dòng này đại diện cho chiến lược xuống dòng cũ của Google Trang tính, trong đó các từ dài hơn một dòng được cắt bớt thay vì bị ngắt. Chiến lược này chưa được hỗ trợ trên một số nền tảng và sẽ bị loại bỏ. Ví dụ:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Các dòng dài hơn chiều rộng của ô sẽ bị cắt bớt. Văn bản sẽ không bao giờ xuống dòng tiếp theo trừ phi người dùng tự chèn một dòng mới. Ví dụ:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Các từ dài hơn một dòng được ngắt ở cấp ký tự thay vì bị cắt bớt. Ví dụ:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Hướng của văn bản trong một ô.

Enum
TEXT_DIRECTION_UNSPECIFIED Hướng văn bản chưa được chỉ định. Đừng sử dụng thuộc tính này.
LEFT_TO_RIGHT Hướng văn bản từ trái sang phải do người dùng đặt.
RIGHT_TO_LEFT Hướng văn bản từ phải sang trái do người dùng đặt.

HyperlinkDisplayType

Liệu có hiển thị siêu liên kết một cách rõ ràng hay không. Nếu bạn không chỉ định thì siêu liên kết này sẽ được liên kết.

Enum
LINKED Siêu liên kết phải được hiển thị rõ ràng.
PLAIN_TEXT Không được hiển thị siêu liên kết.

TextRotation

Chế độ xoay đã áp dụng cho văn bản trong một ô.

Biểu diễn dưới dạng JSON
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Trường
Trường kết hợp type. Kiểu xoay, dọc hoặc góc. type chỉ có thể là một trong các trạng thái sau:
angle

integer

Góc giữa hướng chuẩn và hướng mong muốn. Được đo bằng độ. Các giá trị hợp lệ nằm trong khoảng từ -90 đến 90. Góc dương là góc hướng lên, góc âm là góc hướng xuống dưới.

Lưu ý: Đối với hướng văn bản LTR, các góc dương là ngược chiều kim đồng hồ, còn đối với RTL thì theo chiều kim đồng hồ

vertical

boolean

Nếu là true, văn bản sẽ đọc từ trên xuống dưới, nhưng hướng của từng ký tự sẽ không thay đổi. Ví dụ:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

Một loạt định dạng văn bản. Định dạng của lần chạy này sẽ tiếp tục cho đến chỉ mục bắt đầu của lần chạy tiếp theo. Khi cập nhật, bạn phải đặt tất cả các trường.

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

integer

Chỉ mục ký tự từ 0 mà lần chạy này bắt đầu, theo đơn vị mã UTF-16.

format

object (TextFormat)

Định dạng của lần chạy này. Các giá trị không có sẽ kế thừa định dạng của ô.

DataValidationRule

Quy tắc xác thực dữ liệu.

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

object (BooleanCondition)

Điều kiện mà dữ liệu trong ô phải khớp.

inputMessage

string

Một thông báo hiển thị cho người dùng khi thêm dữ liệu vào ô.

strict

boolean

Đúng nếu dữ liệu không hợp lệ bị từ chối.

showCustomUi

boolean

Đúng nếu giao diện người dùng được tuỳ chỉnh dựa trên loại điều kiện. Nếu đúng, "List" (Danh sách) các điều kiện sẽ hiển thị một trình đơn thả xuống.

DataSourceTable

Bảng nguồn dữ liệu cho phép người dùng nhập một bảng dữ liệu tĩnh từ DataSource vào Trang tính. Hành động này còn được gọi là "Trích xuất" trong trình chỉnh sửa Trang tính.

Biểu diễn dưới dạng JSON
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Trường
dataSourceId

string

Mã của nguồn dữ liệu có liên kết với bảng nguồn dữ liệu.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Loại để chọn cột cho bảng nguồn dữ liệu. Mặc định là SELECTED.

columns[]

object (DataSourceColumnReference)

Các cột được chọn cho bảng nguồn dữ liệu. Chiến lược phát hành đĩa đơn columnSelectionType phải SELECTED.

filterSpecs[]

object (FilterSpec)

Quy cách lọc trong bảng nguồn dữ liệu.

sortSpecs[]

object (SortSpec)

Sắp xếp quy cách trong bảng nguồn dữ liệu. Kết quả của bảng nguồn dữ liệu được sắp xếp theo thứ tự trong quy cách sắp xếp.

rowLimit

integer

Giới hạn số hàng cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ áp dụng một giới hạn mặc định. Vui lòng tham khảo trình chỉnh sửa Trang tính để biết giới hạn mặc định và giới hạn tối đa.

dataExecutionStatus

object (DataExecutionStatus)

Chỉ có đầu ra. Trạng thái thực thi dữ liệu.

DataSourceTableColumnSelectionType

Các loại lựa chọn cột trong bảng nguồn dữ liệu.

Enum
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Loại lựa chọn cột mặc định, không sử dụng.
SELECTED Chọn các cột được chỉ định bởi columns .
SYNC_ALL

Đồng bộ hoá tất cả cột hiện tại và trong tương lai trong nguồn dữ liệu.

Nếu được đặt, bảng nguồn dữ liệu sẽ tìm nạp tất cả cột trong nguồn dữ liệu tại thời điểm làm mới.

DataSourceFormula

Công thức nguồn dữ liệu.

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

string

Mã của nguồn dữ liệu liên kết với công thức.

dataExecutionStatus

object (DataExecutionStatus)

Chỉ có đầu ra. Trạng thái thực thi dữ liệu.