Cells

Dữ liệu di động

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)
  }
}
Các trường
userEnteredValue

object (ExtendedValue)

Giá trị 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 biểu thị dưới dạng kép trong serial number định dạng.

effectiveValue

object (ExtendedValue)

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

string

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

object (CellFormat)

Đị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

object (CellFormat)

Đị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.

note

string

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

textFormatRuns[]

object (TextFormatRun)

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

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 effectiveValue.

dataSourceTable

object (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 effectiveValue.

dataSourceFormula

object (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 userEnteredValue là công thức tham chiếu đến một trang tính DATA_SOURCE nào đó, ví dụ: =SUM(DataSheet!Column).

Định dạng ô

Đị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)
  }
}
Các trường
numberFormat

object (NumberFormat)

Một định dạng mô tả cách hiển 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 bạn cũng đặt backgroundColor, 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 xuống dòng 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ừ 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 TextFormatRun sẽ được ưu tiên hơn đường liên kết ở cấp ô.

textRotation

object (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 (NumberFormatType),
  "pattern": string
}
Các 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, 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 (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Các 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 ô.

Border

Đường viền dọc ô.

Biểu diễn dưới dạng JSON 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Các 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 được chấp nhận; chiều rộng được xác định bởi trường "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 bạn cũng đặt color, trường này sẽ được ưu tiên.

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

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 ô.

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ư CLIP. 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ụ: 

| 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 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ụ: 

| 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. 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ụ: 

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
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ụ: 

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

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
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 type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
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

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ệ 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

boolean

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ụ: 

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

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 (TextFormat)
  }
}
Các trường
startIndex

integer

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

object (TextFormat)

Đị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 (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Các 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 cho người dùng biết 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 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 (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Các trường
dataSourceId

string

Mã của nguồn dữ liệu mà bảng nguồn dữ liệu liên kết.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

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

columns[]

object (DataSourceColumnReference)

Đã chọn các cột cho bảng nguồn dữ liệu. columnSelectionType phải là SELECTED.

filterSpecs[]

object (FilterSpec)

Thông số kỹ thuật lọc trong bảng nguồn dữ liệu.

sortSpecs[]

object (SortSpec)

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

integer

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

object (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 (DataExecutionStatus)
  }
}
Các trường
dataSourceId

string

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

dataExecutionStatus

object (DataExecutionStatus)

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