Bagikan melalui

Mendapatkan data aplikasi

  • Artikel

Gunakan metode berikut di API pengiriman Microsoft Store untuk mendapatkan data untuk aplikasi yang ada di akun Pusat Mitra Anda. Untuk pengenalan API pengiriman Microsoft Store, termasuk prasyarat untuk menggunakan API, lihat Membuat dan mengelola pengiriman menggunakan layanan Microsoft Store.

Sebelum Anda dapat menggunakan metode ini, aplikasi harus sudah ada di akun Pusat Mitra Anda. Untuk membuat atau mengelola pengiriman untuk aplikasi, lihat metode di Mengelola pengiriman aplikasi.

Metode URI Deskripsi
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Mendapatkan data untuk semua aplikasi Anda
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Mendapatkan data untuk aplikasi tertentu
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Mendapatkan add-on untuk aplikasi
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Mendapatkan penerbangan paket untuk aplikasi

Prasyarat

Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API pengiriman Microsoft Store sebelum mencoba menggunakan salah satu metode ini.

Sumber daya data

Metode API pengiriman Microsoft Store untuk mendapatkan data aplikasi menggunakan sumber daya data JSON berikut.

Sumber daya aplikasi

Sumber daya ini mewakili aplikasi yang didaftarkan ke akun Anda.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Sumber daya ini memiliki nilai berikut.

Nilai Tipe Deskripsi
id string ID Toko aplikasi. Untuk informasi selengkapnya tentang ID Penyimpanan, lihat Menampilkan detail identitas aplikasi.
primaryName string Nama utama aplikasi.
packageFamilyName string Nama keluarga paket aplikasi.
packageIdentityName string Nama identitas paket aplikasi.
publisherName string ID penerbit Windows yang terkait dengan aplikasi. Ini sesuai dengan nilai Paket/Identitas/Penerbit yang muncul di halaman Identitas aplikasi untuk aplikasi di Pusat Mitra.
firstPublishedDate string Tanggal aplikasi pertama kali diterbitkan, dalam format ISO 8601.
lastPublishedApplicationSubmission object Sumber daya pengiriman yang menyediakan informasi tentang pengiriman terakhir yang diterbitkan untuk aplikasi.
pendingApplicationSubmission object Sumber daya pengiriman yang menyediakan informasi tentang pengiriman yang tertunda saat ini untuk aplikasi.
hasAdvancedListingPermission Boolean Menunjukkan apakah Anda dapat mengonfigurasi gamingOptions atau trailer untuk pengiriman untuk aplikasi. Nilai ini berlaku untuk pengiriman yang dibuat setelah Mei 2017.

Sumber daya add-on

Sumber daya ini menyediakan informasi tentang add-on.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Sumber daya ini memiliki nilai berikut.

Nilai Tipe Deskripsi
inAppProductId string ID Penyimpanan add-on. Nilai ini disediakan oleh Store. Contoh ID Penyimpanan adalah 9NBLGGH4TNMP.

Sumber daya penerbangan

Sumber daya ini menyediakan informasi tentang penerbangan paket untuk aplikasi.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Sumber daya ini memiliki nilai berikut.

Nilai Tipe Deskripsi
flightId string ID untuk penerbangan paket. Nilai ini disediakan oleh Pusat Mitra.
friendlyName string Nama penerbangan paket, seperti yang ditentukan oleh pengembang.
lastPublishedFlightSubmission object Sumber daya pengiriman yang menyediakan informasi tentang pengiriman terakhir yang diterbitkan untuk penerbangan paket.
pendingFlightSubmission object Sumber daya pengiriman yang menyediakan informasi tentang pengiriman yang tertunda saat ini untuk penerbangan paket.
groupIds array Array string yang berisi ID grup penerbangan yang terkait dengan penerbangan paket. Untuk informasi selengkapnya tentang grup penerbangan, lihat Penerbangan paket.
rankHigherThan string Nama yang ramah dari penerbangan paket yang diberi peringkat langsung lebih rendah dari penerbangan paket saat ini. Untuk informasi selengkapnya tentang peringkat grup penerbangan, lihat Penerbangan paket.

Sumber daya pengiriman

Sumber daya ini menyediakan informasi tentang pengiriman. Contoh berikut menunjukkan format sumber daya ini.

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Sumber daya ini memiliki nilai berikut.

Nilai Tipe Deskripsi
id string ID pengiriman.
resourceLocation string Jalur relatif yang dapat Anda tambahkan ke URI permintaan dasar https://manage.devcenter.microsoft.com/v1.0/my/ untuk mengambil data lengkap untuk pengiriman.