Commit an add-on submission (Confirmar 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 la ingesta 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.
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 y actualice el envío con los cambios necesarios en los datos de envío.
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 solicitud |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit |
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 que contiene el envío que quieres confirmar. El identificador de la Tienda está disponible en el Centro de partners y se incluye en los datos de respuesta de las solicitudes para obtener todos los complementos y Crear un complemento. |
| submissionId | string | Necesario. Identificador del envío que desea confirmar. 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
No proporcione un cuerpo de solicitud para este método.
Ejemplo de solicitud
En el ejemplo siguiente se muestra cómo confirmar 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 la respuesta
| Valor | Tipo | Descripción |
|---|---|---|
| estado | string | El estado del envío. Este puede ser uno de los siguientes valores:
|
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 | 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. |