Aracılığıyla paylaş

Teklif matrisi alma

  • Makale

Bu makalede belirli bir ay için teklif matrisi alma açıklanmaktadır. Teklif matrisi, ürünler ve sku'lar için özellikler ve satın alma kuralları içerir. 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 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: Yönetici Aracısı veya Satış Aracısı.

Ayrıntılar

  • Current yalnızca güncelleştirilmiş yeni ticaret lisansı tabanlı ürünler için veri döndürür.
  • Geçerli fiyatlandırma, API'nin çağrıldığı tarihe kadar geçerli ay içinde kullanılabilen ürünleri içerir. Önceki aylar, seçilen ayın son gününden itibaren tarihi içerir.
  • Bu yöntem, verileri 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 istenecekleriyle ilgili ayrıntılar aşağıdaki adımları izler.

REST isteği

İstek söz dizimi

Metot İstek URI'si
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

URI filtre parametreleri

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

Adı Tür Zorunlu Açıklama
Month Dize Hayır İstenen fiyat listesi için YYYYMM'ye uyulmalıdır.

İstek üst bilgileri

Bu ü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ılmamış olarak mevcut olduğunu unutmayın.

Üst bilgi Değer Türü Değer Açıklama
Kabul Edilen Kodlama (Accept-Encoding) Dize Havasını boşaltmak isteğe bağlı. Atlanırsa, dosya akışı sıkıştırılamaz.

İstek örneği

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST yanıtı

Başarılı olursa, bu yöntem dosya akışı olarak bir teklif matrisi döndürür. Dosya akışı, .csv bir dosya veya .csv zip sıkıştırılmış sürümüdür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.

Yanıt örneği

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

İlgili içerik