ExtensionFeedItem

확장 피드 항목.

JSON 표현 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
필드
resourceName

string

변경할 수 없습니다. 확장 피드 항목의 리소스 이름입니다. 확장 프로그램 피드 항목 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

출력 전용. 확장 피드 항목의 확장 유형입니다. 이 필드는 읽기 전용입니다.
adSchedules[]

object (AdScheduleInfo)

피드 항목이 게재될 수 있는 모든 시간 간격을 지정하는 중첩되지 않는 일정 목록입니다. 일정은 하루에 최대 6개까지 사용할 수 있습니다.
device

enum (FeedItemTargetDevice)

대상 기기
targetedKeyword

object (KeywordInfo)

타겟 키워드입니다.
status

enum (FeedItemStatus)

출력 전용. 피드 항목의 상태입니다. 이 필드는 읽기 전용입니다.
id

string (int64 format)

출력 전용. 이 피드 항목의 ID입니다. 읽기 전용입니다.
startDateTime

string

이 피드 항목이 유효하고 게재를 시작할 수 있는 시작 시간입니다. 시간은 고객의 시간대로 표시됩니다. 형식은 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
endDateTime

string

이 피드 항목이 더 이상 유효하지 않아 게재가 중단되는 종료 시간입니다. 시간은 고객의 시간대로 표시됩니다. 형식은 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
targetedGeoTargetConstant

string

타겟팅된 지역 타겟 상수입니다.
통합 필드 extension. 광고 확장 유형. extension은 다음 중 하나여야 합니다.
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

구조화된 스니펫 광고 확장.
appFeedItem

object (AppFeedItem)

앱 광고 확장을 선택합니다.
callFeedItem

object (CallFeedItem)

전화번호 광고 확장을 클릭합니다.
calloutFeedItem

object (CalloutFeedItem)

콜아웃 광고 확장을 클릭합니다.
textMessageFeedItem

object (TextMessageFeedItem)

문자 메시지 광고 확장.
priceFeedItem

object (PriceFeedItem)

가격 광고 확장
promotionFeedItem

object (PromotionFeedItem)

프로모션 광고 확장을 선택합니다.
locationFeedItem

object (LocationFeedItem)

출력 전용. 위치 광고 확장을 선택합니다. 위치는 비즈니스 프로필에서 피드로 동기화됩니다. 이 필드는 읽기 전용입니다.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

출력 전용. 제휴사 위치 광고 확장. 피드 위치는 체인 ID를 기반으로 Google Ads에서 채웁니다. 이 필드는 읽기 전용입니다.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

호텔 콜아웃 광고 확장
imageFeedItem

object (ImageFeedItem)

변경할 수 없습니다. 광고주가 제공한 이미지 광고 확장입니다.
통합 필드 serving_resource_targeting. 캠페인 또는 광고그룹 수준에서 타겟팅합니다. 캠페인 또는 광고 그룹을 타겟팅하는 피드 항목은 해당 리소스에만 게재됩니다. serving_resource_targeting은 다음 중 하나여야 합니다.
targetedCampaign

string

타겟팅된 캠페인입니다.
targetedAdGroup

string

타겟팅된 광고그룹입니다.

StructuredSnippetFeedItem

구조화된 스니펫 광고 확장을 나타냅니다.

JSON 표현 
{
  "values": [
    string
  ],
  "header": string
}
필드
values[]

string

스니펫의 값입니다. 컬렉션의 최대 크기는 10입니다.
header

string

스니펫의 헤더입니다. 이 문자열은 비워둘 수 없습니다.

AppFeedItem

앱 확장 프로그램을 나타냅니다.

JSON 표현 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
필드
appStore

enum (AppStore)

타겟 앱이 속한 앱 스토어입니다. 필수 입력란입니다.
finalUrls[]

string

모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. 이 목록은 비워 둘 수 없습니다.
finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 사용할 수 있는 최종 모바일 URL의 목록입니다.
urlCustomParameters[]

object (CustomParameter)

추적 UrlTemplate, FinalUrls 또는 FinalMobileUrls에서 URL 맞춤 매개변수 태그를 대체하는 데 사용할 매핑 목록입니다.
linkText

string

광고에서 링크가 렌더링될 때 표시되는 텍스트입니다. 이 문자열은 비워둘 수 없으며 문자열의 길이는 1에서 25 사이여야 합니다.
appId

string

타겟 애플리케이션의 스토어별 ID입니다. 이 문자열은 비워둘 수 없습니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다. 기본값은 '{lpurl}'입니다.
finalUrlSuffix

string

병렬 추적으로 게재되는 방문 페이지 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.

AppStore

앱 광고 확장의 앱 스토어 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
APPLE_ITUNES Apple iTunes
GOOGLE_PLAY Google Play.

TextMessageFeedItem

사용자가 클릭하여 광고주에게 문자 메시지를 보낼 수 있는 확장 프로그램입니다.

JSON 표현 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
필드
businessName

string

메시지 텍스트 앞에 추가할 업체 이름입니다. 필수 입력란입니다.
countryCode

string

광고주 전화번호의 2자리 국가 코드를 대문자로 표기합니다. 필수 입력란입니다.
phoneNumber

string

메시지를 받을 광고주의 전화번호입니다. 필수 항목입니다.
text

string

광고에 표시할 텍스트입니다. 필수 입력란입니다.
extensionText

string

메시지 앱에 채워진 메시지 확장 텍스트입니다.

PriceFeedItem

가격 광고 확장을 나타냅니다.

JSON 표현 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
필드
type

enum (PriceExtensionType)

이 광고 확장의 가격 광고 확장 유형입니다.
priceQualifier

enum (PriceExtensionPriceQualifier)

이 가격 광고 확장의 모든 상품에 대한 가격 책정 요소입니다.
priceOfferings[]

object (PriceOffer)

이 가격 광고 확장에서 제공하는 가격입니다.
trackingUrlTemplate

string

이 가격 광고 확장의 모든 제품에 대한 추적 URL 템플릿입니다.
languageCode

string

가격 광고 확장에 사용되는 언어 코드입니다.
finalUrlSuffix

string

이 가격 광고 확장의 모든 제품에 대한 추적 URL 템플릿입니다.

PriceOffer

가격 광고 확장에서 가격 혜택 1개를 나타냅니다.

JSON 표현 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
필드
price

object (Money)

이 상품의 가격 값입니다.
unit

enum (PriceExtensionPriceUnit)

이 오퍼의 가격 단위입니다.
finalUrls[]

string

모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 사용할 수 있는 최종 모바일 URL의 목록입니다.
header

string

이 오퍼의 헤더 텍스트입니다.
description

string

이 오퍼의 설명 텍스트입니다.

PromotionFeedItem

프로모션 확장 프로그램을 나타냅니다.

JSON 표현 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
필드
discountModifier

enum (PromotionExtensionDiscountModifier)

할인 자격을 수정하는 열거형입니다.
occasion

enum (PromotionExtensionOccasion)

프로모션이 진행된 행사입니다. 행사가 설정된 경우 사용 기간은 행사와 관련된 기간 내에 있어야 합니다.
finalUrls[]

string

모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. 필수 입력란입니다.
finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 사용할 수 있는 최종 모바일 URL의 목록입니다.
urlCustomParameters[]

object (CustomParameter)

추적 UrlTemplate, FinalUrls 또는 FinalMobileUrls에서 URL 맞춤 매개변수 태그를 대체하는 데 사용할 매핑 목록입니다.
promotionTarget

string

프로모션의 타겟팅 대상에 관한 자유 형식의 설명입니다. 필수 입력란입니다.
promotionStartDate

string

프로모션을 사용할 수 있는 시작일입니다.
promotionEndDate

string

프로모션을 사용할 수 있는 마지막 날짜입니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.
finalUrlSuffix

string

병렬 추적으로 게재되는 방문 페이지 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.
languageCode

string

프로모션 언어입니다. BCP 47 언어 태그로 표시됩니다.
통합 필드 discount_type. 할인 유형으로, 비율 할인 또는 할인 금액일 수 있습니다. discount_type은 다음 중 하나여야 합니다.
percentOff

string (int64 format)

세부 프로모션의 할인율입니다. 100만은 1퍼센트입니다. 이 값 또는 amount_off_amount는 필수 항목입니다.
moneyAmountOff

object (Money)

프로모션에서 할인 금액을 할인해 제공합니다. 이 또는 percentageOff는 필수 항목입니다.
통합 필드 promotion_trigger. 프로모션 트리거. 프로모션 코드 또는 요건을 충족하는 주문 금액별 프로모션으로 될 수 있습니다. promotion_trigger은 다음 중 하나여야 합니다.
promotionCode

string

사용자가 프로모션 혜택을 받기 위해 사용해야 하는 코드입니다.
ordersOverAmount

object (Money)

사용자가 프로모션 혜택을 누리기 위해 필요한 총 주문 금액입니다.

LocationFeedItem

위치 광고 확장을 나타냅니다.

JSON 표현 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
필드
businessName

string

업체의 이름입니다.
addressLine1

string

비즈니스 주소의 입력란 1입니다.
addressLine2

string

비즈니스 주소의 두 번째 입력란
city

string

비즈니스 주소의 도시입니다.
province

string

비즈니스 주소의 주/도입니다.
postalCode

string

비즈니스 주소의 우편번호입니다.
countryCode

string

비즈니스 주소의 국가 코드입니다.
phoneNumber

string

비즈니스의 전화번호입니다.

AffiliateLocationFeedItem

제휴사 위치 광고 확장을 나타냅니다.

JSON 표현 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
필드
businessName

string

업체의 이름입니다.
addressLine1

string

비즈니스 주소의 입력란 1입니다.
addressLine2

string

비즈니스 주소의 두 번째 입력란
city

string

비즈니스 주소의 도시입니다.
province

string

비즈니스 주소의 주/도입니다.
postalCode

string

비즈니스 주소의 우편번호입니다.
countryCode

string

비즈니스 주소의 국가 코드입니다.
phoneNumber

string

비즈니스의 전화번호입니다.
chainId

string (int64 format)

제품의 판매자로 광고되는 소매 체인점의 ID입니다.
chainName

string

체인의 이름입니다.

HotelCalloutFeedItem

호텔 콜아웃 광고 확장을 나타냅니다.

JSON 표현 
{
  "text": string,
  "languageCode": string
}
필드
text

string

콜아웃 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).
languageCode

string

호텔 콜아웃 텍스트의 언어입니다. IETF BCP 47 준수 언어 코드입니다.

ImageFeedItem

광고주가 제공한 이미지 광고 확장을 나타냅니다.

JSON 표현 
{
  "imageAsset": string
}
필드
imageAsset

string

필수 항목입니다. 이미지 확장 소재의 리소스 이름입니다.