Ottieni promozione per ID

Si applica a

  • Centro per i partner

Ruoli appropriati

  • 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: aaaa0000-bb11-2222-33cc-444444dddddd
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: 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"
                }
            ]
        ]
    }
}