Trang này được dịch bởi Cloud Translation API.

Other

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 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 một 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ộ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. 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ạ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

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
Trường hợp hợp nhất `kind`. Loại giá trị màu sắc. `kind` chỉ có thể là một trong những giá trị 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.

Trường hợp hợp nhất kind. Loại giá trị màu sắc. kind chỉ có thể là một trong những giá trị 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ứ 6
`LINK`	Biểu thị màu dùng cho đường siêu liên kết

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ách căn chỉnh theo chiều ngang. Không sử dụng phương thức 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

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

{
  "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ục này không được dùng nữa! 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.
`link`	`object (Link)` Đích đến của đường liên kết của văn bản, nếu có. Việc đặt trường đường liên kết trong `TextFormatRun` sẽ xoá các đường liên kết hiện có của ô hoặc đường liên kết cấp ô được đặt trong cùng một yêu cầu. Khi bạn đặt đường liên kết, màu nền trước của văn bản sẽ được đặt thành màu đường liên kết mặc định và văn bản sẽ được gạch chân. Nếu các trường này được sửa đổi trong cùng một yêu cầu, thì các giá trị đó sẽ được sử dụng thay vì giá trị mặc định của đường liên kế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 `destination` can be only one of the following: "uri": string // End of list of possible types for union field `destination`. }

Trường

Trường
Trường hợp hợp nhất `destination`. Đích đến của đường liên kết. `destination` chỉ có thể là một trong những giá trị sau:
`uri`	`string` Giá trị nhận dạng đường liên kết.

Trường hợp hợp nhất destination. Đích đến của đường liên kết. destination chỉ có thể là một trong những giá trị sau:

uri

string

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 (`DataSourceColumnReference`) }, "formula": string }

Trường

Trường
`reference`	`object (DataSourceColumnReference)` Tham chiếu cột.
`formula`	`string` Công thức của cột đã tính.

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

Trường
`name`	`string` 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.

name

string

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á đố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 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 đượ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 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

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`	Công cụ thực thi dữ liệu phụ trợ (ví dụ: BigQuery) gặp lỗi. 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ề 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 đ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 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` 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

Loại giá trị mà một ô trong bảng tính có thể có.

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

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`. }

{

  // 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 giá trị sau:
`numberValue`	`number` Biểu thị một giá trị double. Lưu ý: Ngày, Thời gian và Ngày giờ được thể hiện dưới dạng giá trị gấp đôi ở đị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

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

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à true hoặc false. 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

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ố giá trị hỗ trợ giá trị 0, số khác hỗ trợ 1 hoặc 2 giá trị và `ConditionType.ONE_OF_LIST` hỗ trợ số lượng giá trị tuỳ ý.

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ố giá trị hỗ trợ giá trị 0, số khác hỗ trợ 1 hoặc 2 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. 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ằng 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ằng 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. Cần có một `ConditionValue`.
`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 và í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 và í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ị đ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 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. 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. 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ằng 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. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. 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 và í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à một địa chỉ email hợp lệ. Được hỗ trợ bởi quy tắc 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 quy tắc 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ằng 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 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 các 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. 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 quy tắc 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 vào hoặc sau ngày của giá trị điều kiện. Được hỗ trợ bởi quy tắc 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 quy tắc 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 quy tắc 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 quy tắc 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ởi quy tắc xác thực dữ liệu. 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 hỗ trợ bởi quy tắc 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. Các giá trị này không hỗ trợ công thức.
`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ằng 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ợ. 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à 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 ô 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ợ. 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 bộ lọc trên đối tượng nguồn dữ liệu hỗ trợ. 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
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 những giá trị 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 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`	`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 "+").

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 những giá trị 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 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

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à 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 trang tính. Tất cả chỉ số đều dựa trên giá trị 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). 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ỉ 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. 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`	`integer` Trang tính này đang ở trên 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 kết thúc (loại trừ) dải ô hoặc không đặt nếu không bị ràng buộc.
`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 theo thứ tự tăng dần.
`DESCENDING`	Sắp xếp theo thứ tự 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

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`. }

{
  "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 có thể là một trong những trạng thái sau đây:
`columnIndex`	`integer` Chỉ mục cột 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

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

{
  "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ục này không còn được dùng nữa! Màu tô nền để lọc; chỉ những ô có màu tô 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 cần lọc; chỉ hiển thị các ô có màu này. Trường này loại trừ lẫn nhau với `visibleForegroundColor` và phải được đặt thành màu RGB. Nếu bạn cũng đặt `visibleBackgroundColor`, thì trường này sẽ được ưu tiên.
`visibleForegroundColor (deprecated)`	`object (Color)` Mục này không còn được dùng nữa! 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 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

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`. }

{
  "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 cần được sắp xếp.
`foregroundColor (deprecated)`	`object (Color)` Mục này không được dùng nữa! 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ục này không còn được dùng nữa! 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. 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 giá trị 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

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`. }

{

  // 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 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 những giá trị 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 đã 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ộ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 một 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

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ạ độ.

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ạ độ.