Aracılığıyla paylaş


Eklenti gönderimi oluşturma

İş Ortağı Merkezi hesabınıza kayıtlı bir uygulama için yeni bir eklenti (uygulama içi ürün veya IAP olarak da bilinir) gönderimi oluşturmak için Microsoft Store gönderim API'sinde bu yöntemi kullanın. Bu yöntemi kullanarak yeni bir gönderimi başarıyla oluşturduktan sonra gönderimi güncelleştirerek gönderim verisinde gerekli değişiklikleri yapın ve ardından gönderimi alma ve yayımlama amacıyla işleyin .

Bu yöntemin Microsoft Store gönderim API'sini kullanarak eklenti gönderimi oluşturma işlemine nasıl uyum sağladığı hakkında daha fazla bilgi için bkz.eklenti gönderimlerini yönetme .

Uyarı

Bu yöntem, mevcut bir eklenti için bir gönderim oluşturur. Eklenti oluşturmak için Eklenti oluşturma yöntemini kullanın.

Önkoşullar

Bu yöntemi kullanmak için önce aşağıdakileri yapmanız gerekir:

  • Henüz yapmadıysanız Microsoft Store gönderim API'sinin tüm önkoşullarını tamamlayın.
  • Bu yöntemin istek üst bilgisinde kullanmak üzere bir Azure AD erişim belirteci alın. Erişim belirtecini aldıktan sonra süresi dolmadan önce kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra yenisini alabilirsiniz.
  • Uygulamalarınızdan biri için bir eklenti oluşturun. Bunu İş Ortağı Merkezi'nde yapabilir veya Eklenti oluşturma yöntemini kullanarak yapabilirsiniz.

İstek

Bu yöntem aşağıdaki söz dizimine sahiptir. Başlık ve istek gövdesinin kullanım örnekleri ve açıklamaları için aşağıdaki bölümlere bakın.

Yöntem İstenilen URI
PAYLAŞ https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

İstek başlığı

Başlık Türü Açıklama
İzin String Gerekli. Azure AD erişim belirteci Bearer<token> biçimindedir.

İstek parametreleri

İsim Türü Açıklama
UygulamaİçiÜrünId String Gerekli. Gönderimini oluşturmak istediğiniz eklenti için Mağaza Kimliği. Mağaza Kimliği İş Ortağı Merkezi'nde bulunur ve Eklenti oluşturma oluşturma veya eklenti ayrıntılarını alma isteklerine yönelik yanıt verilerine eklenir.

İstek içeriği

Bu yöntem için bir talep içeriği sağlamayın.

Örnek talep

Aşağıdaki örnekte, eklenti için yeni bir gönderimin nasıl oluşturulacağı gösterilmektedir.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions HTTP/1.1
Authorization: Bearer <your access token>

Yanıt

Aşağıdaki örnek, bu yönteme başarılı bir çağrı için JSON yanıt gövdesini gösterir. Yanıt gövdesi, yeni gönderim hakkında bilgi içerir. Yanıt gövdesindeki değerler hakkında daha fazla bilgi için bkz. eklenti gönderme kaynağı.

{
  "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": [
      {
         "name": "Sale1",
         "basePriceId": "Free",
         "startDate": "2016-05-21T18:40:11.7369008Z",
         "endDate": "2016-05-22T18:40:11.7369008Z",
         "marketSpecificPricings": {
            "RU": "NotAvailable"
         }
      }
    ],
    "priceId": "Free",
    "isAdvancedPricingModel": true
  },
  "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"
}

Hata kodları

İstek başarıyla tamamlanamazsa, yanıt aşağıdaki HTTP hata kodlarından birini içerir.

Hata kodu Açıklama
400 İstek geçersiz olduğundan gönderim oluşturulamadı.
409 Uygulamanın mevcut durumu nedeniyle gönderim oluşturulamadı veya uygulama, şu anda Microsoft Store gönderim API'sitarafından desteklenmeyen bir İş Ortağı Merkezi özelliği kullanıyor.