Aktualisieren einer App-ÜbermittlungUpdate an app submission

Verwenden Sie diese Methode in der Microsoft Store Übermittlungs-API, um eine vorhandene App-Übermittlung zu aktualisieren.Use this method in the Microsoft Store submission API to update an existing app 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 in den Prozess der Erstellung einer APP-Übermittlung mithilfe der Microsoft Store Übermittlungs-API passt, finden Sie unter Verwalten von App-Übermittlungen.For more information about how this method fits into the process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

VoraussetzungenPrerequisites

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

  • Wenn Sie dies nicht bereits getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store Übermittlungs-API erfüllen.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. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu 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 eine Übermittlung für eine Ihrer Apps.Create a submission for one of your apps. Dies können Sie in Partner Center tun, oder Sie können dies mithilfe der Methode zum Erstellen einer APP-Übermittlung tun.You can do this in Partner Center, or you can do this by using the create an app submission 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
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

AnforderungsheaderRequest header

HeaderHeader typeType BESCHREIBUNGDescription
AuthorizationAuthorization Zeichenfolgestring Erforderlich.Required. Das Azure AD-Zugriffstoken im Format Bearer <token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

NameName TypType BESCHREIBUNGDescription
applicationIdapplicationId Zeichenfolgestring Erforderlich.Required. Die Store-ID der App, für die Sie eine Übermittlung aktualisieren möchten.The Store ID of the app for which you want to update a submission. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId Zeichenfolgestring 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 APP-Übermittlungverfügbar.This ID is available in the response data for requests to create an app submission. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungs Seite 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
applicationCategoryapplicationCategory Zeichenfolgestring Eine Zeichenfolge, die Kategorie und/oder Unterkategorie für Ihre App angibt.A string that specifies the category and/or subcategory for your app. Kategorien und Unterkategorien werden mit einem Unterstrich „“ zu einer einzigen Zeichenfolge zusammengefasst, z. B. BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
Preisepricing Objekt (object)object Ein Objekt, das Preisinfos für die App enthält.An object that contains pricing info for the app. Weitere Informationen finden Sie im Abschnitt Preisressource.For more information, see the Pricing resource section.
Sichtbarkeitvisibility Zeichenfolgestring Die Sichtbarkeit der App.The visibility of the app. Mögliche Werte:This can be one of the following values:
  • AusgeblendetHidden
  • ÖffentlichPublic
  • PrivatPrivate
  • NotSetNotSet
targetPublishModetargetPublishMode Zeichenfolgestring Der Veröffentlichungsmodus für die Übermittlung.The publish mode for the submission. Mögliche Werte:This can be one of the following values:
  • UnmittelbarImmediate
  • ManuellManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate Zeichenfolgestring 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.
listingslistings Objekt (object)object Ein Wörterbuch von Schlüssel-Wert-Paaren, wobei ein Schlüssel ein Ländercode und ein Wert eine Eintragsressourcen-Objekt ist, das Eintragsinfos für die App enthält.A dictionary of key and value pairs, where each key is a country code and each value is a Listing resource object that contains listing info for the app.
hardwarePreferenceshardwarePreferences arrayarray Ein Array von Zeichenfolgen, die die Hardwareeinstellungen für die App definieren.An array of strings that define the hardware preferences for your app. Mögliche Werte:This can be one of the following values:
  • TouchTouch
  • TastaturKeyboard
  • MausMouse
  • KameraCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • TelephonyTelephony
automaticBackupEnabledautomaticBackupEnabled booleanboolean Gibt an, ob Windows die App-Daten in automatische Sicherungen auf OneDrive aufnehmen können.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Weitere Informationen finden Sie unter App-Deklarationen.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean Gibt an, ob Kunden die App auf Wechselmedien installieren können.Indicates whether customers can install your app to removable storage. Weitere Informationen finden Sie unter App-Deklarationen.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean Gibt an, ob game DVR für die App aktiviert ist.Indicates whether game DVR is enabled for the app.
gamingoptionsgamingOptions Objekt (object)object Ein Array, das eine Gaming Options-Ressource enthält, die die spielbezogenen Einstellungen für die APP definiert.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean Gibt an, ob Ihre APP es Benutzern ermöglicht, den Einkauf außerhalb des Microsoft Store Commerce-Systems zu tätigen.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Weitere Informationen finden Sie unter App-Deklarationen.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean Gibt an, ob getestet wurde, ob die App die Richtlinien zur Barrierefreiheit erfüllt.Indicates whether your app has been tested to meet accessibility guidelines. Weitere Informationen finden Sie unter App-Deklarationen.For more information, see App declarations.
notesForCertificationnotesForCertification Zeichenfolgestring Enthält Hinweise zur Zertifizierung für Ihre App.Contains notes for certification for your app.
applicationPackagesapplicationPackages arrayarray Enthält Objekte, die Details über die einzelnen Pakete der Übermittlung bereitstellen.Contains objects that provide details about each package in the submission. Weitere Informationen finden Sie unten im Abschnitt Anwendungspaket.For more information, see the Application package section. Beim Aufruf dieser Methode zur Aktualisierung einer App-Übermittlung sind im Antworttext nur die fileName-, fileStatus-, minimumDirectXVersion- und minimumSystemRam-Werte dieser Objekte erforderlich.When calling this method to update an app submission, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of these objects are required in the request body. Die anderen Werte werden von Partner Center aufgefüllt.The other values are populated by Partner Center.
packageDeliveryOptionspackageDeliveryOptions Objekt (object)object Enthält den schrittweisen Paketrollout sowie erforderliche Einstellungen für die Übermittlung.Contains gradual package rollout and mandatory update settings for the submission. Weitere Informationen finden Sie unter options-Objekt für die Paketübermittlung.For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing Zeichenfolgestring Einer der Werte für Unternehmenslizenzierung, die das Verhalten der Unternehmenslizenzierung für die App angeben.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean Gibt an, ob Microsoft die App für zukünftige Windows 10-Gerätefamilien verfügbar machen darf.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanboolean Gibt an, ob die App auf zukünftige Windows 10-Gerätefamilien abzielen darf.Indicates whether your app is allowed to target future Windows 10 device families.
Bettrailers arrayarray Ein Array, das bis zu nach Spann Ende Ressourcen enthält, die videonachspann für die APP-Auflistung darstellen.An array that contains up to trailer resources that represent video trailers for the app listing.

AnforderungsbeispielRequest example

Im folgenden Beispiel wird die Aktualisierung einer App-Übermittlung veranschaulicht.The following example demonstrates how to update an app submission.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
              "epub"
            ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
              "Free ebook reader"
            ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

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 App-Übermittlungsressource.For more details about the values in the response body, see App submission resource.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1",
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

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.
409409 Die Übermittlung konnte aufgrund des aktuellen Status der APP nicht aktualisiert werden, oder die APP verwendet ein Partner Center-Feature, das von der Microsoft Store Übermittlungs-API derzeit nicht unterstütztwird.The submission could not be updated 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.