Olvasás angol nyelven

Megosztás a következőn keresztül:


Előléptetés lekérése azonosító alapján

A következőkre vonatkozik:

  • Partnerközpont

Megfelelő szerepkörök

  • Rendszergazdai ügynök

Megjegyzés

A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.

A partnerek egyetlen promóciót kaphatnak egy adott előléptetési azonosítóhoz és országhoz/régióhoz. Ez a metódus az előléptetési adatokat adja vissza, figyelmen kívül hagyva az előléptetés kezdő és záró dátumát. Ezt a módszert elsősorban egyeztetési célokra használják az előléptetés részleteinek lekérésére még az előléptetés lejárta után is.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

  • Az előléptetési azonosító egy adott előléptetést jelképező sztringek elválasztott készlete.

  • Az ország azt az ügyfélországot/régiót jelöli, amelyhez promóciók érhetők el. Az országot két karakteres országkód jelöli.

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

URI-paraméter

Az elérhető promóciók visszaadásához használja az alábbi lekérdezési paramétereket.

Név Típus Kötelező Leírás
előléptetés azonosítója húr I A lekérendő előléptetést meghatározó sztring.
ország húr I Kétbetűs országkód, amely meghatározza, hogy melyik ügyfélország/régió promóciói érhetők el.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Egyik sem

Promóciós korlátozások

Az API mostantól promóciós korlátozásokat ad vissza. Példákat az alábbi válaszban talál. Ha egy promóció jogosultsági korlátozásokkal rendelkezik, a részletek a válaszban jelennek meg. Ezek az adatok felhasználhatók annak megértésére, hogy az ügyfél jogosult-e a kedvezményre.

Kényszerkategória Kényszerérték Kényszer típusa Leírás
SeatConstraints MinSeats SubscriptionQuantity Az ügyfélnek a promócióra való jogosultsághoz szükséges minimális helyek.
SeatConstraints MaxSeats SubscriptionQuantity A promócióban szereplő helyek maximális száma alkalmazható.
AssetOwnershipLimits MinAssets LifetimeRedemptionCount A promóció minimális hányszor alkalmazható egy ügyfélre, általában 0- ra.
AssetOwnershipLimits MaxAssets LifetimeRedemptionCount A promóció maximális hányszor alkalmazható az ügyfélre.
EligibilityConstraints isApplicable FirstPurchase Jelző, amely jelzi, hogy az ügyfél első vásárlásának kell-e lennie a termék termékváltozatának a promóció fogadásához.
ProductOwnershipConstraints bigId n/a A megadott ajánlatoknak az ügyfélnek már rendelkeznie kell a promócióra való jogosultsághoz (termékváltozat).

Példa kérése

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-válasz

Ha sikeres, ez a módszer egyetlen előléptetést ad vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikerességet vagy a hibát, valamint további hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Példa válaszra

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"
                }
            ]
        ]
    }
}