Freigeben über

Erstellen einer Add-On-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue Add-On-Übermittlung (auch als In-App-Produkt oder IAP bezeichnet) für eine App zu erstellen, die für Ihr Partner Center-Konto registriert ist. Nachdem Sie eine neue Übermittlung mithilfe dieser Methode erfolgreich erstellt haben, aktualisieren Sie die Übermittlung so, dass alle erforderlichen Änderungen an den Übermittlungsdaten vorgenommen werden, und übernehmen Sie dann die Übermittlung für die Aufnahme und Veröffentlichung.

Weitere Informationen dazu, wie diese Methode in den Prozess der Erstellung einer Add-On-Übermittlung mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Add-On-Übermittlungen.

Hinweis

Diese Methode erstellt eine Übermittlung für ein vorhandenes Add-On. Verwenden Sie zum Erstellen eines Add-Ons die Methode "Add-On erstellen".

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

Anfordern

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.

Methode Anforderungs-URI
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Name Typ Beschreibung
inAppProductId Zeichenfolge Erforderlich. Die Store-ID des Add-Ons, für das Sie eine Übermittlung erstellen möchten. Die Store-ID ist im Partner Center verfügbar und ist in den Antwortdaten für Anforderungen zum Erstellen eines Add-Ons oder Abrufen von Add-On-Details enthalten.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Anforderungsbeispiel

Im folgenden Beispiel wird das Erstellen einer neuen Übermittlung für ein Add-On veranschaulicht.

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

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Der Antworttext enthält Informationen zur neuen Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie in der Add-On-Übermittlungsressource.

{
  "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"
}

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode Beschreibung
400 Die Übermittlung konnte nicht erstellt werden, da die Anforderung ungültig ist.
409 Die Übermittlung konnte aufgrund des aktuellen Zustands der App nicht erstellt werden, oder die App verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird.