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

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