Ottieni promozione per ID

Articolo
12/29/2023

Si applica a

Centro per i partner

Ruoli appropriati

Amministratore globale
Agente amministratore

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

I partner possono ottenere una singola promozione per un ID promozione e un paese/area geografica specificati. Questo metodo restituisce i dati relativi alle promozioni, ignorando le date di inizio e fine della promozione. Questo metodo viene usato principalmente per scopi di riconciliazione per recuperare i dettagli della promozione anche dopo la scadenza della promozione.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
L'ID promozione è delimitato da un set di stringhe che rappresentano una promozione specifica.
Paese rappresenta le promozioni paese/area geografica del cliente disponibili per. Il paese è rappresentato da un codice paese a due caratteri.

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

Parametro URI

Usare i parametri di query seguenti per restituire promozioni disponibili.

Nome	Digita	Obbligatorio	Descrizione
promotion-id	string	Y	Stringa che definisce la promozione da recuperare.
country	string	Y	Codice paese di due lettere che determina per quale paese/area geografica del cliente sono disponibili promozioni.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

None

Vincoli promozionali

I vincoli promozionali vengono ora restituiti da questa API. Vedere esempi nella risposta seguente. Se una promozione ha vincoli di idoneità, i dettagli vengono restituiti nella risposta. Questi dati possono essere usati per capire se il cliente è qualificato per lo sconto.

Categoria vincolo	Valore vincolo	Tipo di vincolo	Descrizione
SeatConstraints	MinSeats	SubscriptionQuantity	Posti minimi necessari per il cliente per essere idonei per la promozione.
SeatConstraints	MaxSeats	SubscriptionQuantity	Numero massimo di posti a cui può essere applicata la promozione.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Il numero minimo di volte in cui la promozione può essere applicata per un cliente, in genere 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Numero massimo di volte in cui la promozione può essere applicata al cliente.
IdoneitàConstraints	isApplicable	FirstPurchase	Flag che indica se deve essere il primo acquisto dello SKU del prodotto da parte del cliente per ricevere la promozione.
ProductOwnershipConstraints	bigId	N/D	Le offerte specificate devono essere già di proprietà del cliente per essere idonee per la promozione (SKU prodotto).

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una singola promozione.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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

Condividi tramite