Uzyskiwanie promocji według identyfikatora

Dotyczy

• Centrum partnerskie

Odpowiednie role

• Administrator globalny
• agent Administracja

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

Partnerzy mogą uzyskać pojedynczą promocję dla danego identyfikatora promocji i kraju/regionu. Ta metoda zwraca dane podwyższania poziomu, ignorują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 temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.

• Identyfikator promocji jest rozdzielany zestaw ciągów reprezentujących określoną promocję.

• Kraj reprezentuje promocje kraju/regionu klienta są dostępne. Kraj jest reprezentowany przez dwuznaczny kod kraju.

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
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	Type	Wymagania	opis
identyfikator podwyższania poziomu	string	Y	Ciąg definiujący podwyższanie poziomu do pobrania.
Kraju	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 podwyższenie poziomu ma ograniczenia uprawnień, 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	SubscriptionQuantity	Minimalna liczba miejsc potrzebnych klientowi do skorzystania z promocji.
Ograniczenia miejsca	MaxSeats	SubscriptionQuantity	Maksymalna liczba miejsc, do których można zastosować promo.
AssetOwnershipLimits	Minimalna liczba zasobów	LifetimeRedemptionCount	Minimalna liczba przypadków, w których można zastosować promo dla klienta, zazwyczaj 0.
AssetOwnershipLimits	Maksymalna liczba zasobów	LifetimeRedemptionCount	Maksymalna liczba przypadków, w których można zastosować promo dla klienta.
Ograniczenia uprawnień	isApplicable	Pierwsze zakup	Flaga wskazująca, czy musi to być pierwszy zakup jednostki SKU produktu, aby otrzymać promo.
Ograniczenia związane z właścicielem produktu	bigId	Nie dotyczy	Określone oferty klient musi już być właścicielem, aby kwalifikować się do promocji (jednostka SKU 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca pojedynczą podwyższanie poziomu.

Kody powodzenia 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: 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"
                }
            ]
        ]
    }
}