Uzyskiwanie promocji według identyfikatora
Dotyczy
- Centrum partnerskie
Odpowiednie role
- Agent administracyjny
Uwaga
Nowe doświadczenia handlowe dla usług licencjonowanych obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych doświadczeń handlowych.
Partnerzy mogą uzyskać pojedynczą promocję dla danego identyfikatora promocji i kraju/regionu. Ta metoda zwraca dane promocji, pomijając daty rozpoczęcia i zakończenia promocji. Ta metoda jest używana głównie do celów uzgodnień w celu pobrania szczegółów promocji nawet po wygaśnięciu promocji.
Wymagania wstępne
Poświadczenia zgodnie z opisem w uwierzytelnianiu w Centrum Partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i poświadczeń aplikacja+użytkownik.
Identyfikator promocji to zestaw ograniczonych ciągów, które reprezentują określoną promocję.
Kraj oznacza kraj/region, w którym dostępne są promocje dla klientów. Kraj jest reprezentowany przez dwuznaczny kod kraju.
Żądanie REST
Składnia żądania
Metoda | Żądanie URI |
---|---|
GET | {baseURL}/v1/productpromotions/{promotion-id}?country={country-code} HTTP/1.1 |
Parametr identyfikatora URI
Użyj następujących parametrów zapytania, aby zwrócić dostępne promocje.
Nazwisko | Typ | Wymagane | opis |
---|---|---|---|
identyfikator promocji | string | Y | Ciąg definiujący promocję do pobrania. |
kraj | string | Y | Dwuliterowy kod kraju określający, dla których są dostępne promocje kraju/regionu klienta. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum Partnerskiego.
Treść żądania
Brak
Ograniczenia promocyjne
Ograniczenia promocyjne są teraz zwracane przez ten interfejs API. Zobacz przykłady w odpowiedzi poniżej. Jeśli promocja ma ograniczenia kwalifikacyjne, szczegóły są zwracane w odpowiedzi. Te dane mogą służyć do zrozumienia, czy klient kwalifikuje się do rabatu.
Kategoria ograniczeń | Wartość ograniczenia | Typ ograniczenia | opis |
---|---|---|---|
Ograniczenia miejsca | MinSeats | Ilość Subskrypcji | Minimalna liczba miejsc potrzebnych klientowi do skorzystania z promocji. |
Ograniczenia siedziska | MaksSiedzenia | Liczba subskrypcji | Maksymalna liczba miejsc, do których można zastosować promo. |
AssetOwnershipLimits | Minimalna liczba zasobów | LiczbaWykupówWCałymŻyciu | Minimalna liczba przypadków, w których można zastosować promo dla klienta, zazwyczaj 0. |
AssetOwnershipLimits | MaxAssets | CałkowitaLiczbaWykupień | Maksymalna liczba przypadków, w których można zastosować promo dla klienta. |
Ograniczenia uprawnień | jestZastosowalne | Pierwsze zakup | Flaga wskazująca, czy musi to być pierwszy zakup jednostki SKU produktu, aby otrzymać promo. |
Ograniczenia własności produktu | bigId | Nie dotyczy | Określone oferty, które klient musi już posiadać, aby kwalifikować się do promocji (SKU - jednostka magazynowa produktu). |
Przykład żądania
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
Odpowiedź REST
Jeśli metoda się powiedzie, zwraca jedną promocję.
Kody sukcesu i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
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"
}
]
]
}
}