Fiyat listesi alma

  • Makale

Bu makalede, belirli bir piyasa ve görünüm için fiyat listesinin nasıl alınıp alınamaya ilişkin bilgiler verilmektedir. 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ğrulamayı destekler. Yalnızca uygulama henüz desteklenmiyor. 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: Genel Yönetici, Yönetici Aracısı veya Satış Aracısı.

Ayrıntılar

  • Geçerli yalnızca Azure planı tüketimi ve rezervasyonları, Lisanslı tabanlı (yeni ticaret deneyimi) ve Market ürünleri için veri döndürür.
  • Geçerli fiyatlandırma, API'nin çağrıldığı tarihe kadar geçerli ay boyunca 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 ölçümü fiyatları CSP iş ortağı indirimlerini içerir. Rezervasyonlar için tahmini perakende fiyatları, İş Ortağı Merkezi "Fiyatlandırma ve teklifler" sayfasından indirilebilen rezervasyonlar paylaşılan hizmetlerinde 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 gerekli parametreler

İ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
Market string Yes talep edilen pazar için iki harfli ülke/bölge kodu
PricesheetView string Yes azure_consumption, azure_reservations, updatedlicensebased, market veya yazılım olabilecek istenen fiyat listesi türü.

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

Yazılım fiyat listesi 1 Nisan 2022'den itibaren API aracılığıyla kullanıma sunulacaktır.

URI filtre parametreleri

Aşağıdaki filtre parametrelerini kullanın.

Adı Tür Zorunlu Açıklama
Zaman çizelgesi Dize Hayır Geçirilmediyse varsayılan olarak geçerli olur. Olası değerler geçmiş, geçerli ve gelecek değerleridir.
Month Dize Hayır Yalnızca geçmiş istenirse gereklidir, talep edilen fiyat listesi için YYYYMM'ye bağlı kalmalıdır.

Not

Market için gelecekteki fiyatlandırma desteklenmez. 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

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 kullanılabildiğini, Nisan 2020'den önceki tüm sayfaların yalnızca sıkıştırılmış olarak kullanılamadığını unutmayın.

Üst bilgi Değer Türü Value Açıklama
accept-encoding Dize Deflate 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 için istek ö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ı.

Sonraki adımlar