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, Giờ và Ngày giờ được biểu thị dưới dạng số thực ở định dạng serial number.

effectiveValue

object (ExtendedValue)

Giá trị hiệu quả của ô. Đối với các ô có công thức, đây là giá trị được tính toán. Đối với các ô có giá trị cố định, giá trị này giống với giá trị userEnteredValue. Trường này chỉ có thể đọ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 ghi, đị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 hiệu quả 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 hiệu quả là định dạng mặc định, thì định dạng hiệu quả sẽ không được ghi. Trường này ở chế độ chỉ đọc.

note

string

Mọi ghi chú trên ô.

textFormatRuns[]

object (TextFormatRun)

Các dòng văn bản đa dạng thức được áp dụng cho các tiểu mục của ô. Lượt chạy chỉ hợp lệ trên các chuỗi do người dùng nhập, chứ không phải công thức, bool hoặc số. Các thuộc tính của một 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ượt chạy sẽ kế thừa các thuộc tính của ô trừ khi bạn thay đổi rõ ràng.

Khi ghi, các lần chạy mới sẽ ghi đè mọi lần chạy trước đó. Khi ghi một userEnteredValue mới, 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 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 toán linh độ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 về bảng tổng hợp. Các ô khác sẽ chứa giá trị đã tính toán của kết quả tổng hợp trong các trường effectiveValue.

dataSourceTable

object (DataSourceTable)

Một bảng nguồn dữ liệu được neo tại ô này. Kích thước của bảng nguồn dữ liệu được tính toán linh động dựa trên cấu hình của bảng. Chỉ ô đầu tiên của bảng nguồn dữ liệu mới 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ả bảng nguồn dữ liệu trong trường effectiveValue.

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ố trang tính DATA_SOURCE, 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)

Một định dạng mô tả cách trình bày các 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 bạn cũng đặt backgroundColor, thì 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ách căn chỉnh theo chiều ngang của giá trị trong ô.

verticalAlignment

enum (VerticalAlign)

Cách căn chỉnh 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 đặt đường liên kết ở cấp ô tại đây sẽ xoá các đường liên kết hiện có của ô. Việc đặt trường liên kết trong TextFormatRun sẽ được ưu tiên hơn đường liên kết cấp ô.

textRotation

object (TextRotation)

Độ 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 ghi, 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 Đị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 thuộc tính này một cách 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ùng 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 trường "style".

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 bạn cũng đặt color, thì 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. Khô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 kẻ liền trung bình.
SOLID_THICK Đường viền là một đường kẻ liền dày.
NONE Không có đường viền. Chỉ dùng khi cập nhật đường viền để xoá đường viền đó.
DOUBLE Đường viền là hai đường liền nét.

Khoảng đệm

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ách 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 ở đầ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 ở cuối ô.

WrapStrategy

Cách xuống dòng tự động trong một ô.

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

Các dòng dài hơn chiều rộng ô 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 trừ phi người dùng chèn dòng mới theo cách thủ công. 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 thể hiện 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 sẽ bị cắt bớt thay vì bị ngắt. Chiến lược này không được hỗ trợ trên một số nền tảng và đang dần ngừng hoạt động. Ví dụ: 

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

Các dòng dài hơn chiều rộng ô sẽ bị cắt bớt. Văn bản sẽ không bao giờ xuống dòng trừ phi người dùng chèn dòng mới theo cách thủ công. 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 Chưa chỉ định hướng văn bản. Không sử dụng phương thức này.
LEFT_TO_RIGHT Người dùng đã đặt hướng văn bản từ trái sang phải.
RIGHT_TO_LEFT Người dùng đã đặt hướng văn bản từ phải sang trái.

HyperlinkDisplayType

Liệu có hiển thị rõ ràng siêu liên kết 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 hợp hợp nhất type. Loại xoay, dọc hoặc góc. type chỉ có thể là một trong những giá trị sau:
angle

integer

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

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

vertical

boolean

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

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

TextFormatRun

Một lần chạy đị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ự dựa trên 0 nơi quá trình chạy này bắt đầu, trong các đơ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

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

strict

boolean

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

showCustomUi

boolean

Đúng nếu giao diện người dùng cần được tuỳ chỉnh dựa trên loại điều kiện. Nếu là true, điều kiện "Danh sách" 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 bảng dữ liệu tĩnh từ DataSource vào Trang tính. Thao tác này còn 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ã nhận dạng của nguồn dữ liệu mà bảng nguồn dữ liệu được liên kết.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

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

columns[]

object (DataSourceColumnReference)

Các cột đã chọn cho bảng nguồn dữ liệu. columnSelectionType phải là 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ự dựa trên thông số 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 do trường columns chỉ định.
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.