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

Článek
03/07/2025

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 propagace a zemi/oblast. Tato metoda vrátí propagační data a přitom ignoruje počáteční a koncová data propagace. Tato metoda se používá především pro účely odsouhlasení k získání podrobností o akci i po jejím vypršení platnosti.

Požadavky

Přihlašovací údaje, jak jsou popsány v ověřování Partnerského centra. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace a přihlašovacích údajů aplikace s uživatelem.
ID propagace je oddělená sada řetězců, které představují konkrétní akci.
Země představuje zemi nebo oblast, ve které jsou k dispozici propagační akce pro zákazníka. Země je reprezentována kódem země se dvěma znaky.

Požadavek REST

Syntaxe požadavku

metoda	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	Typ	Požadováno	Popis
id akce	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 viz Hlavičky REST Partnerské centrum.

Tělo žádosti

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, podrobnosti se vrátí v odpovědi. 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	Minimální počet míst	MnožstvíPředplatného	Minimální počet míst potřebných k tomu, aby zákazník měl nárok na promoakci.
Omezení sedadla	Maximální sedadla	Počet předplatného	Maximální počet míst, na které se propagační akce vztahuje.
AssetOwnershipLimits	MinAssets	Počet uplatnění za životnost	Minimální počet, kolikrát se dá propagační akce uplatnit u zákazníka, obvykle 0.
Limity vlastnictví majetku	MaxAssets	Počet uplatnění za životnost	Maximální počet, kolikrát může být propagační akce uplatněna pro zákazníka.
Omezení způsobilosti	je použitelné	První nákup	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í vlastnictví produktu	bigId	Nevztahuje se	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 promoční akci.

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