Aracılığıyla paylaş

Müşteri özel teklifine doğrudan ISV oluşturma

  • Makale

Bir müşteri için doğrudan ISV olarak özel teklif oluşturmak için bu yöntemi kullanın.

İstek

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

İstek üst bilgisi

Üst bilgi Type Açıklama
Yetkilendirme String Gerekli. Biçimindeki Bearer <token>Microsoft Entra erişim belirteci.

İsteğe bağlı: clientID

İstek parametreleri

$version - gerekli. Bu, istekte kullanılan şemanın sürümüdür.

Request body

ISV'nin Müşteriye özel teklif şemasını kullanarak özel teklifin ayrıntılarını sağlayın. Bu bir ad içermelidir.

Aşağıdaki seçenekler, bir müşteri için özel teklif oluştururken İş Ortağı Merkezi'ndeki seçenekleri yansıtır. Seçenekler, burada listelenen offerPricingType değerleriyle tanımlanır:

offerPricingType değeri İş Ortağı Merkezi özel teklif oluşturma seçeneği eşdeğeri
editExistingOfferPricingOnly Mevcut genel teklif ve planlar için fiyatlandırmayı özelleştirin - Tüm işlem yapılabilir teklif türleri için özel bir teklif oluşturmak için bu seçeneği kullanın: SaaS, Azure Sanal Makineler ve Azure Uygulaması... Mutlak fiyatlandırma veya yüzde indirimleri aracılığıyla iş ortağı fiyatlandırmanızı özelleştirebilirsiniz.
saasNewCustomizedPlans SaaS teklifi için fiyatlandırmayı, ölçüm miktarlarını ve kullanıcı sınırlarını özelleştirme - Mutlak iş ortağı fiyatınızı, ölçüm boyutu miktarlarınızı ve kullanıcı sınırlarınızı özelleştirerek SaaS planı için özel bir teklif oluşturmak için bu seçeneği kullanın.
vmSoftwareReservations VM yazılım rezervasyon teklifleri için fiyatlandırmayı ve belirli miktarları özelleştirme - VM yazılım rezervasyonları (1 yıl veya 3 yıl) satmak ve mutlak iş ortağı fiyatını, vCPU boyutunu, miktarlarını, süresini ve ödeme zamanlamasını özelleştirmek üzere çok bölümlü özel bir teklif oluşturmak için bu seçeneği kullanın.

Önceki üç fiyatlandırma türü seçeneği için plana özgü kaynak gereksinimleri farklılık gösterebilir. Ayrıntılar için aşağıdaki tabloya bakın.

Kaynak adı editExistingOfferPricingOnly saasNewCustomizedPlans vmSoftwareReservations
Fiyatlandırma. Plan Bunu, istek gövdesinde yapılandırılacak genel planın plan kimliğine ayarlayın Uygulanamaz Uygulanamaz
pricing.basePlan Uygulanamaz Bunu, istek gövdesinde yapılandırılacak genel planın plan kimliğine ayarlayın Bunu, istek gövdesinde yapılandırılacak genel planın plan kimliğine ayarlayın
pricing.newPlanDetails.name Uygulanamaz Bunu, istek gövdesinde müşteriye gösterilecek yeni planın adı olarak ayarlayın İstek gövdesi için geçerli değildir, sistem oluşturulur ve tamamlandığında işin yanıtında kullanılabilir.
pricing.newPlanDetails.description Uygulanamaz Bunu, istek gövdesindeki yeni plan için müşteriye gösterilecek açıklama olarak ayarlayın İstek gövdesi için geçerli değildir, sistem oluşturulur ve tamamlandığında işin yanıtında kullanılabilir.
customerContractRenewal değeri Açıklama
true Özel teklif, mevcut bir müşteri sözleşmesinin yenilenmesidir. Müşteri yenilemeleri için özel teklifinize %50 indirimli acente ücreti uygulanır
yanlış Özel teklif, mevcut bir müşteri sözleşmesinin yenilenmesi değildir . Standart acente ücretiniz geçerlidir.

İstek gövdesi örnekleri

Yalnızca mevcut genel plan için fiyatlandırmayı özelleştirmek için indirim fiyatlandırmasını kullanan örnek istek gövdesi

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

Yalnızca mevcut genel plan için fiyatlandırmayı özelleştirmek için mutlak fiyatlandırma kullanan örnek istek gövdesi

Yüzde tabanlı indirim yerine mutlak fiyatlandırma kullanıyorsanız:

  1. Mutlak fiyatlandırmayı tanımlayan özel teklif kaynağının üzerinde yeni bir kaynak oluşturun
  2. Yeni oluşturulan kaynağı yapılandırma şemasının kaynaklar listesine başka bir nesne olarak ekleyin.

Mevcut genel planınızın fiyatlandırma kaynağını almak, fiyatları düzenlemek ve ardından özel teklifiniz için düzenlenen kaynağı kullanmak için bu yöntemi kullanın.

GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15

Örnek mutlak fiyatlandırma kaynağı

{
    "$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
                }
            }
        }
    }
}

Bu kaynağı fiyatlandırma modülüne nesne olarak ekleyin

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

SaaS teklifi için fiyatlandırmayı, ölçüm miktarlarını ve kullanıcı sınırlarını özelleştirmek için mutlak fiyatlandırmayı kullanan örnek istek gövdesi

Teklif için mutlak bir fiyat ve kullanılabilirlik kaynağı oluşturmak için aşağıdaki yöntemi kullanın.

GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15

Fiyat ve ölçüm miktarlarını özelleştiren sabit fiyat SaaS teklifi için örnek mutlak fiyatlandırma kaynağı

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

Fiyat ve kullanıcı sınırlarını özelleştiren kullanıcı başına SaaS teklifi için örnek mutlak fiyatlandırma kaynağı

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

Bu kaynağı fiyatlandırma modülüne nesne olarak ekleyin

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

VM yazılım ayırma tekliflerinin fiyatlandırmasını ve belirli miktarlarını özelleştirmek için mutlak fiyatlandırma kullanan örnek istek gövdesi

Teklif için mutlak bir fiyat ve kullanılabilirlik kaynağı oluşturmak için aşağıdaki yöntemi kullanın.

GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15

Fiyat ve miktarları özelleştiren bir VM teklifi için örnek mutlak fiyatlandırma kaynağı

{
    "$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
            }
        }
    }       
}

Bu kaynağı fiyatlandırma modülüne nesne olarak ekleyin

{
 "$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

Yanıt, durumu yoklamada daha sonra kullanabileceğiniz jobId değerini içerir:

{
    "$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": []
}

Hata kodları

HTTP durum kodu Açıklama
Kategori 401 Kimlik Doğrulama Hatası: Geçerli bir Microsoft Entra erişim belirteci kullandığınızdan emin olun.
400 Şema Doğrulaması. İstek gövdesinizin doğru şemayı izlediğinden ve tüm gerekli alanları içerdiğinden emin olun.

İlgili içerik