Aggiornare un invio di componente aggiuntivo

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per aggiornare un invio di un componente aggiuntivo esistente (anche denominato prodotto in-app o IAP). Dopo aver aggiornato correttamente un invio usando questo metodo, è necessario confermare l'invio per l'inserimento e la pubblicazione.

Per ulteriori informazioni su questo metodo nell'ambito del processo di creazione di un invio di un componente aggiuntivo mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di componenti aggiuntivi.

Prerequisiti

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

  • Se non lo si ha ancora fatto, completare i prerequisiti per l'API di invio di 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, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
  • Creare un invio di un componente aggiuntivo per una delle app. È possibile eseguire questa operazione nel Centro per i partner, oppure usando il metodo di creazione di un invio di un componente aggiuntivo.

Richiedi

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

metodo URI della richiesta
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Nome Tipo Descrizione
inAppProductId string Obbligatorio. ID dello Store del componente aggiuntivo per il quale si desidera aggiornare un invio. L'ID dello Store è disponibile nel Centro per i partner ed è incluso nei dati di risposta per le richieste di creazione di un componente aggiuntivo o recupero dei dettagli del componente aggiuntivo.
submissionId string Obbligatorio. L'ID dell'invio da aggiornare. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un invio di un componente aggiuntivo. Per un invio creato nel Centro per i partner, questo ID è disponibile anche nell'URL per la pagina di invio nel Centro per i partner.

Corpo della richiesta

Il corpo della richiesta include i seguenti parametri.

Valore Tipo Descrizione
contentType string Il tipo di contenuto fornito nel componente aggiuntivo. I valori possibili sono i seguenti:
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Asp
  • OnlineDownload
parole chiave array Matrice di stringhe che contengono fino a 10 parole chiave per il componente aggiuntivo. L'app può eseguire query per i componenti aggiuntivi usando queste parole chiave.
lifetime string Durata del componente aggiuntivo. I valori possibili sono i seguenti:
  • Sempre
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ThreeMonths
  • SixMonths
  • OneYear
presentazioni oggetto Oggetto che contiene informazioni di presentazione per il componente aggiuntivo. Per altre informazioni, vedere Risorsa presentazioni.
prezzi oggetto Oggetto che contiene informazioni di prezzo per il componente aggiuntivo. Per altre informazioni, vedere Risorsa di prezzo.
targetPublishMode string Modalità di pubblicazione per l'invio. I valori possibili sono i seguenti:
  • Immediate
  • Manuale
  • SpecificDate
targetPublishDate string Data di pubblicazione per l'invio in formato ISO 8601, se targetPublishMode è impostato su SpecificDate.
tag string I dati per sviluppatori personalizzati per il componente aggiuntivo (queste informazioni sono state precedentemente chiamate tag).
visibility string Visibilità del componente aggiuntivo. I valori possibili sono i seguenti:
  • Nascosta
  • Pubblico
  • Privato
  • NotSet

Esempio di richiesta

L'esempio seguente illustra come aggiornare un invio di un componente aggiuntivo.

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",
}

Response

Nell'esempio seguente viene illustrato il corpo della risposta JSON per una chiamata riuscita a questo metodo. Il corpo della risposta contiene informazioni sull'invio aggiornato. Per ulteriori dettagli sui valori nel corpo della risposta, vedere Risorsa di invio del componente aggiuntivo.

{
  "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"
}

Codici di errore

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

Codice di errore Description
400 Impossibile aggiornare l'invio perché la richiesta non è valida.
409 Impossibile aggiornare l'invio a causa dello stato corrente del componente aggiuntivo oppure perché il componente usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.