Získání povýšení podle ID

Článek
09/27/2024

Platí pro

Partnerské centrum

Odpovídající role

Agent pro správu

Poznámka:

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v přehledu nových obchodních prostředí.

Partneři můžou získat jednu propagační akci pro dané ID povýšení a zemi/oblast. Tato metoda vrátí data povýšení a ignoruje počáteční a koncové datum povýšení. Tato metoda se používá především pro účely odsouhlasení k načtení podrobností o povýšení i po vypršení platnosti povýšení.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID povýšení je sada řetězců, které představují konkrétní povýšení.
Země představuje propagační akce pro zemi nebo oblast zákazníka. Země je reprezentována kódem země se dvěma znaky.

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

Parametr identifikátoru URI

K vrácení dostupných propagačních akcí použijte následující parametry dotazu.

Name	Type	Požadováno	Popis
id povýšení	string	Y	Řetězec definující povýšení, který se má načíst.
země	string	Y	Kód země se dvěma písmeny určující, pro kterou zemi nebo oblast jsou propagační akce zákazníka k dispozici.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nic

Propagační omezení

Toto rozhraní API teď vrací propagační omezení. Podívejte se na příklady v odpovědi níže. Pokud má propagační akce omezení způsobilosti, v odpovědi se vrátí podrobnosti. Tato data se dají použít k pochopení, jestli zákazník splňuje nárok na slevu.

Kategorie omezení	Hodnota omezení	Typ omezení	Popis
Omezení sedadla	MinSeats	SubscriptionQuantity	Minimální počet licencí potřebných k tomu, aby zákazník získal nárok na propagační akci.
Omezení sedadla	MaxSeats	SubscriptionQuantity	Maximální počet míst, na které se propagační akce vztahuje.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Minimální počet, kolikrát se dá propagační akce uplatnit u zákazníka, obvykle 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Maximální počet, kolikrát může být propagační akce uplatněna pro zákazníka.
Omezení způsobilosti	isApplicable	FirstPurchase	Příznak označující, jestli se jedná o první nákup skladové položky produktu zákazníka, aby bylo možné tuto propagační akci získat.
Omezení vlastníka produktu	bigId	–	Zadané nabídky, které zákazník už musí vlastnit, aby měl nárok na propagační akci (skladová položka produktu).

Příklad požadavku

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

Odpověď REST

Pokud je tato metoda úspěšná, vrátí jednu povýšení.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím