Dapatkan promosi berdasarkan ID

Artikel
07/02/2024

Berlaku untuk

Pusat Mitra

Peran yang sesuai

Admin global
Agen admin

Catatan

Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru.

Mitra bisa mendapatkan satu promosi untuk ID promosi dan negara/wilayah tertentu. Metode ini mengembalikan data promosi, mengabaikan tanggal mulai dan berakhir promosi. Metode ini digunakan terutama untuk tujuan rekonsiliasi untuk mengambil detail promosi bahkan setelah promosi kedaluwarsa.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
ID Promosi adalah sekumpulan string yang dibatasi yang mewakili promosi tertentu.
Negara mewakili promosi negara/wilayah pelanggan tersedia untuk. Negara diwakili oleh kode negara dua karakter.

Permintaan REST

Minta sintaks

Metode	URI Permintaan
DAPATKAN	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk mengembalikan promosi yang tersedia.

Nama	Tipe	Wajib	Deskripsi
id promosi	tali	Y	String yang menentukan promosi yang akan diambil.
country	tali	Y	Kode negara dua huruf yang menentukan promosi negara/wilayah pelanggan mana yang tersedia.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak

Batasan promosi

Batasan Promosi sekarang dikembalikan oleh API ini. Lihat contoh dalam respons di bawah ini. Jika promosi memiliki batasan kelayakan, detail dikembalikan dalam respons. Data ini dapat digunakan untuk memahami apakah pelanggan Anda memenuhi syarat untuk diskon.

Kategori batasan	Nilai batasan	Jenis batasan	Deskripsi
SeatConstraints	MinSeats	SubscriptionQuantity	Minimum seat yang dibutuhkan pelanggan untuk memenuhi syarat untuk mendapatkan promo tersebut.
SeatConstraints	MaxSeats	SubscriptionQuantity	Kursi maksimum tempat promo dapat diterapkan.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Jumlah minimum promo dapat diterapkan untuk pelanggan, biasanya 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Berapa kali promo dapat diterapkan untuk pelanggan.
EligibilityConstraints	isApplicable	FirstPurchase	Bendera yang menunjukkan apakah ini harus menjadi pembelian pertama pelanggan dari SKU produk untuk menerima promo.
ProductOwnershipConstraints	bigId	T/A	Penawaran yang ditentukan pelanggan harus sudah memiliki untuk memenuhi syarat untuk promo (SKU Produk).

Contoh permintaan

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

Respons REST

Jika berhasil, metode ini mengembalikan satu promosi.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode Kesalahan.

Contoh tanggapan

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

Bagikan melalui