Hämta befordran efter ID

Gäller för

• Partnercenter

Lämpliga roller

• global administratör
• Administratörsagent

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten över nya handelsupplevelser.

Partner kan få en enda kampanj för ett visst kampanj-ID och land/region. Den här metoden returnerar kampanjdata och ignorerar start- och slutdatum för befordran. Den här metoden används främst i avstämningssyfte för att hämta kampanjinformation även efter att kampanjen har upphört att gälla.

Förutsättningar

• Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.

• Kampanj-ID är avgränsad uppsättning strängar som representerar en specifik kampanj.

• Land representerar de kampanjer för kundens land/region som är tillgängliga för. Landet representeras av en landskod med två tecken.

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

URI-parameter

Använd följande frågeparametrar för att returnera tillgängliga kampanjer.

Namn	Typ	Obligatoriskt	Beskrivning
promotion-id	sträng	Y	En sträng som definierar befordran som ska hämtas.
land	sträng	Y	En landskod med två bokstäver som avgör vilka kampanjer för kundens land/region som är tillgängliga för.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen

Kampanjbegränsningar

Kampanjbegränsningar returneras nu av det här API:et. Se exempel i svaret nedan. Om en kampanj har berättigandebegränsningar returneras information i svaret. Dessa data kan användas för att förstå om kunden kvalificerar sig för rabatten.

Villkorskategori	Villkorsvärde	Villkorstyp	beskrivning
SeatConstraints	MinSeats	SubscriptionQuantity	Minsta antal platser som krävs för att kunden ska vara berättigad till kampanjen.
SeatConstraints	MaxSeats	SubscriptionQuantity	Maximalt antal platser som kampanjen kan tillämpas på.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Det minsta antalet gånger som kampanjen kan användas för en kund, vanligtvis 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Det maximala antalet gånger som kampanjen kan användas för kunden.
BerättigandeConstraints	isApplicable	FirstPurchase	Flagga som anger om detta måste vara kundens första köp av produktens SKU för att ta emot kampanjen.
ProductOwnershipConstraints	bigId	Ej tillämpligt	Angivna erbjudanden som kunden redan måste äga för att vara berättigad till kampanjen (Produkt-SKU).

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden en enda befordran.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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