Membuat add-on
Gunakan metode ini di API pengiriman Microsoft Store untuk membuat add-on (juga dikenal sebagai produk dalam aplikasi atau IAP) untuk aplikasi yang terdaftar ke akun Pusat Mitra Anda.
Catatan
Metode ini membuat add-on tanpa pengiriman apa pun. Untuk membuat pengiriman untuk add-on, lihat metode dalam Mengelola pengiriman add-on.
Prasyarat
Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:
- Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API pengiriman 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.
Minta
Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi header dan isi permintaan.
Metode | URI Permintaan |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts |
Header permintaan
Header | Tipe | Deskripsi |
---|---|---|
Authorization | string | Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<. |
Isi permintaan
Isi permintaan memiliki parameter berikut.
Parameter | Jenis | Deskripsi | Wajib diisi |
---|---|---|---|
applicationIds | array | Array yang berisi ID Toko aplikasi yang dikaitkan dengan add-on ini. Hanya satu item yang didukung dalam array ini. | Ya |
productId | string | ID produk add-on. Ini adalah pengidentifikasi yang dapat digunakan dalam kode untuk merujuk ke add-on. Untuk informasi selengkapnya, lihat Mengatur jenis produk dan ID produk Anda. | Ya |
productType | string | Jenis produk add-on. Nilai berikut didukung: Tahan Lama dan Dapat Dikonsumsi. | Ya |
Contoh permintaan
Contoh berikut menunjukkan cara membuat add-on baru yang dapat dikonsumsi untuk aplikasi.
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
"applicationIds": [ "9NBLGGH4R315" ],
"productId": "my-new-add-on",
"productType": "Consumable",
}
Respons
Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat sumber daya add-on.
{
"applications": {
"value": [
{
"id": "9NBLGGH4R315",
"resourceLocation": "applications/9NBLGGH4R315"
}
],
"totalCount": 1
},
"id": "9NBLGGH4TNMP",
"productId": "my-new-add-on",
"productType": "Consumable",
}
Kode kesalahan
Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.
Kode kesalahan | Deskripsi |
---|---|
400 | Permintaan tidak valid. |
409 | Add-on tidak dapat dibuat karena statusnya saat ini, atau add-on menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store. |