DataFilter

Bộ lọc mô tả dữ liệu nào sẽ được chọn hoặc trả về từ một yêu cầu.

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

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
Trường
Trường hợp filter. Các loại bộ lọc có thể giới hạn dữ liệu được chọn. filter chỉ có thể là một trong những trạng thái sau:
developerMetadataLookup

object (DeveloperMetadataLookup)

Chọn dữ liệu liên kết với siêu dữ liệu nhà phát triển khớp với các tiêu chí mô tả trong DeveloperMetadataLookup này.

a1Range

string

Chọn dữ liệu khớp với dải ô A1 được chỉ định.

gridRange

object (GridRange)

Chọn dữ liệu khớp với dải ô mà GridRange mô tả.

DeveloperMetadataLookup

Chọn DeveloperMetadata khớp với tất cả các trường được chỉ định. Ví dụ: nếu bạn chỉ định một mã siêu dữ liệu thì phương thức này sẽ xem xét DeveloperMetadata có mã nhận dạng duy nhất cụ thể đó. Nếu bạn chỉ định một khoá siêu dữ liệu thì chính sách này sẽ xem xét mọi siêu dữ liệu của nhà phát triển có khoá đó. Nếu bạn đã chỉ định tất cả khoá, chế độ hiển thị và loại vị trí thì chính sách này sẽ xem xét mọi siêu dữ liệu dành cho nhà phát triển có khoá đó và chế độ hiển thị được liên kết với một vị trí thuộc loại đó. Nói chung, thao tác này sẽ chọn tất cả DeveloperMetadata khớp với nút giao của tất cả các trường được chỉ định; bạn cũng có thể chỉ định bất kỳ trường hoặc tổ hợp trường nào.

Biểu diễn dưới dạng JSON
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
Trường
locationType

enum (DeveloperMetadataLocationType)

Giới hạn siêu dữ liệu nhà phát triển đã chọn cho các mục nhập được liên kết với vị trí thuộc loại đã chỉ định. Ví dụ: khi trường này được chỉ định là ROW, quá trình tra cứu này chỉ xem xét siêu dữ liệu nhà phát triển liên kết trên các hàng. Nếu bạn không chỉ định trường, thì tất cả các loại vị trí đều được xem xét. Bạn không thể chỉ định trường này là SPREADSHEET khi locationMatchingStrategy được chỉ định là GIAO DIỆN hoặc khi metadataLocation được chỉ định là một vị trí không phải bảng tính: siêu dữ liệu bảng tính không thể giao cắt với bất kỳ vị trí siêu dữ liệu dành cho nhà phát triển nào khác. Bạn cũng không được chỉ định trường này khi locationMatchingStrategy được chỉ định là EXACT.

metadataLocation

object (DeveloperMetadataLocation)

Giới hạn siêu dữ liệu nhà phát triển đã chọn cho các mục nhập liên kết với vị trí được chỉ định. Trường này khớp với các vị trí chính xác hoặc tất cả các vị trí giao nhau theo locationMatchingStrategy được chỉ định.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Xác định cách phép tra cứu này so khớp với vị trí. Nếu trường này được chỉ định là CHÍNH XÁC thì chỉ siêu dữ liệu nhà phát triển liên kết với vị trí chính xác được chỉ định mới khớp. Nếu trường này được chỉ định là XUNG ĐỘT, thì siêu dữ liệu nhà phát triển liên kết trên các vị trí giao nhau cũng được so khớp. Nếu bạn không chỉ định, trường này sẽ giả định một giá trị mặc định là INTERSECTING. Nếu chỉ định trường này, thì bạn cũng phải chỉ định metadataLocation.

metadataId

integer

Giới hạn siêu dữ liệu của nhà phát triển đã chọn ở siêu dữ liệu có DeveloperMetadata.metadata_id trùng khớp.

metadataKey

string

Giới hạn siêu dữ liệu của nhà phát triển đã chọn ở siêu dữ liệu có DeveloperMetadata.metadata_key trùng khớp.

metadataValue

string

Giới hạn siêu dữ liệu của nhà phát triển đã chọn ở siêu dữ liệu có DeveloperMetadata.metadata_value trùng khớp.

visibility

enum (DeveloperMetadataVisibility)

Giới hạn siêu dữ liệu của nhà phát triển đã chọn ở siêu dữ liệu có DeveloperMetadata.visibility trùng khớp. Nếu bạn không chỉ định, thì hệ thống sẽ xem xét tất cả siêu dữ liệu nhà phát triển hiển thị trong dự án yêu cầu.

DeveloperMetadataLocationMatchingStrategy

Bảng liệt kê các chiến lược để so khớp vị trí siêu dữ liệu nhà phát triển.

Enum
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Giá trị mặc định. Không được sử dụng giá trị này.
EXACT_LOCATION Cho biết rằng vị trí được chỉ định phải được so khớp chính xác. Ví dụ: nếu hàng 3 được chỉ định làm vị trí, thì chiến lược so khớp này sẽ chỉ khớp với siêu dữ liệu của nhà phát triển cũng được liên kết ở hàng 3. Siêu dữ liệu liên kết trên các vị trí khác sẽ không được xem xét.
INTERSECTING_LOCATION Cho biết rằng một vị trí được chỉ định phải khớp với vị trí chính xác đó cũng như mọi vị trí giao nhau. Ví dụ: nếu hàng ba được chỉ định làm vị trí, thì chiến lược so khớp này sẽ khớp với siêu dữ liệu của nhà phát triển được liên kết ở hàng ba cũng như siêu dữ liệu được liên kết tại các vị trí giao cắt với hàng ba. Ví dụ: nếu có siêu dữ liệu nhà phát triển được liên kết trên cột B, thì chiến lược so khớp này cũng sẽ khớp với vị trí đó vì cột B giao với hàng ba.