Obtenir la promotion par ID

Article
09/27/2024

S’applique à

Espace partenaires

Rôles appropriés

Agent administrateur

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Les partenaires peuvent obtenir une promotion unique pour un ID de promotion et un pays/région donnés. Cette méthode retourne les données de promotion, en ignorant les dates de début et de fin de la promotion. Cette méthode est principalement utilisée à des fins de rapprochement pour récupérer les détails de la promotion même après l’expiration de la promotion.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.
L’ID de promotion est un ensemble délimité de chaînes qui représentent une promotion spécifique.
Le pays représente les promotions pays/région du client disponibles. Le pays est représenté par un code de pays à deux caractères.

Demande REST

Syntaxe de la requête

Method	URI de demande
GET	{baseURL}/v1/productpromotions/{promotion-id} ?country={country-code HTTP/1.1

Paramètre d’URI

Utilisez les paramètres de requête suivants pour retourner les promotions disponibles.

Nom	Type	Requise	Description
promotion-id	string	Y	Chaîne définissant la promotion à récupérer.
country	string	Y	Code de pays à deux lettres déterminant les promotions pays/région du client disponibles.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Aucune

Contraintes promotionnelles

Les contraintes promotionnelles sont désormais retournées par cette API. Consultez les exemples de la réponse ci-dessous. Si une promotion a des contraintes d’éligibilité, les détails sont retournés dans la réponse. Ces données peuvent être utilisées pour comprendre si votre client se qualifie pour la remise.

Catégorie de contrainte	Valeur de contrainte	Type de contrainte	Description
SeatConstraints	MinSeats	SubscriptionQuantity	Nombre minimal de sièges nécessaires pour que le client soit éligible à la promotion.
SeatConstraints	MaxSeats	SubscriptionQuantity	Le nombre maximal de sièges auquel la promotion peut être appliquée.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Le nombre minimal de fois où la promotion peut être appliquée à un client, généralement 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Nombre maximal de fois où la promotion peut être appliquée pour le client.
EligibilityConstraints	isApplicable	FirstPurchase	Indicateur indiquant s’il doit s’agir du premier achat de la référence SKU du produit pour recevoir la promotion.
ProductOwnershipConstraints	bigId	S/O	Les offres spécifiées que le client doit déjà posséder pour être éligible à la promotion (référence SKU produit).

Exemple de requête

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

Réponse REST

Si elle réussit, cette méthode retourne une promotion unique.

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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

Partager via