Mengirimkan respons ke ulasan
Penting
MICROSOFT Store meninjau API, seperti yang didokumenkan dalam topik ini, saat ini tidak dalam status berfungsi. Alih-alih menggunakan API, Anda dapat mencapai tugas yang sama dengan menggunakan Pusat Mitra.
Gunakan metode ini di API ulasan Microsoft Store untuk merespons ulasan aplikasi Anda secara terprogram. Saat Anda memanggil metode ini, Anda harus menentukan ID ulasan yang ingin Anda tanggapi. ID ulasan tersedia dalam data respons metode dapatkan tinjauan aplikasi di API analitik Microsoft Store dan dalam unduhan offline laporan Ulasan.
Saat pelanggan mengirimkan ulasan, mereka dapat memilih untuk tidak menerima respons terhadap ulasan mereka. Jika Anda mencoba menanggapi ulasan yang dipilih pelanggan untuk tidak menerima respons, isi respons metode ini akan menunjukkan bahwa upaya respons tidak berhasil. Sebelum memanggil metode ini, Anda dapat secara opsional menentukan apakah Anda diizinkan untuk menanggapi ulasan tertentu dengan menggunakan info dapatkan respons untuk metode ulasan aplikasi.
Catatan
Selain menggunakan metode ini untuk merespons ulasan secara terprogram, Anda juga dapat menanggapi ulasan menggunakan Pusat Mitra.
Prasyarat
Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:
- Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API ulasan Microsoft Store.
- Dapatkan token akses Azure ACTIVE Directory untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.
- Dapatkan ID ulasan yang ingin Anda tanggapi. ID ulasan tersedia dalam data respons metode dapatkan tinjauan aplikasi di API analitik Microsoft Store dan dalam unduhan offline laporan Ulasan.
Minta
Minta sintaks
| Metode | URI Permintaan |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses |
Header permintaan
| Header | Tipe | Deskripsi |
|---|---|---|
| Authorization | string | Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<. |
Parameter permintaan
Metode ini tidak memiliki parameter permintaan.
Isi permintaan
Isi permintaan memiliki nilai berikut.
| Nilai | Tipe | Deskripsi |
|---|---|---|
| Respons | array | Array objek yang berisi data respons yang ingin Anda kirimkan. Untuk informasi selengkapnya tentang data di setiap objek, lihat tabel berikut ini. |
Setiap objek dalam array Respons berisi nilai berikut.
| Nilai | Tipe | Deskripsi | Wajib diisi |
|---|---|---|---|
| ApplicationId | string | ID Toko aplikasi dengan ulasan yang ingin Anda tanggapi. ID Penyimpanan tersedia di halaman Identitas aplikasi pusat mitra. Contoh ID Penyimpanan adalah 9WZDNCRFJ3Q8. | Ya |
| ReviewId | string | ID ulasan yang ingin Anda tanggapi (ini adalah GUID). ID ulasan tersedia dalam data respons metode dapatkan tinjauan aplikasi di API analitik Microsoft Store dan dalam unduhan offline laporan Ulasan. | Ya |
| ResponseText | string | Respons yang ingin Anda kirimkan. Respons Anda harus mengikuti panduan ini. | Ya |
| SupportEmail | string | Alamat email dukungan aplikasi Anda, yang dapat digunakan pelanggan untuk menghubungi Anda secara langsung. Ini harus berupa alamat email yang valid. | Ya |
| IsPublic | Boolean | Jika Anda menentukan true, respons Anda akan ditampilkan di daftar Store aplikasi Anda, tepat di bawah ulasan pelanggan, dan akan terlihat oleh semua pelanggan. Jika Anda menentukan false dan pengguna belum menolak menerima respons email, respons Anda akan dikirim ke pelanggan melalui email, dan tidak akan terlihat oleh pelanggan lain di daftar Toko aplikasi Anda. Jika Anda menentukan false dan pengguna telah memilih untuk tidak menerima respons email, kesalahan akan dikembalikan. | Ya |
Contoh permintaan
Contoh berikut menunjukkan cara menggunakan metode ini untuk mengirimkan respons ke beberapa ulasan.
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"Responses": [
{
"ApplicationId": "9WZDNCRFJ3Q8",
"ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
"ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
"SupportEmail": "support@contoso.com",
"IsPublic": true
},
{
"ApplicationId": "9NBLGGH1RP08",
"ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
"ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
"SupportEmail": "support@contoso.com",
"IsPublic": false
}
]
}
Respons
Isi respons
| Nilai | Tipe | Description |
|---|---|---|
| Hasil | array | Array objek yang berisi data tentang setiap respons yang Anda kirimkan. Untuk informasi selengkapnya tentang data di setiap objek, lihat tabel berikut ini. |
Setiap objek dalam array Hasil berisi nilai berikut.
| Nilai | Tipe | Deskripsi |
|---|---|---|
| ApplicationId | string | ID Toko aplikasi dengan ulasan yang Anda tanggapi. Contoh ID Penyimpanan adalah 9WZDNCRFJ3Q8. |
| ReviewId | string | ID ulasan yang Anda tanggapi. Ini adalah GUID. |
| Berhasil | string | Nilai true menunjukkan bahwa respons Anda berhasil dikirim. Nilai false menunjukkan bahwa respons Anda tidak berhasil. |
| FailureReason | string | Jika Berhasil salah, nilai ini berisi alasan kegagalan. Jika Berhasil benar, nilai ini kosong. |
Contoh tanggapan
Contoh berikut menunjukkan contoh isi respons JSON untuk permintaan ini.
{
"Result": [
{
"ApplicationId": "9WZDNCRFJ3Q8",
"ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
"Successful": "true",
"FailureReason": ""
},
{
"ApplicationId": "9NBLGGH1RP08",
"ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
"Successful": "false",
"FailureReason": "No Permission"
}
]
}