Bagikan melalui

Menerapkan pengiriman add-on

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk menerapkan pengajuan add-on baru atau yang diperbarui (juga dikenal sebagai produk dalam aplikasi atau IAP) ke Pusat Mitra. Tindakan penerapan memperingatkan Pusat Mitra bahwa data pengiriman telah diunggah (termasuk ikon terkait). Sebagai respons, Pusat Mitra menerapkan perubahan pada data pengiriman untuk penyerapan dan penerbitan. Setelah operasi penerapan berhasil, perubahan pada pengiriman ditampilkan di Pusat Mitra.

Untuk informasi selengkapnya tentang bagaimana operasi penerapan sesuai dengan proses 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 lalu perbarui pengiriman dengan perubahan yang diperlukan pada data pengiriman.

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/{inAppProductId}/submissions/{submissionId}/commit

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 berisi pengiriman yang ingin Anda terapkan. ID Penyimpanan tersedia di Pusat Mitra, dan disertakan dalam data respons untuk permintaan mendapatkan semua add-on dan Membuat add-on.
submissionId string Harus diisi. ID pengiriman yang ingin Anda terapkan. 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

Jangan berikan isi permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara menerapkan pengiriman add-on.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat bagian berikut ini.

{
  "status": "CommitStarted"
}

Isi respons

Nilai Tipe Deskripsi
status string Status pengiriman. Ini bisa menjadi salah satu nilai berikut:
  • Tidak ada
  • Dibatalkan
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Menerbitkan
  • Diterbitkan
  • PublishFailed
  • Preprocessing
  • PreProcessingFailed
  • Sertifikasi
  • CertificationFailed
  • Lepaskan
  • ReleaseFailed

Kode kesalahan

Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.

Kode kesalahan Deskripsi
400 Parameter permintaan tidak valid.
404 Pengiriman yang ditentukan tidak dapat ditemukan.
409 Pengiriman yang ditentukan ditemukan tetapi tidak dapat dilakukan dalam statusnya saat ini, atau add-on menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.