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

仅返回请求的字段。
返回与搜索查询匹配的所有字段。