Promoties verkrijgen

Artikel
03/07/2025

Van toepassing op

Partnercentrum

Juiste rollen

Beheeragent

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Voor meer informatie, bekijk het overzicht van nieuwe commerce-ervaringen.

Partners kunnen een lijst krijgen met actieve nieuwe handelspromoties voor een bepaalde markt (land/regio) en segment. Deze methode retourneert beschikbare huidige promoties op basis van de beschikbare begin- en einddatums van promoties.

Vereisten

Inloggegevens zoals beschreven in Partner Center authentication. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Segment vertegenwoordigt het type klant waarvoor de promoties zijn ingeschakeld. Momenteel worden alleen commerciële toepassingen ondersteund.
Het land vertegenwoordigt het land of de regio waar promoties voor klanten beschikbaar zijn. Land wordt vertegenwoordigd door een landcode van twee tekens.

REST-aanvraag

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

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/productpromotions?country={country-code}&segment={segment} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameters om beschikbare promoties te retourneren.

Name	Type	Vereist	Beschrijving
segment	string	J	Een tekenreeks die bepaalt welke promoties beschikbaar zijn voor een bepaald segment.
land	string	Y	Een landcode van twee letters die bepaalt voor welke klantland-/regiopromoties beschikbaar zijn.

Aanvraagheaders

Voor meer informatie, zie REST-kopteksten in het Partnercentrum.

Inhoud van het verzoek

Geen

Aanvraagvoorbeeld

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-antwoord

Als dit lukt, retourneert deze methode een lijst met promoties.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het een succes of mislukking is, en extra foutopsporingsinformatie biedt. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

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

Delen via