CellData
Dữ liệu về một ô cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "userEnteredValue": { object ( |
Trường | |
---|---|
userEnteredValue
|
Giá trị mà người dùng đã nhập vào ô. ví dụ:
|
effectiveValue
|
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
|
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
|
Đị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
|
Đị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. |
hyperlink
|
Siêu liên kết mà ô này trỏ tới, nếu có. Nếu ô chứa nhiều siêu liên kết, trường này sẽ trống. Trường này ở chế độ chỉ đọc. Để thiết lập chế độ cài đặt này, hãy sử dụng
|
note
|
Bất kỳ ghi chú nào trên ô. |
textFormatRuns[]
|
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
|
dataValidation
|
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
|
Đã 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
|
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
|
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
|
CellFormat
Định dạng của một ô.
Biểu diễn dưới dạng JSON |
---|
{ "numberFormat": { object ( |
Trường | |
---|---|
numberFormat
|
Định dạng mô tả cách biểu thị giá trị số cho người dùng. |
backgroundColor
|
Màu nền của ô. Không dùng nữa: Sử dụng
|
backgroundColorStyle
|
Màu nền của ô. Nếu
|
borders
|
Đường viền của ô. |
padding
|
Khoảng đệm của ô. |
horizontalAlignment
|
Căn chỉnh theo chiều ngang của giá trị trong ô. |
verticalAlignment
|
Căn chỉnh theo chiều dọc của giá trị trong ô. |
wrapStrategy
|
Chiến lược bao bọc cho giá trị trong ô. |
textDirection
|
Hướng của văn bản trong ô. |
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
|
hyperlinkDisplayType
|
Nếu có một đường siêu liên kết thì sẽ hiển thị như thế nào trong ô. |
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 (
|
Trường | |
---|---|
type
|
Loại định dạng số. Khi viết, bạn phải đặt trường này. |
pattern
|
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 ( |
Trường | |
---|---|
top
|
Đường viền trên của ô. |
bottom
|
Đường viền dưới cùng của ô. |
left
|
Đường viền trái của ô. |
right
|
Đườ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 ( |
Trường | |
---|---|
style
|
Kiểu đường viền. |
width
|
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
|
Màu của đường viền. Không dùng nữa: Sử dụng
|
colorStyle
|
Màu của đường viền. Nếu
|
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
|
Khoảng đệm trên cùng của ô. |
right
|
Khoảng đệm bên phải của ô. |
bottom
|
Khoảng đệm dưới cùng của ô. |
left
|
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ư
|
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ụ:
|
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ụ:
|
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ụ:
|
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 | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
Giá trị mặc định: siêu liên kết được hiển thị. Đừng sử dụng thuộc tính này. |
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 |
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
|
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
|
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ụ:
|
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 (
|
Trường | |
---|---|
startIndex
|
Chỉ mục ký tự từ 0 mà lần chạy này bắt đầu, theo đơn vị mã UTF-16. |
format
|
Đị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 (
|
Trường | |
---|---|
condition
|
Điều kiện mà dữ liệu trong ô phải khớp. |
inputMessage
|
Một thông báo hiển thị cho người dùng khi thêm dữ liệu vào ô. |
strict
|
Đúng nếu dữ liệu không hợp lệ bị từ chối. |
showCustomUi
|
Đú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 ( |
Trường | |
---|---|
dataSourceId
|
Mã của nguồn dữ liệu có liên kết với bảng nguồn dữ liệu. |
columnSelectionType
|
Loại để chọn cột cho bảng nguồn dữ liệu. Mặc định là
|
columns[]
|
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
|
filterSpecs[]
|
Quy cách lọc trong bảng nguồn dữ liệu. |
sortSpecs[]
|
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
|
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
|
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 (
|
Trường | |
---|---|
dataSourceId
|
Mã của nguồn dữ liệu liên kết với công thức. |
dataExecutionStatus
|
Chỉ có đầu ra. Trạng thái thực thi dữ liệu. |