Sdílet prostřednictvím

Vytvořit let v balíčku

Tuto metodu použijte v rozhraní API pro odesílání z Microsoft Storu k vytvoření testovací verze balíčku pro aplikaci, která je zaregistrovaná v účtu Partnerského centra.

Poznámka:

Tato metoda vytvoří balíček letu bez odeslání. Pokud chcete vytvořit podání testovací verze balíčku, podívejte se na metody v rámci Správa podání testovací verze balíčku.

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 na 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ý.

Žádost

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 na URI
PŘÍSPĚVEK https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Hlavička požadavku

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

Parametry požadavku

Název Typ Popis
ID aplikace řetězec Povinné. ID obchodu aplikace, pro kterou chcete vytvořit balíček letového režimu. Další informace o ID obchodu najdete v Zobrazení podrobností o identitě aplikace.

Obsah požadavku

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

Parametr Typ Popis Povinné
přátelský název řetězec Název balíčku letu, jak jej určil vývojář. Ne
identifikátory skupin pole Pole řetězců, které obsahují ID letových skupin přidružených k letovému balíčku. Další informace o skupinách letů najdete v tématu Zabalení letů. Ne
hodnostVyššíNež řetězec Uživatelsky přívětivý název balíčkového letu, který je hodnocen bezprostředně nižší než aktuální balíčkový let. Pokud tento parametr nenastavíte, bude mít nová testovací verze balíčku nejvyšší pořadí všech letů balíčků. Další informace o řazení skupin letů najdete v tématu Balíček letů. Ne

Požadavek příkladu

Následující příklad demonstruje, jak vytvořit nový letový plán balíčku pro aplikaci s ID Storu 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

Odezva

Následující příklad ukazuje text odpovědi JSON pro úspěšné volání této metody. Další podrobnosti o hodnotách v textu odpovědi najdete v následujících částech.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Obsah odpovědi

Hodnota Typ Popis
ID letu řetězec ID pro let balíčku. Tuto hodnotu poskytuje Partnerské centrum.
přátelský název řetězec Název balíčku flight, jak je uvedeno v požadavku.
identifikátory skupin pole Pole řetězců, které obsahují ID skupin letů přidružených k balíčku letu, jak je uvedeno v požadavku. Další informace o skupinách letů najdete v tématu Zabalení letů.
hodnostVyššíNež řetězec Uživatelsky přívětivý název balíčku letu, který je v pořadí ihned nižší než aktuální balíček letu, jak je specifikováno v požadavku. Další informace o řazení skupin letů najdete v tématu Balíček letů.

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 Požadavek je neplatný.
409 Balíček nelze vytvořit kvůli jeho aktuálnímu stavu nebo aplikace používá funkci Partnerského centra, která momentálně není podporována rozhraním API pro odesílání do Microsoft Storu.
  • Last updated on