Udostępnij przez


Pobieranie danych aplikacji

Użyj następujących metod w interfejsie API przesyłania sklepu Microsoft Store, aby pobrać dane dla istniejących aplikacji na koncie Centrum partnerskiego. Aby zapoznać się z wprowadzeniem do interfejsu API przesłań w Microsoft Store, w tym wymagania wstępne dotyczące jego użycia, zobacz Tworzenie i zarządzanie przesłaniami za pomocą usług Microsoft Store.

Aby można było użyć tych metod, aplikacja musi już istnieć na koncie Centrum partnerskiego. Aby utworzyć lub zarządzać przesyłaniem aplikacji, zobacz metody w Zarządzanie przesyłaniem aplikacji.

Metoda URI Opis
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications Pobieranie danych dla wszystkich aplikacji
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Pobieranie danych dla określonej aplikacji
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Pobieranie dodatków dla aplikacji
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Pobierz loty pakietów dla aplikacji

Wymagania wstępne

Jeśli jeszcze tego nie zrobiłeś/zrobiłaś, zanim spróbujesz użyć którejkolwiek z tych metod, wykonaj wszystkie wymagania wstępne dla interfejsu API przesyłania do sklepu Microsoft Store.

Zasoby danych

Metody interfejsu API przesyłania ze sklepu Microsoft Store do pobierania danych aplikacji używają następujących zasobów danych JSON.

Zasób aplikacji

Ten zasób reprezentuje aplikację zarejestrowaną na Twoim koncie.

{
  "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
}

Ten zasób ma następujące wartości.

Wartość Typ Opis
id sznurek Identyfikator sklepu aplikacji. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.
nazwa główna sznurek Nazwa podstawowa aplikacji.
nazwaRodzinyPakietu sznurek Nazwa rodziny pakietów aplikacji.
nazwaTożsamościPakietu sznurek Nazwa tożsamości pakietu aplikacji.
NazwaWydawcy sznurek Identyfikator wydawcy systemu Windows skojarzony z aplikacją. Odpowiada to wartości Package/Identity/Publisher wyświetlanej na stronie tożsamości aplikacji dla aplikacji w Centrum partnerskim.
data pierwszej publikacji sznurek Data opublikowania aplikacji w formacie ISO 8601.
ostatnio opublikowane zgłoszenie aplikacji przedmiot Zasób przesyłania , który zawiera informacje o ostatnim opublikowanym przesłaniu aplikacji.
oczekujące złożenie aplikacji przedmiot Zasób przesyłania zawierający informacje o bieżącym oczekiwaniu na przesłanie aplikacji.
maZaawansowaneUprawnieniaDoListingu typ logiczny (boolowski) Wskazuje, czy można skonfigurować opcje gry lub zwiastuny do przesyłania w aplikacji. Ta wartość jest prawdziwa dla zgłoszeń utworzonych po maju 2017 r.

Zasób dodatkowy

Ten zasób zawiera informacje o dodatku.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Ten zasób ma następujące wartości.

Wartość Typ Opis
IdentyfikatorProduktuAplikacji sznurek Identyfikator sklepu dodatku. Ta wartość jest dostarczana przez sklep. Przykładowy identyfikator sklepu to 9NBLGGH4TNMP.

Zasoby lotnicze

Ten zasób zawiera informacje o pakiecie lotu dla aplikacji.

{
    "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"
}

Ten zasób ma następujące wartości.

Wartość Typ Opis
flightId (identyfikator lotu) sznurek Identyfikator lotu pakietu. Ta wartość jest dostarczana przez Centrum partnerskie.
przyjaznaNazwa sznurek Nazwa pakietu lotu określona przez dewelopera.
ostatnioOpublikowaneZlecenieLotu przedmiot Zasób zgłoszenia , który zawiera informacje o ostatnim opublikowanym zgłoszeniu dla lotu pakietu.
zgłoszenie lotu w toku przedmiot Zasób przesyłania zawierający informacje o bieżącym oczekiwaniu na przesłanie pakietu.
groupIds (identyfikatory grup) układ Tablica ciągów zawierających identyfikatory grup lotów skojarzonych z lotem pakietowym. Aby uzyskać więcej informacji na temat grup lotów, zobacz Pakiety lotów.
rangaWyższaNiż sznurek Przyjazna nazwa lotu pakietowego, który jest sklasyfikowany bezpośrednio niżej niż aktualny lot pakietowy. Aby uzyskać więcej informacji na temat klasyfikacji grup lotów, zobacz Pakiety lotów.

Zasób zgłoszeń

To źródło zawiera informacje o zgłoszeniu. W poniższym przykładzie pokazano format tego zasobu.

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

Ten zasób ma następujące wartości.

Wartość Typ Opis
id sznurek Identyfikator zgłoszenia.
lokalizacja zasobu sznurek Ścieżka względna, którą można dołączyć do base https://manage.devcenter.microsoft.com/v1.0/my/ request URI, aby pobrać pełne dane do przesłania.