Udostępnij za pośrednictwem


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