MetadataFilter

使用者提供的篩選器，可根據 Chunk 或 Document 層級中繼資料值限制擷取。範例 (類型 = 戲劇 OR 類型 = 動作)：key = "document.custom_metadata.types"條件 = [{stringValue = "drama", Operations = EQUAL}, {stringValue = "action", Operations = EQUAL}]

JSON 表示法 
{
  "key": string,
  "conditions": [
    {
      object (Condition)
    }
  ]
}
欄位
key

string

必要欄位。要篩選的中繼資料索引鍵。
conditions[]

object (Condition)

必要欄位。指定索引鍵會觸發這個篩選器的 Condition。多個 Condition 會以邏輯 OR 連接。

條件

適用於單一鍵的篩選條件。

JSON 表示法 
{
  "operation": enum (Operator),

  // Union field value can be only one of the following:
  "stringValue": string,
  "numericValue": number
  // End of list of possible types for union field value.
}
欄位
operation

enum (Operator)

必要欄位。套用至指定鍵/值組合的運算子，用來觸發條件。
聯集欄位 value。值類型必須與對應鍵的欄位中定義的值類型一致。如果值類型不一致，結果會是空白集合。如果 CustomMetadata 的值類型為 StringList，篩選條件應使用 string_value 搭配 INCLUDES/EXCLUDES 運算，否則結果也會是空白的組合。value 只能採用下列其中一種設定：
stringValue

string

要篩選中繼資料依據的字串值。
numericValue

number

要篩選中繼資料的數值。

業者

定義可套用至鍵/值組合的有效運算子。

列舉
OPERATOR_UNSPECIFIED 預設值。這個值未使用。
LESS 支援數字。
LESS_EQUAL 支援數字。
EQUAL 由數字和字串支援。
GREATER_EQUAL 支援數字。
GREATER 支援數字。
NOT_EQUAL 由數字和字串支援。
INCLUDES 只有在指定鍵的 CustomMetadata 值類型含有 stringListValue 時，字串才會支援。
EXCLUDES 只有在指定鍵的 CustomMetadata 值類型含有 stringListValue 時，字串才會支援。