Fiyat listesi alma
Bu makale, belirli bir piyasa ve görünüm için fiyat listesinin nasıl alınacağını açıklar. Bu yöntem, aya göre geçmiş almak için filtreleri destekler.
Önkoşullar
- İş Ortağı API kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama kullanıcı kimlik doğrulamasını destekler. Yalnızca uygulama desteği henüz sağlanmıyor. http hatası:400 ile karşılaşan iş ortakları İş Ortağı API'sinin kimlik doğrulaması belgelerine başvurmalıdır.
- Bu API şu anda yalnızca iş ortaklarının şu rollerden birinde olması gereken kullanıcı erişimini destekler: Yönetici Aracısı veya Satış Aracısı.
Ayrıntılar
- Geçerli olarak yalnızca Azure planı tüketimi ve rezervasyonları, lisans tabanlı (yeni ticaret deneyimi) ve Market ürünleri için veri döndürür.
- Geçerli fiyatlandırma, geçerli ay boyunca API'nin çağrıldığı tarihe kadar kullanılabilen tüm ölçümleri ve ürünleri içerir. Önceki aylar, belirli bir aya ilişkin tüm ölçümleri ve ürünleri içerir.
- Tüketim ölçümü fiyatları yalnızca ABD Doları cinsindendir, iş ortakları yerel para birimi maliyetlerini hesaplamak için döviz kurları API'sini kullanır.
- Tüketim ölçümü fiyatları tahmini perakende fiyatlarıdır. İş ortağı indirimleri, iş ortağı tarafından kazanılan kredi ile sağlanır.
- Rezervasyon sayaç fiyatları CSP ortak indirimlerini içerir. Rezervasyonlar için tahmini perakende fiyatları, İş Ortağı Merkezi "Fiyatlandırma ve teklifler" sayfasından indirilebilen rezervasyonlar için paylaşılan hizmetlerde bulunabilir.
- Azure planı fiyatlandırması hakkında daha fazla bilgiyi Azure planı fiyatlandırma belgelerinde bulabilirsiniz.
- İş ortağı fiyatlandırması ve döviz kuru API'leri İş Ortağı Merkezi SDK'sının bir parçası değildir.
- Bu yöntem, fiyat listesini dosya akışı olarak döndürür. Dosya akışı, .csv bir dosya veya .csv zip sıkıştırılmış sürümüdür. Sıkıştırılmış dosyaların nasıl isteneceklerine ilişkin ayrıntılar aşağıda verilmiştir.
REST isteği
İstek söz dizimi
Metot | İstek URI'si |
---|---|
GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
URI'nin gerekli parametreleri
İstediğiniz piyasa ve fiyat listesi türünü istemek için aşağıdaki yol parametrelerini kullanın.
Adı | Tür | Zorunlu | Açıklama |
---|---|---|---|
Pazar | string | Yes | talep edilen pazar için iki harfli ülke/bölge kodu |
Fiyat Listesi Görünümü | string | Yes | İstenen fiyat listesi türü, azure_consumption, azure_reservations, updatedlicensebased, marketplace veya yazılım olabilir. |
Not
updatedlicensebased PriceSheetView şu anda yalnızca Microsoft 365/Microsoft Dynamics 365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları tarafından kullanılabilir.
Not
Satış sonu lisans tabanlı fiyat listesi şu anda yalnızca İş Ortağı Merkezi UX aracılığıyla indirilebilir.
URI filtre parametreleri
Aşağıdaki filtre parametrelerini kullanın.
Adı | Tür | Zorunlu | Açıklama |
---|---|---|---|
Zaman çizelgesi | string | Hayır | Geçirilmediyse varsayılan olarak geçerli olur. Olası değerler geçmiş, geçerli ve gelecek değerleridir. |
Month | string | Hayır | Yalnızca geçmiş isteniyorsa gereklidir, talep edilen fiyat listesi için YYYYMM biçimine bağlı kalınmalıdır. |
Not
Pazar Yeri için gelecekteki fiyatlandırma desteklenmiyor. 1 Nisan 2022'den itibaren iş ortakları, Mart 2022 geçmişinden itibaren API aracılığıyla yazılım fiyat listesi geçmişini görüntüleyebilir.
İstek üst bilgileri
- Daha fazla bilgi için bkz. İş ortağı REST üst bilgileri.
Yukarıdaki üst bilgilere ek olarak, fiyatlandırma dosyaları bant genişliğini ve indirme sürelerini azaltan sıkıştırılmış olarak alınabilir. Varsayılan olarak dosyalar sıkıştırılamaz. Dosyaların sıkıştırılmış sürümlerini almak için aşağıdaki üst bilgi değerini ekleyebilirsiniz. Sıkıştırılmış sayfaların yalnızca Nisan 2020'den itibaren mevcut olduğunu, Nisan 2020'den önceki tüm sayfaların yalnızca sıkıştırılmamış olarak mevcut olduğunu unutmayın.
Başlık | Değer Türü | Değer | Açıklama |
---|---|---|---|
accept-encoding | string | söndürmek | isteğe bağlı. Atlanan dosya akışı sıkıştırılmıyorsa. |
İstek örneği
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Yeni ticaret sistemi için talep örneği
Not
updatedlicensebased PriceSheetView şu anda yalnızca Microsoft 365/Microsoft Dynamics 365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları tarafından kullanılabilir.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST yanıtı
Başarılı olursa, bu yöntem fiyat listesini bir dosya akışı olarak döndürür. Dosya akışı, .csv bir dosya veya .csv zip sıkıştırılmış sürümüdür.
Yeni ticaret için yanıt örneği
Not
updatedlicensebased PriceSheetView şu anda yalnızca Microsoft 365/Microsoft Dynamics 365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları tarafından kullanılabilir.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
Yanıt başarısı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.
Yeni ticaret lisanslı gelecekteki fiyat listesi için herhangi bir değişiklik beklenmiyorsa, gelecekteki fiyat listesi iade edilmeyecektir. Gelecekte updatedlicensebased PriceSheetView için istenen Zaman Çizelgesine geçerken, iş ortakları şu API yanıt kodunu görür: 404 Bulunamadı.