Erstellen einer Add-On-Übermittlung
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 bei Ihrem Partner Center-Konto registriert ist. 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.
Weitere Informationen dazu, wie diese Methode in den Prozess zum Erstellen 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. Um ein Add-On zu erstellen, verwenden Sie die Methode zum Erstellen eines Add-Ons.
Voraussetzungen
Zur Verwendung dieser Methode sind folgende Schritte erforderlich:
- Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
- Erstellen Sie ein Add-On für eine Ihrer Apps. Sie können dies im Partner Center oder mithilfe der Add-On-Methode erstellen tun.
Anforderung
Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.
Methode | Anforderungs-URI |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions |
Anforderungsheader
Header | type | BESCHREIBUNG |
---|---|---|
Authorization | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>. |
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 in den Antwortdaten für Anforderungen zum Erstellen eines Add-Ons oder Zum Abrufen von Add-On-Details enthalten. |
Anforderungstext
Stellen Sie keinen Anforderungstext für diese Methode bereit.
Anforderungsbeispiel
Im folgenden Beispiel wird gezeigt, wie Sie eine neue Übermittlung für ein Add-On erstellen.
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode. Der Antworttext enthält Informationen zur neuen Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie unter 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. |
Verwandte Themen
- Erstellen und Verwalten von Übermittlungen mit Microsoft Store-Diensten
- Verwalten von Add-On-Übermittlungen
- Abrufen einer Add-On-Übermittlung
- Ausführen eines Commit für eine Add-On-Übermittlung
- Aktualisieren einer Add-On-Übermittlung
- Löschen einer Add-On-Übermittlung
- Abrufen des Status einer Add-On-Übermittlung
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für