Compartir a través de

Actualización de un envío de complemento

  • Artículo

Usa este método en la API de envío de Microsoft Store para actualizar un envío de complemento existente (también conocido como producto desde la aplicación o IAP). Después de actualizar correctamente un envío mediante este método, debe confirmar el envío para la ingesta y publicación.

Para obtener más información sobre cómo encaja este método en el proceso de creación de un envío de complemento mediante la API de envío de Microsoft Store, consulta Administrar envíos de complementos.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Cree un envío de complemento para una de las aplicaciones. Puede hacerlo en el Centro de partners o puede hacerlo mediante el método Crear un envío de complemento.

Solicitar

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método URI de la solicitud
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Nombre Escribir Descripción
inAppProductId string Necesario. Identificador de la Tienda del complemento para el que quieres actualizar un envío. El identificador de la Tienda está disponible en el Centro de partners y se incluye en los datos de respuesta de las solicitudes para crear un complemento o obtener detalles del complemento.
submissionId string Necesario. Identificador del envío que se va a actualizar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de complemento. Para un envío creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página de envío en el Centro de partners.

Cuerpo de la solicitud

El cuerpo de la solicitud tiene los parámetros siguientes.

Valor Tipo Descripción
contentType string El tipo de contenido que se proporciona en el complemento. Este puede ser uno de los siguientes valores:
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Asp
  • OnlineDownload
palabras clave array Una matriz de cadenas que contiene hasta 10 palabras clave para el complemento. Su aplicación puede consultar complementos utilizando estas palabras clave.
lifetime string La vida útil del complemento. Este puede ser uno de los siguientes valores:
  • Siempre
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ThreeMonths
  • SixMonths
  • OneYear
listings objeto Objeto que contiene información de lista para el complemento. Para obtener más información, vea Enumerar el recurso.
Precios objeto Objeto que contiene información de precios para el complemento. Para obtener más información, consulte Recurso de precios.
targetPublishMode string El modo de publicación para el envío. Este puede ser uno de los siguientes valores:
  • Inmediato
  • Manual
  • SpecificDate
targetPublishDate string La fecha de publicación para el envío en formato ISO 8601, si targetPublishMode está establecido en SpecificDate.
etiqueta string Los datos de desarrollador personalizados para el complemento (esta información anteriormente se denominaba etiqueta).
visibility string La visibilidad del complemento. Este puede ser uno de los siguientes valores:
  • Oculto
  • Público
  • Privada
  • NotSet

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo actualizar un envío de complemento.

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

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. El cuerpo de la respuesta contiene información sobre el envío actualizado. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte Recurso de envío de complementos.

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

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Description
400 No se pudo actualizar el envío porque la solicitud no es válida.
409 No se pudo actualizar el envío debido al estado actual del complemento o el complemento usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.