본문 바로가기
상품API/고객혜택 | 광고 API

리스팅 부가서비스 API

Description
등록/수정 : [PUT] https://sa2.esmplus.com/item/v1/advertising/listing
리스트 부가서비스 설정하는 API 입니다.
옥션 상품에는 프리미엄/프리미엄플러스, 지마켓 상품에는 포커스/포커스플러스 상품을 이용할 수 있습니다.
프리미엄플러스에는 프리미엄이 포커스플러스에는 포커스 서비스가 포함되어 있습니다.

부가서비스 설정은 판매예치금 충전 후 설정 가능 합니다.
사이트별 설정시 예치금 여부에 따라 있는 경우 성공, 없는 경우 실패 처리 됩니다.

G마켓 부가서비스는 25년 9월 15일 종료 예정이나 공지 참고 부탁 드립니다. (공지 바로가기)

Request Description

항목 항목명 필수여부 Type Description
goodsNo 마스터상품번호 Y int 마스터 상품번호
iacPremium > isUse 옥션프리미엄사용여부   boolean true : 사용
false : 미사용
iacPremium > applyPeriod 사용일   int 7, 15, 30, 60, 90 입력 가능
iacPremium > autoExtendType 자동연장설정   int 1 : 자동 연장 미사용
2 : 무제한 연장
3 : 기간 내 연장
iacPremium > autoExtendAmountDay 자동연장사용일   int 7, 15, 30, 60, 90 입력 가능
iacPremium > autoExtendEndDate 제한기간일자   date - AutoExtendType=3 경우
종료기간 날짜 설정
- YYYY-MM-DD 형식으로 입력
iacPremiumPlus > isUse 옥션프리미엄플러스사용여부   boolean true: 사용
false : 미사용
iacPremiumPlus > applyPeriod 사용일   int 7, 15, 30, 60, 90 입력 가능
iacPremiumPlus > autoExtendType 자동연장설정   int 1 : 자동 연장 미사용
2 : 무제한 연장
3 : 기간 내 연장
iacPremiumPlus > autoExtendAmountDay 자동연장사용일   int 7, 15, 30, 60, 90 입력 가능
iacPremiumPlus > autoExtendEndDate 제한기간일자   date - AutoExtendType=3 경우
종료기간 날짜 설정
- YYYY-MM-DD 형식으로 입력
gmktFocus > isUse G마켓포커스사용여부   boolean true: 사용
false : 미사용
gmktFocus > applyPeriod 사용일   int 7, 15, 30, 60, 90 입력 가능
gmktFocus > autoExtendType 자동연장설정   int 1 : 자동 연장 미사용
2 : 무제한 연장
3 : 기간 내 연장
gmktFocus > autoExtendAmountDay 자동연장사용일   int 7, 15, 30, 60, 90 입력 가능
gmktFocus > autoExtendEndDate 제한기간일자   date - AutoExtendType=3 경우
종료기간 날짜 설정
- YYYY-MM-DD 형식으로 입력
gmktFocusPlus > isUse G마켓포커스플러스사용여부   boolean true: 사용
false : 미사용
gmktFocusPlus > applyPeriod 사용일   int 7, 15, 30, 60, 90 입력 가능
gmktFocusPlus > autoExtendType 자동연장설정   int 1 : 자동 연장 미사용
2 : 무제한 연장
3 : 기간 내 연장
gmktFocusPlus > autoExtendAmountDay 자동연장사용일   int 7, 15, 30, 60, 90 입력 가능
gmktFocusPlus > autoExtendEndDate 제한기간일자   date - AutoExtendType=3 경우
종료기간 날짜 설정
- YYYY-MM-DD 형식으로 입력
JSON

{
  "goodsNo": 0,
  "iacPremium": {
    "isUse": true,
    "applyPeriod": 0,
    "autoExtendType": "None",
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2019-04-26"
  },
  "iacPremiumPlus": {
    "isUse": true,
    "applyPeriod": 0,
    "autoExtendType": "None",
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2019-04-26"
  },
  "gmktFocus": {
    "isUse": true,
    "applyPeriod": 0,
    "autoExtendType": "None",
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2019-04-26"
  },
  "gmktFocusPlus": {
    "isUse": true,
    "applyPeriod": 0,
    "autoExtendType": "None",
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2019-04-26"
  }
}

 

Response Description

항목 항목명 Type Description
goodsNo 마스터상품번호 int 적용된 마스터 상품번호

 JSON_Success

{
  "goodsNo": 0
}

JSON_Fail

{
   "resultCode": 0,
   "message": "string"
}

Sample Code_Success

{
  "goodsNo": 1158387297
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"에러메시지."
}

 

'상품API > 고객혜택 | 광고 API' 카테고리의 다른 글

판매자할인 관리 API  (0) 2022.11.03
판매자지급 스마일캐시 API  (0) 2022.11.03
후원/나눔쇼핑 API  (0) 2022.09.27
옥션 복수 할인 API  (0) 2022.09.27
지마켓 복수구매할인 API  (0) 2022.09.27