영어로 읽기

다음을 통해 공유

ID로 승격 가져오기

  • 아티클

적용 대상

  • 파트너 센터

적절한 역할

  • 관리 에이전트

참고

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

파트너는 지정된 프로모션 ID 및 국가/지역에 대해 단일 프로모션을 받을 수 있습니다. 이 메서드는 승격 시작 날짜와 종료 날짜를 무시하고 승격 데이터를 반환합니다. 이 메서드는 주로 승격이 만료된 후에도 승격 세부 정보를 검색하기 위해 조정 목적으로 사용됩니다.

필수 조건

  • 자격 증명은 파트너 센터 인증에서 설명됩니다. 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.

  • 승격 ID는 특정 승격을 나타내는 문자열 집합으로 구분됩니다.

  • 국가는 고객 국가/지역 프로모션을 사용할 수 있음을 나타냅니다. 국가는 두 개의 문자 국가 코드로 표시됩니다.

REST 요청

요청 구문

메서드 요청 URI
GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code} HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 사용 가능한 승격을 반환합니다.

이름 유형 필수 설명
promotion-id string Y 검색할 프로모션을 정의하는 문자열입니다.
나라 string Y 사용할 수 있는 고객 국가/지역 프로모션을 결정하는 두 글자 국가 코드입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

None

홍보 제약 조건

이제 이 API에서 프로모션 제약 조건이 반환됩니다. 아래 응답의 예제를 참조하세요. 승격에 자격 제약 조건이 있는 경우 세부 정보가 응답에 반환됩니다. 이 데이터를 사용하여 고객이 할인을 받을 자격이 있는지 파악할 수 있습니다.

제약 조건 범주 제약 조건 값 제약 조건 유형 설명
좌석 제약 조건 최소 좌석 구독 수량 고객이 프로모션을 받을 자격이 있는 최소 좌석 수입니다.
좌석 제약 조건 최대 좌석 구독 수량 프로모션을 적용할 수 있는 최대 좌석입니다.
자산 소유 한도 MinAssets 누적 교환 횟수 고객에게 프로모션을 적용할 수 있는 최소 횟수(일반적으로 0)입니다.
자산 소유 한도 MaxAssets 기간전체사용횟수 고객에게 프로모션을 적용할 수 있는 최대 횟수입니다.
적격성 제약 조건 적용 가능 여부 첫 구매 프로모션을 받으려면 고객이 제품 SKU를 처음 구매해야 하는지 여부를 나타내는 플래그입니다.
제품 소유 제약 조건 bigId 해당 없음 지정된 제품은 고객이 프로모션(제품 SKU)을 받을 수 있도록 이미 소유하고 있어야 합니다.

요청 예제

HTTP 
GET https://api.partnercenter.microsoft.com/v1/productpromotions/CFQ7TTC0HD33:0003:CFQ7TTC0K59M?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST 응답

성공하면 이 메서드는 단일 승격을 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 오류 코드를 참조하세요.

응답 예제

HTTP 
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 24 Apr 2023 20:42:26 GMT

 
{
    "id": "39NFJQT1SNC7:0001:39NFJQT1Q5KM",
    "name": "TEST Promotion May 2023 - Microsoft 365 F3",
    "description": "TEST Promotion May 2023 - Microsoft 365 F3",
    "startDate": "2023-05-03T00:00:00+00:00",
    "endDate": "9999-01-01T00:00:00+00:00",
    "properties": {
        "isAutoApplicable": true
    },
    "requiredProducts": [
        {
            "productId": "CFQ7TTC0LH05",
            "skuId": "0001",
            "term": {
                "duration": "P1Y",
                "billingCycle": "Annual"
            },
            "pricingPolicies": [
                {
                    "policyType": "PercentDiscount",
                    "value": "0.5"
                }
            ]
        }
    ],
    "promotionConstraints": { 
        "seatConstraints": [
            {
                "minSeats": 10,
                "maxSeats": 100,
                "type": "SubscriptionQuantity"
            }
        ],
        "assetOwnershipLimits": [
            {
                "minAssets": 0,
                "maxAssets": 3,
                "type": "LifetimeRedemptionCount"
            }
        ],
        "eligibilityConstraints": [
            {
                "isApplicable": true,
                "type": "FirstPurchase"
            }
        ],
        "productOwnershipConstraints": [
            [
                {
                    "bigId": "CFQ7TTC0MBMD/0002"
                }
            ]
        ]
    }
}