Freigeben über

Aktualisieren einer Add-On-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine vorhandene Add-On-Übermittlung (auch als In-App-Produkt oder IAP bezeichnet) zu aktualisieren. Nachdem Sie eine Übermittlung mithilfe dieser Methode erfolgreich aktualisiert haben, müssen Sie die Übermittlung für die Aufnahme und Veröffentlichung übernehmen.

Weitere Informationen dazu, wie diese Methode in den Prozess der Erstellung einer Add-On-Übermittlung mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Add-On-Übermittlungen.

Voraussetzungen

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

Anfordern

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

Methode Anforderungs-URI
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Name Typ Beschreibung
inAppProductId Zeichenfolge Erforderlich. Die Store-ID des Add-Ons, für das Sie eine Übermittlung aktualisieren möchten. Die Store-ID ist im Partner Center verfügbar und ist in den Antwortdaten für Anforderungen zum Erstellen eines Add-Ons oder Abrufen von Add-On-Details enthalten.
submissionId Zeichenfolge Erforderlich. Die ID der zu aktualisierenden Übermittlung. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Add-On-Übermittlung verfügbar. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite im Partner Center verfügbar.

Anforderungstext

Der Anforderungstext weist die folgenden Parameter auf.

Wert Typ BESCHREIBUNG
contentType Zeichenfolge Der Inhaltstyp, der im Add-On bereitgestellt wird. Dies kann einer der folgenden Werte sein:
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Asp
  • OnlineDownload
keywords array Ein Array von Zeichenfolgen, die bis zu 10 Schlüsselwörter für das Add-On enthalten. Ihre App kann mithilfe dieser Schlüsselwort (keyword) nach Add-Ons abfragen.
Lebensdauer Zeichenfolge Die Lebensdauer des Add-Ons. Dies kann einer der folgenden Werte sein:
  • Endlos
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ThreeMonths
  • SixMonths
  • OneYear
listings Objekt Ein Objekt, das Eintragsinformationen für das Add-On enthält. Weitere Informationen finden Sie unter Listing-Ressource.
Preise Objekt Ein Objekt, das Preisinformationen für das Add-On enthält. Weitere Informationen finden Sie in der Preisressource.
targetPublishMode Zeichenfolge Der Veröffentlichungsmodus für die Übermittlung. Dies kann einer der folgenden Werte sein:
  • Direkt
  • Manuell
  • SpecificDate
targetPublishDate Zeichenfolge Das Veröffentlichungsdatum für die Übermittlung im ISO 8601-Format, wenn der targetPublishMode auf SpecificDate festgelegt ist.
tag Zeichenfolge Die benutzerdefinierten Entwicklerdaten für das Add-On (diese Informationen wurden zuvor als Tag bezeichnet).
Sichtbarkeit Zeichenfolge Die Sichtbarkeit des Add-Ons. Dies kann einer der folgenden Werte sein:
  • Ausgeblendet
  • Öffentlich
  • Privat
  • NotSet

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie eine Add-On-Übermittlung aktualisiert wird.

PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
}

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Der Antworttext enthält Informationen zur aktualisierten Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie in der Add-On-Übermittlungsressource.

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
  "friendlyName": "Submission 2"
}

Fehlercodes

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

Fehlercode Beschreibung
400 Die Übermittlung konnte nicht aktualisiert werden, da die Anforderung ungültig ist.
409 Die Übermittlung konnte aufgrund des aktuellen Zustands des Add-Ons nicht aktualisiert werden, oder das Add-On verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.