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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
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 có độ chính xác kép ở định dạng serial number.

effectiveValue

object (ExtendedValue)

Giá trị thực tế của ô. Đối với các ô có công thức, đây là giá trị được tính. Đối với các ô có giá trị cố định, giá trị này giống với 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 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à nếu ô chứa công thức, thì định dạng số được tính toán. 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

Mọi ghi chú trên ô.

textFormatRuns[]

object (TextFormatRun)

Các đoạn văn bản đa dạng thức được áp dụng cho các phần phụ của ô. Các đoạn chỉ hợp lệ đối với chuỗi do người dùng nhập, chứ không hợp lệ đối với công thức, giá trị boolean hoặc số. Các thuộc tính của một đoạn văn bản bắt đầu tại một chỉ mục cụ thể trong văn bản và tiếp tục cho đến đoạn văn bản tiếp theo. Các đoạn văn bản sẽ kế thừa các thuộc tính của ô, trừ phi 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 ghi, 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 cố định tại ô này. Kích thước của bảng tổng hợp được tính toán linh hoạt 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 chứa định nghĩa bảng tổng hợp. Các ô khác sẽ chứa các giá trị được tính của kết quả trong bảng tổng hợp ở các trường effectiveValue.

dataSourceTable

object (DataSourceTable)

Một bảng nguồn dữ liệu được cố định tại ô này. Kích thước của bảng nguồn dữ liệu được tính toán linh hoạt 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 các trường effectiveValue.

dataSourceFormula

object (DataSourceFormula)

Chỉ có đầu ra. Thông tin về 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 trang tính DATA_SOURCE nào đó, ví dụ: =SUM(DataSheet!Column).

chipRuns[]

object (ChipRun)

Không bắt buộc. Các chuỗi khối được áp dụng cho các phần phụ của ô. Các thuộc tính của một đoạn văn bản bắt đầu tại một chỉ mục cụ thể trong văn bản và tiếp tục cho đến đoạn văn bản tiếp theo.

Khi đọc, tất cả các lần chạy có gắn chip và không gắn chip đều được tính. Những lần chạy không gắn chip sẽ có Chip trống.

Khi viết, chỉ những lần chạy có chip mới được tính. Các đoạn chứa khối có độ dài là 1 và được biểu thị trong văn bản do người dùng nhập bằng biểu tượng giữ chỗ "@". Các lượt chạy mới sẽ ghi đè mọi lượt chạy trước đó. Việc ghi một userEnteredValue mới sẽ xoá các lần chạy trước đó.

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 thể hiện 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)

Hướng căn chỉnh ngang của giá trị trong ô.

verticalAlignment

enum (VerticalAlign)

Căn chỉnh dọc giá trị trong ô.

wrapStrategy

enum (WrapStrategy)

Kiểu 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ừ phi bị một chuỗi định dạng ghi đè). Việc thiết lập mộ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 một TextFormatRun sẽ được ưu tiên hơn liên kết cấp ô.

textRotation

object (TextRotation)

Góc xoay được á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, hệ thống sẽ sử dụng một mẫu mặc định dựa trên ngôn ngữ của bảng tính (nếu cần) cho loại đã cho. Hãy 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 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 Đị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)
  }
}
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 bên trái của ô.

right

object (Border)

Đường viền bê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 bằng 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 của đường viền.

Enum
STYLE_UNSPECIFIED Bạn chưa chỉ định kiểu. Không sử dụng thuộc tính này.
DOTTED Đường viền có dạng chấm.
DASHED Đường viền là đường nét đứt.
SOLID Đường viền là một đường kẻ liền mỏng.
SOLID_MEDIUM Đường viền là đườ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à 2 đường liền nét.

Khoảng đệm

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 Bạn chưa chỉ định chế độ căn chỉnh theo chiều dọc. Khô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 ở giữa ô.
BOTTOM Văn bản được căn chỉnh rõ ràng xuố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ì thao tác 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 đại diện cho chiến lược xuống dòng cũ của Google Trang tính, trong đó những từ dài hơn một dòng sẽ bị cắt thay vì bị ngắt. Chiến lược này không được hỗ trợ trên tất cả các nền tảng và đang được loại bỏ dần. 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 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

Những từ dài hơn một dòng sẽ được xuống dòng ở cấp độ ký tự thay vì bị cắ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 Bạn chưa chỉ định hướng văn bản. Không sử dụng thuộc tính 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

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

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

TextRotation

Góc xoay được á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 nhóm type. Loại xoay, theo chiều dọc hoặc theo góc. type chỉ có thể là một trong những 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. Các góc dương sẽ hướng lên trên, các góc âm sẽ hướng xuống dưới.

Lưu ý: Đối với hướng văn bản từ trái sang phải, các góc dương có hướng ngược chiều kim đồng hồ, còn đối với hướng văn bản từ phải sang trái, các góc dương có hướ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 từng ký tự sẽ không thay đổi. Ví dụ: 

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

TextFormatRun

Một đoạn văn bản. Định dạng của đoạn này sẽ tiếp tục cho đến chỉ mục bắt đầu của đoạn 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ự bắt đầu từ 0, nơi đoạn này bắt đầu, tính bằng đơ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

Một 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 đáp ứng.

inputMessage

string

Thông báo 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ệ phải 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, các điều kiện "Danh sách" sẽ hiển thị một trình đơn thả xuống.

DataSourceTable

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. Thao tác 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ã 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ác cột cho bảng nguồn dữ liệu. Giá trị mặc định là SELECTED.

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Quy cách bộ 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 dựa trên các quy cách sắp xếp theo thứ tự.

rowLimit

integer

Giới hạn số hàng sẽ trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ áp dụng một hạn mức 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 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ác cột trong nguồn dữ liệu tại thời điểm làm mới.

DataSourceFormula

Một 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ã nhận dạng của nguồn dữ liệu mà công thức được liên kết.

dataExecutionStatus

object (DataExecutionStatus)

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

ChipRun

Lượt chạy của một khối. Khối này sẽ tiếp tục cho đến chỉ mục bắt đầu của lần chạy tiếp theo.

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

integer

Bắt buộc. Chỉ mục ký tự bắt đầu từ 0, nơi đoạn này bắt đầu, tính bằng đơn vị mã UTF-16.

chip

object (Chip)

Không bắt buộc. Khối của lượt chạy này.

Khối

Khối thông minh.

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

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Trường
Trường nhóm properties. Các thuộc tính của khối. properties chỉ có thể là một trong những trạng thái sau:
personProperties

object (PersonProperties)

Thuộc tính của một người được liên kết.

PersonProperties

Các thuộc tính dành riêng cho một người được liên kết.

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

string

Bắt buộc. Địa chỉ email được liên kết với người này. Trường này luôn xuất hiện.

displayFormat

enum (DisplayFormat)

Không bắt buộc. Định dạng hiển thị của khối người dùng. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng định dạng hiển thị mặc định.

DisplayFormat

Định dạng hiển thị ưu tiên (nếu có).

Enum
DISPLAY_FORMAT_UNSPECIFIED Giá trị mặc định, không sử dụng.
DEFAULT Định dạng hiển thị mặc định.
LAST_NAME_COMMA_FIRST_NAME Định dạng hiển thị họ và tên.
EMAIL Định dạng hiển thị email.

RichLinkProperties

Thuộc tính của một đường liên kết đến một tài nguyên trên Google (chẳng hạn như một tệp trong Drive, một video trên YouTube, một địa chỉ trên Maps hoặc một sự kiện trên Lịch). Bạn chỉ có thể viết tệp trên Drive dưới dạng các khối. Tất cả các loại đường liên kết đa dạng thức khác đều chỉ có thể đọc.

URI không được vượt quá 2000 byte khi ghi.

LƯU Ý: Để ghi các chip tệp trên Drive, bạn phải có ít nhất một trong các phạm vi OAuth drive.file, drive.readonly hoặc drive.

Biểu diễn dưới dạng JSON 
{
  "uri": string,
  "mimeType": string
}
Trường
uri

string

Bắt buộc. URI đến đường liên kết. Luôn có sẵn.

mimeType

string

Chỉ có đầu ra. Loại MIME của đường liên kết (nếu có) (ví dụ: khi đó là một tệp trong Drive).