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 URL입니다.
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

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

 요청된 필드만 반환합니다.
검색어와 일치하는 모든 필드를 반환합니다.