Freigeben über

Verwalten von Add-Ons

  • Artikel

Verwenden Sie die folgenden Methoden in der Microsoft Store-Übermittlungs-API, um Add-Ons für Ihre Apps zu verwalten. Eine Einführung in die Microsoft Store-Übermittlungs-API, einschließlich der Voraussetzungen für die Verwendung der API, finden Sie unter Erstellen und Verwalten von Übermittlungen mithilfe von Microsoft Store-Diensten.

Diese Methoden können nur verwendet werden, um Add-Ons abzurufen, zu erstellen oder zu löschen. Informationen zum Erstellen von Übermittlungen für Add-Ons finden Sie unter den Methoden unter "Verwalten von Add-On-Übermittlungen".

Method URI Beschreibung
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Abrufen aller Add-Ons für Ihre Apps
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Abrufen eines bestimmten Add-Ons
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Erstellen eines Add-Ons
DELETE https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Löschen eines Add-Ons

Voraussetzungen

Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API aus, bevor Sie versuchen, eine dieser Methoden zu verwenden.

Datenressourcen

Die Methoden der Microsoft Store-Übermittlungs-API zum Verwalten von Add-Ons verwenden die folgenden JSON-Datenressourcen.

Add-On-Ressource

Diese Ressource beschreibt ein Add-On.

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

Diese Ressource weist die folgenden Werte auf:

Wert Typ Beschreibung
applications array Ein Array, das eine Anwendungsressource enthält, die die App darstellt, der dieses Add-On zugeordnet ist. In diesem Array wird nur ein Element unterstützt.
id Zeichenfolge Die Store-ID des Add-Ons. Dieser Wert wird vom Store bereitgestellt. Ein Beispiel für die Store-ID ist 9NBLGGH4TNMP.
productId Zeichenfolge Die Produkt-ID des Add-Ons. Dies ist die ID, die vom Entwickler beim Erstellen des Add-Ons bereitgestellt wurde. Weitere Informationen finden Sie unter Festlegen des Produkttyps und der Produkt-ID.
productType Zeichenfolge Der Produkttyp des Add-Ons. Die folgenden Werte werden unterstützt: Durable und Consumable.
lastPublishedInAppProductSubmission Objekt Eine Übermittlungsressource , die Informationen zur letzten veröffentlichten Übermittlung für das Add-On bereitstellt.
pendingInAppProductSubmission Objekt Eine Übermittlungsressource , die Informationen zur aktuellen ausstehenden Übermittlung für das Add-On bereitstellt.

Anwendungsressource

Diese Ressource ruft die App auf, der ein Add-On zugeordnet ist. Im folgenden Beispiel wird das Format dieser Ressource veranschaulicht.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
}

Diese Ressource weist die folgenden Werte auf:

Wert Typ BESCHREIBUNG
value Objekt Ein Objekt, das die folgenden Werte enthält:
  • id. Die Store-ID der App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
  • resourceLocation. Ein relativer Pfad, den Sie an den Basisanforderungs-URI https://manage.devcenter.microsoft.com/v1.0/my/ anfügen können, um die vollständigen Daten für die App abzurufen.
totalCount int Die Anzahl der App-Objekte im Anwendungsarray des Antworttexts.

Submission-Ressource

Diese Ressource enthält Informationen zu einer Übermittlung für ein Add-On. Im folgenden Beispiel wird das Format dieser Ressource veranschaulicht.

{
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
}

Diese Ressource weist die folgenden Werte auf:

Wert Typ Beschreibung
id Zeichenfolge Die ID der Übermittlung
resourceLocation Zeichenfolge Ein relativer Pfad, den Sie an den Basisanforderungs-URI https://manage.devcenter.microsoft.com/v1.0/my/ anfügen können, um die vollständigen Daten für die Übermittlung abzurufen.