Freigeben über

Aktualisieren einer App-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine vorhandene App-Übermittlung zu aktualisieren. Nachdem Sie eine Übermittlung mithilfe dieser Methode erfolgreich aktualisiert haben, müssen Sie die Übermittlung für die Aufnahme und Veröffentlichung übernehmen.

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.

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
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Anforderungsheader

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

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App, für die Sie eine Übermittlung aktualisieren möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
submissionId Zeichenfolge Erforderlich. Die ID der zu aktualisierenden Übermittlung. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer App-Übermittlung verfügbar. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite im Partner Center verfügbar.

Anforderungstext

Der Anforderungstext weist die folgenden Parameter auf.

Wert Typ Beschreibung
applicationCategory Zeichenfolge Eine Zeichenfolge, die die Kategorie und/oder Unterkategorie für Ihre App angibt. Kategorien und Unterkategorien werden in einer einzelnen Zeichenfolge mit dem Unterstrich "_" kombiniert, z . B. BooksAndReference_EReader.
Preise Objekt Ein Objekt, das Preisinformationen für die App enthält. Weitere Informationen finden Sie im Abschnitt "Preisressourcen ".
Sichtbarkeit Zeichenfolge Die Sichtbarkeit der App. Dies kann einer der folgenden Werte sein:
  • Ausgeblendet
  • Öffentlich
  • Privat
  • NotSet
targetPublishMode Zeichenfolge Der Veröffentlichungsmodus für die Übermittlung. Dies kann einer der folgenden Werte sein:
  • Direkt
  • Manuell
  • SpecificDate
targetPublishDate Zeichenfolge Das Veröffentlichungsdatum für die Übermittlung im ISO 8601-Format, wenn der targetPublishMode auf SpecificDate festgelegt ist.
listings Objekt Ein Wörterbuch mit Schlüssel- und Wertpaaren, wobei jeder Schlüssel ein Ländercode ist und jeder Wert ein Listing-Ressourcenobjekt ist, das Eintragsinformationen für die App enthält.
hardwarePreferences array Ein Array von Zeichenfolgen, die die Hardwareeinstellungen für Ihre App definieren. Dies kann einer der folgenden Werte sein:
  • Toucheingabe
  • Tastatur
  • Maus
  • Kamera
  • NfcHce
  • Nfc
  • BluetoothLE
  • Telefonie
automaticBackupEnabled boolean Gibt an, ob Windows die Daten Ihrer App in automatische Sicherungen auf OneDrive aufnehmen kann. Weitere Informationen finden Sie unter App-Deklarationen.
canInstallOnRemovableMedia boolean Gibt an, ob Kunden Ihre App auf Wechselmedien installieren können. Weitere Informationen finden Sie unter App-Deklarationen.
isGameDvrEnabled boolean Gibt an, ob game DVR für die App aktiviert ist.
gamingOptions Objekt Ein Array, das eine Ressource für Spieleoptionen enthält, die spielbezogene Einstellungen für die App definiert.
hasExternalInAppProducts boolean Gibt an, ob Ihre App Benutzern das Kaufgeschäft außerhalb des Microsoft Store-Commerce-Systems ermöglicht. Weitere Informationen finden Sie unter App-Deklarationen.
meetAccessibilityGuidelines boolean Gibt an, ob Ihre App getestet wurde, um die Richtlinien für die Barrierefreiheit zu erfüllen. Weitere Informationen finden Sie unter App-Deklarationen.
notesForCertification Zeichenfolge Enthält Hinweise zur Zertifizierung für Ihre App.
applicationPackages array Enthält Objekte, die Details zu den einzelnen Paketen in der Übermittlung bereitstellen. Weitere Informationen finden Sie im Abschnitt "Anwendungspaket" . Beim Aufrufen dieser Methode zum Aktualisieren einer App-Übermittlung sind nur die Werte "fileName", "fileStatus", "minimumDirectXVersion" und "minimumSystemRam" dieser Objekte im Anforderungstext erforderlich. Die anderen Werte werden vom Partner Center aufgefüllt.
packageDeliveryOptions Objekt Enthält schrittweise Paketrollouts und obligatorische Updateeinstellungen für die Übermittlung. Weitere Informationen finden Sie im Objekt "Paketzustellungsoptionen".
enterpriseLicensing Zeichenfolge Einer der Enterprise-Lizenzierungswerte , die das Verhalten der Unternehmenslizenzierung für die App angeben.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies boolean Gibt an, ob Microsoft die App für zukünftige Windows 10- und Windows 11-Gerätefamilien verfügbar machen darf.
allowTargetFutureDeviceFamilies boolean Gibt an, ob Ihre App auf zukünftige Windows 10- und Windows 11-Gerätefamilien abzielen darf.
Anhänger array Ein Array, das bis zu Trailerressourcen enthält, die Videotrailer für den App-Eintrag darstellen.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie eine App-Übermittlung aktualisiert wird.

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": []
}

Antwort

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

{
  "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": []
}

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 aktualisiert werden, da die Anforderung ungültig ist.
409 Die Übermittlung konnte aufgrund des aktuellen Zustands der App nicht aktualisiert werden, oder die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.