Merespons ulasan menggunakan layanan Store
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 API ulasan Microsoft Store untuk merespons ulasan aplikasi Anda secara terprogram di Store. API ini sangat berguna bagi pengembang yang ingin menanggapi banyak ulasan secara massal tanpa menggunakan Pusat Mitra. API ini menggunakan Azure Active Directory (Azure AD) untuk mengautentikasi panggilan dari aplikasi atau layanan Anda.
Langkah-langkah berikut ini menjelaskan proses end-to-end:
- Pastikan Anda telah menyelesaikan semua prasyarat.
- Sebelum Anda memanggil metode di API ulasan Microsoft Store, dapatkan token akses Microsoft Azure ACTIVE Directory. Setelah mendapatkan token, Anda memiliki waktu 60 menit untuk menggunakan token ini dalam panggilan ke API ulasan Microsoft Store sebelum token kedaluwarsa. Setelah token kedaluwarsa, Anda dapat menghasilkan token baru.
- Hubungi API ulasan Microsoft Store.
Catatan
Selain menggunakan API ulasan Microsoft Store untuk merespons ulasan secara terprogram, Anda dapat menanggapi ulasan menggunakan Pusat Mitra secara alternatif.
Langkah 1: Selesaikan prasyarat untuk menggunakan API ulasan Microsoft Store
Sebelum Anda mulai menulis kode untuk memanggil API ulasan Microsoft Store, pastikan Anda telah menyelesaikan prasyarat berikut.
Anda (atau organisasi Anda) harus memiliki direktori Azure Active Directory dan harus memiliki izin Administrator perusahaan untuk direktori tersebut. Jika sudah menggunakan Microsoft 365 atau layanan bisnis lainnya dari Microsoft, Anda sudah memiliki direktori Azure Active Directory. Jika tidak, Anda dapat membuat Azure AD baru di Pusat Mitra tanpa biaya tambahan.
Anda harus mengaitkan aplikasi Microsoft Azure AD dengan akun Pusat Mitra Anda, mengambil ID penyewa dan ID klien untuk aplikasi dan membuat kunci. Aplikasi Microsoft Azure ACTIVE Directory mewakili aplikasi atau layanan tempat Anda ingin memanggil API ulasan Microsoft Store. Anda memerlukan ID penyewa, ID klien, dan kunci untuk mendapatkan token akses Azure Active Directory yang Anda berikan ke API.
Catatan
Anda hanya perlu melakukan tugas ini satu kali. Setelah memiliki ID penyewa, ID klien, dan kunci, Anda dapat menggunakannya kembali kapan saja Anda perlu untuk membuat token akses Azure Active Directory baru.
Untuk mengaitkan aplikasi Microsoft Azure AD dengan akun Pusat Mitra Anda dan mengambil nilai yang diperlukan:
Di Pusat Mitra, kaitkan akun Pusat Mitra organisasi dengan direktori Azure Active Directory organisasi Anda.
Selanjutnya, dari halaman Pengguna di bagian Pengaturan akun di Pusat Mitra, tambahkan aplikasi Microsoft Azure ACTIVE Directory yang mewakili aplikasi atau layanan yang akan Anda gunakan untuk merespons ulasan. Pastikan Anda menetapkan aplikasi ini sebagai peranManajer. Jika aplikasi belum ada di direktori Azure Active Directory, Anda dapat membuat aplikasi Azure Active Directory baru di Pusat Mitra.
Kembali ke halaman Pengguna, klik nama aplikasi Azure Active Directory Anda untuk masuk ke pengaturan aplikasi, dan salin nilai ID Penyewa dan ID Klien.
Klik Tambahkan kunci baru. Pada layar berikut, salin nilai Kunci. Anda tidak akan dapat mengakses info ini lagi setelah meninggalkan halaman ini. Untuk informasi selengkapnya, lihat Mengelola kunci untuk aplikasi Azure Active Directory.
Langkah 2: Mendapatkan token akses Azure Active Directory
Sebelum memanggil salah satu metode di API ulasan Microsoft Store, Anda harus terlebih dahulu mendapatkan token akses Microsoft Azure AD yang Anda teruskan ke header Otorisasi dari setiap metode di API. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat merefresh token sehingga Anda dapat terus menggunakannya dalam panggilan lebih lanjut ke API.
Untuk mendapatkan token akses, ikuti instruksi dalam Panggilan Layanan ke Layanan Menggunakan Kredensial Klien untuk mengirim HTTP POST ke https://login.microsoftonline.com/<tenant_id>/oauth2/token titik akhir. Berikut adalah contoh permintaan.
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com
Untuk nilai tenant_id di POST URI dan parameter client_id dan client_secret, tentukan ID penyewa, ID klien, dan kunci untuk aplikasi yang Anda ambil dari Pusat Mitra di bagian sebelumnya. Untuk parameter sumber daya, Anda harus menentukan https://manage.devcenter.microsoft.com.
Setelah token akses kedaluwarsa, Anda dapat merefreshnya dengan mengikuti instruksi di sini.
Langkah 3: Panggil API ulasan Microsoft Store
Setelah Anda memiliki token akses Microsoft Azure AD, Anda siap untuk memanggil API tinjauan Microsoft Store. Anda harus meneruskan token akses ke header Otorisasi dari setiap metode.
API ulasan Microsoft Store berisi beberapa metode yang dapat Anda gunakan untuk menentukan apakah Anda diizinkan untuk menanggapi ulasan tertentu dan mengirimkan respons ke satu atau beberapa ulasan. Ikuti proses ini untuk menggunakan API ini:
- 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](/windows/apps/publish/reviews-report).
- Panggil metode dapatkan info respons untuk tinjauan aplikasi untuk menentukan apakah Anda diizinkan untuk merespons ulasan. Saat pelanggan mengirimkan ulasan, mereka dapat memilih untuk tidak menerima respons terhadap ulasan mereka. Anda tidak dapat menanggapi ulasan yang dikirimkan oleh pelanggan yang telah memilih untuk tidak menerima respons peninjauan.
- Hubungi metode kirim respons ke ulasan aplikasi untuk merespons ulasan secara terprogram.