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