Memperbarui persentase peluncuran untuk pengajuan aplikasi

  • Artikel
  • 2 menit untuk membaca

Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui persentase peluncuran untuk pengiriman aplikasi. Untuk informasi selengkapnya tentang proses pembuatan pengajuan aplikasi dengan menggunakan API pengiriman Microsoft Store, lihat Mengelola kiriman aplikasi.

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 AD untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakannya sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda bisa mendapatkan yang baru.
  • Buat kiriman untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukannya dengan menggunakan metode buat pengiriman aplikasi .
  • Aktifkan peluncuran paket bertahap untuk pengiriman. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan API pengiriman Microsoft Store.

Minta

Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi parameter header dan permintaan.

Metode URI Permintaan
KIRIM https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage

Meminta header

Header Jenis Deskripsi
Authorization string Wajib diisi. Token akses Azure AD dalam bentuk Bearertoken<>.

Parameter permintaan

Nama Jenis Deskripsi
applicationId string Wajib diisi. ID Toko aplikasi yang berisi kiriman dengan persentase peluncuran paket yang ingin Anda perbarui. Untuk informasi selengkapnya tentang ID Toko, lihat Melihat detail identitas aplikasi.
submissionId string Wajib diisi. ID pengiriman dengan persentase peluncuran paket yang ingin Anda perbarui. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman aplikasi. Untuk kiriman yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman pengiriman di Pusat Mitra.
persentase float Wajib diisi. Persentase pengguna yang akan menerima paket peluncuran bertahap.

Isi permintaan

Jangan memberikan badan permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara memperbarui persentase peluncuran paket untuk pengiriman aplikasi.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan badan respons JSON untuk panggilan yang berhasil ke metode ini. Untuk detail selengkapnya tentang nilai dalam badan respons, lihat Sumber daya peluncuran paket.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Kode galat

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

Kode kesalahan Deskripsi
404 Pengajuan tidak dapat ditemukan.
409 Kode ini menunjukkan salah satu kesalahan berikut: