Condividi tramite

Aggiornare un invio di componente aggiuntivo

Usa questo metodo nell'API di invio a Microsoft Store per aggiornare un invio di componente aggiuntivo esistente (noto anche come prodotto in-app o IAP). Dopo aver aggiornato correttamente un invio usando questo metodo, è necessario confermare l'invio affinché venga elaborato e pubblicato.

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.

Prerequisiti

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

  • Se non è già stato fatto, completare tutti i prerequisiti per l'API di invio a 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 una sottomissione di estensione per una delle tue app. Puoi farlo nel Centro per i partner, oppure puoi farlo usando il metodo Creare un invio di 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
METTERE https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

Intestazione della richiesta

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

Parametri della richiesta

Nome Digitare Descrizione
inAppProductId (identificativo del prodotto in-app) corda Obbligatorio. ID dello Store del componente aggiuntivo per il quale vuoi aggiornare una presentazione. 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.
ID di sottomissione corda Obbligatorio. ID dell'invio da aggiornare. Questo ID è disponibile nei dati di risposta per le richieste di creare un invio di 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 ha i parametri seguenti.

Valore Digitare Descrizione
Tipo di Contenuto corda Tipo di contenuto fornito nel componente aggiuntivo. Può trattarsi di uno dei valori seguenti:
  • Non Impostato
  • ScaricaLibro
  • EMagazina
  • Giornale Elettronico
  • ScaricaMusica
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Aspide
  • Download online
Parole chiave elenco 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.
vita corda Durata del componente aggiuntivo. Può trattarsi di uno dei valori seguenti:
  • Per sempre
  • UnGiorno
  • ThreeDays
  • Cinque Giorni
  • OneWeek
  • TwoWeeks
  • Un Mese
  • TwoMonths
  • TreMesi
  • SixMonths
  • UnAnno
Annunci oggetto Oggetto che contiene informazioni di presentazione per il componente aggiuntivo. Per altre informazioni, vedere elenco di risorse.
Prezzi oggetto Oggetto che contiene informazioni sui prezzi per il componente aggiuntivo. Per altre informazioni, vedere Prezzi della risorsa.
Modalità di Pubblicazione di Target corda Modalità di pubblicazione della sottomissione. Può trattarsi di uno dei valori seguenti:
  • Immediato
  • Manuale
  • Data specifica
dataDiPubblicazioneTarget corda Data di pubblicazione per l'invio in formato ISO 8601, se il targetPublishMode è impostato su SpecificDate.
cartellino corda I dati personalizzati per sviluppatori per il componente aggiuntivo (queste informazioni erano precedentemente chiamate ).
visibilità corda Visibilità del componente aggiuntivo. Può trattarsi di uno dei valori seguenti:
  • Nascosto
  • Pubblico
  • Privato
  • Non Impostato

Esempio di richiesta

L'esempio seguente illustra come aggiornare la sottomissione di un'estensione.

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

Risposta

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Il corpo della risposta contiene informazioni sull'invio aggiornato. Per altri dettagli sui valori nel corpo della risposta, vedere risorsa 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": [],
    "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 correttamente, la risposta conterrà uno dei codici di errore HTTP seguenti.

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