REST Resource: googleAdsFields

資源:GoogleAdsField

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

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

string

僅供輸出。構件的資源名稱。構件資源名稱的格式為:

googleAdsFields/{name}

category

enum (GoogleAdsFieldCategory)

僅供輸出。構件的類別。

selectableWith[]

string

僅供輸出。所有資源、區隔和指標的名稱,都能使用描述的構件選取。

attributeResources[]

string

僅供輸出。具備所述構件可選取的所有資源名稱。這些資源中的欄位不會在搜尋查詢中包含時區隔指標。

系統只會針對類別為「RESOURCE」的構件設定這個欄位。

metrics[]

string

僅供輸出。這個欄位會列出在 FROM 子句中使用所述構件選取的所有指標名稱。系統只會針對類別為「RESOURCE」的構件設定這個屬性。

segments[]

string

僅供輸出。這個欄位會列出所有構件的名稱,包括片段或其他資源;當搜尋查詢中包含該結果時,以及當 FROM 子句使用描述的成果時,系統會區隔指標。系統只會針對類別為「RESOURCE」的構件設定這個屬性。

enumValues[]

string

僅供輸出。構件假設是 ENUM 類型的欄位,可能會假設的值。

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

dataType

enum (GoogleAdsFieldDataType)

僅供輸出。這個欄位會決定可以在 WHERE 子句中與成果搭配使用的運算子。

name

string

僅供輸出。構件的名稱。

selectable

boolean

僅供輸出。構件是否能在搜尋查詢中的 SELECT 子句中使用。

filterable

boolean

僅供輸出。構件是否可以在搜尋查詢的 WHERE 子句中使用。

sortable

boolean

僅供輸出。此構件是否可在搜尋查詢中的 ORDER BY 子句中使用。

typeUrl

string

僅供輸出。描述構件資料類型的 proto 網址。

isRepeated

boolean

僅供輸出。欄位構件是否重複。

GoogleAdsFieldCategory

構件的類別。

列舉
UNSPECIFIED 未指定
UNKNOWN 不明
RESOURCE 描述的構件是資源。
ATTRIBUTE 描述的成果是資源的屬性。在查詢中加入資源屬性欄位,如果查詢的來源資源區隔了 FROM 子句中的資源,就可能區隔查詢。
SEGMENT 描述的構件是一個欄位,且一律將搜尋查詢區隔。
METRIC 描述的構件是一個欄位,且是一項指標。絕不會區隔搜尋查詢。

GoogleAdsFieldDataType

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

列舉
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

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