Erstellen einer Add-On-ÜbermittlungCreate an add-on submission

Verwenden Sie diese Methode in der Microsoft Store-Übermittlung API, um eine neue Add-on (auch bekannt als in-app-Produkt oder IAP) Eingabe für eine app zu erstellen, die mit Ihrem Partner Center-Konto registriert ist.Use this method in the Microsoft Store submission API to create a new add-on (also known as in-app product or IAP) submission for an app that is registered to your Partner Center account. Nachdem Sie erfolgreich eine neue Übermittlung mit dieser Methode erstellt haben, aktualisieren Sie die Übermittlung, um erforderliche Änderungen an den Übermittlungsdaten vorzunehmen, und führen Sie ein Commit für die Übermittlung zur Aufnahme und Veröffentlichung durch.After you successfully create a new submission by using this method, update the submission to make any necessary changes to the submission data, and then commit the submission for ingestion and publishing.

Weitere Informationen dazu, wie diese Methode zum Erstellen einer Add-On-Übermittlung mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Add-On-Übermittlungen.For more information about how this method fits into the process of creating an add-on submission by using the Microsoft Store submission API, see Manage add-on submissions.

Hinweis

Durch diese Methode wird eine Übermittlung für ein vorhandenes Add-On erstellt.This method creates a submission for an existing add-on. Um ein Add-On zu erstellen, verwenden Sie die Methode zum Erstellen eines Add-Ons.To create an add-on, use the Create an add-on method.

VorraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

  • Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nach Erhalt eines Zugriffstokens können Sie es 60 Minuten lang verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.
  • Erstellen Sie ein Add-on für eine Ihrer apps.Create an add-on for one of your apps. Sie können dies im Partner Center, oder Sie erreichen dies, indem die ein Add-on erstellen Methode.You can do this in Partner Center, or you can do this by using the Create an add-on method.

AnforderungRequest

Diese Methode hat die folgende Syntax.This method has the following syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.See the following sections for usage examples and descriptions of the header and request body.

MethodeMethod Anforderungs-URIRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

AnforderungsheaderRequest header

HeaderHeader TypType BeschreibungDescription
AutorisierungAuthorization Stringstring Erforderlich.Required. Die Azure AD-Zugriffstoken in der Form Bearer < token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

NameName TypType BeschreibungDescription
inAppProductIdinAppProductId Stringstring Erforderlich.Required. Die Store-ID des Add-Ons, für das Sie eine Übermittlung erstellen möchten.The Store ID of the add-on for which you want to create a submission. Die Store-ID ist im Partner Center zur Verfügung und befindet sich in die Antwortdaten für Anforderungen an ein Add-on erstellen oder Abrufen von Details des Add-On-.The Store ID is available in Partner Center, and it is included in the response data for requests to Create an add-on or get add-on details.

AnforderungstextRequest body

Stellen Sie keinen Anforderungstext für diese Methode bereit.Do not provide a request body for this method.

AnforderungsbeispielRequest example

Im folgenden Beispiel wird gezeigt, wie Sie eine neue Übermittlung für ein Add-On erstellen.The following example demonstrates how to create a new submission for an add-on.

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

AntwortResponse

Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode.The following example demonstrates the JSON response body for a successful call to this method. Der Antworttext enthält Informationen zur neuen Übermittlung.The response body contains information about the new submission. Weitere Informationen zu den Werten im Antworttext finden Sie unter Add-On-Übermittlungsressource.For more details about the values in the response body, see add-on submission resource.

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

FehlercodesError codes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

FehlercodeError code BeschreibungDescription
400400 Die Übermittlung konnte nicht erstellt werden, da die Anforderung ungültig ist.The submission could not be created because the request is invalid.
409409 Die Übermittlung konnte aufgrund des aktuellen Status der app nicht erstellt werden, oder die app verwendet ein Partner Center-Feature, das derzeit nicht durch die Übermittlung zum Microsoft Store-API unterstützt.The submission could not be created because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.