보너스 프로모션 업데이트

project_id required	integer 프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다. Example: 44056
promotion_id required	integer 프로모션 ID입니다. 프로젝트 내부의 고유 프로모션 식별자입니다. Example: 111425

Request Body schema: application/json

required

Array of objects or null

프로모션을 적용하기 위해 구매 항목에 포함되어야 하는 아이템 세트입니다. 이 매개 변수가 null이면 프로젝트 내의 모든 구매 항목에 프로모션이 적용됩니다.

Array

sku	string Default: "elven_sword" 아이템 SKU입니다.

required

Array of objects or null

Array

quantity	number Default: 1 아이템 수량입니다.
sku	string Default: "elven_shield" 아이템 SKU입니다.

required

object

프로모션의 이름입니다. 키가 "^[a-z]{2}-[A-Z]{2}$" 형식의 로케일인 키/값 쌍을 포함해야 하며 값은 문자열입니다.

property name*

additional property

string

Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

사용자 특성 검증 조건. 사용자 특성이 지정된 모든 조건과 일치하는지 여부에 따라 프로모션의 가용성을 결정합니다.

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

사용자 특성 코드입니다.

operator

required

string

조건에 따라 수행하는 작업 유형입니다. string 특성 유형에 해당합니다.

Enum:	Description
eq	같음
ne	같지 않음

value

required

string <= 255 characters

사용자 특성 값을 비교할 조건 값입니다. 유형은 특성 유형에 따라 다릅니다.

type

required

string

사용자 특성 유형입니다.

Value: "string"

can_be_missing

boolean

사용자 특성에서 특성이 누락된 경우에도 조건이 충족됨을 나타냅니다. 이 특성이 없는 사용자에게 항목을 표시하려면 true를 전달하십시오. 특성이 있지만 값이 조건에 지정된 값과 일치하지 않는 사용자는 항목을 볼 수 없습니다. false - 특성이 있지만 값이 조건에 지정된 값과 일치하지 않거나 특성이 누락된 사용자는 항목을 볼 수 없습니다.

excluded_promotions

Array of integers

이 프로모션을 적용할 때 제외할 프로모션 ID 목록입니다.
Example: [12, 789]

integer

프로모션 ID입니다. 프로젝트 내부의 고유 프로모션 식별자입니다.

is_enabled

boolean

프로모션 활성화 여부.

object

프로모션 제한입니다.

per_user

integer or null

개별 사용자에 대한 프로모션 제한입니다.

object or null

새로고침 기간을 제한합니다.

object

사용자 제한 새로고침 기간입니다.

day_of_month	integer or null [ 1 .. 31 ] 제한 설정을 새로고침하는 날짜입니다. 해당 월의 일수가 짧아 선택한 날짜가 없으면 해당 월의 마지막 날에 새로고침합니다. `monthly` 제한 설정 새로고침 기간 유형만 `null`이 아닙니다.
day_of_week	integer or null [ 1 .. 7 ] 제한을 새로고침하는 요일입니다. 여기서 1은 월요일이고 7은 일요일입니다. `weekly` 제한 설정 새로고침 기간 유형만 `null`이 아닙니다.
displayable_reset_next_date	string <date-time> 제한 설정을 재설정해야 하는 날짜 및 시간입니다(ISO 8601).
displayable_reset_start_date	string <date-time> 첫 번째 제한 설정을 새로고침하는 날짜 및 시간입니다(ISO 8601).
interval_type	string 반복 새로고침 기간 유형입니다. Enum: "daily" "weekly" "monthly"
reset_next_date	integer 새로고침 제한 설정이 적용되는 날짜 및 시간입니다(Unix 타임스탬프)
time	string <full-time> 원하는 시간대의 제한 시간 새로고침 시간입니다(시간 단위로 반올림).

Array of objects or null

프로모션을 적용하기 위한 가격 범위를 설정하는 조건을 가진 개체 배열입니다.
프로모션은 가격이 배열의 모든 조건을 충족하는 아이템에만 적용됩니다. 이 배열을 전달하는 경우 조건 개체의 값이 null로 설정됩니다.

Array

operator

required

string

프로모션을 적용하기 위한 가격 범위를 설정하기 위한 비교 연산자입니다.

Enum:	Description
eq	같음
ge	크거나 같음
gt	보다 큼
le	작거나 같음
lt	미만
ne	같지 않음

value

required

string^\d+(\.\d{1,4})?$

프로모션을 적용하기 위한 가격 범위를 결정하기 위한 값입니다.

Array of objects

프로모션의 유효 기간. 기간이 여러 개 지정된 경우 date_from와 date_until가 모두 필요합니다.

Array

date_from required	string <date-time> 지정된 프로모션의 시작 날짜.
date_until	string or null <date-time> 지정된 프로모션의 종료 날짜. `null`로 설정된 경우 프로모션은 무기한입니다. 단일 유효 기간이 지정된 경우에만 `null`로 설정할 수 있습니다.

Responses

204

프로모션을 성공적으로 업데이트했습니다.

401

기본 인증이 전달되지 않았거나 잘못되었습니다. 기본 인증 또는 올바른 자격 증명을 사용했는지 확인해야 합니다.

422

잘못된 요청입니다.

Request samples

application/json

{"attribute_conditions": [{"attribute": "account_status",
"can_be_missing": false,
"operator": "eq",
"type": "string",
"value": "golden"
}
],
"bonus": [{"quantity": 50000,
"sku": "com.xsolla.mp_credits"
}
],
"condition": [{"sku": "com.xsolla.year_1_season_pass"
}
],
"name": {"de-DE": "Neujahrsbonus",
"en-US": "New Year Bonus"
},
"promotion_periods": [{"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}