REST Resource: searchAds360Fields

資源:SearchAds360Field

SearchAds360Service 使用的欄位或資源 (構件)。

JSON 表示法
{
  "resourceName": string,
  "category": enum (SearchAds360FieldCategory),
  "selectableWith": [
    string
  ],
  "attributeResources": [
    string
  ],
  "metrics": [
    string
  ],
  "segments": [
    string
  ],
  "enumValues": [
    string
  ],
  "dataType": enum (SearchAds360FieldDataType),
  "name": string,
  "selectable": boolean,
  "filterable": boolean,
  "sortable": boolean,
  "typeUrl": string,
  "isRepeated": boolean
}
欄位
resourceName

string

構件資源名稱。構件資源名稱的格式如下:

SearchAds360Fields/{name}

category

enum (SearchAds360FieldCategory)

構件類別。

selectableWith[]

string

所有資源、區隔和指標的名稱,可透過所述構件選取。

attributeResources[]

string

所有可透過所述構件選取的資源名稱。當這些資源的欄位納入搜尋查詢時,不會區隔指標。

這個欄位僅適用於類別為「RESOURCE」的構件。

metrics[]

string

這個欄位會列出所有可與所述成果物搭配選取的指標名稱,前提是該成果物在 FROM 子句中使用。只有類別為 RESOURCE 的構件才會設定此屬性。

segments[]

string

這個欄位會列出所有成果的名稱 (無論是區隔或其他資源),當這些區隔指標包含在搜尋查詢中,且所述成果在 FROM 子句中使用時,就會列出這些名稱。只有類別為 RESOURCE 的構件才會設定此屬性。

enumValues[]

string

如果產物是 ENUM 類型的欄位,則可假設的值。

這個欄位只會針對「區段」或「屬性」類別的構件進行設定。

dataType

enum (SearchAds360FieldDataType)

這個欄位會決定可在 WHERE 子句中與遺跡搭配使用的運算子。

name

string

構件名稱。

selectable

boolean

是否可在搜尋查詢的 SELECT 子句中使用構件。

filterable

boolean

構件是否可用於搜尋查詢的 WHERE 子句。

sortable

boolean

是否可以在搜尋查詢的 ORDER BY 子句中使用構件。

typeUrl

string

說明構件資料類型的 proto 網址,

isRepeated

boolean

欄位遺留物是否重複。

SearchAds360FieldCategory

構件的類別。

列舉
UNSPECIFIED 未指定
UNKNOWN 不明
RESOURCE 描述的構件是資源。
ATTRIBUTE 描述的構件是欄位,並且是資源的屬性。如果所屬資源會將 FROM 子句中的資源劃分為多個部分,在查詢中加入資源屬性欄位可能會導致查詢分割。
SEGMENT 所述的構件是欄位,一律會將搜尋查詢區隔開來。
METRIC 所述的構件是欄位和指標。絕不會區隔搜尋查詢。

SearchAds360FieldDataType

以下是 SearchAds360Service 構件可能採用的各種類型。

列舉
UNSPECIFIED 未指定
UNKNOWN 不明
BOOLEAN

對應至 google.protobuf.BoolValue

適用的運算子:=、!=

DATE

對應至 google.protobuf.StringValue。不過,只要使用與日期相關的一組運算子,就能比較結果。

適用的運算子:=、<、>、<=、>=、BETWEEN、DURING 和 IN

DOUBLE

對應至 google.protobuf.DoubleValue

適用的運算子:=、!=、<、>、IN、NOT IN

ENUM

對應至列舉項目。請參閱 typeUrl 瞭解具體定義。

適用的運算子:=、!=、IN、NOT IN

FLOAT

對應至 google.protobuf.FloatValue

適用的運算子:=、!=、<、>、IN、NOT IN

INT32

對應至 google.protobuf.Int32Value

適用的運算子:=、!=、<、>、<=、>=、BETWEEN、IN、NOT IN

INT64

對應至 google.protobuf.Int64Value

適用的運算子:=、!=、<、>、<=、>=、BETWEEN、IN、NOT IN

MESSAGE

對應至通訊協定緩衝區訊息類型。您可以在 typeUrl 中找到資料類型的詳細資料。

沒有運算子可用於 MESSAGE 欄位。

RESOURCE_NAME

對應至 google.protobuf.StringValue。代表資源或其中一個外鍵的資源名稱 (專屬 ID)。

RESOURCE_NAME 欄位不支援任何運算子。

STRING

對應至 google.protobuf.StringValue。

適用的運算子:=、!=、LIKE、NOT LIKE、IN、NOT IN

UINT64

對應至 google.protobuf.UInt64Value

適用的運算子:=、!=、<、>、<=、>=、BETWEEN、IN、NOT IN

方法

get

只傳回要求的欄位。
傳回與搜尋查詢相符的所有欄位。