Condividi tramite

Presentare un componente aggiuntivo

Usa questo metodo nell'API di invio del Microsoft Store per creare un nuovo componente aggiuntivo (noto anche come prodotto in-app o IAP) per un'app registrata nel tuo account Partner Center. Dopo aver creato correttamente un nuovo invio utilizzando questo metodo, aggiorna l'invio per apportare le modifiche necessarie ai dati dell'invio, e poi conferma l'invio per l'inserimento e la pubblicazione.

Per altre informazioni su come questo metodo rientra nel processo di creazione di un invio di componente aggiuntivo tramite l'API di invio a Microsoft Store, vedere Gestire gli invii di componenti aggiuntivi.

Annotazioni

Questo metodo crea una sottomissione per un componente aggiuntivo esistente. Per creare un componente aggiuntivo, usare il metodo Creare un componente aggiuntivo.

Prerequisiti

Per usare questo metodo, è prima necessario eseguire le operazioni seguenti:

  • Se non l'hai già fatto, completa tutti i prerequisiti per l'API di invio al Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
  • Creare un componente aggiuntivo per una delle app. È possibile eseguire questa operazione nel Centro per i partner oppure usare il metodo Creare un componente aggiuntivo.

Richiesta

Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di utilizzo e descrizioni dell'intestazione e del corpo della richiesta.

Metodo URI della richiesta
INSERISCI https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

Header di richiesta

Intestazione TIPO Descrizione
Autorizzazione corda Obbligatorio. Il token di accesso di Azure AD nel formato Bearer<token>.

Parametri della richiesta

Nome TIPO Descrizione
inAppProductId (identificativo del prodotto in-app) corda Obbligatorio. ID dello Store del componente aggiuntivo per il quale vuoi creare una sottomissione. L'ID dello Store è disponibile nel Centro per i partner ed è incluso nei dati di risposta per le richieste di Creare un componente aggiuntivo o ottenere i dettagli del componente aggiuntivo.

Testo della richiesta

Non bisogna fornire il corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come creare una nuova presentazione per un componente aggiuntivo.

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

Risposta

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Il corpo della risposta contiene informazioni sul nuovo invio. Per ulteriori dettagli sui valori nel corpo della risposta, consultare la risorsa per l'invio di componenti aggiuntivi .

{
  "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": [
      {
         "name": "Sale1",
         "basePriceId": "Free",
         "startDate": "2016-05-21T18:40:11.7369008Z",
         "endDate": "2016-05-22T18:40:11.7369008Z",
         "marketSpecificPricings": {
            "RU": "NotAvailable"
         }
      }
    ],
    "priceId": "Free",
    "isAdvancedPricingModel": true
  },
  "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"
}

Codici di errore

Se la richiesta non può essere completata correttamente, la risposta conterrà uno dei codici di errore HTTP seguenti.

Codice di errore Descrizione
400 Impossibile creare l'invio perché la richiesta non è valida.
409 Impossibile creare l'invio a causa dello stato corrente dell'app o l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.
  • Last updated on