Freigeben über

Ein Add-On erhalten

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Informationen zu einem Add-On (auch als In-App-Produkt oder IAP bezeichnet) für eine App abzurufen, die für Ihr Partner Center-Konto registriert ist.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes ausführen:

  • Wenn Sie dies noch nicht getan haben, erledigen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.
  • Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfrage

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Kopfzeile und des Anforderungstexts.

Methode Anforderungs-URI
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}

Anforderungs-Kopfzeile

Kopfzeile Typ BESCHREIBUNG
Autorisierung Schnur Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Name Typ BESCHREIBUNG
id Schnur Erforderlich. Die Store-ID des abzurufenden Add-Ons. Die Store-ID ist im Partner Center verfügbar.

Anfragekörper

Geben Sie keinen Request-Body für diese Methode an.

Beispielanfrage

Das folgende Beispiel veranschaulicht, wie Informationen zu einem Add-On abgerufen werden.

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

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode angezeigt. Weitere Informationen zu den Werten im Antworttext finden Sie unter Erweiterungsressource.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "Test-add-on",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode BESCHREIBUNG
404 Das angegebene Add-On konnte nicht gefunden werden.
409 Die Erweiterung verwendet eine Funktion des Partner Centers, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.