Mengunduh margin

Berlaku untuk: Pusat Mitra

Peran yang sesuai: Agen administrator

Mitra bisa mendapatkan daftar margin aktif untuk mitra tertentu. Metode ini mengembalikan margin berdasarkan mitra dan tanggal mulai dan berakhir yang tersedia. Download margins mengembalikan data dalam format yang dibatasi koma.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

Permintaan REST

[GET] /v1/margins/download

Sintaks permintaan

Metode URI Permintaan
DAPATKAN {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

Untuk daftar kode negara, lihat Kode negara, wilayah, negara bagian, dan provinsi penjualan bersama.

Parameter URI

Tabel ini mencantumkan parameter kueri yang diperlukan.

Nama Tipe Wajib Deskripsi
negara String Y Nilainya adalah string yang menunjukkan kode negara.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Partner Center.

Isi permintaan

Tidak

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/margins/download?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Respons REST

Jika berhasil, metode ini mengembalikan daftar harga sebagai aliran file sebagai file a.csv

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 lebih banyak parameter. Untuk daftar lengkapnya, lihat Kode Kesalahan.

Contoh tanggapan

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

"b82103f870af_e71f19b1-27cf-43d3-be46-3d87a9d908a2","US","Percentage","Test PMC 2 PC","DZH318Z0FTST","HelloWorld3","0002","plan1","Dynamics 365","3b274863-227e-4b2c-a463-330b949e2e34","3pptesting","8.0","","","","","","","","","8/14/2023 6:09:28 PM","10/31/2023 11:59:59 PM","live","8/14/2023 6:09:28 PM"