Özel teklif gönderme API'lerine genel bakış
Özel teklifler, yayımcıların ve müşterilerin özelleştirilmiş terimlerle zamana bağlı fiyatlandırma oluşturarak Azure Market'te 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, uygulama veya hizmetinizden gelen çağrıların kimliğini doğrulamak için Azure Active Directory 'yi (Azure AD) 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, Azure Market'teki belirli bir ürün için özelleştirilmiş koşullar ve fiyatlandırmaya sahip bir ISV ile belirli bir müşteri arasındaki ö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) – Azure Market'teki belirli ürünler için özelleştirilmiş terimler ve fiyatlandırma özelliklerine sahip bir ISV ve belirli bir müşterinin tercih edilen satış ortağı tarafından işbirliği içinde yapılandırılan özel bir anlaşma. ISV, iş ortağının kullanımına sunulan indirimli toptan satış fiyatını tanımlar, satış 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.
Terimler
- MPO kaynağı – MPO, ISV ile satış ortağı arasında belirli bir müşteri için aynı özel anlaşmada yapılan bir işbirliğidir. MPO'nun 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 müşteriye sunan satış ortağı MPO'nun satıcısıdır. Herhangi bir MPO için yalnızca bir satıcı olabilir.
- Ürün : Azure Market'teki 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 Azure AD dizinine ve genel yönetici iznine sahip olması gerekir. Microsoft 365 veya Microsoft'un diğer iş hizmetlerini zaten kullanıyorsanız Azure AD dizininiz zaten vardır. Aksi takdirde, İş Ortağı Merkezi'nde ücretsiz olarak yeni bir Azure AD oluşturabilirsiniz.
Bir Azure AD 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 Azure AD erişim belirtecini almak için bu değerlere ihtiyacınız vardır.
2. Adım: Azure AD erişim belirteci alma (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 Azure AD 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
| Kimlik | Bunları nerede bulabilirim? |
|---|---|
| client_id | Bkz. Azure AD uygulamasını İş Ortağı Merkezi hesabınızla ilişkilendirme. |
| tenant_id | Bkz. Azure AD uygulamasını İş Ortağı Merkezi hesabınızla ilişkilendirme. |
| client_secret | Bkz. Azure AD uygulamasını İş Ortağı Merkezi hesabınızla ilişkilendirme. |
| productId | Bu makaledeki Ürünleri alma bölümüne bakın. |
| planId | Bu makaledeki Belirli bir ürün için planları alma bölümüne bakın. |
| privateofferId | Bu makaledeki Özel teklifleri alma bölümüne bakın. |
Ü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: İstekte bulun
Ö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.
| Jobstatus | Description |
|---|---|
| NotStarted | İş henüz başlamadı; bu, ilk istekte verilen yanıtın bir parçasıdır. |
| Çalışıyor | İş hala çalışıyor. |
| Tamamlandı | İş tamamlandı. Daha fazla ayrıntı için jobResult bölümüne bakın. |
| jobResult | Açıklama |
| Beklemede | İş henüz tamamlanmadı. |
| Başarılı oldu | İş başarıyla tamamlandı. Bu iş, işle ilgili özel teklife başvuran bir resourceURI de döndürür. Özel bir teklifin tüm ayrıntılarını almak için bu resourceURI'yi kullanın. |
| Başarısız | İş başarısız oldu. Bu, hatanın nedenini belirlemeye yardımcı olmak için ilgili hataları da döndürür. |
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 satış 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 satış 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 satış ortağı (satıcı) olmasına bağlıdır. aynı ISV/satış ortağı yayımlama akışı ve İş Ortağı Merkezi'ni yöneten iş kuralları API'de yansıtılır. İşte genel bakış:
| API İşlemi | ISV (Kaynak) | Satış Ortağı (Satıcı) |
|---|---|---|
| Oluştur |
|
|
| Silme |
|
|
| Geri |
|
|