KIMLIĞE göre yükseltme al

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi

  • İş Ortağı Merkezi

Uygun roller

  • Genel yönetici
  • Yönetim Aracısı

Not

yeni ticaret değişiklikleri şu anda yalnızca Microsoft 365 ve Dynamics 365 yeni ticaret deneyimi technical preview sürümü olan iş ortakları tarafından kullanılabilir.

İş ortakları, belirli bir promosyon KIMLIĞI ve ülkesi için tek bir promosyon alabilir. Bu yöntem, promosyon başlangıç ve bitiş tarihlerini yoksayarak yükseltme verilerini döndürür. Bu yöntem, öncelikle yükseltme süresi dolduktan sonra bile yükseltme ayrıntılarını almak için mutabakat amaçlarıyla kullanılır.

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçı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 promosyonu temsil eden sınırlı dizeler kümesidir.

  • Ülke, için sunulan müşteri ülkesi promosyonları temsil eder. Ülke iki karakterli bir ülke koduyla temsil edilir.

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/v1/productpromotions/{Promotion-ID}? ülke = {Country-Code http/1.1

URI parametresi

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

Ad Tür Gerekli Açıklama
Promosyon kimliği string Y Alınacak promosyonu tanımlayan bir dize.
ülke string Y Hangi müşteri ülke promosyonları için kullanılabilir olduğunu belirleyen iki harfli ülke kodu.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Yok

İ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ı veya başarısızlık ve daha fazla hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek 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 Sep 2021 20:42:26 GMT

 
        {
            "id": "39NFJQT1PJQB:0001:39NFJQT1Q5KN",
            "name": "Visio Plan 1",
            "description": "Visio Plan 1",
            "startDate": "2021-09-23T00:00:00+00:00",
            "endDate": "2021-10-14T23:59:59+00:00",
            "properties": {
                "isAutoApplicable": true
            },
            "requiredProducts": [
                {
                    "productId": "CFQ7TTC0HD33",
                    "skuId": "0003",
                    "term": {
                        "duration": "P1Y",
                        "billingCycle": "Annual"
                    },
                    "pricingPolicies": [
                        {
                            "policyType": "PercentDiscount",
                            "value": "0.05"
                        }
                    ]
                }
            ]
        }