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 biểu diễn 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; nó cũng có thể được cung cấp đơn giản cho UIColor +colorWithRed:green:blue:alpha trong iOS; và chỉ cần thực hiện một chút thao tác, nó có thể dễ dàng được định dạng thành CSS rgba() trong JavaScript.

Trang tham khảo 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 – 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 phải quyết định bằng màu sắc, việc triển khai, trừ phi được ghi lại khác, sẽ coi hai màu là bằng nhau nếu tất cả các giá trị màu đỏ, xanh lục, xanh lam 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
}
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 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

Tỷ lệ của màu này sẽ được áp dụng cho điểm ảnh. 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. Tính năng này sử dụng một thông báo trình bao bọc thay vì một đại lượng vô hướng số thực đơ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

Một giá trị màu sắc.

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 kết hợp kind. Loại giá trị màu sắc. kind chỉ có thể là một trong các trạng thái sau:
rgbColor

object (Color)

màu RGB. Chiến lược phát hành đĩa đơn alpha giá trị trong Color thường không được hỗ trợ.

themeColor

enum (ThemeColorType)

Màu giao diện.

ThemeColorType

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

Enum
THEME_COLOR_TYPE_UNSPECIFIED Màu giao diện chưa được chỉ định
TEXT Đại diện cho màu văn bản chính
BACKGROUND Đại diện cho 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

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 của ô.
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 của ô.

TextFormat

Định dạng của một chuỗi văn bản trong một ô. Giá trị không có 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 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 foregroundColor cũng được đặt, 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 chữ.

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 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á đối tượng nguồn dữ liệu với dữ liệu mới nhất từ DataSource. 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 liên kết cũng như một quy trì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 sẽ tạo một lượt thực thi dữ liệu để làm mới trang tính nguồn dữ liệu 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

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 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. Séc 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 đã cung cấp là 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ề 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 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 cho 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 inch 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
{

  // 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 kết hợp value. Loại giá trị trong một ô. 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

Biểu thị một giá trị kép. Lưu ý: Ngày, Thời gian và Ngày giờ được thể hiện dưới dạng gấp đôi trong 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, điều này sẽ được thể hiện dưới dạng stringValue trong số "123".

boolValue

boolean

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

formulaValue

string

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

errorValue

object (ErrorValue)

Biểu thị một lỗi. Trường này ở chế độ chỉ đọc.

ErrorValue

Lỗi trong ô.

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 được sử dụng loại lỗi này.
ERROR Tương ứng với #ERROR! .
NULL_VALUE Tương ứng với #NULL! .
DIVIDE_BY_ZERO Tương ứng với #DIV/0 .
VALUE Tương ứng với #VALUE! .
REF Tương ứng với #REF! .
NAME Tương ứng với #NAME? .
NUM Tương ứng với #NUM! .
N_A Tương ứng với #N/A .
LOADING Tương ứng với Loading... trạng thái.

BooleanCondition

Một điều kiện có thể đánh giá là true hoặc false. BooleanConditions được sử dụng theo đị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, số khác hỗ trợ một hoặc hai giá trị và ConditionType.ONE_OF_LIST hỗ trợ số lượng giá trị tuỳ ý.

ConditionType

Loại điều kiện.

Enum
CONDITION_TYPE_UNSPECIFIED Giá trị mặc định, không sử dụng.
NUMBER_GREATER Giá trị của ô phải lớn hơn giá trị của điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. 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ở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_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. Cần có 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 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 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 để 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 về đối tượng nguồn dữ liệu.
NUMBER_NOT_EQ Giá trị của ô không được 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. Cần có một ConditionValue để 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 về đố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 hai ConditionValues.
NUMBER_NOT_BETWEEN Giá trị của ô không được nằm giữa hai giá trị điều kiện. Được hỗ trợ bởi tính năng xác thực dữ liệu, định dạng có điều kiện và bộ lọc. Cần có đú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ở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_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. Cần có 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. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Cần có một ConditionValue.
TEXT_EQ Giá trị của ô phải khớp chính xác 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. Cần có một ConditionValue để 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 về đố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 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ằng tính năng xác thực dữ liệu. Không bắt buộc 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 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 để 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 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. Cần có một ConditionValue đó có thể là relative date.
DATE_ON_OR_BEFORE Giá trị của ô phải vào 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. Cần có 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ằng tính năng xác thực dữ liệu. Cần có 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ằng tính năng xác thực dữ liệu. Cần có đúng hai ConditionValues.
DATE_NOT_BETWEEN Giá trị của ô phải nằm ngoài phạm vi ngày 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. Cần có đúng hai ConditionValues.
DATE_IS_VALID Giá trị của ô phải là một ngày. Được hỗ trợ bằng tính năng xác thực dữ liệu. Không yêu cầu ConditionValues.
ONE_OF_RANGE Giá trị của ô phải được liệt kê trong lưới trong dải ô của giá trị điều kiện. Được hỗ trợ bằng tính năng xác thực dữ liệu. Cần 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ằng tính năng xác thực dữ liệu. Hỗ trợ bất kỳ số lượng condition values, một giá trị 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. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Không yêu cầu ConditionValues.
NOT_BLANK Không được để trống giá trị của ô. Tính năng định dạng có điều kiện và bộ lọc hỗ trợ định dạng này. Không yêu cầu ConditionValues.
CUSTOM_FORMULA Công thức của điều kiện phải có giá trị là true. Đượ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ợ. 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à không đánh dấu. Một giá trị cho biết ô sẽ hiển thị là được đánh dấu khi chứa giá trị đó và được bỏ đánh dấu khi ô trống. Hai giá trị cho biết ô sẽ hiển thị như đã đánh dấu 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 kiểm khi có giá trị "Có" và hộp được bỏ chọn khi có giá trị "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ợ. Cần có ít nhất một ConditionValue.
DATE_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ợ. 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. Cần có 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 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 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 typeDATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE hoặc DATE_ON_OR_AFTER.

Ngày tương đối không được hỗ trợ trong việc 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ị dựa vào đ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 một = hoặc dấu "+").

RelativeDate

Kiểm soát cách đánh giá một đ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ị 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à ngày 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 từ 0. Chỉ số mở một nửa, tức là chỉ mục bắt đầu được tính toàn bộ và chỉ mục kết thúc 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ã 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. 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 ở dải ô này đang bật.

startRowIndex

integer

Hàng bắt đầu (bao gồm) dải ô hoặc không đặt nếu không bị ràng buộc.

endRowIndex

integer

Hàng kết thúc (loại trừ) 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 đặt nếu không bị ràng buộc.

endColumnIndex

integer

Cột kết thúc (loại trừ) dải ô hoặc không đặt nếu không bị ràng buộc.

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 Hãy sắp xếp theo thứ tự giảm dần.

FilterSpec

Tiêu chí bộ 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 kết 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 từ 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 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

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

condition

object (BooleanCondition)

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

visibleBackgroundColor
(deprecated)

object (Color)

Màu nền để lọc theo; chỉ hiển thị các ô có màu này. Độc quyền 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 theo; 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 visibleBackgroundColor cũng được đặt, trường này sẽ được ưu tiên.

visibleForegroundColor
(deprecated)

object (Color)

Màu nền trước để lọc theo; chỉ hiển thị các ô có màu nền trước này. Độc quyền 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 theo; chỉ hiển thị các ô có màu nền trước này. 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 visibleForegroundColor cũng được đặt, 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 cần được sắp xếp.

foregroundColor
(deprecated)

object (Color)

Màu nền trước để sắp xếp; các ô có màu nền trước này sẽ được sắp xếp lên đầu. Độc quyền 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 đầu. Độc quyền lẫn nhau với backgroundColor và phải là màu thuộc loại RGB. Nếu foregroundColor cũng được đặt, 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 được sắp xếp lên trên cùng. Độc quyền 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 được sắp xếp lên trên cùng. Độc quyền lẫn nhau với foregroundColor và phải là màu thuộc loại RGB. Nếu backgroundColor cũng được đặt, trường này sẽ được ưu tiên.

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

integer

Phương diện sẽ được áp dụng cách 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 đượ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 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 các trạng thái sau:
sheetId

integer

Trang tính này đang bật. Chỉ đặt nếu đối tượng được nhúng nằm trên trang tính của chính đối tượ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à đố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 ngang, tính bằng pixel, mà đối tượng được bù trừ khỏi ô neo.

offsetYPixels

integer

Độ lệch dọc (tính bằng pixel) mà đối tượng được bù trừ khỏi ô neo.

widthPixels

integer

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

heightPixels

integer

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

GridCoordinate

Toạ độ trong trang tính. Tất cả chỉ số đều từ 0.

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

integer

Trang tính có toạ độ này đang ở trên.

rowIndex

integer

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

columnIndex

integer

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