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ữ khác nhau sao cho gọn nhẹ. Ví dụ: các trường của biểu diễn này có thể được cung cấp một cách đơn giản cho hàm khởi tạo của
java.awt.Color
trong Java; nó cũng có thể được cung cấp đơn giản cho UIColor
+colorWithRed:green:blue:alpha
trong iOS; và chỉ cần thực hiện một chút thao tác, nó có thể dễ dàng được định dạng thành CSS
rgba()
trong JavaScript.
Trang tham khảo này không có thông tin về hệ màu tuyệt đối cần 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 sẽ giả định hệ màu sRGB.
Khi cần phải quyết định bằng màu sắc, việc triển khai, trừ phi được ghi lại khác, sẽ coi hai màu là bằng nhau nếu tất cả các giá trị màu đỏ, xanh lục, xanh lam và alpha của chúng khác nhau tối đa
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 đỏ trong màu dưới dạng một giá trị trong khoảng [0, 1]. |
green
|
Lượng màu xanh lục trong màu 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
|
Tỷ lệ của màu này sẽ được áp dụng cho điểm ảnh. 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. Tính năng này sử dụng một thông báo trình bao bọc thay vì một đại lượng vô hướng số thực đơ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ạn 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 cung cấp rõ ràng giá trị là 1.0). |
ColorStyle
Một giá trị màu sắc.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp
kind . Loại giá trị màu sắc.
kind
chỉ có thể là một trong các trạng thái sau:
|
|
rgbColor
|
màu RGB. Chiến lược phát hành đĩa đơn
|
themeColor
|
Màu giao diện. |
ThemeColorType
Loại màu giao diện.
SpreadsheetProperties
chứa một
SpreadsheetTheme
xác định mối liên kết giữa 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
|
Đại diện cho màu văn bản chính |
BACKGROUND
|
Đại diện cho 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ứ 6 |
LINK
|
Biểu thị màu 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 của ô. |
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 của ô. |
TextFormat
Định dạng của một chuỗi văn bản trong một ô. Giá trị không có cho biết trường này 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
|
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 chữ. |
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ó. Đặt trường liên kết trong một
|
Đường liên kết
Nguồn tham khảo bên ngoài hoặc cục bộ.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết 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 đườ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
|
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 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. Giá trị 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á đối tượng nguồn dữ liệu với dữ liệu mới nhất từ
DataSource
. Thường được lên lịch để chạy ở chế độ nền, bạn có thể kiểm tra
state
để biết liệu quá trình thực thi có hoàn tất hay không
Có một số trường hợp trong đó 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 liên kết cũng như một quy trình thực thi dữ liệu để đồng bộ hoá dữ liệu từ nguồn dữ liệu vào trang tính. -
Updating a data source
sẽ tạo một lượt thực thi dữ liệu để làm mới trang tính nguồn dữ liệu 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 mà dữ liệu được làm mới 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 thành công 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 trả về nhiều cột hơn giới hạn. |
TOO_MANY_CELLS
|
Quá trình thực thi dữ liệu trả về nhiều ô hơn giới hạn. |
ENGINE
|
Công cụ thực thi dữ liệu phụ trợ (ví dụ: BigQuery) gặp lỗi. Séc
errorMessage
để biết thông tin chi tiết.
|
PARAMETER_INVALID
|
Một hoặc một số thông số nguồn dữ liệu đã cung cấp là không hợp lệ. |
UNSUPPORTED_DATA_TYPE
|
Quá trình thực thi dữ liệu sẽ 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ề email đại diện 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
|
Quá trình thực thi dữ liệu hiện đang diễn ra, bạn không thể làm mới cho đến khi quá trình này 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 cho phép trong một ô. |
DATA_NOT_FOUND
|
Không tìm thấy cơ sở dữ liệu được tham chiếu theo nguồn dữ liệu. */ |
PERMISSION_DENIED
|
Người dùng không có quyền truy cập vào cơ sở dữ liệu được tham chiếu bởi nguồn dữ liệu. |
MISSING_COLUMN_ALIAS
|
Quá trình thực thi dữ liệu sẽ trả về cột bị thiếu email đại diện. |
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
inch
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
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 kết hợp
value . Loại giá trị trong một ô. 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
|
Biểu thị một giá trị kép. Lưu ý: Ngày, Thời gian và Ngày giờ được thể hiện dưới dạng gấp đôi trong
|
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
|
Biểu thị một công thức. |
errorValue
|
Biểu thị một lỗi. Trường này ở chế độ chỉ đọc. |
ErrorValue
Lỗi trong ô.
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 được sử dụng loại lỗi này. |
ERROR
|
Tương ứng với
#ERROR!
.
|
NULL_VALUE
|
Tương ứng với
#NULL!
.
|
DIVIDE_BY_ZERO
|
Tương ứng với
#DIV/0
.
|
VALUE
|
Tương ứng với
#VALUE!
.
|
REF
|
Tương ứng với
#REF!
.
|
NAME
|
Tương ứng với
#NAME?
.
|
NUM
|
Tương ứng với
#NUM!
.
|
N_A
|
Tương ứng với
#N/A
.
|
LOADING
|
Tương ứng với
Loading...
trạng thái.
|
BooleanCondition
Một điều kiện có thể đánh giá là true hoặc false. BooleanConditions được sử dụng theo định dạng có điều kiện, xác thực dữ liệu và 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[]
|
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. Cần có một
ConditionValue .
|
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. Cần có một
ConditionValue .
|
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. Cần có một
ConditionValue .
|
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. Cần có một
ConditionValue .
|
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. Cần có một
ConditionValue
để xác thực dữ liệu, định dạng có điều kiện và 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 bộ lọc về đối tượng nguồn dữ liệu.
|
NUMBER_NOT_EQ
|
Giá trị của ô không được bằ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. Cần có một
ConditionValue
để xác thực dữ liệu, định dạng có điều kiện và 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 bộ lọc về đố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ó đúng hai
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ó đúng hai
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. Cần có một
ConditionValue .
|
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. Cần có một
ConditionValue .
|
TEXT_STARTS_WITH
|
Giá trị của ô phải bắt đầu bằng giá trị của điều kiện. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Cần có một
ConditionValue .
|
TEXT_ENDS_WITH
|
Giá trị của ô phải kết thúc bằng giá trị của điều kiện. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Cần có một
ConditionValue .
|
TEXT_EQ
|
Giá trị của ô phải khớp chính xác với giá trị của điều kiện. Được hỗ trợ bằng 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ó một
ConditionValue
để xác thực dữ liệu, định dạng có điều kiện và 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 bộ lọc về đố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 hỗ trợ bằng tính năng xác thực dữ liệu. Không yêu cầu
ConditionValues .
|
TEXT_IS_URL
|
Giá trị của ô phải là một URL hợp lệ. Được hỗ trợ bằng tính năng xác thực dữ liệu. Không bắt buộc
ConditionValues .
|
DATE_EQ
|
Giá trị của ô phải cùng ngày 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. Cần có một
ConditionValue
để xác thực dữ liệu, định dạng có điều kiện và 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 bộ lọc về đối tượng nguồn dữ liệu.
|
DATE_BEFORE
|
Giá trị của ô phải trước 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. Cần có một
ConditionValue
đó 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. Cần có một
ConditionValue
đó có thể là
relative date .
|
DATE_ON_OR_BEFORE
|
Giá trị của ô phải vào hoặc trước ngày của giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Cần có một
ConditionValue
đó có thể là
relative date .
|
DATE_ON_OR_AFTER
|
Giá trị của ô phải vào hoặc sau ngày của giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Cần có một
ConditionValue
đó có thể là
relative date .
|
DATE_BETWEEN
|
Giá trị của ô phải nằm giữa ngày của hai giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Cần có đúng hai
ConditionValues .
|
DATE_NOT_BETWEEN
|
Giá trị của ô phải nằm ngoài phạm vi ngày của hai giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Cần có đúng hai
ConditionValues .
|
DATE_IS_VALID
|
Giá trị của ô phải là một ngày. Được hỗ trợ bằng tính năng xác thực dữ liệu. 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 hỗ trợ bằng tính năng xác thực dữ liệu. Cần 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 hỗ trợ bằng tính năng xác thực dữ liệu. Hỗ trợ bất kỳ số lượng
condition values , một giá trị cho mỗi mục trong danh sách. Các giá trị này không hỗ trợ công thức.
|
BLANK
|
Giá trị của ô phải trống. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Không yêu cầu
ConditionValues .
|
NOT_BLANK
|
Không được để trống giá trị của ô. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Không yêu cầu
ConditionValues .
|
CUSTOM_FORMULA
|
Công thức của điều kiện phải có giá trị là true. Đượ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ợ. Cần có một
ConditionValue .
|
BOOLEAN
|
Giá trị của ô phải là TRUE/FALSE hoặc nằm trong danh sách giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Hiển thị dưới dạng hộp đánh dấu ô. Hỗ trợ 0, 1 hoặc 2
ConditionValues . Không có giá trị nào cho biết ô phải là TRUE hoặc FALSE, trong đó TRUE hiển thị là đã đánh dấu và FALSE hiển thị là không đánh dấu. Một giá trị cho biết ô sẽ hiển thị là được đánh dấu khi chứa giá trị đó và được bỏ đánh dấu khi ô trống. Hai giá trị cho biết ô sẽ hiển thị như đã đánh dấu 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 kiểm khi có giá trị "Có" và hộp được bỏ chọn khi có giá trị "Không".
|
TEXT_NOT_EQ
|
Giá trị của ô không được giống hoàn toàn giá trị của điều kiện. Được bộ lọc trên đối tượng nguồn dữ liệu hỗ trợ. Cần có ít nhất một
ConditionValue .
|
DATE_NOT_EQ
|
Giá trị của ô không được giống hoàn toàn giá trị của điều kiện. Được bộ lọc trên đối tượng nguồn dữ liệu hỗ trợ. 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. Cần có một
ConditionValue .
|
ConditionValue
Giá trị của điều kiện.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp
value . Giá trị của điều kiện, phải đặt chính xác một giá trị.
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 việc xác thực dữ liệu. Các tham số này chỉ được hỗ trợ trong định dạng có điều kiện và bộ lọc có điều kiện. |
userEnteredValue
|
Giá trị dựa vào điều kiệ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 một
|
RelativeDate
Kiểm soát cách đánh giá một điều kiện về ngày.
Enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Giá trị mặc định, không sử dụng. |
PAST_YEAR
|
Giá trị này là một năm trước ngày hôm nay. |
PAST_MONTH
|
Giá trị này là một tháng trước ngày hôm nay. |
PAST_WEEK
|
Giá trị là một tuần trước ngày hôm nay. |
YESTERDAY
|
Giá trị là ngày hôm qua. |
TODAY
|
Giá trị là ngày hôm nay. |
TOMORROW
|
Giá trị là ngày mai. |
GridRange
Một dải ô trên trang tính. Tất cả chỉ số đều từ 0. Chỉ số mở một nửa, tức là chỉ mục bắt đầu được tính toàn bộ và chỉ mục kết thúc không bao gồm – [startIndex, endIndex). Chỉ mục bị thiếu 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ỉ số 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. Phạm vi trống thường không có ý nghĩa và thường 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 ở dải ô này đang bật. |
startRowIndex
|
Hàng bắt đầu (bao gồm) dải ô hoặc không đặt nếu không bị ràng buộc. |
endRowIndex
|
Hàng kết thúc (loại trừ) 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 đặt nếu không bị ràng buộc. |
endColumnIndex
|
Cột kết thúc (loại trừ) dải ô hoặc không đặt nếu không bị ràng buộc. |
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
|
Hãy sắp xếp theo thứ tự giảm dần. |
FilterSpec
Tiêu chí bộ 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 kết 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 từ 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 bộ lọc.
Biểu diễn dưới dạng JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Trường | |
---|---|
condition
|
Một điều kiện phải đúng thì các giá trị mới được hiển thị. (Thao tác này không ghi đè
|
visibleBackgroundColor
|
Màu nền để lọc theo; chỉ hiển thị các ô có màu này. Độc quyền lẫn nhau với
|
visibleBackgroundColorStyle
|
Màu nền để lọc theo; chỉ hiển thị các ô có màu này. Trường này loại trừ lẫn nhau với
|
visibleForegroundColor
|
Màu nền trước để lọc theo; chỉ hiển thị các ô có màu nền trước này. Độc quyền lẫn nhau với
|
visibleForegroundColorStyle
|
Màu nền trước để lọc theo; chỉ hiển thị các ô có màu nền trước này. 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 cần đượ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 sẽ được sắp xếp lên đầu. Độc quyền 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 sẽ được sắp xếp lên đầu. Độc quyền lẫn nhau với
|
backgroundColor
|
Màu nền để sắp xếp; các ô có màu nền này được sắp xếp lên trên cùng. Độc quyền lẫn nhau với
|
backgroundColorStyle
|
Màu nền để sắp xếp; các ô có màu nền này được sắp xếp lên trên cùng. Độc quyền lẫn nhau với
|
Trường kết hợp
reference . Tham chiếu đến phương diện đã sắp xếp.
reference
chỉ có thể là một trong các trạng thái sau:
|
|
dimensionIndex
|
Phương diện sẽ được áp dụng cách 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 được nhúng, chẳng hạn như biểu đồ.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp
location . Vị trí của vật thể. 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 này đang bật. Chỉ đặt nếu đối tượng được nhúng nằm trên trang tính của chính đối tượng đó. Phải là số không âm. |
overlayPosition
|
Vị trí mà đối tượng được phủ lên trên lưới. |
newSheet
|
Nếu đúng, đối tượng đã nhúng sẽ được đưa vào 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 đượ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 liên kết. |
offsetXPixels
|
Độ lệch ngang, tính bằng pixel, mà đối tượng được bù trừ khỏi ô neo. |
offsetYPixels
|
Độ lệch dọc (tính bằng pixel) mà đối tượng được bù trừ khỏi ô neo. |
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ỉ số đều từ 0.
Biểu diễn dưới dạng JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Trường | |
---|---|
sheetId
|
Trang tính có toạ độ này đang ở trên. |
rowIndex
|
Chỉ mục hàng của toạ độ. |
columnIndex
|
Chỉ mục cột của toạ độ. |