Memperbarui pengiriman aplikasi

Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui pengiriman aplikasi yang ada. Setelah Anda berhasil memperbarui kiriman 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 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 .

Minta

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

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

Header permintaan

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 tempat Anda ingin memperbarui kiriman. Untuk informasi selengkapnya tentang ID Toko, lihat Melihat detail identitas aplikasi.
submissionId string Wajib diisi. ID pengajuan untuk diperbarui. 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.

Isi permintaan

Badan permintaan memiliki parameter berikut.

Nilai Jenis Deskripsi
applicationKategori string String yang menentukan kategori dan/atau subkategori untuk aplikasi Anda. Kategori dan subkategori 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 publikasi untuk pengiriman. Ini bisa menjadi salah satu nilai berikut:
  • Segera
  • Manual
  • SpecificDate
targetPublishDate string Tanggal publikasi 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:
  • Sentuh
  • Keyboard
  • Tikus
  • 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 DVR game 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 melakukan pembelian di luar sistem perdagangan Microsoft Store. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
meetAccessibilityGuidelines boolean Menunjukkan apakah aplikasi Anda telah diuji untuk memenuhi pedoman aksesibilitas. Untuk informasi selengkapnya, lihat Deklarasi aplikasi.
notesUntuk Sertifikasi 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-objek ini yang diperlukan dalam badan 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 di masa mendatang.
allowTargetFutureDeviceFamilies boolean Menunjukkan apakah aplikasi Anda diizinkan untuk menargetkan keluarga perangkat Windows 10 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 badan respons JSON untuk panggilan yang berhasil ke metode ini. Badan respons berisi informasi tentang pengiriman yang diperbarui. Untuk detail selengkapnya tentang nilai di badan 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 galat

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

Kode kesalahan Deskripsi
400 Pengajuan 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.