Aktualisieren einer Add-On-ÜbermittlungUpdate an add-on submission

Verwenden Sie diese Methode der Microsoft Store-Übermittlungs-API zur Aktualisierung einer vorhandenen Add-On-Übermittlung (Add-Ons werden auch als In-App-Produkt bzw. IAP bezeichnet).Use this method in the Microsoft Store submission API to update an existing add-on (also known as in-app product or IAP) submission. Nachdem Sie mit dieser Methode eine Übermittlung erfolgreich aktualisiert haben, müssen Sie ein Commit für die Übermittlung für Aufnahme und Veröffentlichung durchführen.After you successfully update a submission by using this method, you must 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.

VoraussetzungenPrerequisites

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-Übermittlung für eine Ihrer apps.Create an add-on submission for one of your apps. Sie können dies im Partner Center, oder Sie erreichen dies, indem die erstellen Sie ein Add-on-Übermittlung Methode.You can do this in Partner Center, or you can do this by using the Create an add-on submission method.

AnfordernRequest

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
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

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 aktualisieren möchten.The Store ID of the add-on for which you want to update 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.
submissionIdsubmissionId stringstring Erforderlich.Required. Die ID der zu aktualisierenden Übermittlung.The ID of the submission to update. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Add-On-Übermittlung verfügbar.This ID is available in the response data for requests to create an add-on submission. Für eine Eingabe, die im Partner Center erstellt wurde, ist diese ID auch in die URL für die Seite für die Auftragsübermittlung im Partner Center verfügbar.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

AnforderungstextRequest body

Der Anforderungstext hat folgende Parameter.The request body has the following parameters.

WertValue TypType BeschreibungDescription
contentTypecontentType stringstring Der Inhaltstyp, der im Add-On bereitgestellt wird.The type of content that is provided in the add-on. Folgende Werte sind möglich:This can be one of the following values:
  • NotSetNotSet
  • BookDownloadBookDownload
  • EMagazineEMagazine
  • ENewspaperENewspaper
  • MusicDownloadMusicDownload
  • MusicStreamMusicStream
  • OnlineDataStorageOnlineDataStorage
  • VideoDownloadVideoDownload
  • VideoStreamVideoStream
  • AspAsp
  • OnlineDownloadOnlineDownload
keywordskeywords arrayarray Ein Array von Zeichenfolgen, das bis zu 10 Schlüsselwörter für das Add-On enthalten kann.An array of strings that contain up to 10 keywords for the add-on. Die App kann mit diesen Schlüsselwörter Add-Ons abfragen.Your app can query for add-ons using these keywords.
lifetimelifetime stringstring Die Lebensdauer des Add-Ons.The lifetime of the add-on. Folgende Werte sind möglich:This can be one of the following values:
  • ForeverForever
  • OneDayOneDay
  • ThreeDaysThreeDays
  • FiveDaysFiveDays
  • OneWeekOneWeek
  • TwoWeeksTwoWeeks
  • OneMonthOneMonth
  • TwoMonthsTwoMonths
  • ThreeMonthsThreeMonths
  • SixMonthsSixMonths
  • OneYearOneYear
listingslistings objectobject Ein Objekt, das Eintragsinfos für das Add-On enthält.An object that contains listing info for the add-on. Weitere Informationen finden Sie unter Eintragsressource.For more information, see Listing resource.
pricingpricing objectobject Ein Objekt, das Eintragsinfos für das Add-On enthält.An object that contains pricing info for the add-on. Weitere Informationen finden Sie unter Preisressource.For more information, see Pricing resource.
targetPublishModetargetPublishMode stringstring Der Veröffentlichungsmodus für die Übermittlung.The publish mode for the submission. Folgende Werte sind möglich:This can be one of the following values:
  • ImmediateImmediate
  • ManualManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring Das Veröffentlichungsdatum der Übermittlung im ISO 8601-Format, wenn TargetPublishMode den Wert SpecificDate hat.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
tagtag stringstring Die benutzerdefinierten Entwicklerdaten für das Add-On (diese Informationen wurden zuvor als tag bezeichnet).The custom developer data for the add-on (this information was previously called the tag).
visibilityvisibility stringstring Die Sichtbarkeit des Add-Ons.The visibility of the add-on. Folgende Werte sind möglich:This can be one of the following values:
  • HiddenHidden
  • PublicPublic
  • PrivatePrivate
  • NotSetNotSet

AnforderungsbeispielRequest example

Im folgenden Beispiel wird die Aktualisierung einer Add-On-Übermittlung veranschaulicht.The following example demonstrates how to update an add-on submission.

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

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 aktualisierten Übermittlung.The response body contains information about the updated 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": [],
    "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"
}

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 aktualisiert werden, da die Anforderung ungültig ist.The submission could not be updated because the request is invalid.
407409 Die Übermittlung konnte aufgrund des aktuellen Status des Add-Ons nicht aktualisiert werden, oder das Add-on verwendet ein Partner Center-Feature, das derzeit nicht durch die Übermittlung zum Microsoft Store-API unterstützt.The submission could not be updated because of the current state of the add-on, or the add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.