Promosyonları alma

Makale
07/02/2024

Şunun için geçerlidir:

İş Ortağı Merkezi

Uygun roller

Genel yöneticisi
Yönetici aracısı

Not

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 pazar (ülke/bölge) ve segment için etkin yeni ticaret promosyonlarının listesini alabilir. Bu yöntem, kullanılabilir başlangıç ve bitiş tarihlerine göre kullanılabilir geçerli promosyonları döndürü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.
Segment, promosyonların etkinleştirildiği müşteri türünü temsil eder. Şu anda yalnızca ticari desteği vardır.
Ülke, müşteri ülke/bölge promosyonlarının kullanılabilmesini temsil eder. Ülke, iki karakterli bir ülke koduyla temsil edilir.

REST isteği

[GET] /v1/productpromotions?country={country-code}&segment={segment}

İstek söz dizimi

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

URI parametresi

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

Adı	Tür	Zorunlu	Açıklama
parça	string	Y	Belirli bir kesim için hangi yükseltmelerin kullanılabilir olduğunu belirleyen 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

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/productpromotions?country=US&segment=commercial 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 bir yükseltme listesi 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, 26 Feb 2021 20:42:26 GMT


{
    "totalCount": 2,
    "items": [
        {
            "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"
                        }
                    ]
                }
            ]
        },
        {
            "id": "39NFJQT1PJQC:0001:39NFJQT1Q5KM",
            "name": "Vision Plan 1",
            "description": "Vision 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": "Monthly"
                    },
                    "pricingPolicies": [
                        {
                            "policyType": "PercentDiscount",
                            "value": "0.167"
                        }
                    ]
                }
            ]
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Aracılığıyla paylaş