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ừ biểu thị màu bằng nhiều ngôn ngữ, thay vì tính cô đọng. Ví dụ: các trường của biểu thức này có thể được cung cấp một cách đơn giản cho hàm khởi tạo của java.awt.Color trong Java; hàm này cũng có thể được cung cấp một cách đơn giản cho phương thức +colorWithRed:green:blue:alpha của UIColor trong iOS; và chỉ cần một chút công sức, bạn có thể dễ dàng định dạng hàm này thành chuỗi rgba() CSS trong JavaScript.

Trang tham chiếu này không có thông tin về hệ màu tuyệt đối cần dùng để diễn giải giá trị RGB, chẳng hạn như sRGB, Adobe RGB, DCI-P3 và BT.2020. Theo mặc định, các ứng dụng sẽ giả định hệ màu sRGB.

Khi cần xác định sự bằng nhau về màu sắc, các hoạt động triển khai (trừ phi có tài liệu khác) sẽ coi hai màu là bằng nhau nếu tất cả các giá trị đỏ, xanh lục, xanh lam và alpha của chúng khác nhau nhiều nhất 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 số của màu này sẽ được áp dụng cho pixel. Tức là màu cuối cùng của pixel đượ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. Thao tác này sử dụng một thông báo bao bọc thay vì một đại lượng vô hướng đơ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

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 nhóm kind. Loại giá trị màu. kind chỉ có thể là một trong những trạng thá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 giữ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 Biểu thị màu nhấn đầu tiên
ACCENT2 Biểu thị màu nhấn thứ hai
ACCENT3 Biểu thị màu nhấn thứ ba
ACCENT4 Biểu thị màu nhấn thứ tư
ACCENT5 Biểu thị màu nhấn thứ năm
ACCENT6 Biểu thị 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 chế độ 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 ô.
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 ô.

TextFormat

Định dạng của một đoạn văn bản trong một ô. Giá trị vắng mặt cho biết trường này 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 tiền cảnh của văn bản. Không dùng nữa: Sử dụng foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Màu tiền cảnh 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 của phông chữ.

bold

boolean

True nếu văn bản được in đậm.

italic

boolean

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

strikethrough

boolean

True nếu văn bản có đường 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. Giá trị này phải là duy nhất trong một nguồn dữ liệu.

DataExecutionStatus

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

Một lượt thực thi dữ liệu được tạo để đồng bộ hoá một đối tượng nguồn dữ liệu với dữ liệu mới nhất từ một DataSource. Thường thì hoạt động này đượ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 kích hoạt hoạt động thực thi dữ liệu để 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 hoạt động 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 hoạt động 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 dữ liệu được làm mới thành công gần đây nhất.

DataExecutionState

Một quá trình 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 Đã 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

Một danh sách 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 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 nhận được từ công cụ thực thi dữ liệu phụ trợ (ví dụ: BigQuery). Hãy xem 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 hiện đang diễn ra, bạn không thể làm mới cho đến khi quá trình này hoàn tất.
OTHER 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 mà nguồn dữ liệu tham chiếu đến. */
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 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ố đố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 nhóm value. Loại giá trị trong một ô. Nếu không có trường nào được đặt, thì ô sẽ không có dữ liệu. value chỉ có thể là một trong những trạng thái sau:
numberValue

number

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

stringValue

string

Biểu thị 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ì 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)

Đại diện cho một lỗi. Trường này ở chế độ 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 có 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 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. BooleanCondition được dùng cho đị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ị bằng 0, một số 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ằng tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Chỉ cần 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. Chỉ cần một ConditionValue.
NUMBER_LESS Giá trị của ô phải nhỏ hơn giá trị của điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Chỉ cần một ConditionValue.
NUMBER_LESS_THAN_EQ Giá trị của ô phải nhỏ hơn hoặc bằng giá trị của điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Chỉ cần 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ằ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 cho quy tắc 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, đồng thời yêu cầu í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ằ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 cho quy tắc 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, đồng thời yêu cầu í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 trong khoảng giữa hai giá trị đ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 chính xác hai ConditionValues.
NUMBER_NOT_BETWEEN Giá trị của ô không được nằm trong khoảng giữa hai giá trị đ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 chính xác hai ConditionValues.
TEXT_CONTAINS Giá trị của ô phải 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. Chỉ cần 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. Chỉ cần một ConditionValue.
TEXT_STARTS_WITH Giá trị của ô phải bắt đầu bằng giá trị của điều kiện. Được hỗ trợ bằng bộ lọc và định dạng có điều kiện. Chỉ cần một ConditionValue.
TEXT_ENDS_WITH Giá trị của ô phải kết thúc bằng giá trị của điều kiện. Được hỗ trợ bằng bộ lọc và định dạng có điều kiện. Chỉ cần một ConditionValue.
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ằ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 cho quy tắc 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, đồng thời yêu cầu í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ằng tính năng xác thực dữ liệu. Không cần ConditionValues.
TEXT_IS_URL Giá trị của ô phải là một URL hợp lệ. Được hỗ trợ bằng tính năng xác thực dữ liệu. Không cần ConditionValues.
DATE_EQ Giá trị của ô phải là cùng ngày 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 một ConditionValue cho quy tắc 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, đồng thời yêu cầu í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ó 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 có thể là relative date.
DATE_AFTER Giá trị của ô phải sau ngày có 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 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ằng tính năng xác thực dữ liệu. 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 bằng hoặc sau ngày có giá trị của điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. 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 trong khoảng thời gian giữa hai giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Yêu cầu chính xác hai ConditionValues.
DATE_NOT_BETWEEN Giá trị của ô phải nằm ngoài khoảng thời gian của hai giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Yêu cầu chính xác hai ConditionValues.
DATE_IS_VALID Giá trị của ô phải là ngày. Được hỗ trợ bằng tính năng xác thực dữ liệu. Không cần ConditionValues.
ONE_OF_RANGE Giá trị của ô phải được liệt kê trong lưới trong phạm vi giá trị của điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Yêu cầu một ConditionValue duy nhất 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ị của điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Hỗ trợ mọi số lượng condition values, mỗi mục trong danh sách có một condition values. 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ằng bộ lọc và định dạng có điều kiện. Không cần ConditionValues.
NOT_BLANK Không được để trống giá trị của ô. Được hỗ trợ bằng bộ lọc và định dạng có điều kiện. Không cần 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ợ. Chỉ cần 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. Kết xuất dưới dạng hộp đánh dấu trong ô. 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ị dưới dạng đã đánh dấu và FALSE hiển thị dưới dạng 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à chưa đánh dấu khi ô trống. Hai giá trị cho biết ô sẽ hiển thị ở trạng thái đã đánh dấu khi chứa giá trị đầu tiên và ở trạng thái 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 được đánh dấu khi có giá trị "Yes" và một hộp không được đánh dấu khi có giá trị "No".
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. Bạn phải cung cấp í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. Bạn phải cung cấp ít nhất một ConditionValue.
FILTER_EXPRESSION Giá trị của ô phải tuân theo mẫu được chỉ định. Chỉ cần một ConditionValue.

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 nhóm value. Bạn phải đặt chính xác một giá trị cho điều kiện. value chỉ có thể là một trong những 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. Các hàm này chỉ được hỗ trợ trong tính năng đị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 vào. 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 về ngày.

Enum
RELATIVE_DATE_UNSPECIFIED Giá trị mặc định, không sử dụng.
PAST_YEAR Giá trị này là một năm trước ngày hôm nay.
PAST_MONTH Giá trị này là một tháng trước ngày hôm nay.
PAST_WEEK Giá trị 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ả các chỉ mục đều dựa trên mốc 0. Chỉ mục là bán mở, tức là chỉ mục bắt đầu là bao gồm và chỉ mục kết thúc là không bao gồm – [startIndex, endIndex). Chỉ mục bị thiếu cho biết phạm vi không bị giới hạn ở phía đó.

Ví dụ: nếu "Sheet1" là mã nhận dạng 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 (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 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 
{
  "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 nhóm reference. Tham chiếu đến cột được lọc. reference chỉ có thể là một trong những trạng thá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 hoặc ẩn các 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 là true để các giá trị xuất hiện. (Thao tác này không ghi đè hiddenValues – nếu có giá trị được liệt kê ở đó, giá trị đó vẫn sẽ bị ẩn.)

visibleBackgroundColor
(deprecated)

object (Color)

Màu nền cầ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 cần lọc; chỉ những ô có màu nền này mới xuất hiện. Trường này mang tính 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ỉ những ô 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ỉ những ô có màu nền trước này mới xuất hiện. Trường này mang tính 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 đượ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)

Bạn nên sắp xếp dữ liệu đơn đặt hàng.

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

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

integer

Phương diện mà bạn muốn áp dụng tiêu 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 nhóm 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 trạng thái sau:
sheetId

integer

Trang tính chứa dữ liệu 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 một 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à một đối tượng được phủ lên trên một 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 theo chiều ngang (tính bằng pixel) mà đối tượng bị lệch so với ô neo.

offsetYPixels

integer

Độ lệch dọc (tính bằng pixel) mà đối tượng bị lệch 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

Một toạ độ trong trang tính. Tất cả cá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ạ độ.