Sdílet prostřednictvím

Získat informace o nasazení pro odeslání aplikace

Tuto metodu použijte v rámci rozhraní API pro odeslání Microsoft Storu ke získání informací o zavedení balíčku pro odeslání testovacího balíčku. Další informace o procesu vytváření odeslání aplikace pomocí rozhraní API pro odeslá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 předpoklady pro rozhraní API pro odeslání 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ý.
  • 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í .

Žádost

Tato metoda má následující syntaxi. Příklady použití a popisy parametrů hlaviček a požadavků najdete v následujících částech.

Metoda Požadavek na URI
získej https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout

Hlavička požadavku

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

Parametry požadavku

Název Typ Popis
ID aplikace řetězec Povinné. ID v obchodě aplikace, která obsahuje podání s informacemi o distribuci balíčku, které chcete získat. Další informace o ID Storu najdete v tématu Zobrazení podrobností o identitě aplikace.
ID příspěvku řetězec Povinné. ID odeslání s informacemi o nasazení balíčku, které chcete získat. Tento identifikátor je k dispozici v datech odpovědi pro žá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.

Obsah požadavku

Pro tuto metodu nezadádejte text požadavku.

Požadavek příkladu

Následující příklad ukazuje, jak získat informace o zavedení balíčku pro odeslání aplikace.

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

Odezva

Následující příklad ukazuje text odpovědi JSON pro úspěšné volání této metody pro odeslání aplikace s povolením postupného zavedení balíčku. Další podrobnosti o hodnotách v textu odpovědi najdete v tématu Nasazení balíčku.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Pokud odeslání aplikace nemá povolené postupné zavedení balíčku, vrátí se následující text odpovědi.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

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
404 Odeslání nebylo nalezeno.
409 Odeslání nepatří do zadané 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.
  • Last updated on