Sdílet prostřednictvím

Vytvořte odeslání aplikace

Tuto metodu použijte v rozhraní API pro odesílání z Microsoft Storu k vytvoření nového odeslání pro aplikaci, která je zaregistrovaná v účtu Partnerského centra. Po úspěšném vytvoření nového podání pomocí této metody je třeba aktualizovat podání, provést potřebné změny v datech podání, a poté potvrdit podání pro následné zpracování 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 to ještě neudělali, dokončete všechny požadavky pro rozhraní API pro odesílání aplikací do Microsoft Store.
  • 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ý.
  • Ujistěte se, že aplikace již obsahuje alespoň jedno provedení s informacemi o věkovém hodnocení dokončenými.

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 Identifikátor URI požadavku
PŘÍSPĚVEK https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions

Hlavička požadavku

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

Parametry požadavku

Jméno Typ Popis
ID aplikace řetězec Povinné ID obchodu aplikace, pro kterou chcete vytvořit předložení. Další informace o ID obchodu najdete v tématu Zobrazení podrobností o identitě aplikace.

Text požadavku

Pro tuto metodu nezadádejte text požadavku.

Příklad žádosti

Následující příklad ukazuje, jak vytvořit nové odeslání pro aplikaci.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions HTTP/1.1
Authorization: Bearer <your access token>

Odpověď

Následující příklad ukazuje text odpovědi JSON pro úspěšné volání této metody. Tělo odpovědi obsahuje informace o nové odeslané položce. Další podrobnosti o hodnotách v textu odpovědi najdete v tématu zdroj pro odeslání aplikace.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "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": "Uploaded",
      "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 vytvořit, protože požadavek je neplatný.
409 Odeslání nelze vytvořit z důvodu aktuálního stavu aplikace nebo aplikace používá funkci Partnerského centra, která je aktuálně nepodporována rozhraním API pro odesílání z Microsoft Storu.
  • Last updated on