- 리소스: 프로모션
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- RedemptionChannel
- 속성
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ProductApplicability
- OfferType
- CouponValueType
- DestinationEnum
- StoreApplicability
- PromotionStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- DestinationStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 상태
- ItemLevelIssue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 심각도
- 메서드
리소스: 프로모션
프로모션을 나타냅니다. 자세한 내용은 다음 도움말을 참고하세요.
데이터 유효성 검사를 통과하는 데 필요한 프로모션 입력 속성은 주로 아래에 정의되어 있습니다.
프로모션 입력을 삽입하고 업데이트한 후 최종 프로모션을 검색할 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.
JSON 표현 |
---|
{ "name": string, "promotionId": string, "contentLanguage": string, "targetCountry": string, "redemptionChannel": [ enum ( |
필드 | |
---|---|
name |
식별자. 프로모션의 이름입니다. 형식: |
promotionId |
필수 항목입니다. 사용자가 프로모션을 고유하게 식별하기 위해 프로모션 ID를 제공했습니다. 프로모션 비승인을 방지하려면 최소 요구사항을 따르세요. |
contentLanguage |
필수 항목입니다. 프로모션의 두 글자 ISO 639-1 언어 코드입니다. 프로모션은 일부 언어에만 제공됩니다. |
targetCountry |
필수 항목입니다. 고유 식별자의 일부로 사용되는 대상 국가입니다. CLDR 지역 코드로 표시됩니다. 프로모션은 일부 국가에서만 사용할 수 있습니다. 무료 등록정보 및 쇼핑 광고 오프라인 판매점 인벤토리 광고 |
redemptionChannel[] |
필수 항목입니다. 프로모션의 사용 채널입니다. 채널이 하나 이상 필요합니다. |
dataSource |
출력 전용입니다. 프로모션의 기본 데이터 소스입니다. |
attributes |
선택사항입니다. 프로모션 속성 목록입니다. |
customAttributes[] |
선택사항입니다. 맞춤 (판매자 제공) 속성의 목록입니다. 데이터 사양의 속성을 일반 형식으로 제출하는 데에도 사용할 수 있습니다 (예: |
promotionStatus |
출력 전용입니다. 프로모션 상태, 데이터 유효성 검사 문제, 즉 비동기식으로 계산된 프로모션에 대한 정보입니다. |
versionNumber |
선택사항입니다. 프로모션의 기존 버전 (최신성)을 나타내며, 여러 업데이트가 동시에 완료될 때 올바른 순서를 유지하는 데 사용할 수 있습니다. 설정하면 버전 번호가 기존 프로모션의 현재 버전 번호보다 낮을 때 삽입이 차단됩니다. 현재 작업이 방지되면 취소된 예외가 발생합니다. |
RedemptionChannel
프로모션 채널입니다.
열거형 | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
채널이 지정되지 않았음을 나타냅니다. |
IN_STORE |
채널이 스토어에 추가되었음을 나타냅니다. products 에 사용된 local 채널과 동일합니다. |
ONLINE |
채널이 온라인 상태임을 나타냅니다. |
속성
속성.
JSON 표현 |
---|
{ "productApplicability": enum ( |
필드 | |
---|---|
productApplicability |
필수 항목입니다. 모든 제품 또는 특정 제품에만 프로모션이 적용되는지 여부입니다. |
offerType |
필수 항목입니다. 프로모션 유형입니다. 이 속성을 사용하여 고객이 프로모션을 사용하는 데 쿠폰 코드가 필요한지 여부를 표시합니다. |
genericRedemptionCode |
선택사항입니다. 프로모션의 일반 쿠폰 사용 코드입니다. |
longTitle |
필수 항목입니다. 프로모션의 긴 제목입니다. |
couponValueType |
필수 항목입니다. coupon value type 속성은 진행 중인 프로모션의 유형을 나타내는 데 사용됩니다. 선택한 쿠폰 값의 유형에 따라 일부 속성이 필요합니다. |
promotionDestinations[] |
필수 항목입니다. 프로모션이 적용되는 대상 유형 목록입니다. 데이터 소스에 지원 값을 포함하여 대상 유형을 지정하지 않으면 프로모션이 쇼핑 광고와 무료 등록정보에 기본적으로 표시됩니다. 이전에는 Shopping Actions, Google 플랫폼, Google 지역 플랫폼 값을 제품의 대상 유형으로 제출했을 수 있습니다. 이러한 값을 나타내려면 |
itemIdInclusion[] |
선택사항입니다. 프로모션에서 상품 ID를 기준으로 한 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 |
brandInclusion[] |
선택사항입니다. 프로모션을 위한 브랜드별 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 |
itemGroupIdInclusion[] |
선택사항입니다. 프로모션의 상품 그룹 ID를 기준으로 한 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부[productApplicability] 속성이 specific_products로 설정된 경우에만 적용됩니다. |
productTypeInclusion[] |
선택사항입니다. 프로모션의 제품 유형별로 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 |
itemIdExclusion[] |
선택사항입니다. 프로모션에 대해 상품 ID 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 |
brandExclusion[] |
선택사항입니다. 프로모션에 대해 브랜드 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 |
itemGroupIdExclusion[] |
선택사항입니다. 상품 그룹 ID를 기준으로 제품 필터 제품 필터 속성은 프로모션 적용 여부 |
productTypeExclusion[] |
선택사항입니다. 프로모션에서 제품 유형 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 |
minimumPurchaseAmount |
선택사항입니다. 프로모션 최소 구매액 |
minimumPurchaseQuantity |
선택사항입니다. 프로모션의 최소 구매 수량입니다. |
limitQuantity |
선택사항입니다. 프로모션의 최대 구매 수량입니다. |
limitValue |
선택사항입니다. 프로모션 최대 제품 가격. |
percentOff |
선택사항입니다. 프로모션에서 제공하는 비율 할인입니다. |
moneyOffAmount |
선택사항입니다. 프로모션에서 제공하는 할인 금액입니다. |
getThisQuantityDiscounted |
선택사항입니다. 프로모션에서 할인되는 상품의 수입니다. 이 속성은 |
freeGiftValue |
선택사항입니다. 프로모션의 사은품 가치입니다. |
freeGiftDescription |
선택사항입니다. 프로모션에 대한 사은품 설명입니다. |
freeGiftItemId |
선택사항입니다. 프로모션의 사은품 상품 ID입니다. |
promotionEffectiveTimePeriod |
필수 항목입니다. 프로모션 시행일의 |
promotionDisplayTimePeriod |
선택사항입니다. 프로모션 표시 날짜의 |
storeApplicability |
선택사항입니다. 프로모션이 모든 매장 또는 지정된 매장에만 적용되는지 여부 매장 적용 여부가 포함되지 않은 오프라인 판매점 인벤토리 광고 프로모션에서 오류가 발생합니다. |
storeCodesInclusion[] |
선택사항입니다. 프로모션에 포함할 판매점 코드입니다. 매장 필터 속성은 제품이 판매되는 오프라인 상점의 판매점 코드 (비즈니스 프로필의 판매점 ID)입니다. 자세한 내용은 오프라인 제품 인벤토리 데이터 사양을 참조하세요. |
storeCodesExclusion[] |
선택사항입니다. 프로모션에서 제외할 판매점 코드입니다. 매장 필터 속성은 |
promotionUrl |
선택사항입니다. 프로모션이 표시되는 판매자 사이트 페이지의 URL입니다. |
ProductApplicability
프로모션이 적용되는 제품 또는 제품 목록
열거형 | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
프로모션이 적용되는 제품을 알 수 없습니다. |
ALL_PRODUCTS |
모든 제품에 적용할 수 있습니다. |
SPECIFIC_PRODUCTS |
단일 제품 또는 제품 목록에만 적용할 수 있습니다. |
OfferType
프로모션의 혜택 유형입니다.
열거형 | |
---|---|
OFFER_TYPE_UNSPECIFIED |
알 수 없는 혜택 유형입니다. |
NO_CODE |
코드가 없는 혜택 유형입니다. |
GENERIC_CODE |
코드가 포함된 혜택 유형입니다. offerType = GENERIC_CODE 인 경우 프로모션의 일반 쿠폰 사용 코드가 필요합니다. |
CouponValueType
프로모션의 쿠폰 값 유형입니다.
열거형 | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
쿠폰 값 유형이 지정되지 않았음을 나타냅니다. |
MONEY_OFF |
할인 쿠폰 값 유형입니다. |
PERCENT_OFF |
할인율 쿠폰 값 유형입니다. |
BUY_M_GET_N_MONEY_OFF |
M개 수량 구매 시 쿠폰 금액 유형 N개 할인. minimumPurchaseQuantity 및 getThisQuantityDiscounted 가 있어야 합니다. moneyOffAmount 도 있어야 합니다. |
BUY_M_GET_N_PERCENT_OFF |
M개 수량 구매 시 쿠폰 값 유형 N% 할인 minimumPurchaseQuantity 및 getThisQuantityDiscounted 가 있어야 합니다. percent_off_percentage 도 있어야 합니다. |
BUY_M_GET_MONEY_OFF |
M개 이상 구매 시 할인 혜택 제공 minimumPurchaseQuantity 및 moneyOffAmount 가 있어야 합니다. |
BUY_M_GET_PERCENT_OFF |
M개 이상 구매 시 할인 혜택 제공 minimumPurchaseQuantity 및 percent_off_percentage 가 있어야 합니다. |
FREE_GIFT |
설명이 포함된 사은품. |
FREE_GIFT_WITH_VALUE |
금전적 가치가 있는 사은품 |
FREE_GIFT_WITH_ITEM_ID |
상품 ID가 포함된 사은품입니다. |
FREE_SHIPPING_STANDARD |
표준 무료 배송 쿠폰 값 유형입니다. |
FREE_SHIPPING_OVERNIGHT |
익일 무료 배송 쿠폰 값 유형입니다. |
FREE_SHIPPING_TWO_DAY |
2일 무료 배송 쿠폰 값 유형입니다. |
DestinationEnum
대상 값입니다.
열거형 | |
---|---|
DESTINATION_ENUM_UNSPECIFIED |
지정되지 않음 |
SHOPPING_ADS |
쇼핑 광고. |
DISPLAY_ADS |
디스플레이 광고. |
LOCAL_INVENTORY_ADS |
오프라인 판매점 인벤토리 광고. |
FREE_LISTINGS |
무료 등록정보. |
FREE_LOCAL_LISTINGS |
무료 오프라인 제품 등록정보. |
YOUTUBE_SHOPPING |
YouTube Shopping |
StoreApplicability
프로모션이 적용되는 판매점 코드 또는 판매점 코드 목록입니다. 오프라인 판매점 인벤토리 광고 프로모션에만 적용됩니다.
열거형 | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
프로모션이 적용되는 판매점 코드를 알 수 없습니다. |
ALL_STORES |
모든 매장에 프로모션이 적용됩니다. |
SPECIFIC_STORES |
프로모션은 지정된 매장에만 적용됩니다. |
PromotionStatus
프로모션의 상태입니다.
JSON 표현 |
---|
{ "destinationStatuses": [ { object ( |
필드 | |
---|---|
destinationStatuses[] |
출력 전용입니다. 프로모션의 대상 도착 페이지입니다. |
itemLevelIssues[] |
출력 전용입니다. 프로모션과 관련된 문제 목록입니다. |
creationDate |
출력 전용입니다. 프로모션이 생성된 날짜(ISO 8601 형식): 날짜, 시간, 오프셋(예: |
lastUpdateDate |
출력 전용입니다. 프로모션 상태가 ISO 8601 형식으로 마지막으로 업데이트된 날짜입니다. 날짜, 시간, 오프셋(예: |
DestinationStatus
지정된 대상의 상태입니다.
JSON 표현 |
---|
{ "reportingContext": enum ( |
필드 | |
---|---|
reportingContext |
출력 전용입니다. 프로모션 대상 위치의 이름입니다. |
status |
출력 전용입니다. 지정된 대상의 상태입니다. |
주
프로모션의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
알 수 없는 프로모션 상태입니다. |
IN_REVIEW |
프로모션을 검토 중입니다. |
REJECTED |
프로모션이 비승인되었습니다. |
LIVE |
프로모션이 승인되어 활성 상태입니다. |
STOPPED |
판매자가 프로모션을 중지했습니다. |
EXPIRED |
프로모션이 더 이상 활성 상태가 아닙니다. |
PENDING |
프로모션이 중지되지 않고 모든 리뷰가 승인되었지만 활성 날짜는 미래 날짜입니다. |
ItemLevelIssue
프로모션과 관련된 문제입니다.
JSON 표현 |
---|
{ "code": string, "severity": enum ( |
필드 | |
---|---|
code |
출력 전용입니다. 문제의 오류 코드입니다. |
severity |
출력 전용입니다. 이 문제가 프로모션 게재에 미치는 영향 |
resolution |
출력 전용입니다. 판매자가 문제를 해결할 수 있는지 여부입니다. |
attribute |
출력 전용입니다. 문제가 단일 속성으로 인해 발생한 경우 속성의 이름입니다. |
reportingContext |
출력 전용입니다. 문제가 적용되는 대상 위치입니다. |
description |
출력 전용입니다. 간단한 문제 설명(영어) |
detail |
출력 전용입니다. 자세한 문제 설명(영어) |
documentation |
출력 전용입니다. 이 문제를 해결하는 데 도움이 되는 웹페이지의 URL입니다. |
applicableCountries[] |
출력 전용입니다. 문제가 혜택에 적용되는 국가 코드 (ISO 3166-1 alpha-2) 목록입니다. |
심각도
문제의 심각도입니다.
열거형 | |
---|---|
SEVERITY_UNSPECIFIED |
지정되지 않음 |
NOT_IMPACTED |
이 문제는 경고를 나타내며 프로모션에 직접적인 영향을 미치지 않습니다. |
DEMOTED |
프로모션 순위가 낮아졌으며 검색결과에서 실적이 제한될 가능성이 높습니다. |
DISAPPROVED |
문제로 인해 프로모션이 비승인됩니다. |
메서드 |
|
---|---|
|
판매자 센터 계정에서 프로모션을 검색합니다. |
|
판매자 센터 계정에 프로모션을 삽입합니다. |
|
판매자 센터 계정에서 프로모션을 나열합니다. |