Aracılığıyla paylaş

Fiyat listesi alma

  • Makale

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

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ı.

İlgili içerik