Other

Màu

Biểu thị một màu trong không gian màu RGBA. Biểu thị 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ữ hơn là tính nhỏ gọn. Ví dụ: các trường của bản trình bày này có thể được cung cấp một cách dễ dàng cho hàm khởi tạo của java.awt.Color trong Java; cũng có thể được cung cấp một cách dễ dàng 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 thành chuỗi rgba() CSS trong JavaScript.

Trang tham khảo này không có thông tin về không gian 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 phải giả định không gian màu sRGB.

Khi cần quyết định tính chất bằng nhau của màu sắc, các phương thức 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 lam và alpha của chúng 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

number

Lượng màu đỏ trong màu dưới dạng giá trị trong khoảng [0, 1].

green

number

Lượng màu xanh lục trong màu dưới dạng giá trị trong khoảng [0, 1].

blue

number

Lượng màu xanh dương trong màu dưới dạng giá trị trong khoảng [0, 1].

alpha

number

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 bằng phương trình:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Điều này có nghĩa là giá trị 1.0 tương ứng với màu đồng nhất, trong khi giá trị 0.0 tương ứng với màu hoàn toàn trong suốt. Phương thức này sử dụng thông báo trình bao bọc thay vì một đại lượng vô hướng float đơ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ẽ được kết xuất dưới dạng màu đồng nhất (như thể giá trị alpha đã được chỉ định rõ ràng là 1.0).

ColorStyle

Giá trị màu.

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

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Trường
Trường hợp hợp nhất kind. Loại giá trị màu. kind chỉ có thể là một trong những loại sau:
rgbColor

object (Color)

Màu RGB. Giá trị alpha trong đối tượng Color thường không được hỗ trợ.

themeColor

enum (ThemeColorType)

Màu giao diện.

ThemeColorType

Các loại màu giao diện.

SpreadsheetProperties chứa một SpreadsheetTheme xác định mối liên kết của các loại màu giao diện này với các màu cụ thể.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Màu giao diện không xác đị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

HorizontalAlign

Cách căn chỉnh văn bản theo chiều ngang trong một ô.

Enum
HORIZONTAL_ALIGN_UNSPECIFIED Bạn chưa chỉ định căn chỉnh theo chiều ngang. Khô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 ở 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 dòng văn bản trong ô. Giá trị không có nghĩa là trường không được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Trường
foregroundColor
(deprecated)

object (Color)

Màu nền trước của văn bản. Không dùng nữa: Sử dụng foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Màu nền trước của văn bản. Nếu bạn cũng đặt foregroundColor, thì trường này sẽ được ưu tiên.

fontFamily

string

Bộ phông chữ.

fontSize

integer

Kích thước phông chữ.

bold

boolean

Đúng nếu văn bản được in đậm.

italic

boolean

Đúng nếu văn bản được in nghiêng.

strikethrough

boolean

Đúng nếu văn bản có dấu gạch ngang.

underline

boolean

Đúng nếu văn bản được gạch chân.

DataSourceColumn

Một cột trong nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
Trường
reference

object (DataSourceColumnReference)

Tham chiếu cột.

formula

string

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

string

Tên hiển thị của cột. Tên 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. Quá trình này 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 mà 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ư một quá trì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 quá trình 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 (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Trường
state

enum (DataExecutionState)

Trạng thái thực thi dữ liệu.

errorCode

enum (DataExecutionErrorCode)

Mã lỗi.

errorMessage

string

Thông báo lỗi (có thể để trống).

lastRefreshTime

string (Timestamp format)

Lấy thời gian gần đây nhất dữ liệu được làm mới thành công.

DataExecutionState

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 Chưa bắt đầu thực thi dữ liệ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 Quá trình thực thi dữ liệu đã hoàn tất thành công.
FAILED Quá trình thực thi dữ liệu đã hoàn tất nhưng có lỗi.

DataExecutionErrorCode

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 chờ thực thi dữ liệu.
TOO_MANY_ROWS Quá trình thực thi dữ liệu 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 Lỗi được nhận từ công cụ thực thi dữ liệu phụ trợ (ví dụ: BigQuery). Hãy kiểm tra 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 đượ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 trả về tên cột hoặc email đại diện 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 đang diễn ra, không thể làm mới cho đến khi hoàn tất.
OTHER Các lỗi khác.
TOO_MANY_CHARS_PER_CELL Quá trình thực thi dữ liệu 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 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 theo nguồn dữ liệu.
MISSING_COLUMN_ALIAS Quá trình thực thi dữ liệu trả về các 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 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 Quá trình thực thi dữ liệu đã bị huỷ.

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 value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
Trường
Trường hợp hợp nhất value. Loại giá trị trong một ô. Nếu không đặt trường nào, ô sẽ không có dữ liệu. value chỉ có thể là một trong những loại sau:
numberValue

number

Biểu thị một giá trị double. Lưu ý: Ngày, Giờ và Ngày giờ được biểu thị dưới dạng số thực ở định dạng SERIAL_NUMBER.

stringValue

string

Biểu thị một giá trị chuỗi. Không bao gồm dấu ngoặc đơn ở đầu. Ví dụ: nếu người dùng nhập '123 vào giao diện người dùng, thì thao tác này sẽ được biểu thị dưới dạng stringValue của "123".

boolValue

boolean

Biểu thị một giá trị boolean.

formulaValue

string

Biểu thị một công thức.

errorValue

object (ErrorValue)

Biểu thị lỗi. Trường này chỉ có thể đọc.

ErrorValue

Lỗi trong một ô.

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

enum (ErrorType)

Loại lỗi.

message

string

Một thông báo có thêm thông tin về lỗi (theo 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 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ể đánh giá là đúng hoặc sai. BooleanConditions được sử dụng trong đị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 (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Trường
type

enum (ConditionType)

Loại điều kiện.

values[]

object (ConditionValue)

Giá trị của điều kiện. Số lượng giá trị được hỗ trợ phụ thuộc vào condition type. Một số hỗ trợ giá trị rỗng, một số khác hỗ trợ một hoặc hai giá trị và ConditionType.ONE_OF_LIST hỗ trợ số lượng giá trị tuỳ ý.

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 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 một ConditionValue duy nhất để 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, cũng như ít nhất một ConditionValue cho bộ lọc trên các đố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 một ConditionValue duy nhất để 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, cũng như ít nhất một ConditionValue cho bộ lọc trên các đối tượng nguồn dữ liệu.
NUMBER_BETWEEN Giá trị của ô phải nằm giữa hai 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 đú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. Yêu cầu đú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. 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 giống hệt 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 một ConditionValue duy nhất để 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, cũng như ít nhất một ConditionValue cho bộ lọc trên các đối tượng nguồn dữ liệu.
TEXT_IS_EMAIL Giá trị của ô phải là địa chỉ email hợp lệ. Được hỗ trợ bởi 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ởi tính năng xác thực dữ liệu. Không yêu cầu ConditionValues.
DATE_EQ Giá trị của ô phải là ngày 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 một ConditionValue duy nhất để 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, cũng như ít nhất một ConditionValue cho bộ lọc trên các đố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. Yêu cầu 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. Yêu cầu một ConditionValue có thể là relative date.
DATE_ON_OR_BEFORE Giá trị của ô phải trùng hoặc 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. Yêu cầu một ConditionValue có thể là relative date.
DATE_ON_OR_AFTER Giá trị của ô phải là ngày bắt đầu hoặc sau ngày bắt đầu của giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu. Yêu cầu 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ởi tính năng xác thực dữ liệu. Yêu cầu đúng hai ConditionValues.
DATE_NOT_BETWEEN Giá trị của ô phải nằm ngoài ngày của hai giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu. Yêu cầu đúng hai ConditionValues.
DATE_IS_VALID Giá trị của ô phải là ngày. Được hỗ trợ bởi 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 phạm vi của giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu. Yêu cầu một ConditionValue và giá trị phải là một dải ô hợp lệ theo 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ởi tính năng xác thực dữ liệu. Hỗ trợ số lượng condition values bất kỳ, một cho mỗi mục trong danh sách. Không hỗ trợ công thức 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 đánh giá là đú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. Bộ lọc trang tính nguồn dữ liệu không 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ị điều kiện. Được hỗ trợ bởi 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à chưa đánh dấu. Một giá trị cho biết ô sẽ hiển thị là đã đánh dấu khi chứa giá trị đó và bỏ đánh dấu khi ô đó trống. Hai giá trị cho biết ô sẽ hiển thị là đã đánh dấu khi chứa giá trị đầu tiên và chưa đánh dấu khi chứa giá trị thứ hai. Ví dụ: ["Yes","No"] cho biết ô sẽ hiển thị một hộp đánh dấu khi có giá trị "Yes" (Có) và một hộp không đánh dấu khi có giá trị "No" (Không).
TEXT_NOT_EQ Giá trị của ô phải khác chính xác với giá trị của điều kiện. Được hỗ trợ bởi các bộ lọc trên đối tượng nguồn dữ liệu. Yêu cầu ít nhất một ConditionValue.
DATE_NOT_EQ Giá trị của ô phải khác chính xác với giá trị của điều kiện. Được hỗ trợ bởi các bộ lọc trên đối tượng nguồn dữ liệu. Yêu cầu ít nhất một ConditionValue.
FILTER_EXPRESSION Giá trị của ô phải tuân theo mẫu đã 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 value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
Trường
Trường hợp hợp nhất value. Giá trị của điều kiện, bạn phải đặt đúng một giá trị. value chỉ có thể là một trong những loại sau:
relativeDate

enum (RelativeDate)

Ngày tương đối (dựa trên ngày hiện tại). Chỉ hợp lệ nếu type là DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE hoặc DATE_ON_OR_AFTER.

Ngày tương đối không được hỗ trợ trong tính năng xác thực dữ liệu. Các hàm này chỉ được hỗ trợ trong quy tắc định dạng có điều kiện và bộ lọc có điều kiện.

userEnteredValue

string

Giá trị mà điều kiện 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 = hoặc dấu "+").

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ị này là một năm trước hôm nay.
PAST_MONTH Giá trị này là một tháng trước hôm nay.
PAST_WEEK Giá trị này là một tuần trước ngày hôm nay.
YESTERDAY Giá trị là hôm qua.
TODAY Giá trị là hôm nay.
TOMORROW Giá trị là ngày mai.

GridRange

Một dải ô trên trang tính. Tất cả chỉ mục đều dựa trên mốc 0. Chỉ mục là nửa mở, tức là chỉ mục bắt đầu bao gồm cả chỉ mục đầu và chỉ mục kết thúc không bao gồm chỉ mục cuối -- [startIndex, endIndex). Việc thiếu chỉ mục cho biết phạm vi không có 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

integer

Trang tính chứa dải ô này.

startRowIndex

integer

Hàng bắt đầu (bao gồm cả hàng này) của dải ô hoặc không được đặt nếu không có giới hạn.

endRowIndex

integer

Hàng cuối cùng (không bao gồm) của dải ô hoặc không được đặt nếu không có giới hạn.

startColumnIndex

integer

Cột bắt đầu (bao gồm cả cột này) của dải ô hoặc không được đặt nếu không có giới hạn.

endColumnIndex

integer

Cột cuối (không bao gồm) của dải ô hoặc không được đặt nếu không có 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 liên kết với một cột cụ thể.

Biểu diễn dưới dạng JSON 
{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Trường
filterCriteria

object (FilterCriteria)

Tiêu chí cho cột.

Trường hợp hợp nhất reference. Tham chiếu đến cột đã lọc. reference chỉ có thể là một trong những loại sau:
columnIndex

integer

Chỉ mục cột bắt đầu từ 0.

dataSourceColumnReference

object (DataSourceColumnReference)

Tham chiếu đến một cột nguồn dữ liệu.

FilterCriteria

Tiêu chí hiển thị/ẩn hàng trong bộ lọc hoặc chế độ xem bộ lọc.

Biểu diễn dưới dạng JSON 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Trường
hiddenValues[]

string

Giá trị cần ẩn.

condition

object (BooleanCondition)

Một điều kiện phải đúng để các giá trị hiển thị. (Điều này không ghi đè hiddenValues – nếu một giá trị được liệt kê ở đó, giá trị đó vẫn sẽ bị ẩn.)

visibleBackgroundColor
(deprecated)

object (Color)

Màu nền để lọc; chỉ những ô có màu nền này mới xuất hiện. Loại trừ lẫn nhau với visibleForegroundColor. Không dùng nữa: Sử dụng visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

Màu nền để lọc; chỉ những ô có màu nền này mới xuất hiện. Trường này loại trừ lẫn nhau với visibleForegroundColor và phải được đặt thành màu loại RGB. Nếu bạn cũng đặt visibleBackgroundColor, thì trường này sẽ được ưu tiên.

visibleForegroundColor
(deprecated)

object (Color)

Màu nền trước để lọc; chỉ các ô có màu nền trước này mới xuất hiện. Loại trừ lẫn nhau với visibleBackgroundColor. Không dùng nữa: Sử dụng visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Màu nền trước để lọc; chỉ các ô có màu nền trước này mới xuất hiện. Trường này loại trừ lẫn nhau với visibleBackgroundColor và phải được đặt thành màu loại RGB. Nếu bạn cũng đặt visibleForegroundColor, thì trường này sẽ được ưu tiên.

SortSpec

Thứ tự sắp xếp 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 (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Trường
sortOrder

enum (SortOrder)

Dữ liệu đơn đặt hàng phải được sắp xếp.

foregroundColor
(deprecated)

object (Color)

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 trên cùng. Loại trừ lẫn nhau với backgroundColor. Không dùng nữa: Sử dụng foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

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 trên cùng. Loại trừ lẫn nhau với backgroundColor và phải là màu loại RGB. Nếu bạn cũng đặt foregroundColor, thì trường này sẽ được ưu tiên.

backgroundColor
(deprecated)

object (Color)

Màu nền để sắp xếp; các ô có màu nền này sẽ được sắp xếp lên trên cùng. Loại trừ lẫn nhau với foregroundColor. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Màu nền để sắp xếp; các ô có màu nền này sẽ được sắp xếp lên trên cùng. Loại trừ lẫn nhau với foregroundColor và phải là màu loại RGB. Nếu bạn cũng đặt backgroundColor, thì trường này sẽ được ưu tiên.

Trường hợp hợp nhất reference. Tham chiếu đến phương diện đã sắp xếp. reference chỉ có thể là một trong những loại sau:
dimensionIndex

integer

Phương diện cần áp dụng cách sắp xếp.

dataSourceColumnReference

object (DataSourceColumnReference)

Tham chiếu đến một 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 location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
Trường
Trường hợp hợp nhất 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 những loại sau:
sheetId

integer

Trang tính chứa hàm này. Chỉ đặt nếu đối tượng được nhúng nằm trên trang tính riêng. Phải là số không âm.

overlayPosition

object (OverlayPosition)

Vị trí mà đối tượng được phủ lên trên lưới.

newSheet

boolean

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ột đối tượng được phủ lên trên lưới.

Biểu diễn dưới dạng JSON 
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Trường
anchorCell

object (GridCoordinate)

Ô mà đối tượng được liên kết.

offsetXPixels

integer

Độ lệch theo chiều ngang, tính bằng pixel, mà đối tượng được dịch chuyển so với ô neo.

offsetYPixels

integer

Độ lệch dọc, tính bằng pixel, mà đối tượng được dịch chuyển so với ô neo.

widthPixels

integer

Chiều rộng của đối tượng, tính bằng pixel. Giá trị mặc định là 600.

heightPixels

integer

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 mốc 0.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
Trường
sheetId

integer

Trang tính chứa toạ độ này.

rowIndex

integer

Chỉ mục hàng của toạ độ.

columnIndex

integer

Chỉ mục cột của toạ độ.