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 類型的欄位,則可假設的值。

這個欄位僅適用於「SEGMENT」或「ATTRIBUTE」類別的成果。

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

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