Memperbarui pengiriman add-on
Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui pengajuan add-on yang ada (juga dikenal sebagai produk dalam aplikasi atau IAP). Setelah berhasil memperbarui pengiriman dengan menggunakan metode ini, Anda harus melakukan pengiriman untuk penyerapan dan penerbitan.
Untuk informasi selengkapnya tentang bagaimana metode ini cocok dengan proses pembuatan pengiriman add-on dengan menggunakan API pengiriman Microsoft Store, lihat 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.
- Buat pengiriman add-on untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode Buat pengiriman add-on.
Minta
Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi header dan isi permintaan.
Metode | URI Permintaan |
---|---|
TARUH | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId} |
Header permintaan
Header | Tipe | Deskripsi |
---|---|---|
Authorization | string | Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<. |
Parameter permintaan
Nama | Tipe | Deskripsi |
---|---|---|
inAppProductId | string | Harus diisi. ID Penyimpanan add-on yang ingin Anda perbarui pengirimannya. ID Penyimpanan tersedia di Pusat Mitra, dan disertakan dalam data respons untuk permintaan membuat add-on atau mendapatkan detail add-on. |
submissionId | string | Harus diisi. ID pengiriman yang akan diperbarui. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman add-on. Untuk pengiriman yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman pengiriman di Pusat Mitra. |
Isi permintaan
Isi permintaan memiliki parameter berikut.
Nilai | Tipe | Deskripsi |
---|---|---|
contentType | string | Jenis konten yang disediakan dalam add-on. Ini bisa menjadi salah satu nilai berikut:
|
kata kunci | array | Array string yang berisi hingga 10 kata kunci untuk add-on. Aplikasi Anda dapat mengkueri add-on menggunakan kata kunci ini. |
lifetime | string | Masa pakai add-on. Ini bisa menjadi salah satu nilai berikut:
|
Daftar | object | Objek yang berisi info daftar untuk add-on. Untuk informasi selengkapnya, lihat Mencantumkan sumber daya. |
harga | object | Objek yang berisi info harga untuk add-on. Untuk informasi selengkapnya, lihat Sumber daya harga. |
targetPublishMode | string | Mode penerbitan untuk pengiriman. Ini bisa menjadi salah satu nilai berikut:
|
targetPublishDate | string | Tanggal penerbitan untuk pengiriman dalam format ISO 8601, jika targetPublishMode diatur ke SpecificDate. |
tag | string | Data pengembang kustom untuk add-on (informasi ini sebelumnya disebut tag). |
Visibilitas | string | Visibilitas add-on. Ini bisa menjadi salah satu nilai berikut:
|
Contoh permintaan
Contoh berikut menunjukkan cara memperbarui pengiriman add-on.
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"contentType": "EMagazine",
"keywords": [
"books"
],
"lifetime": "FiveDays",
"listings": {
"en": {
"description": "English add-on description",
"icon": {
"fileName": "add-on-en-us-listing2.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (English)"
},
"ru": {
"description": "Russian add-on description",
"icon": {
"fileName": "add-on-ru-listing.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (Russian)"
}
},
"pricing": {
"marketSpecificPricings": {
"RU": "Tier3",
"US": "Tier4",
},
"sales": [],
"priceId": "Free"
},
"targetPublishDate": "2016-03-15T05:10:58.047Z",
"targetPublishMode": "Immediate",
"tag": "SampleTag",
"visibility": "Public",
}
Respons
Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Isi respons berisi informasi tentang pengiriman yang diperbarui. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya pengiriman add-on.
{
"id": "1152921504621243680",
"contentType": "EMagazine",
"keywords": [
"books"
],
"lifetime": "FiveDays",
"listings": {
"en": {
"description": "English add-on description",
"icon": {
"fileName": "add-on-en-us-listing2.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (English)"
},
"ru": {
"description": "Russian add-on description",
"icon": {
"fileName": "add-on-ru-listing.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (Russian)"
}
},
"pricing": {
"marketSpecificPricings": {
"RU": "Tier3",
"US": "Tier4",
},
"sales": [],
"priceId": "Free"
},
"targetPublishDate": "2016-03-15T05:10:58.047Z",
"targetPublishMode": "Immediate",
"tag": "SampleTag",
"visibility": "Public",
"status": "PendingCommit",
"statusDetails": {
"errors": [
{
"code": "None",
"details": "string"
}
],
"warnings": [
{
"code": "ListingOptOutWarning",
"details": "You have removed listing language(s): []"
}
],
"certificationReports": [
{
}
]
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
"friendlyName": "Submission 2"
}
Kode kesalahan
Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.
Kode kesalahan | Deskripsi |
---|---|
400 | Pengiriman tidak dapat diperbarui karena permintaan tidak valid. |
409 | Pengiriman tidak dapat diperbarui karena status add-on saat ini, atau add-on menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store. |
Topik terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk