Zasoby promocji
Dotyczy
- Centrum partnerskie
Odpowiednie role
- Agent administracyjny
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.
Opisuje zasoby dotyczące promocji stosowanych do transakcji dla nowych subskrypcji handlowych.
Promocja
Rabat stosowany podczas zakupu jednostki SKU produktu w przypadku spełnienia kryteriów kwalifikowalności.
| Właściwość | Type | Opis |
|---|---|---|
| identyfikator | string | Identyfikator promocji. |
| nazwa | string | Przyjazna nazwa promocji. |
| opis | string | Opis promocji. |
| startDate | string | Data rozpoczęcia promocji. |
| endDate | string | Data zakończenia, kiedy promocja ma zastosowanie. |
| requiredProducts | lista wymaganych produktów | Szczegóły produktu, jednostki SKU i zasady cennika, dla których ma zastosowanie podwyższenie poziomu. |
| właściwości | lista właściwości | Właściwości promocji, w tym informacje o tym, czy promocja ma zastosowanie automatycznie. |
RequiredProducts
Szczegóły produktu, jednostki SKU i zasady cennika, dla których ma zastosowanie podwyższenie poziomu.
| Właściwość | Type | Opis |
|---|---|---|
| productId | string | Identyfikator produktu, dla których jest dostępna promocja. |
| skuId | string | Identyfikator jednostki SKU, dla których jest dostępna promocja. |
| termin | Termin | Termin zawierający czas trwania i cykl rozliczeniowy, dla których jest dostępna promocja. |
| pricingPolicies | Lista cenZasady | Lista zasad definiujących typy rabatów i wartości promocji. |
Termin
Reprezentuje termin, dla którego można kupić promocję.
| Właściwość | Type | Opis |
|---|---|---|
| czas trwania | string | Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata). |
| billingCycle | string | Opisuje częstotliwość stosowania promocji do rozliczeń. Wartości mogą obejmować wartości Miesięczne, Roczne, OneTime lub Nieznane. |
CennikZasady
Opisz typy rabatów i wartości promocji.
| Właściwość | Type | Opis |
|---|---|---|
| type | string | Opisz, czy rabat jest oparty na procentach, czy rabatach na stawkę płaską. |
| wartość | string | Definiuje ilość zastosowanego rabatu. |
Właściwości
Właściwości podwyższania poziomu.
| Właściwość | Type | Opis |
|---|---|---|
| isAutoApplicable | bool | Wskazuje, czy promocja jest stosowana automatycznie, czy też musi zostać przekazana przez partnera. |
PromocjaEligibilitiesRequestItem
Właściwości reprezentujące transakcję i uprawnienia promocji.
| Właściwość | Type | Opis |
|---|---|---|
| identyfikator | int | Identyfikator elementu uprawnień do promocji. |
| catalogItemId | string | Identyfikator elementu wykazu, do których zostanie zastosowana promocja. Obejmuje identyfikator produktu, identyfikator jednostki SKU i identyfikator dostępności. |
| ilość | int | Liczba licencji lub wystąpień. |
| termDuration | string | Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata). |
| billingCycle | string | Opisuje częstotliwość stosowania promocji do rozliczeń. Wartości mogą obejmować wartości Miesięczne, Roczne, OneTime lub Nieznane. |
| identyfikator promocji | string | Identyfikator promocji. |
PromocjaEligibilities
Lista produktów, jednostek SKU i ich uprawnień do podwyższenia poziomu.
| Właściwość | Type | Opis |
|---|---|---|
| identyfikator | int | Identyfikator elementu uprawnień do promocji. |
| catalogItemId | string | Identyfikator elementu wykazu, do których zostanie zastosowana promocja. Obejmuje identyfikator produktu, identyfikator jednostki SKU i identyfikator dostępności. |
| ilość | int | Liczba licencji lub wystąpień. |
| termDuration | string | Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata). |
| billingCycle | string | Opisuje częstotliwość stosowania promocji do rozliczeń. Wartości mogą obejmować wartości Miesięczne, Roczne, Jednorazowe lub Nieznane. |
| uprawnienia | Lista promocjiEligibilities | Reprezentuje listę wyników kwalifikowalności do podwyższenia poziomu. |
Kwalifikowalność podwyższania poziomu
Lista produktów, jednostek SKU i ich uprawnień do podwyższenia poziomu.
| Właściwość | Type | Opis |
|---|---|---|
| identyfikator promocji | string | Identyfikator promocji. |
| isEligible | bool | Opisuje, czy podwyższenie poziomu kwalifikuje się do danego elementu żądania uprawnień. |
| błędy | Lista promocjiEligibilityErrors | Błędy opisujące, dlaczego element żądania uprawnień do podwyższenia poziomu nie kwalifikuje się. |
PromotionEligibilityError
Wyjaśnia, dlaczego element żądania uprawnień do podwyższenia poziomu nie kwalifikuje się.
| Właściwość | Type | Opis |
|---|---|---|
| type | string | Typy błędów uprawnień do podwyższenia poziomu mogą obejmować InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously lub Termin. |
| opis | string | Opisuje, czy podwyższenie poziomu kwalifikuje się do danego elementu żądania uprawnień. |
RedemptionLimitPromotionEligibilityError
Zawiera szczegółowe informacje o tym, dlaczego przekroczono limit realizacji.
| Właściwość | Type | Opis |
|---|---|---|
| maxPromotionRedemptionCount | int | Maksymalna liczba prób uzyskania promocji. |
| remainingPromotionRedemptionCount | int | Pozostała liczba prób uzyskania promocji. |
SeatCountPromotionEligibilityError
Zawiera szczegółowe informacje o tym, dlaczego przekroczono limit liczby miejsc. Wszystkie wartości są dopuszczane do wartości null.
| Właściwość | Type | Opis |
|---|---|---|
| minimumRequiredSeats | int | Minimalna liczba licencji, które będą obsługiwane przez podwyższenie poziomu. |
| maximumRequiredSeats | int | Maksymalna liczba licencji, które będą obsługiwane przez podwyższenie poziomu. |
| availableSeats | int | Pozostała liczba licencji, które partner może uzyskać dla danej promocji. |
TermPromotionEligibilityError
Zawiera szczegółowe informacje o tym, dlaczego termin promocji nie został zaakceptowany.
| Właściwość | Type | Opis |
|---|---|---|
| eligibleTerms | Podwyższenie poziomu | Kwalifikujące się warunki promocji będą obsługiwane. |
Podwyższenie poziomu
Zawiera szczegółowe informacje o tym, dlaczego przekroczono limit liczby miejsc.
| Właściwość | Type | Opis |
|---|---|---|
| billingCycle | string | Opisuje częstotliwość stosowania promocji do rozliczeń. Wartości mogą obejmować wartości Miesięczne, Roczne, Jednorazowe lub Nieznane. |
| czas trwania | string | Czas trwania zakupionego terminu. |