Özel teklif gönderme API'lerine genel bakış

Özel teklifler, yayımcıların ve müşterilerin özelleştirilmiş koşullarla zamana bağlı fiyatlandırma oluşturarak Azure Market bir veya daha fazla ürünü işlemesine olanak tanır. Özel teklif gönderim API'leri, yayımcıların müşteriler ve/veya CSP iş ortakları için program aracılığıyla özel teklifler oluşturmasına ve yönetmesine olanak tanır. Bu API, uygulamanızdan veya hizmetinizden gelen çağrıların kimliğini doğrulamak için Microsoft Entra Id kullanır.

İş Ortağı Merkezi'nde bulunan ve özel teklif gönderme API'sinin desteklediği üç ana özel teklif türü vardır:

• ISV'ye müşteriye özel teklif – İş Ortağı Merkezi'nde müşteri özel teklifi olarak da adlandırılır. Bu, bir ISV ile belirli bir müşteri arasında, Azure Market'da belirli bir ürün için özelleştirilmiş koşullar ve fiyatlandırmaya sahip özel bir anlaşmadır. ISV'den müşteriye özel teklif hakkında daha fazla bilgi edinin.
• ISV'ye CSP iş ortağı özel teklifi – İş Ortağı Merkezi'nde CSP İş Ortakları özel teklifi olarak da adlandırılır. Bu tür bir özel teklif, ISV'nin CSP iş ortağı için toptan satış fiyatı oluşturmak üzere zamana bağlı marj belirtmesine olanak tanır. ISV'den CSP iş ortağına özel teklif hakkında daha fazla bilgi edinin.
• Çok bölümlü özel teklif (MPO) : ISV ve belirli bir müşterinin tercih edilen kanal iş ortağı tarafından işbirliği içinde yapılandırılan ve Azure Market'deki belirli ürünler için özelleştirilmiş koşullar ve fiyatlandırma ile özel bir anlaşma. ISV, iş ortağının kullanımına sunulan indirimli toptan satış fiyatını tanımlar, kanal ortağı son müşteri fiyatına ulaşmak için toptan satış fiyatının üzerine kar payı ekleyebilir ve teklifi kabul ve satın alma için müşteriye sunar. MPO'nun kabulü ve satın alınması, MÜŞTERI özel tekliflerine ISV ile aynı akışı izler. Çok bölümlü özel teklif hakkında daha fazla bilgi edinin.

Terminoloji

• MPO kaynağı – MPO, BELIRLI bir müşteri için aynı özel anlaşmada ISV ile kanal iş ortağı arasında yapılan bir işbirliğidir. MPO'sunu ilk oluşturan taraf teklifin "kaynağı" olarak atanır ve genellikle MPO'ya dahil edilen ürünlerin ISV'sini oluşturur. Belirli bir MPO için yalnızca bir kaynak olabilir.
• MPO satıcısı – Teklifi son müşteri fiyatıyla hazırlayan ve teklifi müşteriye sunan kanal iş ortağı MPO'nun satıcısıdır. Herhangi bir MPO için yalnızca bir satıcı olabilir.
• Ürün: Azure Market bir teklifi temsil eden tek bir birim. Listeleme sayfası başına bir ürün vardır.
• Plan : Belirli bir ürünün tek bir sürümü. Belirli bir ürün için çeşitli fiyatlandırma düzeylerini veya koşulları temsil eden birden çok plan olabilir.
• İş : Bu API'de istekte bulunurken oluşturulan görev. Özel teklifleri ve çok bölümlü özel teklifleri yönetmek için bu API kullanılırken, isteği tamamlamak için bir iş oluşturulur. İş tamamlandıktan sonra ilgili (çok bölümlü) özel teklif hakkında daha fazla bilgi edinebilirsiniz.

Desteklenen senaryolar

• Müşteri için özel teklif oluşturma
• Kurumsal bayi için özel teklif oluşturma
• Müşteri için çok bölümlü özel teklif oluşturma
• Özel teklifi silme
• Özel teklifi geri çekme
• Çok bölümlü özel tekliflerin listesini sorgulama
• Ürün ve planların listesini sorgulama

Bu API'yi kullanmaya hazır olun

Özel teklifler API'sini çağırmak için kod yazmadan önce aşağıdaki önkoşulları tamamladığınızdan emin olun. Aynı önkoşullar tüm yayımlama iş ortakları için de geçerlidir.

1. Adım: Microsoft Ürün Alımı API'sini (tek seferlik) kullanmak için önkoşulları tamamlayın

Sizin veya kuruluşunuzun bir Microsoft Entra dizinine ve genel yönetici iznine sahip olması gerekir. Microsoft 365 veya Microsoft'un diğer iş hizmetlerini zaten kullanıyorsanız, Microsoft Entra dizininiz zaten vardır. Aksi takdirde, İş Ortağı Merkezi'nde ücretsiz olarak yeni bir Microsoft Entra Kimliği oluşturabilirsiniz.

Bir Microsoft Entra Id uygulamasını İş Ortağı Merkezi hesabınızla ilişkilendirmeniz ve kiracı kimliğinizi, istemci kimliğinizi ve anahtarınızı almanız gerekir. Özel teklifler API'sine yönelik çağrılarda kullanacağınız Microsoft Entra erişim belirtecini almak için bu değerlere ihtiyacınız vardır.

2. Adım: Microsoft Entra erişim belirtecini edinme (her seferinde)

Microsoft Store gönderim API'sindeki yöntemlerden herhangi birini çağırmadan önce, API'deki her yöntemin yetkilendirme üst bilgisine geçirmek için bir Microsoft Entra erişim belirteci gerekir. Süresi dolmadan önce belirteci kullanmak için 60 dakikanız vardır. Süre dolduktan sonra, bir belirteci yenileyebilir, böylece API'ye yapılan diğer çağrılarda bu belirteci kullanmaya devam edebilirsiniz.

Erişim belirtecini almak için bkz. tenant_id/oauth2/token uç noktasına HTTP POST göndermek için https://login.microsoftonline.com/<>İstemci Kimlik Bilgilerini Kullanarak Hizmet çağrılarına hizmet verme. İşte örnek bir istek:

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://graph.microsoft.com/

POST URI'sindeki tenant_id değeri ile client_id ve client_secret parametreleri için, önceki bölümde İş Ortağı Merkezi'nden aldığınız uygulamanızın kiracı kimliğini, istemci kimliğini ve anahtarını belirtin. Kaynak parametresi için belirtmelisiniz https://graph.microsoft.com/.

Ürün, plan ve özel teklif kimliklerini bulma

Ürünleri alma

Özel teklif, İş Ortağı Merkezi hesabınızdaki mevcut bir ürünü temel alır. İş Ortağı Merkezi hesabınızla ilişkili ürünlerin listesini görmek için şu API çağrısını kullanın:

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

Yanıt aşağıdaki örnek biçimde görüntülenir:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/product/2022-07-01",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "type": "enum",
      "alias": "string"
    }
  ],
  "@nextLink": "opaque_uri"
}

Belirli bir ürün için planları alma

Birden fazla plan içeren ürünler için belirli bir planı temel alan özel bir teklif oluşturmak isteyebilirsiniz. Öyleyse, o planın kimliğine ihtiyacınız vardır. Aşağıdaki API çağrısını kullanarak ürünün planlarının (varyantlar veya SKU'lar gibi) listesini alın:

GET https://graph.microsoft.com/rp/product-ingestion/plan?product=<product-id>&$version=2022-07-01

Yanıt aşağıdaki örnek biçimde görüntülenir:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-07-01",
      "product": "string",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "alias": "string"
    }
  ]
}

Özel teklifleri alma

Hesabınızla ilişkili çok bölümlü özel teklifler de dahil olmak üzere tüm özel tekliflerin listesini görmek için aşağıdaki API çağrısını kullanın:

GET https://graph.microsoft.com/rp/product-ingestion/private-offer/query?$version=2023-07-15

API'yi kullanma

Özel teklif API'si, İş Ortağı Merkezi hesabınızdaki ürünler ve planlarla ilişkili özel teklifler oluşturmanıza ve yönetmenize olanak tanır. Bu API'yi kullanırken tipik çağrı düzeninin özeti aşağıda verilmiştır.

1. Adım: İsteği yapma

Özel teklif oluşturmak, silmek, geri çekmek veya yükseltmek için bir API çağrısı yaptığınızda, istenen görevi tamamlamak için yeni bir iş oluşturulur. API yanıtı, işle ilişkili bir jobId içerir.

2. Adım: İş durumunu yoklama

İlk API yanıtından jobId değerini kullanarak iş durumunu almak için yoklama yapın. İşin durumu Çalışıyor veya Tamamlandı olacaktır. İş tamamlandıktan sonra sonuç Başarılı veya Başarısız olur. Performans sorunlarını önlemek için bir işi dakikada bir kereden fazla yoklamayın.

Daha fazla bilgi için bkz . Mevcut işin durumunu sorgulama.

3. Adım: Tamamlanan işlerden bilgi alma

Başarılı bir iş, ilgili özel teklife başvuran bir resourceUri döndürür. Gelecekte privateofferId gibi özel teklif hakkında daha fazla bilgi edinmek için bu kaynak Uri'sini kullanın.

Başarısız bir iş, işin neden başarısız olduğuna ve sorunun nasıl çözüleceğini gösteren hatalar içerir.

Daha fazla bilgi için bkz . Mevcut özel teklifin ayrıntılarını alma.

ISV ve kanal iş ortağının çok bölümlü özel teklif için API'yi işbirliğiyle nasıl kullanması gerekir?

Hem ISV hem de kanal iş ortağı, belirli bir MPO'nun oluşturulması ve yönetilmesi için aynı API'leri kullanabilir. Ancak, BIR MPO'daki API'yi etkileyebilecek kaynaklar, API'yi çağıranın MPO'nun ISV(kaynak) veya kanal ortağı (satıcı) olmasına bağlıdır. aynı ISV/kanal iş ortağı yayımlama akışı ve İş Ortağı Merkezi'ni yöneten iş kuralları API'de yansıtılır. İşte genel bakış:

İlgili içerik

• Müşteri için özel teklif oluşturma
• Kurumsal bayi için özel teklif oluşturma
• Müşteri API'si için çok bölümlü özel teklif oluşturma