5.4 리스팅부가서비스 API – ESM Trading API

5.4 리스팅부가서비스 API

등록/수정 : [PUT] https://sa.esmplus.com/item/v1/advertising/listing

Description
검색 리스트군 상단에 위치시키는 광고 설정 API입니다
프리미엄/프리미엄플러스/포커스/포커스플러스 상품을 이용할 수 있습니다
Request Description
G마켓 / 옥션 상품 동시 관리 시, G마켓 ID & 옥션 ID 토큰으로 사용합니다
G마켓 상품만 관리 시, G마켓 ID의 토큰으로 사용합니다
옥션 상품만 관리 시, 옥션 ID의 토큰으로 사용합니다
항목항목명필수여부TypeDescription
goodsNo마스터상품번호Yint마스터 상품번호
iacPremium > isUse옥션프리미엄사용여부Ybooleantrue: 사용, false : 미사용
iacPremium > applyPeriod사용일intAPI호출 기준으로
1,3,5,7,14,15,28,30,56,60,90 입력
iacPremium > autoExtendType자동연장설정int1:자동연장미사용,
2:무제한연장,
3:제한기간연장
iacPremium > autoExtendAmountDay자동연장사용일int1,3,5,7,14,15,28,30,56,60,90 입력
iacPremium > autoExtendEndDate제한기간일자dateAutoExtendType=3 제한기간 연장일 경우, 연장종료기간날짜
iacPremiumPlus > isUse옥션프리미엄플러스사용여부Ybooleantrue: 사용, false : 미사용
iacPremiumPlus > applyPeriod사용일intAPI호출 기준으로
1,3,5,7,14,15,28,30,56,60,90 입력
iacPremiumPlus > autoExtendType자동연장설정int1:자동연장미사용,
2:무제한연장,
3:제한기간연장
iacPremiumPlus > autoExtendAmountDay자동연장사용일int1,3,5,7,14,15,28,30,56,60,90 입력
iacPremiumPlus > autoExtendEndDate제한기간일자dateAutoExtendType=3 제한기간 연장일 경우,
연장종료기간날짜
gmktFocusPlus > isUseG마켓포커스플러스사용여부Ybooleantrue: 사용, false : 미사용
gmktFocusPlus > applyPeriod사용일intAPI호출 기준으로
1,3,5,7,14,28,30,56,60,90 입력
gmktFocusPlus > autoExtendType자동연장설정int1:자동연장미사용,
2:무제한연장,
3:제한기간연장
gmktFocusPlus > autoExtendAmountDay자동연장사용일int1,3,5,7,14,28,30,56,60,90 입력
gmktFocusPlus > autoExtendEndDate제한기간일자dateAutoExtendType=3 제한기간 연장일 경우,
연장종료기간날짜
JSON_등록/수정Sample Code_등록/수정
{
  "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"
  }
}

{
  "goodsNo": 1152031807,
  "iacPremium": {
    "isUse": true,
    "applyPeriod": 5,
    "autoExtendType": 1,
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2018-09-30"
  },
  "iacPremiumPlus": {
    "isUse": false,
    "applyPeriod": 1,
    "autoExtendType": 1,
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2018-09-30"
  },
  "gmktFocus": {
    "isUse": false,
    "applyPeriod": 1,
    "autoExtendType": 1,
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2018-09-30"
  },
  "gmktFocusPlus": {
    "isUse": false,
    "applyPeriod": 3,
    "autoExtendType": 1,
    "autoExtendAmountDay": 0,
    "autoExtendEndDate": "2018-09-30"
  }
}

Response Description
항목항목명TypeDescription
goodsNo마스터상품번호int적용된 마스터 상품번호
JSON_Success_등록/수정JSON_FailSample Code_Success_등록/수정Sample Code_Fail
{
  "goodsNo": 0
}

{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}

{
  "goodsNo": 1158387297
}

{
  "ResultCode":1000,
  "Message":"에러메시지.",
  "Data":null
}
Error Code
결과코드메시지원인