Kimliğine göre promosyon alma

Makale
12/29/2023

Şunun için geçerlidir:

İş Ortağı Merkezi

Uygun roller

Genel yöneticisi
Yönetici aracısı

Dekont

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

İş ortakları belirli bir promosyon kimliği ve ülke/bölge için tek bir promosyon alabilir. Bu yöntem, yükseltme başlangıç ve bitiş tarihlerini yoksayarak yükseltme verilerini döndürür. Bu yöntem öncelikli olarak yükseltme süresi dolduktan sonra bile yükseltme ayrıntılarını almak için mutabakat amacıyla kullanılır.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Yükseltme Kimliği, belirli bir yükseltmeyi temsil eden sınırlandırılmış dize kümesidir.
Ülke, müşteri ülke/bölge promosyonlarının kullanılabilmesini temsil eder. Ülke, iki karakterli bir ülke koduyla temsil edilir.

REST isteği

İstek söz dizimi

Metot	İstek URI'si
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

URI parametresi

Kullanılabilir yükseltmeleri döndürmek için aşağıdaki sorgu parametrelerini kullanın.

Veri Akışı Adı	Tür	Zorunlu	Açıklama
promotion-id	string	Y	Alınacak yükseltmeyi tanımlayan bir dize.
Ülke	string	Y	Hangi müşteri ülke/bölge promosyonlarının kullanılabilir olduğunu belirleyen iki harfli ülke kodu.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

Hiçbiri

Promosyon kısıtlamaları

Tanıtım Kısıtlamaları artık bu API tarafından döndürülür. Aşağıdaki yanıttaki örneklere bakın. Yükseltmenin uygunluk kısıtlamaları varsa, yanıtta ayrıntılar döndürülür. Bu veriler, müşterinizin indirime uygun olup olmadığını anlamak için kullanılabilir.

Kısıtlama kategorisi	Kısıtlama değeri	Kısıtlama türü	Açıklama
SeatConstraints	MinSeats	SubscriptionQuantity	Müşterinin promosyona uygun olması için gereken minimum koltuklar.
SeatConstraints	MaxSeats	SubscriptionQuantity	Promosyona uygulanabilecek maksimum koltuk sayısı.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Promosyonun bir müşteri için en az kaç kez uygulanabileceği (genellikle 0).
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Promosyonun müşteri için en fazla kaç kez uygulanabileceği.
EligibilityConstraints	isApplicable	FirstPurchase	Promosyonu almak için müşterinin ürün SKU'sunu ilk satın alması gerekip gerekmediğini gösteren bayrak.
ProductOwnershipConstraints	bigId	Yok	Belirtilen teklifler, müşterinin promosyona (Ürün SKU'su) uygun olması için zaten sahip olması gerekir.

İstek örneği

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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

REST yanıtı

Başarılı olursa, bu yöntem tek bir yükseltme döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve daha fazla hata ayıklama bilgisi ile birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
                }
            ]
        ]
    }
}

Aracılığıyla paylaş