Vytvoření přímé nabídky nezávislých výrobců softwaru pro zákazníky
Pomocí této metody můžete vytvořit soukromou nabídku pro zákazníka přímo jako výrobce softwaru.
Žádost
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
Hlavička požadavku
Hlavička | Typ | Popis |
---|---|---|
Autorizace | String | Povinný: Přístupový token Microsoft Entra ve formuláři Bearer <token> . |
Volitelné: CLIENTID
Parametry požadavku
$version – povinné. Toto je verze schématu, které se používá v požadavku.
Text požadavku
Zadejte podrobnosti o privátní nabídce pomocí schématu privátní nabídky nezávislých výrobců softwaru pro zákazníka. Musí obsahovat název.
Následující možnosti zrcadlí možnosti v Partnerském centru při vytváření privátní nabídky pro zákazníka. Možnosti jsou definovány hodnotami offerPricingType uvedené zde:
offerPricingType – hodnota | Ekvivalent možnosti vytvoření privátní nabídky v Partnerském centru |
---|---|
editExistingOfferPricingOnly | Přizpůsobte si ceny stávajících veřejných nabídek a plánů – Pomocí této možnosti můžete vytvořit soukromou nabídku pro všechny typy transakcí: SaaS, Azure Virtual Machines a Aplikace Azure lications. Ceny partnerů si můžete přizpůsobit prostřednictvím absolutních cen nebo procentuálních slev. |
saasNewCustomizedPlans | Přizpůsobení cen, množství měřičů a uživatelských limitů pro nabídku SaaS – Pomocí této možnosti můžete vytvořit soukromou nabídku pro plán SaaS přizpůsobením absolutní ceny partnera, měřením množství dimenzí a uživatelských limitů. |
vmSoftwareReservations | Přizpůsobte ceny a konkrétní množství nabídek rezervací softwaru virtuálních počítačů – pomocí této možnosti můžete vytvořit vícedílnou soukromou nabídku pro prodej rezervací softwaru virtuálních počítačů (1 rok nebo 3 roky) a přizpůsobit absolutní cenu partnera, velikost vCPU, množství, dobu trvání a platební plán. |
U předchozích tří možností cenového typu se požadavky na prostředky specifické pro konkrétní plán mohou lišit, podrobnosti najdete v následující tabulce.
Název prostředku | editExistingOfferPricingOnly | saasNewCustomizedPlans | vmSoftwareReservations |
---|---|---|---|
stanovení cen. Plán | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. | Nelze použít | Nelze použít |
pricing.basePlan | Nelze použít | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. |
pricing.newPlanDetails.name | Nelze použít | Nastavte ho na název nového plánu, který se zákazníkovi zobrazí v textu požadavku. | Na text požadavku se nevztahuje, systém se vygeneruje a bude k dispozici v odpovědi úlohy po dokončení. |
pricing.newPlanDetails.description | Nelze použít | Nastavte tento popis na popis, který se zobrazí zákazníkovi pro nový plán v textu požadavku. | Na text požadavku se nevztahuje, systém se vygeneruje a bude k dispozici v odpovědi úlohy po dokončení. |
customerContractRenewal value | Popis |
---|---|
true | Soukromá nabídka je prodloužení stávající smlouvy se zákazníkem. Sleva za 50% poplatek za agenturu se vztahuje na vaši soukromou nabídku na prodloužení platnosti zákazníka. |
false (nepravda) | Soukromá nabídka není prodloužením stávající smlouvy se zákazníkem. Platí váš standardní poplatek za agenturu. |
Ukázky textu požadavku
Ukázkový text požadavku s využitím cen slev pro přizpůsobení cen pouze pro stávající veřejný plán
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "editExistingOfferPricingOnly",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA ",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{ "product": "product/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage", "discountPercentage": 5 }
]
}
]
}
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen pouze pro stávající veřejný plán
Pokud místo slev založených na procentech používáte absolutní ceny:
- Vytvoření nového prostředku nad prostředkem privátní nabídky, který definuje absolutní ceny
- Tento nově vytvořený prostředek zahrňte jako jiný objekt do seznamu prostředků schématu konfigurace.
Tuto metodu použijte k získání cenového prostředku pro váš stávající veřejný plán, úpravě cen a následnému použití upraveného prostředku pro vaši soukromou nabídku.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSimpleAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"offerPricingType": "editExistingOfferPricingOnly",
"plan": "plan/987654",
"pricing": {
"recurrentPrice": {
"priceInputOption": "usd",
"prices": [
{
"pricePerPaymentInUsd": 1,
"billingTerm": {
"type": "month",
"value": 1
}
},
{
"pricePerPaymentInUsd": 2,
"paymentOption": {
"type": "month",
"value": 1
},
"billingTerm": {
"type": "year",
"value": 1
}
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"pricePerPaymentInUsd": 1
}
}
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
[
{
"product": "product/34771906-9711-4196-9f60-4af380fd5042",
"plan": "plan/123456",
"discountType": "percentage",
"discountPercentage": 5
},
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/987654",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSimpleAbsolutePricing"
}
}
]
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen, měření a uživatelských limitů pro nabídku SaaS
Pomocí následující metody vytvořte pro nabídku absolutní cenu a prostředek dostupnosti.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku pro nabídku SaaS s plochou sazbou, která přizpůsobí množství cen a měřičů
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"resourceName": "newSaaSPlanAbsolutePricing",
"plan": "plan/ 123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "flatRate",
"priceInputOption": "usd",
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.1
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.12
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"quantity": 10.0,
"isInfinite": false
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"quantity": 15.0,
"isInfinite": false
}
]
},
"meter2": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": true
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"isInfinite": true
}
]
}
}
}
}
}
Ukázka absolutního cenového prostředku pro nabídku SaaS pro jednotlivé uživatele, která přizpůsobí ceny a limity uživatelů
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSaaSPlanAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "perUser",
"priceInputOption": "usd",
"userLimits": {
"min": 20,
"max": 100
},
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.01
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "year",
"value": 1
},
"pricePerPaymentInUsd": 0.02
}
]
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "saasNewCustomizedPlans",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSaaSPlanAbsolutePricing"
}
"basePlan": "plan/123456",
"newPlanDetails": {
"name": "newPlanName",
"description": "newPlanDescription"
}
]
}
]
}
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen a konkrétních množství nabídek rezervací softwaru virtuálních počítačů
Pomocí následující metody vytvořte pro nabídku absolutní cenu a prostředek dostupnosti.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku pro nabídku virtuálních počítačů, která přizpůsobí ceny a množství
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newVMSRAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"offerPricingType": "vmSoftwareReservations",
"plan": "plan/987654",
"softwareReservation": {
"reservationDuration": {
"type": "year",
"value": 1
},
"paymentSchedule": {
"type": "year",
"value": 1
},
"vmPrices": {
"36Core": {
"quantity": 4.0,
"unitPricePerPaymentPeriodInUsd": 0.04
}
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "vmSoftwareReservations",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newVMSRAbsolutePricing"
}
"basePlan": "plan/987654"
]
}
]
}
Response
Odpověď obsahuje ID úlohy, kterou můžete později použít k dotazování stavu:
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2023-07-15",
"jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
"jobStatus": "notStarted",
"jobResult": "pending",
"jobStart": "2021-12-21T21:29:54.9702903Z",
"jobEnd": "0001-01-01",
"errors": []
}
Kódy chyb
Stavový kód HTTP | Popis |
---|---|
401 | Chyba ověřování: Ujistěte se, že používáte platný přístupový token Microsoft Entra. |
400 | Ověřování schématu Ujistěte se, že text požadavku sleduje správné schéma a obsahuje všechna povinná pole. |