Eventi
19 nov, 23 - 21 nov, 23
Scopri i vantaggi più recenti dei partner con i miglioramenti del prodotto per supportare la crescita delle pratiche di intelligenza artificiale in Microsoft Ignite online.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
Si applica a
Ruoli appropriati
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.
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.
metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1 |
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. |
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
None
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). |
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
In caso di esito positivo, questo metodo restituisce una singola promozione.
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.
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"
}
]
]
}
}
Eventi
19 nov, 23 - 21 nov, 23
Scopri i vantaggi più recenti dei partner con i miglioramenti del prodotto per supportare la crescita delle pratiche di intelligenza artificiale in Microsoft Ignite online.
Iscriviti subito