Memperbarui pengiriman aplikasi

Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui pengiriman aplikasi yang ada. 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 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 header dan isi permintaan.

Metode Meminta URI
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

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 ingin Anda perbarui pengirimannya. Untuk informasi selengkapnya tentang ID Toko, lihat Menampilkan detail identitas aplikasi.
submissionId string Wajib diisi. ID pengiriman yang akan diperbarui. 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

Isi permintaan memiliki parameter berikut.

Nilai Jenis Deskripsi
applicationCategory string String yang menentukan kategori dan/atau subkategori untuk aplikasi Anda. Kategori dan subkataan digabungkan menjadi satu string dengan karakter garis bawah '_', seperti BooksAndReference_EReader.
Harga objek Objek yang berisi info harga untuk aplikasi. Untuk informasi selengkapnya, lihat bagian Sumber daya harga .
Visibilitas string Visibilitas aplikasi. Ini bisa menjadi salah satu nilai berikut:
  • Tersembunyi
  • Publik
  • Privat
  • NotSet
targetPublishMode string Mode penerbitan untuk pengiriman. Ini bisa menjadi salah satu nilai berikut:
  • Segera
  • Manual
  • SpecificDate
targetPublishDate string Tanggal penerbitan untuk pengiriman dalam format ISO 8601, jika targetPublishMode diatur ke SpecificDate.
Daftar objek Kamus pasangan kunci dan nilai, di mana setiap kunci adalah kode negara dan setiap nilai adalah objek sumber daya Daftar yang berisi info daftar untuk aplikasi.
hardwarePreferences array Array string yang menentukan preferensi perangkat keras untuk aplikasi Anda. Ini bisa menjadi salah satu nilai berikut:
  • Sentuhan
  • Keyboard
  • Mouse
  • Kamera
  • NfcHce
  • Nfc
  • BluetoothLE
  • Telephony
automaticBackupEnabled boolean Menunjukkan apakah Windows dapat menyertakan data aplikasi Anda dalam pencadangan otomatis ke OneDrive. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
canInstallOnRemovableMedia boolean Menunjukkan apakah pelanggan dapat menginstal aplikasi Anda ke penyimpanan yang dapat dilepas. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
isGameDvrEnabled boolean Menunjukkan apakah game DVR diaktifkan untuk aplikasi.
gamingOptions objek Array yang berisi satu sumber daya opsi game yang menentukan pengaturan terkait game untuk aplikasi.
hasExternalInAppProducts boolean Menunjukkan apakah aplikasi Anda memungkinkan pengguna untuk melakukan pembelian di luar sistem perdagangan Microsoft Store. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
meetAccessibilityGuidelines boolean Menunjukkan apakah aplikasi Anda telah diuji untuk memenuhi panduan aksesibilitas. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
notesForCertification string Berisi catatan untuk sertifikasi untuk aplikasi Anda.
applicationPackages array Berisi objek yang memberikan detail tentang setiap paket dalam pengiriman. Untuk informasi selengkapnya, lihat bagian Paket aplikasi . Saat memanggil metode ini untuk memperbarui pengiriman aplikasi, hanya nilai fileName, fileStatus, minimumDirectXVersion, dan minimumSystemRam dari objek ini yang diperlukan dalam isi permintaan. Nilai lainnya diisi oleh Pusat Mitra.
packageDeliveryOptions objek Berisi peluncuran paket bertahap dan pengaturan pembaruan wajib untuk pengiriman. Untuk informasi selengkapnya, lihat Objek opsi pengiriman paket.
EnterpriseLicensing string Salah satu nilai nilai lisensi perusahaan yang menunjukkan perilaku lisensi perusahaan untuk aplikasi.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies boolean Menunjukkan apakah Microsoft diizinkan untuk membuat aplikasi tersedia untuk keluarga perangkat Windows 10 dan Windows 11 di masa mendatang.
allowTargetFutureDeviceFamilies boolean Menunjukkan apakah aplikasi Anda diizinkan untuk menargetkan keluarga perangkat Windows 10 dan Windows 11 di masa mendatang.
Trailer array Array yang berisi hingga sumber daya trailer yang mewakili trailer video untuk daftar aplikasi.

Contoh permintaan

Contoh berikut menunjukkan cara memperbarui pengiriman aplikasi.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
		      "epub"
		    ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
		      "Free ebook reader"
		    ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

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 aplikasi.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1",
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

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 aplikasi saat ini, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.