Alle add-ons ophalen

Gebruik deze methode in de Microsoft Store-indienings-API om gegevens op te halen voor alle invoegtoepassingen voor alle apps die zijn geregistreerd bij uw Partnercentrum-account.

Vereiste voorwaarden

Als u deze methode wilt gebruiken, moet u eerst het volgende doen:

  • Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store-indienings-API voltooien.
  • Haal een Azure AD-toegangstoken op dat moet worden gebruikt in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.

Aanvraag

Deze methode heeft de volgende syntaxis. Zie de volgende secties voor gebruiksvoorbeelden en beschrijvingen van de header en aanvraagtekst.

Methode URI-aanvraag
TOEVOEGEN https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Header van het verzoek

Koptekst Typologie Beschrijving
Autorisatie touw Verplicht. Het Azure AD-toegangstoken in de vorm van Bearer<token>.

Aanvraagparameters

Alle aanvraagparameters zijn optioneel voor deze methode. Als u deze methode zonder parameters aanroept, bevat het antwoord gegevens voor alle invoegtoepassingen voor alle apps die zijn geregistreerd bij uw account.

Kenmerk Typologie Beschrijving Verplicht
Bovenaan int (integer) Het aantal items dat moet worden geretourneerd in het verzoek (oftewel het aantal te retourneren add-ons). Als uw account meer invoegtoepassingen heeft dan de waarde die u in de query opgeeft, bevat de antwoordtekst een relatief URI-pad dat u kunt toevoegen aan de methode-URI om de volgende pagina met gegevens aan te vragen. Nee.
overslaan int (integer) Het aantal items dat moet worden overgeslagen in de query voordat de resterende items worden geretourneerd. Gebruik deze parameter om door gegevenssets te bladeren. Met top=10 en skip=0 worden bijvoorbeeld items 1 tot en met 10 opgehaald, top=10 en skip=10 worden items 11 tot en met 20 opgehaald, enzovoort. Nee.

Inhoud van het verzoek

Geef geen aanvraagbody op voor deze methode.

Voorbeelden opvragen

In het volgende voorbeeld ziet u hoe u alle invoegtoepassingsgegevens ophaalt voor alle apps die zijn geregistreerd bij uw account.

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

In het volgende voorbeeld ziet u hoe u alleen de eerste 10 invoegtoepassingen ophaalt.

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

Reactie

In het volgende voorbeeld ziet u de hoofdtekst van het JSON-antwoord dat is geretourneerd door een geslaagde aanvraag voor de eerste vijf invoegtoepassingen die zijn geregistreerd bij een ontwikkelaarsaccount met 1072 totale invoegtoepassingen. Voor de leesbaarheid toont dit voorbeeld alleen de gegevens voor de eerste twee add-ons die door het verzoek worden geretourneerd. Zie de volgende sectie voor meer informatie over de waarden in de hoofdtekst van het antwoord.

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

Antwoordlichaam

Waarde Typologie Beschrijving
@nextLink touw Als er extra pagina's met gegevens zijn, bevat deze tekenreeks een relatief pad dat u kunt toevoegen aan de basis-https://manage.devcenter.microsoft.com/v1.0/my/ aanvraag-URI om de volgende pagina met gegevens aan te vragen. Als de initiële parameter van de initiële aanvraagbody bijvoorbeeld is ingesteld op 10 maar er 100 add-ons zijn geregistreerd voor uw account, bevat de antwoordbody een @nextLink waarde van inappproducts?skip=10&top=10, wat aangeeft dat u https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 kunt aanroepen om de volgende 10 add-ons aan te vragen.
waarde gegevensreeks Een matrix die objecten bevat die informatie bieden over elke invoegtoepassing. Zie invoegtoepassingsresourcevoor meer informatie.
totaalaantal int (integer) Het aantal app-objecten in de array van het antwoordlichaam.

Foutcodes

Als de aanvraag niet kan worden voltooid, bevat het antwoord een van de volgende HTTP-foutcodes.

Foutcode Beschrijving
404 Er zijn geen invoegtoepassingen gevonden.
409 De apps of invoegtoepassingen maken gebruik van partnercentrumfuncties die momenteel niet worden ondersteund door de Microsoft Store-inzendings-API.
  • Last updated on