Compartir a través de


Realizar un envío de complemento

Usa este método en la API de envío de Microsoft Store para confirmar un envío de complemento nuevo o actualizado (también conocido como producto desde la aplicación o IAP) al Centro de partners. La acción de confirmación alerta al Centro de partners de que se han cargado los datos de envío (incluidos los iconos relacionados). En respuesta, el Centro de Partners confirma los cambios en los datos de envío para su incorporación y publicación. Una vez que la operación de confirmación se realiza correctamente, los cambios en el envío se muestran en el Centro de Partners.

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

Prerrequisitos

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

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Crear un de envío de complemento y, a continuación, actualizar el de envío con los cambios necesarios en los datos de envío.

Solicitud

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 Solicitud de URI
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Nombre Tipo Descripción
inAppProductId (ID de producto en la aplicación) cuerda / cadena Obligatorio. ID de la tienda del complemento que contiene la publicación que quieres confirmar. El identificador de la Tienda está disponible en el Centro de Partners y se incluye en los datos de respuesta para las solicitudes de Obtener todos los complementos y Crear un complemento.
Id de envío cuerda / cadena Obligatorio. Identificador del envío que desea confirmar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear una presentación de complemento. Para una presentación que se creó en el Centro de socios, este identificador también está disponible en la URL de la página de la presentación en el Centro de socios.

Cuerpo de la solicitud

No incluya un contenido de la solicitud para este método.

Ejemplo de solicitud

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

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

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte las secciones siguientes.

{
  "status": "CommitStarted"
}

Cuerpo de respuesta

Importancia Tipo Descripción
estado cuerda / cadena Estado del envío. Este puede ser uno de los siguientes valores:
  • Ninguno
  • Cancelado
  • CompromisoPendiente
  • CommitStarted
  • Falló el commit
  • Pendiente de publicación
  • Publicación
  • Publicado
  • Error de publicación
  • Preprocesamiento
  • Error en el preprocesamiento
  • Certificación
  • Fallo de certificación
  • Versión
  • Lanzamiento fallido

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 Descripción
400 Los parámetros de solicitud no son válidos.
404 No se encontró el envío especificado.
409 Se encontró el envío especificado, pero no se pudo confirmar en su estado actual 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.