Sdílet prostřednictvím


Získání dat aplikace

Pomocí následujících metod v rozhraní API pro odesílání z Microsoft Storu získáte data pro existující aplikace v účtu Partnerského centra. Úvod do rozhraní API pro odesílání z Microsoft Storu, včetně požadavků na používání rozhraní API, najdete v tématu Vytváření a správa odesílání pomocí služeb Microsoft Store.

Než budete moct tyto metody použít, aplikace už musí existovat ve vašem účtu Partnerského centra. Pokud chcete vytvářet nebo spravovat odesílání pro aplikace, podívejte se na metody v části Správa odesílání aplikací.

Metoda Identifikátor URI Popis
získej https://manage.devcenter.microsoft.com/v1.0/my/applications Získání dat pro všechny vaše aplikace
získej https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Získání dat pro konkrétní aplikaci
získej https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Získání doplňků pro aplikaci
získej https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Získání balíkových letů pro aplikaci

Požadavky

Pokud jste to ještě neudělali, před pokusem o použití některé z těchto metod dokončete všechny požadavky rozhraní API pro odesílání z Microsoft Storu.

Datové prostředky

Metody rozhraní API pro odesílání z Microsoft Storu pro získání dat aplikace používají následující datové prostředky JSON.

Zdroje aplikace

Tento prostředek představuje aplikaci, která je zaregistrovaná ve vašem účtu.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Tento prostředek má následující hodnoty.

Hodnota Typ Popis
identifikační číslo řetězec ID obchodu aplikace. Další informace o ID Storu najdete v tématu Zobrazení podrobností o identitě aplikace.
primárníJméno řetězec Primární název aplikace.
názevRodinyBalíčků řetězec Název rodiny balíčků aplikace.
název identity balíčku řetězec Název identity balíčku aplikace.
název vydavatele řetězec ID vydavatele Windows, které je přidružené k aplikaci. Odpovídá hodnotě Package/Identity/Publisher , která se zobrazí na stránce Identita aplikace pro aplikaci v Partnerském centru.
datumPrvníhoVydání řetězec Datum, kdy byla aplikace poprvé publikována ve formátu ISO 8601.
posledníPublikovanáPodáníApplikace objekt Prostředek předložení, který poskytuje informace o posledním publikovaném předložení pro aplikaci.
čekající podání žádosti objekt Prostředek pro odeslání , který poskytuje informace o aktuálním nevyřízeném odeslání aplikace.
máPokročiléOprávněníVýpisu Boolean Určuje, jestli můžete nakonfigurovat herní možnosti nebo trailery pro odeslání aplikace. Tato hodnota platí pro odeslání vytvořená po květnu 2017.

Doplňkový zdroj

Tento zdroj poskytuje informace o doplňku.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Tento prostředek má následující hodnoty.

Hodnota Typ Popis
inAppProductId (identifikátor produktu v aplikaci) řetězec ID úložiště doplňku. Tato hodnota je poskytována obchodem. Příkladem ID obchodu je 9NBLGGH4TNMP.

Letecký zdroj

Tento zdroj poskytuje informace o letu v rámci balíčku pro aplikaci.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Tento prostředek má následující hodnoty.

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 letu, jak jej určil vývojář.
posledníOdesláníLetu objekt Prostředek pro odeslání , který poskytuje informace o posledním publikovaném odeslání letu balíčku.
čekající odeslání letu objekt Prostředek pro odeslání , který poskytuje informace o aktuálním čekajícím odeslání pro letová balíček.
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ů.
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. Pro více informací o řazení skupin letů se podívejte na Balíček letů.

Zdroj předložení

Tento zdroj poskytuje informace o předložení. Následující příklad ukazuje formát tohoto prostředku.

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Tento prostředek má následující hodnoty.

Hodnota Typ Popis
identifikační číslo řetězec ID podání.
umístění zdroje řetězec Relativní cesta, kterou můžete připojit k základnímu identifikátoru URI požadavku https://manage.devcenter.microsoft.com/v1.0/my/ pro načtení kompletních dat pro odeslání.