Hämta app-data

Använd följande metoder i Microsoft Store-api:et för överföring för att hämta data för befintliga appar i ditt Partnercenter-konto. För en introduktion till Microsoft Stores inlämnings-API, inklusive krav för att använda API:et, se Skapa och hantera inlämningar med hjälp av Microsoft Store-tjänster.

Innan du kan använda dessa metoder måste appen redan finnas i ditt Partnercenter-konto. Information om hur du skapar eller hanterar inskickade appar finns i metoderna i Hantera appöverföringar.

Metod URI (Uniform Resource Identifier) Beskrivning
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications Hämta data för alla dina appar
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Hämta data för en specifik app
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Hämta tillägg för en app
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Hämta flygpaket för en app

Förutsättningar

Om du inte redan har gjort det slutför du alla krav för Microsoft Store-api:et för insändning innan du försöker använda någon av dessa metoder.

Dataresurser

API-metoderna för insändning till Microsoft Store för att hämta appdata använder följande JSON-dataresurser.

Programresurs

Den här resursen representerar en app som är registrerad på ditt konto.

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

Den här resursen har följande värden.

Värde Typ Beskrivning
Id-nummer snöre Appens Store-ID. Mer information om Store-ID finns i Visa information om appidentitet.
primärnamn snöre Appens primära namn.
paketfamiljenamn snöre Appens paketfamiljenamn.
paketIdentityNamn snöre Appens paketidentitetsnamn.
Utgivarens namn snöre Det Windows-utgivar-ID som är associerat med appen. Detta motsvarar värdet Package/Identity/Publisher som visas på sidan Appidentitet för appen i Partnercenter.
förstaPubliceringsDatum snöre Det datum då appen först publicerades, i ISO 8601-format.
senastPubliceradeAnsökningsinlämning objekt En inlämningsresurs som innehåller information om den senast publicerade inlämningen för appen.
inskickande av ansökan väntar objekt En insändningsresurs som innehåller information om den aktuella väntande insändningen för appen.
harAvanceradListningsBehörighet booleskt Anger om du kan konfigurera gamingOptions eller trailers för inlämningar för appen. Det här värdet gäller för inlämningar som skapats efter maj 2017.

Tilläggsresurs

Den här resursen innehåller information om ett tillägg.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Den här resursen har följande värden.

Värde Typ Beskrivning
produkt-ID i app snöre Store-ID:t för tillägget. Det här värdet anges av Store. Ett exempel på butiks-ID är 9NBLGGH4TNMP.

Flygresurs

Den här resursen innehåller information om en paketflygning för en app.

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

Den här resursen har följande värden.

Värde Typ Beskrivning
flightId snöre ID:t för paketresan. Det här värdet anges av Partnercenter.
användarvänligt namn snöre Namnet på flygpaketet som specificerats av utvecklaren.
senastPubliceradeFlyginsändning objekt En inlämningsresurs som innehåller information om den senaste publicerade inlämningen för paketflygningen.
väntande flyginlämning objekt En resurs för inlämningsproceduren som ger information om den aktuella pågående inlämningen av paketflyg.
grupp-ID:n samling En matris med strängar som innehåller ID:t för de flyggrupper som är associerade med paketflygningen. Mer information om flyggrupper finns i Paketflyg.
rankas högre än snöre Det vänliga namnet på det flygpaket som rangordnas omedelbart lägre än det aktuella flygpaketet. Mer information om rangordning av flyggrupper finns i Paketflyg.

Inlämningsresurs

Den här resursen innehåller information om en inlämning. I följande exempel visas formatet för den här resursen.

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

Den här resursen har följande värden.

Värde Typ Beskrivning
Id-nummer snöre ID:t för insändningen.
resursplats snöre En relativ sökväg som du kan lägga till i bas-https://manage.devcenter.microsoft.com/v1.0/my/-förfrågnings-URI för att hämta fullständiga data för inskickandet.

 

  • Last updated on