Bagikan melalui

Mendapatkan lembar harga

  • Artikel

Artikel ini menjelaskan cara mendapatkan lembar harga untuk pasar dan tampilan tertentu. Metode ini mendukung filter untuk mendapatkan riwayat menurut bulan.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi API Mitra. Skenario ini hanya mendukung autentikasi pengguna aplikasi. Khusus aplikasi belum didukung. Mitra yang mengalami kesalahan http:400 harus berkonsultasi dengan dokumentasi autentikasi API Mitra.
  • API ini saat ini hanya mendukung akses pengguna di mana mitra harus berada dalam salah satu peran berikut: Admin Global, Agen Admin, atau Agen Penjualan.

Detail

  • Saat ini mengembalikan data hanya untuk konsumsi dan reservasi paket Azure, Berbasis lisensi (pengalaman perdagangan baru), dan produk Marketplace.
  • Harga saat ini mencakup semua meter dan produk yang tersedia selama bulan ini hingga tanggal API dipanggil. Bulan-bulan sebelumnya mencakup semua meter dan produk yang tersedia untuk bulan tertentu.
  • Harga meter konsumsi hanya dalam USD, mitra menggunakan API nilai tukar mata uang asing untuk menghitung biaya mata uang lokal.
  • Harga meter konsumsi diperkirakan harga eceran. Diskon mitra tersedia melalui kredit yang diperoleh mitra.
  • Harga meter reservasi termasuk diskon mitra CSP. Estimasi harga ritel untuk reservasi dapat ditemukan di reservasi layanan bersama yang dapat diunduh dari halaman "Harga dan penawaran" Pusat Mitra.
  • Informasi selengkapnya tentang harga paket Azure dapat ditemukan dalam dokumentasi harga paket Azure.
  • Harga mitra dan API nilai tukar mata uang asing bukan bagian dari SDK Pusat Mitra.
  • Metode ini mengembalikan daftar harga sebagai aliran file. Aliran file adalah file .csv atau versi zip terkompresi dari .csv. Detail tentang cara meminta file terkompresi disertakan di bawah ini.

Permintaan REST

Minta sintaks

Metode URI Permintaan
DAPATKAN https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Parameter yang diperlukan URI

Gunakan parameter jalur berikut untuk meminta pasar dan jenis lembar harga yang Anda inginkan.

Nama Tipe Wajib Deskripsi
Pasar string Ya Kode negara/wilayah dua huruf untuk pasar yang diminta
PricesheetView string Ya Jenis lembar harga yang diminta, yang dapat azure_consumption, azure_reservations, updatedlicensebased, marketplace, atau perangkat lunak.

Catatan

updatelicensebased PriceSheetView saat ini hanya tersedia untuk mitra yang merupakan bagian dari pratinjau teknis pengalaman perdagangan baru Microsoft 365/Microsoft Dynamics 365.

Catatan

Daftar harga perangkat lunak akan tersedia melalui API mulai 1 April 2022.

Parameter filter URI

Gunakan parameter filter berikut.

Nama Tipe Wajib Deskripsi
Garis Waktu string No Default ke saat ini jika tidak diteruskan. Nilai yang mungkin adalah riwayat, saat ini, dan masa depan.
Month string No Hanya diperlukan jika riwayat diminta, harus mematuhi YYYYMM untuk lembar harga yang diminta.

Catatan

Harga di masa mendatang tidak didukung untuk Marketplace. Mulai 1 April 2022, mitra akan dapat melihat riwayat daftar harga perangkat lunak melalui API, dimulai dengan riwayat Maret 2022.

Header permintaan

  • Untuk informasi selengkapnya, lihat Header REST Mitra.

Selain header di atas, file harga dapat diambil sebagai bandwidth pengurangan terkompresi dan waktu pengunduhan. Secara default, file tidak dikompresi. Untuk mendapatkan versi file yang dikompresi, Anda dapat menyertakan nilai header di bawah ini. Sadari bahwa lembar terkompresi hanya tersedia mulai April 2020 dan seterusnya, semua lembar sebelum April 2020 hanya tersedia sebagai tidak dikompresi.

Header Jenis Nilai Nilai Deskripsi
Accept-Encoding string Mengempis Opsional. Jika aliran file yang dihilangkan tidak dikompresi.

Contoh permintaan

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

Contoh permintaan untuk perdagangan baru

Catatan

updatelicensebased PriceSheetView saat ini hanya tersedia untuk mitra yang merupakan bagian dari pratinjau teknis pengalaman perdagangan baru Microsoft 365/Microsoft Dynamics 365.

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

Respons REST

Jika berhasil, metode ini mengembalikan daftar harga sebagai aliran file. Aliran file adalah file .csv atau versi zip terkompresi dari .csv.

Contoh respons untuk perdagangan baru

Catatan

updatelicensebased PriceSheetView saat ini hanya tersedia untuk mitra yang merupakan bagian dari pratinjau teknis pengalaman perdagangan baru Microsoft 365/Microsoft Dynamics 365.

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 ==============

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode Kesalahan.

Jika tidak ada perubahan yang diharapkan untuk daftar harga mendatang berbasis lisensi perdagangan baru, tidak akan ada daftar harga di masa mendatang yang dikembalikan. Saat meneruskan masa depan ke Timeline yang diminta untuk PriceSheetView yang diperbaruilicensebased, mitra akan melihat kode respons API berikut: 404 Tidak Ditemukan.

Langkah berikutnya