Freigeben über

App-Einreichung aktualisieren

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

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 ausführen:

  • Wenn Sie dies noch nicht getan haben, erledigen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.
  • Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
  • Erstellen Sie eine Einreichung für eine deiner Apps. Sie können dies im Partner Center tun, oder Sie können dies tun, indem Sie die Methode eine App-Einreichung erstellen verwenden.

Anfrage

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Kopfzeile und des Anforderungstexts.

Methode Anforderungs-URI
PLATZIEREN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Anforderungs-Kopfzeile

Kopfzeile Typ BESCHREIBUNG
Autorisierung Schnur Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Name Typ BESCHREIBUNG
Anwendungs-ID Schnur 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.
Einreichungs-ID Schnur Erforderlich. Die ID der Einsendung, die aktualisiert werden soll. Diese ID ist in den Antwortdaten für Anfragen zum Erstellen einer App-Einreichungbei 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.

Anfragekörper

Der Anforderungstext weist die folgenden Parameter auf.

Wert Typ BESCHREIBUNG
Anwendungskategorie Schnur 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.
Preisgestaltung Objekt Ein Objekt, das Preisinformationen für die App enthält. Weitere Informationen finden Sie im Abschnitt Preisressource.
Sichtbarkeit Schnur Die Sichtbarkeit der App. Dies kann einer der folgenden Werte sein:
  • Versteckt
  • Öffentlichkeit
  • Privat
  • Nicht festgelegt
Zielveröffentlichungsmodus Schnur Der Veröffentlichungsmodus für die Einsendung. Dies kann einer der folgenden Werte sein:
  • Sofortig
  • Handbuch
  • SpezifischesDatum
Zielveröffentlichungsdatum Schnur Das Veröffentlichungsdatum für die Einsendung im ISO 8601-Format, wenn targetPublishMode auf SpecificDate festgelegt ist.
Auflistungen Objekt Ein Wörterbuch mit Schlüssel- und Wertpaaren, wobei jeder Schlüssel ein Ländercode ist und jeder Wert ein Eintragsressource Objekt ist, das Eintragsinformationen für die App enthält.
Hardware-Einstellungen Array Ein Array von Zeichenfolgen, die die Hardwareeinstellungen für Ihre App definieren. Dies kann einer der folgenden Werte sein:
  • Berührung
  • Tastatur
  • Maus
  • Kamera
  • NfcHce
  • NFC
  • BluetoothLE
  • Telefonie
Automatische Sicherung aktiviert Boolescher Wert Gibt an, ob Windows die Daten Ihrer App in automatische Sicherungen auf OneDrive aufnehmen kann. Weitere Informationen finden Sie unter App-Erklärungen.
kannAufWechselmedienInstalliertWerden Boolescher Wert Gibt an, ob Kunden Ihre App auf wechselbaren Speichermedien installieren können. Weitere Informationen finden Sie unter App-Erklärungen.
isSpielDvrAktiviert Boolescher Wert Gibt an, ob die Game-DVR-Funktion für die App aktiviert ist.
Spieloptionen Objekt Ein Array, das eine Spieloptionenressource enthält, die spielbezogene Einstellungen für die App definiert.
hat externe In-App-Produkte Boolescher Wert Gibt an, ob Ihre App Benutzern das Kaufgeschäft außerhalb des Microsoft Store-Commerce-Systems ermöglicht. Weitere Informationen finden Sie unter App-Erklärungen.
Barrierefreiheitsrichtlinien erfüllen Boolescher Wert Gibt an, ob Ihre App getestet wurde, um die Richtlinien für die Barrierefreiheit zu erfüllen. Weitere Informationen finden Sie unter App-Erklärungen.
Notizen für die Zertifizierung Schnur Enthält Hinweise zur Zertifizierung für Ihre App.
Anwendungspakete Array Enthält Objekte, die Details zu den einzelnen Paketen in der Einreichung liefern. Weitere Informationen finden Sie im Abschnitt Anwendungspaket. Beim Aufrufen dieser Methode zum Aktualisieren einer App-Übermittlung sind im Anfrageinhalt nur die Werte für fileName, fileStatus, minimumDirectXVersionund minimumSystemRam dieser Objekte erforderlich. Die anderen Werte werden vom Partner Center aufgefüllt.
Paketlieferoptionen Objekt Enthält die schrittweise Einführung von Paketen und verpflichtende Update-Einstellungen für die Einreichung. Weitere Informationen finden Sie unter Objekt für Lieferoptionen für Pakete.
Unternehmenslizenzierung Schnur Einer der Unternehmenslizenzierungs-Werte, der das Lizenzierungsverhalten der App angibt.
LassenSieMicrosoftÜberDieVerfügbarkeitDerAppFürZukünftigeGeräteFamilienEntscheiden Boolescher Wert Gibt an, ob Microsoft die App für zukünftige Windows 10- und Windows 11-Gerätefamilienverfügbar machen darf.
ErlaubeZielzukünftigeGerätefamilien Boolescher Wert Gibt an, ob Ihre App für zukünftige Windows 10- und Windows 11-Gerätefamilienverwendet werden darf.
Trailer Array Ein Array, das bis zu Trailerressourcen enthält,, die Videotrailer für den App-Eintrag darstellen.

Beispielanfrage

Im folgenden Beispiel wird veranschaulicht, wie eine App-Einreichung 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 angezeigt. Der Antworttext enthält Informationen zur aktualisierten Einsendung. 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 derzeitigen Zustands der App nicht aktualisiert werden, oder die App verwendet eine Funktion des Partner Center, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.