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ữ 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

number

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

green

number

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

blue

number

Lượng màu xanh dương trong màu dưới dạng một 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 theo 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. 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 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 kind. Loại giá trị màu. kind chỉ có thể là một trong các trạng thái sau:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

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

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 (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, 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)

Giá trị 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. 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 (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 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 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 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

number

Đạ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 SERIAL_NUMBER.

stringValue

string

Đạ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 '123 vào giao diện người dùng, thì giá trị này sẽ được biểu thị dưới dạng stringValue của "123".

boolValue

boolean

Đại diện cho một giá trị boolean.

formulaValue

string

Đại diện cho một công thức.

errorValue

object (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 (ErrorType),
  "message": string
}
Trường
type

enum (ErrorType)

Loại lỗi.

message

string

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 (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Trường
type

enum (ConditionType)

Loại điều kiện.

values[]

object (ConditionValue)

Các 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ợ các giá trị 0, một số giá trị 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 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 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 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

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

string

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 = 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ị 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

integer

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

startRowIndex

integer

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

integer

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

integer

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

integer

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 (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 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

integer

Chỉ mục cột dựa trên 0.

dataSourceColumnReference

object (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 (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Trường
hiddenValues[]

string

Giá trị cần được ẩn.

condition

object (BooleanCondition)

Đ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 đè hiddenValues – nếu một giá trị được liệt kê ở đó thì giá trị đó vẫn sẽ bị ẩn.)

visibleBackgroundColor
(deprecated)

object (Color)

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 visibleForegroundColor. Không dùng nữa: Sử dụng visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

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 và phải được đặt thành màu kiểu RGB. Nếu bạn cũng đặt visibleBackgroundColor, 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 được hiển thị. 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 được hiển thị. Trường này loại trừ lẫn nhau với visibleBackgroundColor và phải được đặt thành màu kiểu RGB. Nếu bạn cũng đặt visibleForegroundColor, trường này sẽ được ưu tiên.

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

backgroundColor
(deprecated)

object (Color)

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 foregroundColor. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

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

integer

Thứ nguyên mà bạn sẽ áp dụng sắp xếp.

dataSourceColumnReference

object (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 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 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

integer

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

object (OverlayPosition)

Vị trí mà tại đó đố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à đối tượng sẽ đượ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 neo vào.

offsetXPixels

integer

Độ lệch ngang, tính bằng pixel, mà đối tượng được bù trừ so với ô liên kết.

offsetYPixels

integer

Độ lệch dọc, tính bằng pixel, mà đối tượng được bù trừ so với ô liên kết.

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