Sdílet prostřednictvím

Aktualizace odeslání aplikace

Tuto metodu použijte v rozhraní API pro odesílání z Microsoft Storu k aktualizaci existujícího odeslání aplikace. Po úspěšné aktualizaci odeslání pomocí této metody je nutné potvrdit odeslání pro příjem a publikování.

Další informace o tom, jak tato metoda zapadá do procesu vytváření odeslání aplikace pomocí rozhraní API pro odesílání z Microsoft Storu, najdete v tématu Správa odesílání aplikací.

Požadavky

Pokud chcete použít tuto metodu, musíte nejprve provést následující:

  • Pokud jste tak ještě neučinili, dokončete všechny předpoklady pro rozhraní API pro odesílání z Microsoft Storu.
  • Získejte přístupový token Azure AD , který se použije v hlavičce požadavku pro tuto metodu. Po získání přístupového tokenu ho budete mít 60 minut, než vyprší jeho platnost. Po vypršení platnosti tokenu můžete získat nový.
  • Vytvořte odeslání pro jednu z vašich aplikací. Můžete to udělat v Partnerském centru nebo to můžete udělat pomocí metody vytvoření aplikace pro odeslání .

Prosba

Tato metoda má následující syntaxi. Příklady použití a popisy hlavičky a textu požadavku najdete v následujících částech.

Metoda Požadavek URI
UMÍSTIT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Hlavička požadavku

Záhlaví Typ Popis
Oprávnění řetězec Povinné. Přístupový token Azure AD ve formě Bearer<token>.

Parametry požadavku

Jméno Typ Popis
ID aplikace řetězec Povinné. ID obchodu aplikace, pro kterou chcete aktualizovat podání. Další informace o ID store najdete v části Zobrazení podrobností o identitě aplikace.
ID podání řetězec Povinné. ID odeslání, které se má aktualizovat. Toto ID je k dispozici v datech odpovědi na žádosti o vytvoření podání aplikace. U odeslání vytvořeného v Partnerském centru je toto ID k dispozici také na adrese URL stránky pro odeslání v Partnerském centru.

Text požadavku

Tělo požadavku má následující parametry.

Hodnota Typ Popis
kategorie aplikace řetězec Řetězec, který určuje kategorii nebo podkategorii vaší aplikace. Kategorie a podkategorie se zkombinují do jednoho řetězce se znakem podtržítka _, například BooksAndReference_EReader.
stanovení cen objekt Objekt, který obsahuje informace o cenách aplikace. Další informace najdete v části Cenový zdroj.
viditelnost řetězec Viditelnost aplikace Může to být jedna z následujících hodnot:
  • Schovaný
  • Veřejný
  • Soukromý
  • Nenastaveno
cílový režim publikování řetězec Režim publikace při odeslání Může to být jedna z následujících hodnot:
  • Bezprostřední
  • Uživatelská příručka
  • KonkrétníDatum
cílovéDatumPublikace řetězec Datum publikování pro odeslání ve formátu ISO 8601, pokud je režim publikování nastaven na konkrétní datum.
výpisy objekt Slovník párů klíč a hodnota, kde každý klíč je kód země a každá hodnota je objekt seznamu, který obsahuje seznamové informace o aplikaci.
nastavení hardwaru pole Pole řetězců, které definují předvolby hardwaru pro vaši aplikaci. Může to být jedna z následujících hodnot:
  • Dotyk
  • Klávesnice
  • Myš
  • Fotoaparát
  • NfcHce
  • NFC
  • BluetoothLE
  • Telefonování
automatickéZálohováníPovoleno booleovský Určuje, jestli windows může do automatických záloh na OneDrive zahrnout data vaší aplikace. Další informace najdete v tématu Deklarace aplikací.
lzeNainstalovatNaVyměnitelnáMédia booleovský Určuje, jestli si zákazníci můžou aplikaci nainstalovat do vyměnitelného úložiště. Další informace najdete v tématu Deklarace aplikací.
jeGameDvrPovoleno booleovský Určuje, jestli je pro aplikaci povolena záznamová funkce DVR.
herní možnosti objekt Pole, které obsahuje jeden prostředek herních nastavení, definující herní nastavení pro aplikaci.
má externí produkty v aplikaci booleovský Určuje, jestli vaše aplikace umožňuje uživatelům nakupovat mimo obchodní systém Microsoft Store. Další informace najdete v tématu Deklarace aplikací.
splňtePokynyProPřístupnost booleovský Označuje, jestli byla vaše aplikace testována tak, aby splňovala pokyny pro usnadnění přístupu. Další informace najdete v tématu Deklarace aplikací.
poznámky pro certifikaci řetězec Obsahuje poznámky k certifikaci vaší aplikace.
balíčky aplikací pole Obsahuje objekty, které poskytují podrobnosti o jednotlivých balíčcích v odeslání. Další informace najdete v části balíček aplikace . Při volání této metody pro aktualizaci odeslání aplikace se v textu požadavku vyžadují pouze hodnoty fileName, fileStatus, minimumDirectXVersion a minimumSystemRam . Ostatní hodnoty jsou nastavené Partnerským centrem.
možnosti doručení balíku objekt Obsahuje postupné zavedení balíčku a povinná nastavení aktualizace pro odeslání. Další informace naleznete v tématu objekt Možnosti doručení balíčku.
podnikové licencování řetězec Jedna z hodnot licencování organizace , které označují chování podnikového licencování aplikace.
povolitMicrosoftRozhodnoutODostupnostiAplikacíProBudoucíŘadyZařízení booleovský Určuje, jestli má Microsoft povoleno zpřístupnit aplikaci pro budoucí rodiny zařízení s Windows 10 a Windows 11.
povolitCílovéBudoucíRodinyZařízení booleovský Určuje, jestli má vaše aplikace povoleno cílit na budoucí rodiny zařízení s Windows 10 a Windows 11.
přívěsy pole Pole, které obsahuje až zdroje trailerů, které představují video trailery pro záznam v obchodě.

Ukázkový požadavek

Následující příklad ukazuje, jak aktualizovat odeslání aplikace.

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

Odpověď

Následující příklad ukazuje text odpovědi JSON pro úspěšné volání této metody. Text odpovědi obsahuje informace o aktualizovaném odeslaném obsahu. Další informace o hodnotách v těle odpovědi naleznete v části zdroj pro odeslání aplikace .

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

Kódy chyb

Pokud požadavek nelze úspěšně dokončit, odpověď bude obsahovat jeden z následujících kódů chyb HTTP.

Kód chyby Popis
400 Odeslání nelze aktualizovat, protože požadavek je neplatný.
409 Odeslání nebylo možné aktualizovat z důvodu aktuálního stavu aplikace nebo aplikace používá funkci Partnerského centra, která není aktuálně podporována rozhraním API pro odesílání z Microsoft Storu.