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

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