Màu
Đại diện cho một màu trong hệ màu RGBA. Cách trình bày này được thiết kế để đơn giản hoá việc chuyển đổi sang và từ các bản trình bày màu sắc bằng nhiều ngôn ngữ thay vì tính gọn gàng. Ví dụ: các trường của biểu diễn này có thể được cung cấp đơn giản cho hàm khởi tạo của java.awt.Color
trong Java; cũng có thể dễ dàng cung cấp cho phương thức +colorWithRed:green:blue:alpha
của UIColor trong iOS; và chỉ cần một chút thao tác, bạn có thể dễ dàng định dạng chuỗi CSS rgba()
trong JavaScript.
Trang tham khảo này không có thông tin về hệ màu tuyệt đối được dùng để diễn giải giá trị RGB. Ví dụ: sRGB, Adobe RGB, DCI-P3 và BT.2020. Theo mặc định, các ứng dụng phải giả định hệ màu sRGB.
Khi cần quyết định sự cân bằng màu, các phương pháp triển khai (trừ phi được ghi nhận khác) sẽ coi hai màu là bằng nhau nếu tất cả giá trị đỏ, xanh lục, xanh dương và alpha của mỗi màu khác nhau tối đa là 1e-5
.
Ví dụ (Java):
import com.google.type.Color;
// ...
public static java.awt.Color fromProto(Color protocolor) {
float alpha = protocolor.hasAlpha()
? protocolor.getAlpha().getValue()
: 1.0;
return new java.awt.Color(
protocolor.getRed(),
protocolor.getGreen(),
protocolor.getBlue(),
alpha);
}
public static Color toProto(java.awt.Color color) {
float red = (float) color.getRed();
float green = (float) color.getGreen();
float blue = (float) color.getBlue();
float denominator = 255.0;
Color.Builder resultBuilder =
Color
.newBuilder()
.setRed(red / denominator)
.setGreen(green / denominator)
.setBlue(blue / denominator);
int alpha = color.getAlpha();
if (alpha != 255) {
result.setAlpha(
FloatValue
.newBuilder()
.setValue(((float) alpha) / denominator)
.build());
}
return resultBuilder.build();
}
// ...
Ví dụ (iOS / obj-C):
// ...
static UIColor* fromProto(Color* protocolor) {
float red = [protocolor red];
float green = [protocolor green];
float blue = [protocolor blue];
FloatValue* alpha_wrapper = [protocolor alpha];
float alpha = 1.0;
if (alpha_wrapper != nil) {
alpha = [alpha_wrapper value];
}
return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
}
static Color* toProto(UIColor* color) {
CGFloat red, green, blue, alpha;
if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
return nil;
}
Color* result = [[Color alloc] init];
[result setRed:red];
[result setGreen:green];
[result setBlue:blue];
if (alpha <= 0.9999) {
[result setAlpha:floatWrapperWithValue(alpha)];
}
[result autorelease];
return result;
}
// ...
Ví dụ (JavaScript):
// ...
var protoToCssColor = function(rgbColor) {
var redFrac = rgbColor.red || 0.0;
var greenFrac = rgbColor.green || 0.0;
var blueFrac = rgbColor.blue || 0.0;
var red = Math.floor(redFrac * 255);
var green = Math.floor(greenFrac * 255);
var blue = Math.floor(blueFrac * 255);
if (!('alpha' in rgbColor)) {
return rgbToCssColor(red, green, blue);
}
var alphaFrac = rgbColor.alpha.value || 0.0;
var rgbParams = [red, green, blue].join(',');
return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};
var rgbToCssColor = function(red, green, blue) {
var rgbNumber = new Number((red << 16) | (green << 8) | blue);
var hexString = rgbNumber.toString(16);
var missingZeros = 6 - hexString.length;
var resultBuilder = ['#'];
for (var i = 0; i < missingZeros; i++) {
resultBuilder.push('0');
}
resultBuilder.push(hexString);
return resultBuilder.join('');
};
// ...
Biểu diễn dưới dạng JSON |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
Trường | |
---|---|
red
|
Lượng màu đỏ dưới dạng một giá trị trong khoảng [0, 1]. |
green
|
Lượng màu xanh lục dưới dạng một giá trị trong khoảng [0, 1]. |
blue
|
Lượng màu xanh dương trong màu dưới dạng một giá trị trong khoảng [0, 1]. |
alpha
|
Phần màu này sẽ được áp dụng cho pixel. Tức là màu pixel cuối cùng được xác định theo phương trình:
Điều này có nghĩa là giá trị 1,0 tương ứng với một màu đồng nhất, trong khi giá trị 0,0 tương ứng với một màu hoàn toàn trong suốt. Thao tác này sử dụng thông báo trình bao bọc thay vì đại lượng vô hướng nổi đơn giản để có thể phân biệt giữa giá trị mặc định và giá trị chưa được đặt. Nếu bị bỏ qua, đối tượng màu này sẽ hiển thị dưới dạng một màu đồng nhất (như thể giá trị alpha đã được chỉ định rõ ràng là 1.0). |
ColorStyle
Một giá trị màu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp kind . Loại giá trị màu.
kind chỉ có thể là một trong các trạng thái sau:
|
|
rgbColor
|
Màu RGB. Thường thì giá trị |
themeColor
|
Màu giao diện. |
ThemeColorType
Loại màu giao diện.
SpreadsheetProperties
chứa SpreadsheetTheme
giúp xác định việc ánh xạ các loại màu giao diện này với màu cụ thể.
Enum | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Màu giao diện chưa được chỉ định |
TEXT
|
Biểu thị màu văn bản chính |
BACKGROUND
|
Biểu thị màu nền chính |
ACCENT1
|
Đại diện cho màu nhấn đầu tiên |
ACCENT2
|
Đại diện cho màu nhấn thứ hai |
ACCENT3
|
Đại diện cho màu nhấn thứ ba |
ACCENT4
|
Đại diện cho màu nhấn thứ tư |
ACCENT5
|
Đại diện cho màu nhấn thứ năm |
ACCENT6
|
Đại diện cho màu nhấn thứ sáu |
LINK
|
Đại diện cho màu sử dụng cho siêu liên kết |
HorizontalAlign
Căn chỉnh văn bản theo chiều ngang trong một ô.
Enum | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Căn chỉnh ngang không được chỉ định. Đừng sử dụng thuộc tính này. |
LEFT
|
Văn bản được căn chỉnh rõ ràng ở bên trái ô. |
CENTER
|
Văn bản được căn chỉnh rõ ràng vào giữa ô. |
RIGHT
|
Văn bản được căn chỉnh rõ ràng ở bên phải ô. |
TextFormat
Định dạng của một loạt văn bản trong một ô. Giá trị vắng mặt cho biết trường không được chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "foregroundColor": { object ( |
Trường | |
---|---|
foregroundColor
|
Màu nền trước của văn bản. Không dùng nữa: Sử dụng |
foregroundColorStyle
|
Màu nền trước của văn bản. Nếu bạn cũng đặt |
fontFamily
|
Bộ phông chữ. |
fontSize
|
Kích thước phông chữ. |
bold
|
Đúng nếu văn bản được in đậm. |
italic
|
Đúng nếu văn bản được in nghiêng. |
strikethrough
|
Đúng nếu văn bản có dấu gạch ngang. |
underline
|
Đúng nếu văn bản được gạch chân. |
link
|
Đích liên kết của văn bản, nếu có. Việc đặt trường liên kết trong |
Đường liên kết
Tham chiếu bên ngoài hoặc cục bộ.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp destination . Đích liên kết.
destination chỉ có thể là một trong các trạng thái sau:
|
|
uri
|
Giá trị nhận dạng liên kết. |
DataSourceColumn
Một cột trong nguồn dữ liệu.
Biểu diễn dưới dạng JSON |
---|
{
"reference": {
object (
|
Trường | |
---|---|
reference
|
Giá trị tham chiếu cột. |
formula
|
Công thức của cột đã tính. |
DataSourceColumnReference
Giá trị nhận dạng duy nhất tham chiếu đến một cột nguồn dữ liệu.
Biểu diễn dưới dạng JSON |
---|
{ "name": string } |
Trường | |
---|---|
name
|
Tên hiển thị của cột. Mã này phải là duy nhất trong một nguồn dữ liệu. |
DataExecutionStatus
Trạng thái thực thi dữ liệu.
Một lượt thực thi dữ liệu được tạo để đồng bộ hoá một đối tượng nguồn dữ liệu với dữ liệu mới nhất từ DataSource
. Chương trình này thường được lên lịch để chạy ở chế độ nền, bạn có thể kiểm tra state
của chương trình để biết liệu một lượt thực thi có hoàn tất hay không
Có một số trường hợp quá trình thực thi dữ liệu được kích hoạt để chạy:
-
Adding a data source
tạo một trang tính nguồn dữ liệu được liên kết cũng như thực thi dữ liệu để đồng bộ hoá dữ liệu từ nguồn dữ liệu với trang tính. -
Updating a data source
tạo một lượt thực thi dữ liệu để làm mới trang tính nguồn dữ liệu được liên kết theo cách tương tự. -
Bạn có thể gửi
refresh request
để làm mới một hoặc nhiều đối tượng nguồn dữ liệu một cách rõ ràng.
Biểu diễn dưới dạng JSON |
---|
{ "state": enum ( |
Trường | |
---|---|
state
|
Trạng thái thực thi dữ liệu. |
errorCode
|
Mã lỗi. |
errorMessage
|
Thông báo lỗi, có thể để trống. |
lastRefreshTime
|
Lấy thời gian làm mới dữ liệu thành công gần đây nhất. |
DataExecutionState
Bảng liệt kê các trạng thái thực thi dữ liệu.
Enum | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
Giá trị mặc định, không sử dụng. |
NOT_STARTED
|
Quá trình thực thi dữ liệu chưa bắt đầu. |
RUNNING
|
Quá trình thực thi dữ liệu đã bắt đầu và đang chạy. |
CANCELLING
|
Quá trình thực thi dữ liệu hiện đang bị huỷ. |
SUCCEEDED
|
Đã hoàn tất quá trình thực thi dữ liệu. |
FAILED
|
Quá trình thực thi dữ liệu đã hoàn tất nhưng có lỗi. |
DataExecutionErrorCode
Bảng liệt kê mã lỗi thực thi dữ liệu.
Enum | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Giá trị mặc định, không sử dụng. |
TIMED_OUT
|
Đã hết thời gian thực thi dữ liệu. |
TOO_MANY_ROWS
|
Quá trình thực thi dữ liệu sẽ trả về nhiều hàng hơn giới hạn. |
TOO_MANY_COLUMNS
|
Quá trình thực thi dữ liệu sẽ trả về nhiều cột hơn giới hạn. |
TOO_MANY_CELLS
|
Quá trình thực thi dữ liệu sẽ trả về nhiều ô hơn giới hạn. |
ENGINE
|
Lỗi nhận được từ công cụ thực thi dữ liệu phụ trợ (ví dụ: BigQuery). Hãy truy cập vào
errorMessage
để biết thông tin chi tiết.
|
PARAMETER_INVALID
|
Một hoặc một vài thông số nguồn dữ liệu được cung cấp không hợp lệ. |
UNSUPPORTED_DATA_TYPE
|
Quá trình thực thi dữ liệu trả về một loại dữ liệu không được hỗ trợ. |
DUPLICATE_COLUMN_NAMES
|
Quá trình thực thi dữ liệu sẽ trả về bí danh hoặc tên cột trùng lặp. |
INTERRUPTED
|
Quá trình thực thi dữ liệu bị gián đoạn. Vui lòng làm mới sau. |
CONCURRENT_QUERY
|
Hiện đang thực thi dữ liệu, bạn không thể làm mới quá trình thực thi này cho đến khi hoàn tất. |
OTHER
|
Lỗi khác. |
TOO_MANY_CHARS_PER_CELL
|
Quá trình thực thi dữ liệu sẽ trả về các giá trị vượt quá số ký tự tối đa được phép trong một ô. |
DATA_NOT_FOUND
|
Không tìm thấy cơ sở dữ liệu được nguồn dữ liệu tham chiếu. */ |
PERMISSION_DENIED
|
Người dùng không có quyền truy cập vào cơ sở dữ liệu mà nguồn dữ liệu tham chiếu. |
MISSING_COLUMN_ALIAS
|
Quá trình thực thi dữ liệu trả về các cột bị thiếu bí danh. |
OBJECT_NOT_FOUND
|
Đối tượng nguồn dữ liệu không tồn tại. |
OBJECT_IN_ERROR_STATE
|
Đối tượng nguồn dữ liệu hiện đang ở trạng thái lỗi. Để buộc làm mới, hãy đặt force trong RefreshDataSourceRequest .
|
OBJECT_SPEC_INVALID
|
Thông số kỹ thuật của đối tượng nguồn dữ liệu không hợp lệ. |
DATA_EXECUTION_CANCELLED
|
Đã huỷ quá trình thực thi dữ liệu. |
ExtendedValue
Các loại giá trị mà một ô trong bảng tính có thể có.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp value . Loại giá trị trong ô. Nếu bạn không đặt trường nào, thì ô không có dữ liệu.
value chỉ có thể là một trong các trạng thái sau:
|
|
numberValue
|
Đại diện cho một giá trị kép. Lưu ý: Giá trị Ngày, Giờ và DateTime được biểu thị bằng số kép ở định dạng |
stringValue
|
Đại diện cho một giá trị chuỗi. Không bao gồm dấu nháy đơn ở đầu. Ví dụ: nếu người dùng nhập |
boolValue
|
Đại diện cho một giá trị boolean. |
formulaValue
|
Đại diện cho một công thức. |
errorValue
|
Đại diện cho một lỗi. Trường này chỉ để đọc. |
ErrorValue
Lỗi trong một ô.
Biểu diễn dưới dạng JSON |
---|
{
"type": enum (
|
Trường | |
---|---|
type
|
Loại lỗi. |
message
|
Một thông báo cung cấp thêm thông tin về lỗi (bằng ngôn ngữ của bảng tính). |
ErrorType
Loại lỗi.
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED
|
Loại lỗi mặc định, không sử dụng loại lỗi này. |
ERROR
|
Tương ứng với lỗi #ERROR! .
|
NULL_VALUE
|
Tương ứng với lỗi #NULL! .
|
DIVIDE_BY_ZERO
|
Tương ứng với lỗi #DIV/0 .
|
VALUE
|
Tương ứng với lỗi #VALUE! .
|
REF
|
Tương ứng với lỗi #REF! .
|
NAME
|
Tương ứng với lỗi #NAME? .
|
NUM
|
Tương ứng với lỗi #NUM! .
|
N_A
|
Tương ứng với lỗi #N/A .
|
LOADING
|
Tương ứng với trạng thái Loading... .
|
BooleanCondition
Một điều kiện có thể cho kết quả là true (đúng) hoặc false (sai). Điều kiện Boolean được sử dụng trong định dạng có điều kiện, xác thực dữ liệu và các tiêu chí trong bộ lọc.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type
|
Loại điều kiện. |
values[]
|
Các giá trị của điều kiện. Số lượng giá trị được hỗ trợ phụ thuộc vào |
ConditionType
Loại điều kiện.
Enum | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
Giá trị mặc định, không sử dụng. |
NUMBER_GREATER
|
Giá trị của ô phải lớn hơn giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
NUMBER_GREATER_THAN_EQ
|
Giá trị của ô phải lớn hơn hoặc bằng giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
NUMBER_LESS
|
Giá trị của ô phải nhỏ hơn giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
NUMBER_LESS_THAN_EQ
|
Giá trị của ô phải nhỏ hơn hoặc bằng giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
NUMBER_EQ
|
Giá trị của ô phải bằng giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu phải có một ConditionValue duy nhất để xác thực dữ liệu, định dạng có điều kiện, cũng như các bộ lọc đối với các đối tượng không phải nguồn dữ liệu và ít nhất một ConditionValue cho các bộ lọc trên đối tượng nguồn dữ liệu.
|
NUMBER_NOT_EQ
|
Giá trị của ô không được bằng giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu phải có một ConditionValue duy nhất để xác thực dữ liệu, định dạng có điều kiện, cũng như các bộ lọc trên các đối tượng không phải nguồn dữ liệu và ít nhất một ConditionValue cho các bộ lọc trên đối tượng nguồn dữ liệu.
|
NUMBER_BETWEEN
|
Giá trị của ô phải nằm giữa hai giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Cần có chính xác 2 ConditionValues .
|
NUMBER_NOT_BETWEEN
|
Giá trị của ô không được nằm giữa hai giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Cần có chính xác 2 ConditionValues .
|
TEXT_CONTAINS
|
Giá trị của ô phải chứa giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
TEXT_NOT_CONTAINS
|
Giá trị của ô không được chứa giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất.
|
TEXT_STARTS_WITH
|
Giá trị của ô phải bắt đầu bằng giá trị của điều kiện. Được hỗ trợ bởi bộ lọc và định dạng có điều kiện. Yêu cầu một ConditionValue duy nhất.
|
TEXT_ENDS_WITH
|
Giá trị của ô phải kết thúc bằng giá trị của điều kiện. Được hỗ trợ bởi bộ lọc và định dạng có điều kiện. Yêu cầu một ConditionValue duy nhất.
|
TEXT_EQ
|
Giá trị của ô phải chính xác là giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu phải có một ConditionValue duy nhất để xác thực dữ liệu, định dạng có điều kiện, cũng như các bộ lọc trên các đối tượng không phải nguồn dữ liệu và ít nhất một ConditionValue cho các bộ lọc trên đối tượng nguồn dữ liệu.
|
TEXT_IS_EMAIL
|
Giá trị của ô phải là một địa chỉ email hợp lệ. Được xác thực dữ liệu hỗ trợ. Không yêu cầu ConditionValues .
|
TEXT_IS_URL
|
Giá trị của ô phải là một URL hợp lệ. Được xác thực dữ liệu hỗ trợ. Không yêu cầu ConditionValues .
|
DATE_EQ
|
Giá trị của ô phải giống với giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu phải có một ConditionValue duy nhất để xác thực dữ liệu, định dạng có điều kiện, cũng như các bộ lọc đối với các đối tượng không phải nguồn dữ liệu và ít nhất một ConditionValue cho các bộ lọc trên đối tượng nguồn dữ liệu.
|
DATE_BEFORE
|
Giá trị của ô phải trước ngày diễn ra giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất có thể là relative date .
|
DATE_AFTER
|
Giá trị của ô phải sau ngày của giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu một ConditionValue duy nhất có thể là relative date .
|
DATE_ON_OR_BEFORE
|
Giá trị của ô phải vào hoặc trước ngày diễn ra giá trị của điều kiện. Được xác thực dữ liệu hỗ trợ. Yêu cầu một ConditionValue duy nhất có thể là relative date .
|
DATE_ON_OR_AFTER
|
Giá trị của ô phải trùng hoặc sau ngày diễn ra giá trị của điều kiện. Được xác thực dữ liệu hỗ trợ. Yêu cầu một ConditionValue duy nhất có thể là relative date .
|
DATE_BETWEEN
|
Giá trị của ô phải nằm giữa các ngày của hai giá trị điều kiện. Được xác thực dữ liệu hỗ trợ. Cần có chính xác 2 ConditionValues .
|
DATE_NOT_BETWEEN
|
Giá trị của ô phải nằm ngoài ngày của 2 giá trị điều kiện. Được xác thực dữ liệu hỗ trợ. Cần có chính xác 2 ConditionValues .
|
DATE_IS_VALID
|
Giá trị của ô phải là ngày. Được xác thực dữ liệu hỗ trợ. Không yêu cầu ConditionValues .
|
ONE_OF_RANGE
|
Giá trị của ô phải được liệt kê trong lưới trong dải ô của giá trị điều kiện. Được xác thực dữ liệu hỗ trợ. Yêu cầu phải có một ConditionValue và giá trị phải là một dải ô hợp lệ trong ký hiệu A1.
|
ONE_OF_LIST
|
Giá trị của ô phải nằm trong danh sách giá trị điều kiện. Được xác thực dữ liệu hỗ trợ. Hỗ trợ số lượng condition values bất kỳ, một số cho mỗi mục trong danh sách. Công thức không được hỗ trợ trong các giá trị.
|
BLANK
|
Giá trị của ô phải để trống. Được hỗ trợ bởi bộ lọc và định dạng có điều kiện. Không yêu cầu ConditionValues .
|
NOT_BLANK
|
Giá trị của ô không được để trống. Được hỗ trợ bởi bộ lọc và định dạng có điều kiện. Không yêu cầu ConditionValues .
|
CUSTOM_FORMULA
|
Công thức của điều kiện phải có kết quả là true (đúng). Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Không được bộ lọc trang tính nguồn dữ liệu hỗ trợ. Yêu cầu một ConditionValue duy nhất.
|
BOOLEAN
|
Giá trị của ô phải là TRUE/FALSE hoặc nằm trong danh sách giá trị của điều kiện. Được xác thực dữ liệu hỗ trợ. Hiển thị dưới dạng hộp đánh dấu ô. Hỗ trợ 0, một hoặc hai ConditionValues . Không có giá trị nào cho biết ô phải là TRUE hoặc FALSE, trong đó TRUE sẽ hiển thị là được đánh dấu và FALSE hiển thị là được bỏ đánh dấu. Một giá trị cho biết ô sẽ hiển thị ở trạng thái đã đánh dấu khi có chứa giá trị đó và bỏ đánh dấu khi trống. Hai giá trị cho biết ô sẽ hiển thị ở trạng thái đã kiểm tra khi chứa giá trị đầu tiên và được bỏ đánh dấu khi chứa giá trị thứ hai. Ví dụ: ["Yes","No"] cho biết ô sẽ hiển thị hộp đánh dấu khi có giá trị "Yes" và hộp đánh dấu được bỏ đánh dấu khi có giá trị "No".
|
TEXT_NOT_EQ
|
Giá trị của ô phải hoàn toàn không phải là giá trị của điều kiện. Được bộ lọc hỗ trợ trên đối tượng nguồn dữ liệu. Cần có ít nhất một ConditionValue .
|
DATE_NOT_EQ
|
Giá trị của ô phải hoàn toàn không phải là giá trị của điều kiện. Được bộ lọc hỗ trợ trên đối tượng nguồn dữ liệu. Cần có ít nhất một ConditionValue .
|
FILTER_EXPRESSION
|
Giá trị của ô phải tuân theo mẫu được chỉ định. Yêu cầu một ConditionValue duy nhất.
|
ConditionValue
Giá trị của điều kiện.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp value . Bạn phải đặt chính xác giá trị của điều kiện.
value chỉ có thể là một trong các trạng thái sau:
|
|
relativeDate
|
Ngày tương đối (dựa trên ngày hiện tại). Chỉ hợp lệ nếu Ngày tương đối không được hỗ trợ trong tính năng xác thực dữ liệu. Chúng chỉ được hỗ trợ trong bộ lọc có điều kiện và định dạng có điều kiện. |
userEnteredValue
|
Một giá trị mà điều kiện này dựa trên. Giá trị được phân tích cú pháp như thể người dùng đã nhập vào một ô. Công thức được hỗ trợ (và phải bắt đầu bằng |
RelativeDate
Kiểm soát cách đánh giá điều kiện ngày.
Enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Giá trị mặc định, không sử dụng. |
PAST_YEAR
|
Giá trị là một năm trước ngày hôm nay. |
PAST_MONTH
|
Giá trị là trước ngày hôm nay 1 tháng. |
PAST_WEEK
|
Giá trị là một tuần trước hôm nay. |
YESTERDAY
|
Giá trị là ngày hôm qua. |
TODAY
|
Giá trị là hôm nay. |
TOMORROW
|
Giá trị là ngày mai. |
GridRange
Một dải ô trên một trang tính. Tất cả chỉ mục đều dựa trên 0. Các chỉ số mở một nửa, tức là chỉ mục bắt đầu bao gồm và chỉ mục kết thúc là không bao gồm -- [startIndex, endIndex). Thiếu chỉ mục cho biết phạm vi không bị giới hạn ở phía đó.
Ví dụ: nếu "Sheet1"
là mã trang tính 123456, thì:
Sheet1!A1:A1 == sheetId: 123456,
startRowIndex: 0, endRowIndex: 1,
startColumnIndex: 0, endColumnIndex: 1
Sheet1!A3:B4 == sheetId: 123456,
startRowIndex: 2, endRowIndex: 4,
startColumnIndex: 0, endColumnIndex: 2
Sheet1!A:B == sheetId: 123456,
startColumnIndex: 0, endColumnIndex: 2
Sheet1!A5:B == sheetId: 123456,
startRowIndex: 4,
startColumnIndex: 0, endColumnIndex: 2
Sheet1 == sheetId: 123456
Chỉ mục bắt đầu phải luôn nhỏ hơn hoặc bằng chỉ mục kết thúc. Nếu chỉ mục bắt đầu bằng chỉ mục kết thúc, thì dải ô sẽ trống. Các dải ô trống thường không có ý nghĩa và thường được hiển thị trong giao diện người dùng dưới dạng #REF!
.
Biểu diễn dưới dạng JSON |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
Trường | |
---|---|
sheetId
|
Trang tính chứa dải ô này. |
startRowIndex
|
Hàng bắt đầu (bao gồm) của dải ô hoặc không được đặt nếu không bị giới hạn. |
endRowIndex
|
Hàng kết thúc (không bao gồm) của dải ô hoặc không đặt nếu không bị giới hạn. |
startColumnIndex
|
Cột bắt đầu (bao gồm) dải ô hoặc không được đặt nếu không bị giới hạn. |
endColumnIndex
|
Cột kết thúc (không bao gồm) dải ô hoặc không đặt nếu không bị giới hạn. |
SortOrder
Thứ tự sắp xếp.
Enum | |
---|---|
SORT_ORDER_UNSPECIFIED
|
Giá trị mặc định, không sử dụng giá trị này. |
ASCENDING
|
Sắp xếp tăng dần. |
DESCENDING
|
Sắp xếp giảm dần. |
FilterSpec
Tiêu chí lọc được liên kết với một cột cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "filterCriteria": { object ( |
Trường | |
---|---|
filterCriteria
|
Tiêu chí cho cột. |
Trường hợp reference . Tham chiếu đến cột đã lọc.
reference chỉ có thể là một trong các trạng thái sau:
|
|
columnIndex
|
Chỉ mục cột dựa trên 0. |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu. |
FilterCriteria
Tiêu chí để hiển thị/ẩn hàng trong chế độ xem bộ lọc hoặc chế độ xem bộ lọc.
Biểu diễn dưới dạng JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Trường | |
---|---|
condition
|
Điều kiện phải đúng thì các giá trị mới xuất hiện. (Thao tác này không ghi đè |
visibleBackgroundColor
|
Màu nền để lọc; chỉ các ô có màu nền này mới được hiển thị. Loại trừ lẫn nhau với |
visibleBackgroundColorStyle
|
Màu nền để lọc; chỉ các ô có màu nền này mới được hiển thị. Trường này loại trừ lẫn nhau với |
visibleForegroundColor
|
Màu nền trước để lọc; chỉ các ô có màu nền trước này được hiển thị. Loại trừ lẫn nhau với |
visibleForegroundColorStyle
|
Màu nền trước để lọc; chỉ các ô có màu nền trước này được hiển thị. Trường này loại trừ lẫn nhau với |
SortSpec
Thứ tự sắp xếp được liên kết với một cột hoặc hàng cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "sortOrder": enum ( |
Trường | |
---|---|
sortOrder
|
Dữ liệu đơn đặt hàng sẽ được sắp xếp. |
foregroundColor
|
Màu nền trước để sắp xếp; các ô có màu nền trước này được sắp xếp ở trên cùng. Loại trừ lẫn nhau với |
foregroundColorStyle
|
Màu nền trước để sắp xếp; các ô có màu nền trước này được sắp xếp ở trên cùng. Loại trừ lẫn nhau với |
backgroundColor
|
Màu nền cần sắp xếp; các ô có màu nền này được sắp xếp ở trên cùng. Loại trừ lẫn nhau với |
backgroundColorStyle
|
Màu nền cần sắp xếp; các ô có màu nền này được sắp xếp ở trên cùng. Loại trừ lẫn nhau với |
Trường hợp reference . Tham chiếu đến phương diện được sắp xếp.
reference chỉ có thể là một trong các trạng thái sau:
|
|
dimensionIndex
|
Thứ nguyên mà bạn sẽ áp dụng sắp xếp. |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu. |
EmbeddedObjectPosition
Vị trí của một đối tượng nhúng, chẳng hạn như biểu đồ.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp location . Vị trí của đối tượng. Bạn phải đặt đúng một giá trị.
location chỉ có thể là một trong các trạng thái sau:
|
|
sheetId
|
Trang tính đang hiển thị nội dung này. Chỉ đặt nếu đối tượng được nhúng nằm trên trang tính riêng. Không được là số âm. |
overlayPosition
|
Vị trí mà tại đó đối tượng được phủ lên trên lưới. |
newSheet
|
Nếu đúng, đối tượng được nhúng sẽ được đặt trên một trang tính mới có mã nhận dạng được chọn cho bạn. Chỉ dùng khi viết. |
OverlayPosition
Vị trí mà đối tượng sẽ được phủ lên trên lưới.
Biểu diễn dưới dạng JSON |
---|
{
"anchorCell": {
object (
|
Trường | |
---|---|
anchorCell
|
Ô mà đối tượng được neo vào. |
offsetXPixels
|
Độ lệch ngang, tính bằng pixel, mà đối tượng được bù trừ so với ô liên kết. |
offsetYPixels
|
Độ lệch dọc, tính bằng pixel, mà đối tượng được bù trừ so với ô liên kết. |
widthPixels
|
Chiều rộng của đối tượng, tính bằng pixel. Giá trị mặc định là 600. |
heightPixels
|
Chiều cao của đối tượng, tính bằng pixel. Giá trị mặc định là 371. |
GridCoordinate
Toạ độ trong trang tính. Tất cả chỉ mục đều dựa trên 0.
Biểu diễn dưới dạng JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Trường | |
---|---|
sheetId
|
Trang tính chứa toạ độ này. |
rowIndex
|
Chỉ mục hàng của toạ độ. |
columnIndex
|
Chỉ mục cột của toạ độ. |