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. Um Übermittlungen für Add-Ons zu erstellen, verwenden Sie die Methoden in Verwalten von Add-On-Übermittlungen.

Methode 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

Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen, 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"
  }
}

Die Ressource hat die folgenden Werte.

Wert Typ Beschreibung
applications array Ein Array mit genau einer Anwendungsressource, 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. Beispiel für eine Store-ID: 9NBLGGH4TNMP.
productId Zeichenfolge Die Produkt-ID des Add-Ons. Dies ist die ID, die vom Entwickler während der Erstellung des Add-Ons angegeben wurde. Weitere Informationen finden Sie unter Festlegen von Produkttyp und Produkt-ID für das IAP.
productType Zeichenfolge Der Produkttyp des Add-Ons. Die folgenden Werte werden unterstützt: Durable und Consumable.
lastPublishedInAppProductSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die letzte veröffentlichte Übermittlung für das Add-On.
pendingInAppProductSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die aktuelle ausstehende Übermittlung für das Add-On.

Anwendungsressource

Diese Ressource beschreibt die App, der ein Add-On zugeordnet ist. Das folgende Beispiel veranschaulicht das Format der Ressource.

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

Die Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
value Objekt (object) Ein Objekt, das die folgenden Werte enthält:
  • id. Die Store-ID der App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.
  • 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 applications-Array des Antworttexts.

Übermittlungsressource

Diese Ressource enthält Informationen über eine Übermittlung für ein Add-On. Das folgende Beispiel veranschaulicht das Format der Ressource.

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

Die Ressource hat die folgenden Werte.

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.