Mendapatkan info peluncuran untuk pengiriman aplikasi

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk mendapatkan info peluncuran paket untuk pengiriman penerbangan paket. Untuk informasi selengkapnya tentang proses pembuatan pengiriman aplikasi dengan menggunakan API pengiriman Microsoft Store, lihat Mengelola pengiriman 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 dapat memperoleh yang baru.
  • Buat pengiriman untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode buat pengiriman aplikasi .

Minta

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

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

Meminta kop

Header Jenis Deskripsi
Authorization string Wajib diisi. Token akses Azure AD dalam bentuktoken>Pembawa<.

Parameter permintaan

Nama Jenis Deskripsi
applicationId string Wajib diisi. ID Toko aplikasi yang berisi pengiriman dengan info peluncuran paket yang ingin Anda dapatkan. Untuk informasi selengkapnya tentang ID Toko, lihat Menampilkan detail identitas aplikasi.
submissionId string Wajib diisi. ID pengiriman dengan info peluncuran paket yang ingin Anda dapatkan. ID ini tersedia dalam data respons untuk permintaan untuk membuat pengiriman aplikasi. 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 mendapatkan info peluncuran paket untuk pengiriman aplikasi.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini untuk pengiriman aplikasi dengan peluncuran paket bertahap diaktifkan. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya peluncuran paket.

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

Jika pengiriman aplikasi tidak mengaktifkan peluncuran paket bertahap, isi respons berikut akan dikembalikan.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

Kode kesalahan

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

Kode kesalahan Deskripsi
404 Pengiriman tidak dapat ditemukan.
409 Pengiriman bukan milik aplikasi yang ditentukan, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.