Een directe ISV maken voor de persoonlijke aanbieding van de klant
Gebruik deze methode om rechtstreeks als ISV een privéaanbieding voor een klant te maken.
Aanvraag
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
Aanvraagheader
| Koptekst | Type | Description |
|---|---|---|
| Autorisatie | String | Vereist. Het Microsoft Entra-toegangstoken in het formulier Bearer <token>. |
Optioneel: clientID
Aanvraagparameters
$version - vereist. Dit is de versie van het schema dat in de aanvraag wordt gebruikt.
Aanvraagtekst
Geef de details van de privéaanbieding op met behulp van het schema van de privéaanbieding van de klant met behulp van het schema voor privéaanbiedingen van klanten. Dit moet een naam bevatten.
De volgende opties weerspiegelen de opties in Partnercentrum bij het maken van een privéaanbieding voor een klant. Opties worden gedefinieerd door de waarden offerPricingType die hier worden vermeld:
| offerPricingType-waarde | Optie voor het maken van privéaanbiedingen in Partnercentrum equivalent |
|---|---|
| editExistingOfferPricingOnly | Prijzen aanpassen voor bestaande openbare aanbiedingen en abonnementen: gebruik deze optie om een privéaanbieding te maken voor alle transactable aanbiedingstypen: SaaS, Azure Virtual Machines en Azure-toepassing s. U kunt uw partnerprijzen aanpassen via absolute prijs- of percentagekortingen. |
| saasNewCustomizedPlans | Prijzen, meterhoeveelheden en gebruikerslimieten aanpassen voor SaaS-aanbieding : gebruik deze optie om een privéaanbieding voor een SaaS-abonnement te maken door uw absolute partnerprijs, maatlijnhoeveelheden en gebruikerslimieten aan te passen. |
| vmSoftwareReservations | Prijzen en specifieke hoeveelheden aanpassen voor aanbiedingen voor VM-softwarereservering : gebruik deze optie om een privé-aanbieding met meerdere partijen te maken voor het verkopen van VM-softwarereserveringen (1 jaar of 3 jaar) en pas de absolute partnerprijs, vCPU-grootte, hoeveelheden, duur en betalingsschema aan. |
Zie de volgende tabel voor meer informatie voor de vorige drie prijstypeopties. De vereisten voor abonnementsspecifieke resources kunnen variëren.
| Resourcenaam | editExistingOfferPricingOnly | saasNewCustomizedPlans | vmSoftwareReservations |
|---|---|---|---|
| Prijzen. Plan | Stel deze in op de plan-id van het openbare plan dat moet worden geconfigureerd in de aanvraagbody | Niet van toepassing | Niet van toepassing |
| pricing.basePlan | Niet van toepassing | Stel deze in op de plan-id van het openbare plan dat moet worden geconfigureerd in de aanvraagbody | Stel deze in op de plan-id van het openbare plan dat moet worden geconfigureerd in de aanvraagbody |
| pricing.newPlanDetails.name | Niet van toepassing | Stel dit in op de naam van het nieuwe plan dat wordt weergegeven aan de klant in de aanvraagbody | Niet van toepassing op de aanvraagbody, wordt door het systeem gegenereerd en beschikbaar in het antwoord van de taak wanneer deze is voltooid. |
| pricing.newPlanDetails.description | Niet van toepassing | Stel dit in op de beschrijving die wordt weergegeven aan de klant voor het nieuwe plan in de aanvraagbody | Niet van toepassing op de aanvraagbody, wordt door het systeem gegenereerd en beschikbaar in het antwoord van de taak wanneer deze is voltooid. |
Voorbeelden van aanvraagtekst
Voorbeeld van aanvraagbody met kortingsprijzen om alleen prijzen voor een bestaand openbaar abonnement aan te passen
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "editExistingOfferPricingOnly",
"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 }
]
}
]
}
Voorbeeld van aanvraagbody met absolute prijzen om alleen prijzen voor een bestaand openbaar abonnement aan te passen
Als u absolute prijzen gebruikt in plaats van korting op basis van percentages:
- Een nieuwe resource maken boven de privé-aanbiedingsresource waarmee de absolute prijzen worden gedefinieerd
- Neem die zojuist gemaakte resource op als een ander object in de lijst met resources van het configuratieschema.
Gebruik deze methode om de prijsresource voor uw bestaande openbare abonnement te verkrijgen, de prijzen te bewerken en vervolgens de bewerkte resource voor uw persoonlijke aanbieding te gebruiken.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Voorbeeld van absolute prijsresource
{
"$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
}
}
}
}
}
Deze resource opnemen als een object in de prijsmodule
[
{
"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"
}
}
]
Voorbeeldaanvraagbody met behulp van absolute prijzen voor het aanpassen van prijzen, meting van hoeveelheden en gebruikerslimieten voor SaaS-aanbieding
Gebruik de volgende methode om een absolute prijs- en beschikbaarheidsresource voor de aanbieding te maken.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Voorbeeld van absolute prijsresource voor een saaS-aanbieding met vaste tarieven waarmee de prijs- en meterhoeveelheden worden aangepast
{
"$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
}
]
}
}
}
}
}
Voorbeeld van absolute prijsresource voor een SaaS-aanbieding per gebruiker waarmee prijs- en gebruikerslimieten worden aangepast
{
"$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
}
]
}
}
}
Deze resource opnemen als een object in de prijsmodule
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "saasNewCustomizedPlans",
"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"
}
]
}
]
}
Voorbeeldaanvraagbody met behulp van absolute prijzen voor het aanpassen van prijzen en specifieke hoeveelheden voor aanbiedingen voor VM-softwarereservering
Gebruik de volgende methode om een absolute prijs- en beschikbaarheidsresource voor de aanbieding te maken.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Voorbeeld van absolute prijsresource voor een VM-aanbieding waarmee prijs en hoeveelheden worden aangepast
{
"$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
}
}
}
}
Deze resource opnemen als een object in de prijsmodule
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "vmSoftwareReservations",
"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"
]
}
]
}
Respons
Het antwoord bevat de jobId die u later kunt gebruiken om de status te peilen:
{
"$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": []
}
Foutcodes
| HTTP-statuscode | Beschrijving |
|---|---|
| 401 | Verificatiefout: zorg ervoor dat u een geldig Microsoft Entra-toegangstoken gebruikt. |
| 400 | Schemavalidatie. Zorg ervoor dat de hoofdtekst van de aanvraag het juiste schema volgt en alle vereiste velden bevat. |
Gerelateerde inhoud
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor