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.
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.
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1 |
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. |
További információ: Partnerközpont – REST fejlécek.
Egyik sem
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). |
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
Ha sikeres, ez a módszer egyetlen előléptetést ad vissza.
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.
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"
}
]
]
}
}