Hämta alla tillägg

Använd den här metoden i Microsoft Store-api:et för att hämta data för alla tillägg för alla appar som är registrerade på ditt Partnercenter-konto.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för inlämning till Microsoft Store-API:et.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begäran om URI
FÅ https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Förfrågningshuvudrad

Rubrik Typ Beskrivning
Auktorisering snöre Obligatoriskt. Azure AD-åtkomsttokenet i formen Bearer<token>.

Parametrar för begäran

Alla parametrar för begäran är valfria för den här metoden. Om du anropar den här metoden utan parametrar innehåller svaret data för alla tillägg för alla appar som är registrerade på ditt konto.

Parameter Typ Beskrivning Krävs
topp Int Antalet objekt som ska returneras i begäran (d.s. antalet tillägg som ska returneras). Om ditt konto har fler tillägg än det värde som du anger i frågan innehåller svarstexten en relativ URI-sökväg som du kan lägga till i metod-URI:n för att begära nästa sida med data. Nej
hoppa över Int Antalet objekt som ska kringgås i frågan innan de återstående objekten returneras. Använd den här parametern för att bläddra igenom datauppsättningar. Till exempel hämtar top=10 och skip=0 objekten 1 till och med 10, top=10 och skip=10 hämtar objekten 11 till 20 och så vidare. Nej

begäranens innehåll

Ange ingen begärandetext för den här metoden.

Exempel på begäran

I följande exempel visas hur du hämtar alla tilläggsdata för alla appar som är registrerade på ditt konto.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer <your access token>

I följande exempel visas hur du endast hämtar de första 10 tilläggen.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Svar

I följande exempel visas JSON-svarstexten som returneras av en lyckad begäran för de första 5 tilläggen som är registrerade på ett utvecklarkonto med totalt 1 072 tillägg. I det här exemplet visas bara data för de två första tilläggen som returneras av begäran. Mer information om värdena i svarstexten finns i följande avsnitt.

{
  "@nextLink": "inappproducts/?skip=5&top=5",
  "value": [
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMP",
      "productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243619",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243705",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
      }
    },
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMN",
      "productId": "6a3c9788-a350-448a-bd32-16160a13018a",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243538",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243106",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
      }
    },

  // Other add-ons omitted for brevity...
  ],
  "totalCount": 1072
}

Svarsdel

Värde Typ Beskrivning
@nextLink snöre Om det finns ytterligare sidor med data, innehåller den här strängen 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:n för att begära nästa sida med data. Om parametern översta i den ursprungliga begärandetexten är inställd på 10 men det finns 100 tillägg registrerade på ditt konto, innehåller svarstexten ett @nextLink värde för inappproducts?skip=10&top=10, vilket indikerar att du kan anropa https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 för att begära nästa 10 tillägg.
värde samling En matris som innehåller objekt som innehåller information om varje tillägg. Mer information finns i tilläggsresurs.
totalt antal Int Antalet appobjekt i -värdet matrisen i svarstexten.

Felkoder

Om begäran inte kan slutföras innehåller svaret någon av följande HTTP-felkoder.

Felkod Beskrivning
404 Inga tillägg hittades.
409 Apparna eller tilläggen använder Partner Center-funktioner som för närvarande inte stöds av Microsoft Store-API:et för överföring.
  • Last updated on