Other

Màu

Đại diện cho một màu trong hệ màu RGBA. Bản trình bày này được thiết kế để đơn giản hóa việc chuyển đổi sang và từ bản trình bày màu bằng nhiều ngôn ngữ khác nhau về tính nhỏ gọn. Ví dụ: các trường của cách biểu diễn này có thể không rõ ràng được cung cấp cho hàm khởi tạo của java.awt.Color trong Java; cũng có thể là rất đơn giản đối với phương thức +colorWithRed:green:blue:alpha của UIColor trong iOS; và, chỉ cần thực hiện một vài thao tác, nó có thể dễ dàng được định dạng thành chuỗi rgba() của CSS trong JavaScript.

Trang tham khảo này không có thông tin về hệ màu tuyệt đối nên sử dụng để diễn giải giá trị RGB – ví dụ: sRGB, Adobe RGB, DCI-P3 và BT.2020. Theo mặc định, các ứng dụng sẽ giả định hệ màu sRGB.

Khi cần xác định sự cân bằng màu sắc, các phương thức triển khai, trừ khi được ghi lại bằng cách khác, coi hai màu là như nhau nếu tất cả các giá trị màu đỏ, xanh lục, xanh dương và alpha của chúng khác nhau tối đa 1e-5.

Ví dụ (Java): 

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Ví dụ (iOS / Obj-C): 

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Ví dụ (JavaScript): 

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
Biểu diễn dưới dạng JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Các 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ây trong màu dưới dạng giá trị trong khoảng [0, 1].

blue

number

Lượng màu xanh lam trong một 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àu đồng nhất, trong khi giá trị 0.0 tương ứng với màu hoàn toàn trong suốt. Phương thức này sử dụng thông báo trong trình bao bọc thay vì vô hướng thả nổi đơn giản để có thể phân biệt giữa giá trị mặc định và giá trị không được thiết lập. Nếu bị bỏ qua, đối tượng màu này sẽ được hiển thị dưới dạng khối đồng màu (như thể giá trị alpha đã cho sẵn có giá trị là 1,0).

Kiểu màu

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.
}
Các trường
Trường nhóm kind. Loại giá trị màu sắc. kind chỉ có thể là một trong những loại sau đây:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Màu giao diện.

Loại màu giao diện

Loại màu giao diện.

SpreadsheetProperties chứa 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 màu cụ thể.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Màu giao diện không xác định
TEXT Thể hiện màu văn bản chính
BACKGROUND Thể hiện màu nền chính
ACCENT1 Thể hiện 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 Thể hiện màu nhấn thứ sáu

Căn ngang

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. Không sử dụng.
LEFT Văn bản được căn chỉnh rõ ràng ở bên trái của ô.
CENTER Văn bản được căn chỉnh rõ ràng với tâm của ô.
RIGHT Văn bản được căn chỉnh rõ ràng ở bên phải của ô.

Định dạng văn bản

Định dạng 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)
  }
}
Các 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

Họ phông chữ.

fontSize

integer

Kích thước của 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 bị gạch ngang chữ.

underline

boolean

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

Cột nguồn dữ liệu

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

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

object (DataSourceColumnReference)

Tham chiếu cột.

formula

string

Công thức của cột đã tính.

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

Giá trị nhận dạng duy nhất tham chiếu đến cột nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "name": string
}
Các trường
name

string

Tên hiển thị của cột. Tên phải là duy nhất trong một nguồn dữ liệu.

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

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

Hệ thống sẽ tạo một quy trình thực thi dữ liệu để đồng bộ hóa đối tượng nguồn dữ liệu với dữ liệu mới nhất từ DataSource. Nó thường được lên lịch chạy ở chế độ nền, bạn có thể kiểm tra state để biết một quá trình thực thi đã hoàn tất hay chưa

Có một số trường hợp mà quá trình thực thi dữ liệu được kích hoạt để chạy:

  • Adding a data source tạo một trang tính nguồn dữ liệu 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ào 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 liên kết 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
}
Các 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)

Xem thời gian làm mới dữ liệu lần cuối.

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

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

Mã lỗi thực thi dữ liệu

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 Quá trình thực thi dữ liệu đã hết thời gian.
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 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 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 kiểm tra errorMessage để biết chi tiết.
PARAMETER_INVALID Một hoặc một số thông số nguồn dữ liệu đã cung cấp không hợp lệ.
UNSUPPORTED_DATA_TYPE Quá trình thực thi dữ liệu sẽ trả về một loại dữ liệu không được hỗ trợ.
DUPLICATE_COLUMN_NAMES Quá trình thực thi dữ liệu sẽ trả về tên cột hoặc bí danh 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 và 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 cho phép trong một ô duy nhấ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 được nguồn dữ liệu tham chiếu.
MISSING_COLUMN_ALIAS Quá trình thực thi dữ liệu sẽ trả về 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 Đặc tả đối tượng nguồn dữ liệu không hợp lệ.

Giá trị mở rộng

Các loại giá trị mà ô 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.
}
Các trường
Trường nhóm value. Loại giá trị trong ô. Nếu bạn không đặt trường nào, ô sẽ không có dữ liệu. value chỉ có thể là một trong những loại sau đây:
numberValue

number

Thể hiện giá trị kép. Lưu ý: Ngày, giờ và ngày giờ được biểu thị dưới dạng số kép ở định dạng SERIAL_NUMBER.

stringValue

string

Đại diện cho 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 trong "123".

boolValue

boolean

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

formulaValue

string

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

errorValue

object (ErrorValue)

Biểu thị lỗi. Đây là trường chỉ đọc.

Giá trị lỗi

Lỗi trong một ô.

Biểu diễn dưới dạng JSON 
{
  "type": enum (ErrorType),
  "message": string
}
Các 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).

Loại lỗi

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

Điều kiện Boolean

Một điều kiện có thể cho kết quả là đúng hoặc sai. BooleanĐiều kiện được sử dụng bởi đị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)
    }
  ]
}
Các 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ố tệp hỗ trợ giá trị 0, một số khác hỗ trợ một hoặc hai giá trị và ConditionType.ONE_OF_LIST hỗ trợ số lượng giá trị tuỳ ý.

Loại điều kiện

Loại điều kiện.

Enum
CONDITION_TYPE_UNSPECIFIED Không sử dụng giá trị mặc định.
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 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.
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 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.
NUMBER_LESS Giá trị của ô phải nhỏ hơn giá trị của điều kiện. Được hỗ trợ bởi 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.
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 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.
NUMBER_EQ Giá trị của ô phải bằng giá trị của điều kiện. Được hỗ trợ bởi 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 để xác thực dữ liệu, định dạng có điều kiện và các bộ lọ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 đố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 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 để xác thực dữ liệu, định dạng có điều kiện và các bộ lọ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 đố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 xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Yêu cầu đúng hai ConditionValues.
NUMBER_NOT_BETWEEN Giá trị của ô không được nằm giữa hai giá trị điều kiện. Được hỗ trợ bởi 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 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.
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 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.
TEXT_STARTS_WITH Giá trị của ô phải bắt đầu bằng giá trị của điều kiện. Được bộ lọc và định dạng có điều kiện hỗ trợ. Yêu cầu 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 bộ lọc và định dạng có điều kiện hỗ trợ. Yêu cầu 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ởi 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 để xác thực dữ liệu, định dạng có điều kiện và các bộ lọ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 đối tượng nguồn dữ liệu.
TEXT_IS_EMAIL Giá trị của ô phải là địa chỉ email hợp lệ. Được xác thực bằng dữ liệu hỗ trợ. Không yêu cầu ConditionValues.
TEXT_IS_URL Giá trị của ô phải là URL hợp lệ. Được xác thực bằng dữ liệu hỗ trợ. Không yêu cầu ConditionValues.
DATE_EQ Giá trị của ô phải cùng ngày với giá trị của điều kiện. Được hỗ trợ bởi 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 để xác thực dữ liệu, định dạng có điều kiện và các bộ lọ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 đố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 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 giá trị của điều kiện. Được hỗ trợ bởi 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 giá trị của điều kiện. Được xác thực bằng 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 vào hoặc sau ngày giá trị của điều kiện. Được xác thực bằng 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 trong khoảng thời gian từ ngày của hai giá trị điều kiện. Được xác thực bằng dữ liệu hỗ trợ. 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 xác thực bằng dữ liệu hỗ trợ. Yêu cầu đúng hai ConditionValues.
DATE_IS_VALID Giá trị của ô phải là ngày tháng. Được xác thực bằng 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 thuộc phạm vi giá trị điều kiện. Được xác thực bằng 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 các giá trị điều kiện. Được xác thực bằng dữ liệu hỗ trợ. Hỗ trợ số lượng condition values bất kỳ, một mục cho mỗi mục trong danh sách. Công thức không được hỗ trợ trong các giá trị này.
BLANK Giá trị của ô phải trống. Được bộ lọc và định dạng có điều kiện hỗ trợ. Không yêu cầu ConditionValues.
NOT_BLANK Không được để trống giá trị của ô. Được bộ lọc và định dạng có điều kiện hỗ trợ. Không yêu cầu ConditionValues.
CUSTOM_FORMULA Công thức của điều kiện phải cho kết quả là true. Được hỗ trợ bởi 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.
BOOLEAN Giá trị của ô phải là TRUE/FALSE hoặc nằm trong danh sách các giá trị điều kiện. Được xác thực bằng dữ liệu hỗ trợ. Hiển thị dưới dạng hộp kiểm ô. Hỗ trợ ConditionValues, một hoặc hai. Không có giá trị nào cho biết ô phải là TRUE hoặc FALSE, trong đó TRUE hiển thị là đã chọn và FALSE hiển thị là đã bỏ chọn. Một giá trị cho biết ô sẽ hiển thị dưới dạng đã chọn khi ô đó chứa giá trị đó và bỏ chọn khi ô trống. Hai giá trị cho biết ô sẽ hiển thị dưới dạng đã chọn khi ô đó chứa giá trị đầu tiên và bỏ chọn khi ô chứa giá trị thứ hai. Ví dụ: ["Yes","No"] cho biết ô sẽ hiển thị hộp kiểm khi ô đó có giá trị "Có" và một hộp kiểm được bỏ chọn khi ô có giá trị "Không".
TEXT_NOT_EQ Giá trị của ô phải chính xác không phải là giá trị của điều kiện. Được cá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 chính xác không phải là giá trị của điều kiện. Được cá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 được chỉ định. Yêu cầu một ConditionValue.

Giá trị điều kiện

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.
}
Các trường
Trường nhóm value. Phải đặt chính xác giá trị của điều kiện. value chỉ có thể là một trong những loại sau đây:
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 xác thực dữ liệu. Chúng 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ị thể hiện điều kiện. Giá trị được phân tích cú pháp như thể người dùng đã nhập vào một ô. Công thức được hỗ trợ (và phải bắt đầu bằng = hoặc '+').

Ngày tương đối

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

Dải ô vuông

Một dải ô trên trang tính. Tất cả chỉ mục đều dựa trên 0. Chỉ số có một nửa mở, tức là chỉ số bắt đầu được bao gồm và chỉ mục cuối là độc quyền -- [startIndex, endIndex). Thiếu chỉ mục cho biết dải ô không bị giới hạn ở phía đó.

Ví dụ: nếu "Sheet1" là mã trang tính 123456, thì:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

Chỉ số bắt đầu phải luôn nhỏ hơn hoặc bằng chỉ mục kết thúc. Nếu chỉ mục bắt đầu bằng chỉ mục kết thúc thì dải ô sẽ trống. Các dải ô 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
}
Các trường
sheetId

integer

Trang tính có chứa phạm vi 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 được liên kết.

endRowIndex

integer

Hàng kết thúc (không bao gồm) của dải ô hoặc không được đặt nếu không được liên kết.

startColumnIndex

integer

Cột bắt đầu (bao gồm) của dải ô hoặc không được đặt nếu không được liên kết.

endColumnIndex

integer

Cột kết thúc (không bao gồm) của dải ô hoặc không được đặt nếu không được liên kết.

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 giảm dần.

Thông số bộ lọc

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.
}
Các trường
filterCriteria

object (FilterCriteria)

Tiêu chí cho cột.

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

integer

Chỉ mục cột số 0.

dataSourceColumnReference

object (DataSourceColumnReference)

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

Tiêu chí bộ lọc

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

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

string

Các giá trị cần được ẩn.

condition

object (BooleanCondition)

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

visibleBackgroundColor
(deprecated)

object (Color)

Màu nền được lọc theo; chỉ những ô có màu tô này được hiển thị. Loại trừ lẫn nhau bằng visibleForegroundColor. Không dùng nữa: Sử dụng visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

Màu nền được lọc theo; chỉ những ô có màu tô này đượ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 loại 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ỉ những ô có màu nổi này mới được hiển thị. Loại trừ lẫn nhau bằng 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ổi này mới đượ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 loại RGB. Nếu bạn cũng đặt visibleForegroundColor, trường này sẽ được ưu tiên.

Sắp xếp

Thứ tự sắp xếp liên kết với một cột hoặc hàng cụ thể.

Biểu diễn dưới dạng JSON 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

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

enum (SortOrder)

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

foregroundColor
(deprecated)

object (Color)

Màu nền trước để sắp xếp; các ô có màu nổi này được sắp xếp ở trên cùng. Loại trừ lẫn nhau bằng 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ổi 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àu kiểu 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 sắp xếp theo ô; các ô có màu tô này được sắp xếp ở trên cùng. Loại trừ lẫn nhau bằng foregroundColor. Không dùng nữa: Sử dụng backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Màu nền được sắp xếp theo ô; các ô có màu tô 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àu kiểu RGB. Nếu bạn cũng đặt backgroundColor, trường này sẽ được ưu tiên.

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

integer

Thứ nguyên sắp xếp nên được áp dụng.

dataSourceColumnReference

object (DataSourceColumnReference)

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

Vị trí đối tượng được nhúng

Vị trí của một đối tượng dạ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.
}
Các trường
Trường nhóm location. Vị trí của vật thể. Phải đặt chính xác một giá trị. location chỉ có thể là một trong những loại sau đây:
sheetId

integer

Trang tính này đang bật. Chỉ đặt khi đối tượng nhúng nằm trên trang tính riêng. Phải là số không âm.

overlayPosition

object (OverlayPosition)

Vị trí đặt đối tượng phủ 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ó ID được chọn cho bạn. Chỉ dùng khi viết.

Lớp phủ Vị trí

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

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

object (GridCoordinate)

Ô liên kết với đối tượng.

offsetXPixels

integer

Độ lệch ngang, tính bằng pixel, mà đối tượng được bù từ ô neo.

offsetYPixels

integer

Độ lệch dọc, tính bằng pixel, mà đối tượng được bù từ ô 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.

Grid Tọa độ

Một tọa độ 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
}
Các trường
sheetId

integer

Trang tính mà tọa độ này đang sử dụng.

rowIndex

integer

Chỉ mục hàng của tọa độ.

columnIndex

integer

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