Dữ liệu di động
Dữ liệu về một ô cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "userEnteredValue": { object ( |
Các trường | |
---|---|
userEnteredValue
|
Giá trị người dùng đã nhập vào ô. Ví dụ:
|
effectiveValue
|
Giá trị hiệu quả 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 với userEnteredValue. Đây là trường chỉ đọc. |
formattedValue
|
Giá trị được định dạng của ô. Đây là giá trị mà người dùng nhìn thấy. Đây là trường chỉ đọc. |
userEnteredFormat
|
Định dạng mà người dùng nhập vào ô. Khi viết, định dạng mới sẽ được hợp nhất với định dạng hiện tại. |
effectiveFormat
|
Định dạng hiệu quả đang được ô sử dụng. Điều này bao gồm kết quả của việc áp dụng bất kỳ định dạng có điều kiện nào và nếu ô chứa công thức, định dạng số đã tính. Nếu định dạng hiệu quả là định dạng mặc định, định dạng hiệu quả sẽ không được ghi. Đây là trường chỉ đọc. |
hyperlink
|
Một siêu liên kết mà ô này trỏ đến, nếu có. Nếu ô chứa nhiều siêu liên kết, trường này sẽ trống. Đây là trường chỉ đọc. Để thiết lập giá trị này, hãy sử dụng công thức |
note
|
Bất kỳ ghi chú nào trên ô. |
textFormatRuns[]
|
Chạy văn bản đa dạng thức được áp dụng cho các phần phụ của ô. Lần chạy chỉ hợp lệ trên các chuỗi do người dùng nhập, không hợp lệ trên các công thức, số nhận dạng ký tự hoặc số. Các thuộc tính của một lần chạy bắt đầu ở 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. Lượt chạy sẽ kế thừa các thuộc tính của ô trừ khi được thay đổi một cách rõ ràng.
Khi ghi, các lần chạy mới sẽ ghi đè bất kỳ lần chạy nào trước đó. Khi viết một |
dataValidation
|
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
|
Một bảng tổng hợp cố định tại ô này. Kích thước của bảng tổng hợp được tính động dựa trên dữ liệu, nhóm, bộ lọc, giá trị, v.v. Chỉ có ô 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ị đã tính toán từ kết quả của bảng tổng hợp trong các trường |
dataSourceTable
|
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 độ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 có 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 các trường |
dataSourceFormula
|
Chỉ đầu ra. Thông tin về một công thức nguồn dữ liệu trên ô. Trường này sẽ được đặt nếu |
Định dạng ô
Định dạng của một ô.
Biểu diễn dưới dạng JSON |
---|
{ "numberFormat": { object ( |
Các trường | |
---|---|
numberFormat
|
Một định dạng mô tả cách hiển 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 bạn cũng đặt |
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 xuống dòng 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ừ khi bị ghi đè bằng một lần chạy định dạng). Việc đặt đường liên kết ở cấp độ ô tại đây sẽ xóa các đường liên kết hiện có của ô. Việc đặt trường liên kết trong |
hyperlinkDisplayType
|
Nếu có, cách hiển thị siêu liên kết trong ô. |
textRotation
|
Đã áp dụng tùy chọn xoay cho văn bản trong ô. |
Định dạng số
Định dạng số của một ô.
Biểu diễn dưới dạng JSON |
---|
{
"type": enum (
|
Các 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, hệ thống sẽ sử dụng một 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 hình đã 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ợ. |
Loại định dạng số
Đị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 tính năng này. |
TEXT
|
Định dạng văn bản, ví dụ: 1000.12
|
NUMBER
|
Định dạng số, ví dụ: 1,000.12
|
PERCENT
|
Định dạng phần trăm, 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 ( |
Các trường | |
---|---|
top
|
Đường viền trên cùng 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 ô. |
Border
Đường viền dọc ô.
Biểu diễn dưới dạng JSON |
---|
{ "style": enum ( |
Các 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 được chấp nhận; chiều rộng được xác định bởi trường "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 bạn cũng đặt |
Phong cách
Kiểu đường viền.
Enum | |
---|---|
STYLE_UNSPECIFIED
|
Kiểu không được chỉ định. Không sử dụng. |
DOTTED
|
Đường viền bị chấm chấm. |
DASHED
|
Đường viền nét đứt. |
SOLID
|
Đường viền là một đường liền nét mảnh. |
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 sử dụng khi cập nhật đường viền để xóa đường viền đó. |
DOUBLE
|
Đường viền là hai đường liền nét. |
Khoảng đệm
Lượ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 } |
Các 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 ô. |
Căn dọc
Căn chỉnh văn bản theo chiều dọc trong một ô.
Enum | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
Căn chỉnh theo chiều dọc không được chỉ định. Không sử dụng. |
TOP
|
Văn bản được căn chỉnh rõ ràng với đầu ô. |
MIDDLE
|
Văn bản được căn chỉnh rõ ràng với giữa ô. |
BOTTOM
|
Văn bản được căn chỉnh rõ ràng với phần dưới cùng của ô. |
Gói chiến lược
Cách xuống dòng tự động trong một ô.
Enum | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
Không sử dụng giá trị mặc định. |
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à ô đó còn 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 thể hiện chiến lược gói Google Trang tính cũ, trong đó các từ dài hơn một dòng sẽ được cắt thay vì bị hỏng. Chiến lược này không được hỗ trợ trên tất cả nền tảng và đang dần bị loại bỏ. Ví dụ:
|
CLIP
|
Các dòng dài hơn chiều rộng ô sẽ bị cắt. Văn bản sẽ không bao giờ xuống dòng tiếp theo trừ khi người dùng chèn dòng mới theo cách thủ công. Ví dụ:
|
WRAP
|
Những từ dài hơn một dòng được gói ở cấp ký tự thay vì bị cắt bớt. Ví dụ:
|
Hướng văn bản
Hướng của văn bản trong ô.
Enum | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
Hướng của văn bản không được chỉ định. Không sử dụng. |
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. |
Loại siêu liên kết hiển thị
Có hiển thị siêu liên kết một cách rõ ràng hay không. Nếu không được chỉ định thì siêu liên kết 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ị. Không sử dụng. |
LINKED
|
Một siêu liên kết phải được hiển thị rõ ràng. |
PLAIN_TEXT
|
Không nên hiển thị siêu liên kết. |
Xoay văn bản
Đã áp dụng chế độ xoay cho văn bản trong một ô.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm type . Loại xoay, dọc hoặc góc.
type chỉ có thể là một trong những loại sau đây:
|
|
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ệ là từ -90 đến 90. Các góc dương được tăng góc lên, âm được nghiêng xuống dưới. Lưu ý: Đối với hướng văn bản LTR, góc dương theo hướng ngược chiều kim đồng hồ, trong khi đối với RTL, chúng 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 các ký tự riêng lẻ không thay đổi. Ví dụ:
|
Chạy định dạng văn bản
Chạy một định dạng văn bản. Định dạng của lần chạy này tiếp tục cho đến khi 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 (
|
Các trường | |
---|---|
startIndex
|
Chỉ mục ký tự gốc 0, bắt đầu bằng lần chạy, bằng đơn vị mã UTF-16. |
format
|
Định dạng của lần chạy này. Giá trị vắng mặt kế thừa định dạng của ô. |
Quy tắc xác thực dữ liệu
Quy tắc xác thực dữ liệu.
Biểu diễn dưới dạng JSON |
---|
{
"condition": {
object (
|
Các trường | |
---|---|
condition
|
Điều kiện mà dữ liệu trong ô phải khớp. |
inputMessage
|
Một thông báo cho người dùng biết 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 phải được tuỳ chỉnh dựa trên loại điều kiện. Nếu đúng, các điều kiện "Danh sách" sẽ hiển thị menu thả xuống. |
Bảng nguồn dữ liệu
Một 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. Đâ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 ( |
Các trường | |
---|---|
dataSourceId
|
Mã của nguồn dữ liệu mà bảng nguồn dữ liệu liên kết. |
columnSelectionType
|
Loại để chọn các cột cho bảng nguồn dữ liệu. Giá trị mặc định là |
columns[]
|
Đã chọn các cột cho bảng nguồn dữ liệu. |
filterSpecs[]
|
Thông số kỹ thuật lọc trong bảng nguồn dữ liệu. |
sortSpecs[]
|
Sắp xếp thông số 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 dựa trên thông số kỹ thuật sắp xếp theo thứ tự. |
rowLimit
|
Giới hạn số lượng hàng sẽ trả về. Nếu bạn không đặt chính sách này, giới hạn mặc định sẽ được áp dụng. Vui lòng tham khảo Trình chỉnh sửa trang tính để biết các giới hạn mặc định và tối đa. |
dataExecutionStatus
|
Chỉ đầu ra. Trạng thái thực thi dữ liệu. |
Loại nguồn bảng dữ liệu nguồn
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 xác định.
|
SYNC_ALL
|
Đồng bộ hóa tất cả cá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ác cột trong nguồn dữ liệu tại thời điểm làm mới. |
Công thức DataSource
Công thức nguồn dữ liệu.
Biểu diễn dưới dạng JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
Các trường | |
---|---|
dataSourceId
|
Mã của nguồn dữ liệu có công thức liên kết. |
dataExecutionStatus
|
Chỉ đầu ra. Trạng thái thực thi dữ liệu. |