프로모션 리소스

적용 대상

• 파트너 센터

적절한 역할

• 글로벌 관리자
• 관리 에이전트

참고

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

새 상거래 구독의 트랜잭션에 적용되는 프로모션 리소스에 대해 설명합니다.

홍보 행사

자격 기준이 충족되는 경우 제품 SKU를 구매할 때 적용되는 할인입니다.

속성	형식	Description
id	문자열	승격 식별자입니다.
name	문자열	프로모션의 이름입니다.
description	문자열	프로모션에 대한 설명입니다.
startDate	문자열	프로모션을 적용할 수 있는 경우의 시작 날짜입니다.
endDate	문자열	프로모션을 적용할 수 있는 종료 날짜입니다.
requiredProducts	requiredProducts 목록	제품, SKU 세부 정보 및 가격 책정 정책은 프로모션에 적용됩니다.
properties	속성 목록입니다.	승격을 자동으로 적용할 수 있는지 여부를 포함하여 승격에 대한 속성입니다.

RequiredProducts

제품, SKU 세부 정보 및 가격 책정 정책은 프로모션에 적용됩니다.

속성	형식	Description
productId	문자열	프로모션을 사용할 수 있는 제품의 식별자입니다.
skuId	문자열	승격을 사용할 수 있는 SKU의 식별자입니다.
용어	용어	프로모션 기간 및 청구 주기 포함하는 용어를 사용할 수 있습니다.
pricingPolicies	가격 책정 목록정책	프로모션 할인 유형 및 값을 정의하는 정책 목록입니다.

용어

프로모션을 구매할 수 있는 용어를 나타냅니다.

속성	형식	Description
duration	문자열	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	문자열	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.

PricingPolicies

프로모션 할인 유형 및 값을 설명합니다.

속성	형식	Description
type	문자열	할인이 백분율 또는 정액 할인을 기반으로 하는지 여부를 설명합니다.
값	문자열	적용된 할인 금액을 정의합니다.

속성

승격에 대한 속성입니다.

속성	형식	Description
isAutoApplicable	bool	승격이 자동으로 적용되는지 또는 파트너가 전달해야 하는지 여부를 나타냅니다.

PromotionEligibilitiesRequestItem

트랜잭션 및 프로모션의 자격을 나타내는 속성입니다.

속성	형식	Description
id	int	프로모션 자격 항목 식별자입니다.
catalogItemId	문자열	승격이 적용될 카탈로그 항목 식별자입니다. 제품 ID, SKU ID 및 가용성 ID를 포함합니다.
quantity	int	라이선스 또는 인스턴스 수입니다.
termDuration	문자열	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	문자열	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.
promotionID	문자열	승격 식별자입니다.

PromotionEligibilities

제품, SKU 및 해당 프로모션 자격 목록입니다.

속성	형식	Description
id	int	프로모션 자격 항목 식별자입니다.
catalogItemId	문자열	승격이 적용될 카탈로그 항목 식별자입니다. 제품 ID, SKU ID 및 가용성 ID를 포함합니다.
quantity	int	라이선스 또는 인스턴스 수입니다.
termDuration	문자열	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	문자열	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.
자격	PromotionEligibilities 목록	승격 자격 결과 목록을 나타냅니다.

PromotionEligibility

제품, SKU 및 해당 프로모션 자격 목록입니다.

속성	형식	Description
promotionId	문자열	승격 식별자입니다.
isEligible	bool	프로모션이 지정된 자격 요청 항목에 적합한지 설명합니다.
오류	PromotionEligibilityErrors 목록	프로모션 자격 요청 항목이 적합하지 않은 이유를 설명하는 오류입니다.

PromotionEligibilityError

프로모션 자격 요청 항목이 자격이 없는 이유를 설명합니다.

속성	형식	Description
type	문자열	승격 자격 오류 유형에는 InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously 또는 Term이 포함될 수 있습니다.
description	문자열	프로모션이 지정된 자격 요청 항목에 적합한지 설명합니다.

RedemptionLimitPromotionEligibilityError

상환 한도를 초과한 이유에 대한 세부 정보를 포함합니다.

속성	형식	Description
maxPromotionRedemptionCount	int	승격을 획득할 수 있는 최대 횟수입니다.
remainingPromotionRedemptionCount	int	프로모션을 획득할 수 있는 남은 횟수입니다.

SeatCountPromotionEligibilityError

좌석 수 제한을 초과한 이유에 대한 세부 정보를 포함합니다. 모든 값은 null 허용입니다.

속성	형식	Description
minimumRequiredSeats	int	프로모션이 지원하는 최소 라이선스입니다.
maximumRequiredSeats	int	프로모션에서 지원할 최대 라이선스입니다.
availableSeats	int	파트너가 지정된 프로모션을 위해 획득할 수 있는 남은 라이선스 수입니다.

TermPromotionEligibilityError

프로모션 용어가 수락되지 않은 이유에 대한 세부 정보를 포함합니다.

속성	형식	Description
eligibleTerms	PromotionTerm	프로모션이 지원하는 적격 조건입니다.

PromotionTerm

좌석 수 제한을 초과한 이유에 대한 세부 정보를 포함합니다.

속성	형식	Description
billingCycle	문자열	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.
duration	문자열	구매되는 기간입니다.