Memperbarui pengiriman add-on

Gunakan metode ini di API pengiriman Microsoft Store untuk memperbarui pengiriman add-on yang ada (juga dikenal sebagai produk dalam aplikasi atau IAP). 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 add-on dengan menggunakan API pengiriman Microsoft Store, lihat Mengelola pengiriman add-on.

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 pengiriman add-on untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode Buat pengiriman add-on .

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/inappproducts/{inAppProductId}/submissions/{submissionId}

Header permintaan

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

Parameter permintaan

Nama Jenis Deskripsi
inAppProductId string Wajib diisi. ID Toko add-on yang ingin Anda perbarui kiriman. ID Toko tersedia di Pusat Mitra, dan disertakan dalam data respons untuk permintaan Membuat add-on atau mendapatkan detail add-on.
submissionId string Wajib diisi. ID pengajuan untuk diperbarui. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman add-on. 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
contentType string Jenis konten yang disediakan dalam add-on. Ini bisa menjadi salah satu nilai berikut:
  • NotSet
  • Unduh Buku
  • EMagazine
  • ENewspaper
  • MusikDownload
  • Aliran Musik
  • OnlineDataStorage
  • Unduh Video
  • Streaming Video
  • Asp
  • Unduh Online
kata kunci array Array string yang berisi hingga 10 kata kunci untuk add-on. Aplikasi Anda dapat meminta add-on menggunakan kata kunci ini.
Seumur hidup string Masa pakai add-on. Ini bisa menjadi salah satu nilai berikut:
  • Selamanya
  • Satu Hari
  • Tiga Hari
  • Lima Hari
  • Satu Minggu
  • Dua Minggu
  • OneMonth
  • Dua Bulan
  • Tiga Bulan
  • Enam Bulan
  • Satu Tahun
Daftar objek Objek yang berisi info daftar untuk add-on. Untuk informasi selengkapnya, lihat Mencantumkan sumber daya.
Harga objek Objek yang berisi info harga untuk add-on. Untuk informasi selengkapnya, lihat Sumber daya harga.
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.
tag string Data pengembang kustom untuk add-on (informasi ini sebelumnya disebut tag).
Visibilitas string Visibilitas add-on. Ini bisa menjadi salah satu nilai berikut:
  • Tersembunyi
  • Publik
  • Privat
  • NotSet

Contoh permintaan

Contoh berikut menunjukkan cara memperbarui pengiriman add-on.

PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
}

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 add-on.

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
  "friendlyName": "Submission 2"
}

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