Freigeben über


Verwalten von Add-Ons

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 in Verwalten von Add-On-Übermittlungen.

Methode URI (Uniform Resource Identifier) Beschreibung
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Alle Erweiterungen für Ihre Apps erhalten
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Abrufen eines bestimmten Add-Ons
SENDEN https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Erstellen eines Add-Ons
Löschen https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Löschen einer Erweiterung

Voraussetzungen

Wenn Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Einreichungs-API, bevor Sie eine dieser Methoden verwenden.

Datenressourcen

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

Zusatzressource

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 hat die folgenden Werte.

Wert Typ Beschreibung
Anwendungen 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 Schnur Die Store-ID des Add-Ons. Dieser Wert wird vom Store bereitgestellt. Ein Beispiel für die Store-ID ist 9NBLGGH4TNMP.
Produkt-ID Schnur 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.
Produkttyp Schnur Der Produkttyp des Add-Ons. Die folgenden Werte werden unterstützt: Durable und Consumable.
zuletztVeröffentlichtInAppProduktEinreichung Objekt Eine Übermittlungsressource, die Informationen zur letzten veröffentlichten Übermittlung für das Add-On bereitstellt.
ausstehende In-App-Produktübermittlung Objekt Eine Übermittlungsressource, die Informationen zur aktuell ausstehenden Übermittlung für das Add-On bereitstellt.

Anwendungsressource

Diese Ressource beschreibt die App, der eine Erweiterung zugeordnet ist. Im folgenden Beispiel wird das Format dieser Ressource veranschaulicht.

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

Diese Ressource hat die folgenden Werte.

Wert Typ Beschreibung
Wert 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 Details zur App-Identität.
  • resourceLocation-. Ein relativer Pfad, den Sie an den Basis-https://manage.devcenter.microsoft.com/v1.0/my/ Anforderungs-URI anfügen können, um die vollständigen Daten für die App abzurufen.
Gesamtanzahl INT Die Anzahl der App-Objekte im applications-Array des Antworttexts.

Übermittlungsressource

Diese Ressource enthält Informationen zu einer Einreichung für eine Erweiterung. Im folgenden Beispiel wird das Format dieser Ressource veranschaulicht.

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

Diese Ressource hat die folgenden Werte.

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