Compartir a través de

Administrar envíos de aplicaciones

La API de presentación de Microsoft Store proporciona métodos que puedes usar para administrar las presentaciones de tus aplicaciones, incluidos los despliegues graduales de paquetes. Para obtener una introducción a la API de envío de Microsoft Store, incluidos los requisitos previos para usar la API, consulta Crear y administrar envíos mediante los servicios de Microsoft Store.

Importante

Si usas la API de envío de la Microsoft Store para crear un envío de una aplicación, asegúrate de realizar más cambios en el envío solo mediante la API, en lugar de a través del Partner Center. Si usa el Centro de partners para cambiar un envío que creó originalmente mediante la API, ya no podrá cambiar ni confirmar ese envío mediante la API. En algunos casos, el envío podría dejarse en un estado de error en el que no puede continuar en el proceso de envío. Si esto ocurre, debe eliminar el envío y crear un nuevo envío.

Importante

No puedes usar esta API para publicar presentaciones para compras por volumen de a través de Microsoft Store para Empresas y Microsoft Store para Educación o para publicar presentaciones de aplicaciones LOB directamente a empresas. En ambos escenarios, debe usar el Centro de Partners para publicar la presentación.

Métodos para administrar envíos de aplicaciones

Use los métodos siguientes para obtener, crear, actualizar, confirmar o eliminar un envío de aplicación. Para poder usar estos métodos, la aplicación ya debe existir en la cuenta del Centro de Partners y primero debe crear una publicación para la aplicación en el Centro de Partners. Para obtener más información, consulte los requisitos previos de .

Método URI Descripción
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Obtener una presentación de aplicación existente
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status Obtener el estado de un envío existente de aplicaciones
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions Crear una nueva publicación de aplicación
PON https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Actualizar una presentación de aplicación existente
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit Enviar una nueva o actualizada presentación de aplicación
ELIMINAR https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Eliminación de una presentación de aplicación

Crear una presentación de aplicación

Para crear un envío para una aplicación, siga este proceso.

  1. Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.

    Nota:

    Asegúrese de que la aplicación ya tenga al menos un envío completado con la información de las clasificaciones de edad completada.

  2. Obtener un token de acceso de Azure AD. Debes pasar este token de acceso a los métodos de la API de envío de aplicaciones de Microsoft Store. 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.

  3. Crear un envío de aplicación ejecutando el siguiente método en la API de envío de Microsoft Store. Este método crea un nuevo envío en curso, que es una copia del último envío publicado.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions

    El cuerpo de la respuesta contiene un envío de la aplicación recurso que incluye el identificador del nuevo envío, el URI de la firma de acceso compartido (SAS) para cargar los archivos relacionados para el envío a Azure Blob Storage (como paquetes de aplicaciones, mostrar imágenes y archivos finalizados) y todos los datos del nuevo envío (como las descripciones e información de precios).

    Nota:

    Un URI de SAS proporciona acceso a un recurso seguro en Azure Storage sin necesidad de claves de cuenta. Para obtener información general sobre los URI de SAS y su uso con Azure Blob Storage, consulte firmas de acceso compartido, parte 1: Descripción del modelo de SAS y firmas de acceso compartido, parte 2: Creación y uso de una SAS con Blob Storage.

  4. Si va a agregar nuevos paquetes, listar imágenes o archivos de tráiler para el envío, preparar los paquetes de la aplicación y preparar las capturas de pantalla de la aplicación, imágenes y tráilers. Agregue todos estos archivos a un archivo ZIP.

  5. Revise los datos de envío de la aplicación con los cambios necesarios para el nuevo envío, y ejecute el siguiente método para actualizar el envío de la aplicación.

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

    Nota:

    Si va a agregar nuevos archivos para el envío, asegúrese de actualizar los datos de envío para hacer referencia al nombre y la ruta de acceso relativa de estos archivos en el archivo ZIP.

  6. Si está agregando nuevos paquetes, enumerando imágenes o archivos de tráiler para el envío, cargue el archivo ZIP en Azure Blob Storage utilizando el URI SAS que se proporcionó en el cuerpo de respuesta del método POST que llamó anteriormente. Hay diferentes bibliotecas de Azure que puede usar para hacerlo en una variedad de plataformas, entre las que se incluyen:

    En el ejemplo de código de C# siguiente se muestra cómo cargar un archivo ZIP en Azure Blob Storage mediante la clase CloudBlockBlob en la biblioteca cliente de Azure Storage para .NET. En este ejemplo se supone que el archivo ZIP ya se ha escrito en un objeto de secuencia.

    string sasUrl = "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";
Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
    new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
await blockBob.UploadFromStreamAsync(stream);

  7. Confirmar el envío de la aplicación ejecutando el método siguiente. Esto avisará al Centro de asociados que ha completado su envío y que las actualizaciones deben aplicarse ahora a su cuenta.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit

  8. Compruebe el estado de confirmación ejecutando el método siguiente para obtener el estado del envío de la aplicación.

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status

    Para confirmar el estado del envío, revise el valor del estado en el cuerpo de la respuesta. Este valor debe cambiar de CommitStarted a PreProcessing si la solicitud tiene éxito o a CommitFailed si hay errores en la solicitud. Si hay errores, el campo statusDetails contiene más detalles sobre el error.

  9. Una vez completado correctamente el commit, el envío se envía a la tienda para el procesamiento. Puedes seguir supervisando el progreso del envío mediante el método anterior o visitando el Centro de partners.

Métodos para administrar un lanzamiento gradual de paquetes

Puedes implementar gradualmente los paquetes actualizados en un envío de aplicación a un porcentaje de los clientes de la aplicación en Windows 10 y Windows 11. Esto le permite supervisar los comentarios y los datos analíticos de los paquetes específicos para asegurarse de que está seguro de la actualización antes de implementarla de forma más amplia. Puede cambiar el porcentaje de lanzamiento (o detener la actualización) de un envío publicado sin tener que crear un nuevo envío. Para obtener más información, incluidas las instrucciones para habilitar y administrar un lanzamiento gradual de paquetes en el Centro de partners, consulte este artículo.

Para habilitar mediante programación un lanzamiento gradual de paquetes para un envío de aplicación, siga este proceso mediante métodos en la API de envío de Microsoft Store:

  1. Crear un envío de una aplicación o obtener un envío de una aplicación existente.
  2. En los datos de respuesta, localice el recurso packageRollout, configure el campo isPackageRollout en truey configure el campo packageRolloutPercentage en el porcentaje de clientes de tu aplicación que deben recibir los paquetes actualizados.
  3. Pase los datos de envío de la aplicación actualizados al actualice un método de envío de aplicación.

Una vez habilitada una implementación gradual de paquetes para un envío de aplicación, puedes usar los métodos siguientes para obtener, actualizar, detener o finalizar la implementación gradual mediante programación.

Método URI Descripción
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout Obtener la información de lanzamiento gradual de un envío de aplicación
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage Actualizar el porcentaje de lanzamiento gradual en un envío de aplicaciones
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout Detener el lanzamiento gradual de una aplicación para la presentación de aplicaciones
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout Finalizar el despliegue gradual de una presentación de aplicación

Ejemplos de código para administrar envíos de aplicaciones

En los artículos siguientes se proporcionan ejemplos de código detallados que muestran cómo crear un envío de aplicación en varios lenguajes de programación diferentes:

Módulo de PowerShell StoreBroker

Como alternativa a llamar directamente a la API de envío de Microsoft Store, también proporcionamos un módulo de PowerShell de código abierto que implementa una interfaz de línea de comandos sobre la API. Este módulo se denomina StoreBroker. Puedes usar este módulo para administrar los envíos de aplicaciones, vuelos y complementos desde la línea de comandos en lugar de llamar directamente a la API de envío de Microsoft Store, o simplemente puedes examinar el origen para ver más ejemplos de cómo llamar a esta API. El módulo StoreBroker se usa activamente en Microsoft como la forma principal de enviar muchas aplicaciones de primera entidad a la Tienda.

Para obtener más información, consulte nuestra página de StoreBroker en GitHub.

Recursos de datos

Los métodos de la API de envío de Microsoft Store para administrar envíos de aplicaciones usan los siguientes recursos de datos JSON.

Recurso para el envío de aplicaciones

Este recurso describe un envío de aplicación.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
          "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "description": "Main page",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
identificación cuerda / cadena El identificador del envío. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de aplicación, obtener todas las aplicacionesy obtener una aplicación. 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.
categoría de aplicación cuerda / cadena Una cadena que especifica la categoría y/o la subcategoría para tu aplicación. Las categorías y subcategorías se combinan en una sola cadena con el carácter de subrayado "_", como BooksAndReference_EReader.
Precios objeto Un recurso de precios que contiene información de precios para la aplicación.
visibilidad cuerda / cadena Visibilidad de la aplicación. Este puede ser uno de los siguientes valores:
  • Oculto
  • Público
  • Privada
  • NotSet
modoDePublicaciónObjetivo cuerda / cadena Modo de publicación de la presentación. Este puede ser uno de los siguientes valores:
  • Inmediata
  • Manual de instrucciones
  • FechaEspecífica
fechaObjetivoDePublicación cuerda / cadena La fecha de publicación del envío en formato ISO 8601, si el modo de publicación objetivo (targetPublishMode) está establecido en una fecha específica (SpecificDate).
Listados objeto Diccionario de pares de clave y valor, donde cada clave es un código de país y cada valor es un recurso del listado que contiene información del listado para la aplicación.
preferencias de hardware arreglo Matriz de cadenas que definen las preferencias de hardware para la aplicación. Este puede ser uno de los siguientes valores:
  • Toque
  • Teclado
  • Ratón
  • Cámara
  • NfcHce
  • NFC
  • BluetoothLE
  • Telefonía
copiaDeSeguridadAutomáticaActivada booleano Indica si Windows puede incluir los datos de la aplicación en copias de seguridad automáticas en OneDrive. Para obtener más información, consulte Declaraciones de aplicación.
puedeInstalarEnMediosExtraíbles booleano Indica si los clientes pueden instalar la aplicación en un almacenamiento extraíble. Para obtener más información, consulte Declaraciones de aplicación.
¿Está habilitado el DVR de Juego? booleano Indica si el DVR del juego está habilitado para la aplicación.
opciones de juego arreglo Matriz que contiene un recurso de opciones de juego que define la configuración relacionada con el juego para la aplicación.
tieneProductosExternosEnLaAplicación booleano Indica si la aplicación permite a los usuarios realizar compras fuera del sistema de comercio de Microsoft Store. Para obtener más información, consulte Declaraciones de aplicación.
cumplirConLasDirectricesDeAccesibilidad booleano Indica si la aplicación se ha probado para cumplir las directrices de accesibilidad. Para obtener más información, consulte Declaraciones de aplicación.
notasParaCertificación cuerda / cadena Contiene notas para la certificación de su aplicació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
detalles del estado objeto Un estado detalla el recurso que contiene detalles adicionales sobre el estado del envío, incluida la información sobre los errores.
fileUploadUrl cuerda / cadena URI de firma de acceso compartido (SAS) para subir paquetes para la presentación. Si está agregando nuevos paquetes, enumerando imágenes o archivos de tráiler para el envío, cargue el archivo ZIP que contiene los paquetes e imágenes en este URI. Para obtener más información, consulte Crear una presentación de aplicación.
paquetes de aplicaciones arreglo Conjunto de recursos del paquete de aplicación que proporcionan detalles sobre cada paquete en la presentación.
opcionesDeEntregaDePaquetes objeto Un recurso de opciones de entrega de paquetes que contiene el despliegue gradual de paquetes y las opciones de actualización obligatoria para la presentación.
licenciamiento empresarial cuerda / cadena Uno de los valores de licencia empresarial que indican el comportamiento de las licencias empresariales para la aplicación.
permitirAMicrosoftDecidirDisponibilidadDeAplicacionesParaFuturasFamiliasDeDispositivos booleano Indica si Microsoft puede hacer que la aplicación esté disponible para futuras familias de dispositivos Windows 10 y Windows 11.
permitirObjetivoFuturasFamiliasDeDispositivos objeto Diccionario de pares clave y valor, donde cada clave corresponde a una familia de dispositivos de Windows 10 y Windows 11, y cada valor es un booleano que indica si la aplicación está permitida para tener como objetivo la familia de dispositivos especificada.
nombre amistoso cuerda / cadena Nombre amigable del envío, como se muestra en el Centro de partners. Este valor se genera automáticamente al crear el envío.
remolques arreglo Una matriz que contiene hasta 15 recursos de tráiler que representan tráilers de vídeo para las listas de aplicaciones.

Recurso de precios

Este recurso contiene información de precios para la aplicación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
período de prueba cuerda / cadena Cadena que especifica el período de prueba de la aplicación. Este puede ser uno de los siguientes valores:
  • SinPruebaGratuita
  • Un día
  • TrialNeverExpires
  • SevenDays
  • Quince Días
  • Treinta días
precios específicos del mercado objeto Diccionario de pares clave y valor, donde cada clave es un código de país ISO 3166-1 alfa-2 de dos letras y cada valor es un nivel de precio. Estos elementos representan los precios personalizados para tu aplicación en mercados específicos. Cualquier elemento de este diccionario anula el precio base especificado por el valor de priceId para el mercado especificado.
ventas arreglo En desuso. Un conjunto de recursos de venta que contienen información de ventas para la app.
priceId cuerda / cadena Un plan de tarifa que especifica el de precios base de para la aplicación.
ModeloDePreciosAvanzado booleano Si true, su cuenta de desarrollador tiene acceso al conjunto expandido de niveles de precios desde 0,99 USD hasta 1999,99 USD. Si false, su cuenta de desarrollador tiene acceso al conjunto original de niveles de precio desde 0,99 USD hasta 999,99 USD. Para obtener más información sobre los distintos niveles, consulte planes de tarifa.

Nota Este campo es de solo lectura.

Recurso comercial

Estos recursos contienen información de venta para una aplicación.

Importante

El recurso Sale ya no se admite y actualmente no se pueden obtener ni modificar los datos de venta de un envío de aplicación mediante la API de envío de Microsoft Store. En el futuro, actualizaremos la API de envío de Microsoft Store para introducir una nueva manera de acceder mediante programación a la información de ventas para envíos de aplicaciones.

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
nombre cuerda / cadena Nombre de la venta.
basePriceId cuerda / cadena El nivel de precios a usar para el precio base de la venta.
Fecha de inicio cuerda / cadena Fecha de inicio de la venta en formato ISO 8601.
fecha de finalización cuerda / cadena Fecha de finalización de la venta en formato ISO 8601.
precios específicos del mercado objeto Diccionario de pares clave y valor, donde cada clave es un código de país ISO 3166-1 alfa-2 de dos letras y cada valor es un nivel de precio. Estos elementos representan los precios personalizados para tu aplicación en mercados específicos. Cualquier elemento de este diccionario reemplaza el precio base especificado por el identificador basePriceId para el mercado especificado.

Enumerar recurso

Este recurso contiene información de descripción de una aplicación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
baseListing objeto La lista base de la información de la aplicación, que define la información de listado predeterminada para todas las plataformas.
modificaciones de plataforma objeto Diccionario de pares clave-valor, donde cada clave es una cadena que identifica una plataforma para la cual se debe sobrescribir la información del listado, y cada valor es un recurso de listado base (que contiene solo los valores desde la descripción hasta el título) que especifica la información del listado que se va a sobrescribir para la plataforma especificada. Las claves pueden tener los siguientes valores:
  • Desconocido
  • Windows80
  • Windows81
  • WindowsPhone71
  • WindowsPhone80
  • WindowsPhone81

Recurso base de listado

Este recurso contiene información de lista base para una aplicación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
Información de derechos de autor y marcas registradas cuerda / cadena propiedad intelectual y/o información de marca comercial opcionales.
palabras clave arreglo Conjunto de palabras clave para que tu aplicación aparezca en los resultados de búsqueda.
términos de la licencia cuerda / cadena Los términos de licencia opcionales para su aplicación.
Política de privacidad cuerda / cadena Este valor está obsoleto. Para establecer o cambiar la dirección URL de la directiva de privacidad de tu aplicación, debe hacerlo en la página de propiedades de del Centro de Partners. Puede omitir este valor de las llamadas a la API de presentación. Si establece este valor, se omitirá.
contacto de soporte cuerda / cadena Este valor está obsoleto. Para establecer o cambiar la URL de contacto de soporte o la dirección de correo electrónico de la aplicación, debe hacerlo en la página Propiedades de del Centro de Partners. Puede omitir este valor de las llamadas a la API de presentación. Si establece este valor, se omitirá.
URL del sitio web cuerda / cadena Este valor está obsoleto. Para establecer o cambiar la dirección URL de la página web de la aplicación, debe hacerlo en la página Properties del Centro de Partners. Puede omitir este valor de las llamadas a la API de presentación. Si establece este valor, se omitirá.
descripción cuerda / cadena La descripción de la lista de aplicaciones.
Características arreglo Una matriz de hasta 20 cadenas que enumeran las características de para tu aplicación.
releaseNotes cuerda / cadena Las notas de la versión de para la aplicación.
Imágenes arreglo Un conjunto de recursos de imágenes e íconos para el listado de aplicaciones.
hardware recomendado arreglo Matriz de hasta 11 cadenas que enumeran las configuraciones de hardware recomendadas para la aplicación.
hardware mínimo cuerda / cadena Matriz de hasta 11 cadenas que enumeran las configuraciones de hardware mínimas para tu aplicación.
título cuerda / cadena Título de la lista de aplicaciones.
descripción breve cuerda / cadena Solo se usa para juegos. Esta descripción aparece en la sección Información del Centro de juegos en Xbox One y ayuda a los clientes a comprender más sobre tu juego.
título corto cuerda / cadena Una versión más corta del nombre del producto. Si se proporciona, este nombre más corto puede aparecer en varios lugares de Xbox One (durante la instalación, en Logros, etc.) en lugar del título completo del producto.
sortTitle cuerda / cadena Si su producto se puede ordenar alfabéticamente de diferentes formas, puede ingresar otra versión aquí. Esto puede ayudar a los clientes a encontrar el producto más rápidamente al buscar.
Título de voz cuerda / cadena Un nombre alternativo para el producto que, si se proporciona, puede usarse en la experiencia de audio en Xbox One cuando se usa Kinect o un casco.
devStudio cuerda / cadena Especifique este valor si desea incluir un campo Desarrollado por en la lista. (El publicado por campo mostrará el nombre para mostrar del publicador asociado a su cuenta, independientemente de si proporciona o no un valor de devStudio).

Recurso de imagen

Este recurso contiene datos de imagen e icono para una lista de aplicaciones. Para obtener más información sobre las imágenes e iconos de una lista de aplicaciones, consulte Capturas de pantalla e imágenes de la aplicación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
Nombre del archivo cuerda / cadena Nombre del fichero de imagen en el archivo ZIP que cargó para la presentación.
estado del archivo cuerda / cadena Estado del archivo de imagen. Este puede ser uno de los siguientes valores:
  • Ninguno
  • Carga pendiente
  • Subido
  • PendienteDelete
identificación cuerda / cadena Identificador de la imagen. Este valor lo proporciona Partner Center.
descripción cuerda / cadena Descripción de la imagen.
tipoDeImagen cuerda / cadena Indica el tipo de la imagen. Actualmente se soportan las siguientes cadenas.

Imágenes de captura de pantalla:

  • Captura de pantalla (use este valor para la captura de pantalla de escritorio)
  • Captura de pantalla móvil
  • XboxScreenshot
  • SurfaceHubScreenshot
  • Captura de pantalla de HoloLens

Logotipos de la Tienda:

  • StoreLogo9x16
  • StoreLogoSquare
  • Icono (use este valor para el logotipo de 1:1 300 x 300 píxeles)

imágenes promocionales:

  • ArtePromocional16x9
  • ArtePromocional2400X1200

imágenes de Xbox:

  • XboxBrandedKeyArt
  • XboxTitledHeroArt
  • ArtePromocionalDestacadoDeXbox

imágenes promocionales opcionales:

  • SquareIcon358X358
  • BackgroundImage1000X800
  • ObraDeArtePromocional414X180

Recurso para opciones de juegos

Este recurso contiene la configuración relacionada con el juego para la aplicación. Los valores de este recurso corresponden a la configuración del juego para envíos en el Centro de partners.

{
  "gamingOptions": [
    {
      "genres": [
        "Games_ActionAndAdventure",
        "Games_Casino"
      ],
      "isLocalMultiplayer": true,
      "isLocalCooperative": true,
      "isOnlineMultiplayer": false,
      "isOnlineCooperative": false,
      "localMultiplayerMinPlayers": 2,
      "localMultiplayerMaxPlayers": 12,
      "localCooperativeMinPlayers": 2,
      "localCooperativeMaxPlayers": 12,
      "isBroadcastingPrivilegeGranted": true,
      "isCrossPlayEnabled": false,
      "kinectDataForExternal": "Enabled"
    }
  ],
}

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
Géneros arreglo Matriz de una o varias de las siguientes cadenas que describen los géneros del juego:
  • Games_ActionAndAdventure
  • Juegos_CartasYTablero
  • Juegos_Casino
  • Juegos_Educativos
  • Juegos_FamiliaYNiños
  • Juegos_de_Pelea
  • Juegos_Música
  • Games_Platformer
  • Juegos_RompecabezasYTrivia
  • Juegos_CarrerasYVuelo
  • Juegos_Rol
  • Juegos_de_tiro
  • Juegos_Simulación
  • Juegos_Deportes
  • Juegos_Estrategia
  • Games_Word
isLocalMultiplayer booleano Indica si el juego admite multijugador local.
esCooperativaLocal booleano Indica si el juego admite co-oplocal.
esMultijugadorEnLínea booleano Indica si el juego admite multijugador en línea.
isOnlineCooperative booleano Indica si el juego admite co-open línea.
localMultiplayerMinPlayers Int Especifica el número mínimo de jugadores que admite el juego para multijugador local.
localMultiplayerMaxPlayers Int Especifica el número máximo de jugadores que admite el juego para multijugador local.
localCooperativeMinPlayers Int Especifica el número mínimo de jugadores que admite el juego para la modalidad local co-op.
localCooperativeMaxPlayers Int Especifica el número máximo de jugadores que admite el juego para co-oplocal.
seHaConcedidoElPrivilegioDeTransmisión booleano Indica si el juego admite la difusión.
estáCrossPlayActivado booleano Indica si el juego admite sesiones multijugador entre jugadores en equipos Con Windows 10 y Windows 11 y Xbox.
kinectDataForExternal cuerda / cadena Uno de los siguientes valores de cadena que indica si el juego puede recopilar datos de Kinect y enviarlos a servicios externos:
  • NotSet
  • Desconocido
  • Activado
  • Deshabilitado

Nota:

El recurso gamingOptions se agregó en mayo de 2017, después de que la API de envío de Microsoft Store se lanzara por primera vez para los desarrolladores. Si creó un envío para una aplicación a través de la API de envío antes de que se introdujo este recurso y este envío todavía está en curso, este recurso será nulo para los envíos de la aplicación hasta que confirme correctamente el envío o lo elimine. Si el recurso gamingOptions no está disponible para envíos para una aplicación, el campo hasAdvancedListingPermission del recurso Application devuelto por el método obtener una aplicación es falso.

Recurso de detalles de estado

Este recurso contiene detalles adicionales sobre el estado de un envío. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
Errores objeto Conjunto de recursos de detalles de estado que contienen detalles de error de la presentación.
Advertencias objeto Conjunto de recursos de detalles de estado que contienen detalles de advertencia para la presentación.
informes de certificación objeto Conjunto de recursos relacionados con el informe de certificación que proporcionan acceso a los datos del informe de certificación para la presentación. Puede examinar estos informes para obtener más información si se produce un error en la certificación.

Recurso detallado de estado

Este recurso proporciona información adicional sobre cualquier error o advertencia relacionada con una presentación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
código cuerda / cadena Código de estado de envío que describe el tipo de error o advertencia.
Detalles cuerda / cadena Mensaje con más detalles sobre el problema.

Recurso del paquete de aplicación

Este recurso contiene detalles sobre un paquete de aplicación para el envío.

{
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
}

Este recurso tiene los siguientes valores.

Nota:

Al llamar al actualizar un método de envío de aplicación, solo los fileName, fileStatus, minimumDirectXVersiony mínimoSystemRam valores de este objeto son necesarios en el cuerpo de la solicitud. Los demás valores serán rellenados por el Centro de Partners.

Importancia Tipo Descripción
Nombre del archivo cuerda / cadena Nombre del paquete.
estado del archivo cuerda / cadena Estado del paquete. Este puede ser uno de los siguientes valores:
  • Ninguno
  • Carga pendiente
  • Subido
  • PendienteDelete
identificación cuerda / cadena Identificador que identifica de forma única el paquete. El Partner Center proporciona este valor.
Versión cuerda / cadena Versión del paquete de la aplicación. Para obtener más información, consulte numeración de versión del paquete.
arquitectura cuerda / cadena Arquitectura del paquete (por ejemplo, ARM).
Idiomas arreglo Matriz de códigos de idioma para los idiomas que admite la aplicación. Para obtener más información, vea idiomas admitidos.
Capacidades arreglo Matriz de funcionalidades requeridas por el paquete. Para obtener más información sobre las funcionalidades, consulte Declaraciones de funcionalidad de la aplicación.
versión mínima de DirectX cuerda / cadena Versión mínima de DirectX compatible con el paquete de la aplicación. Esto solo se puede establecer para aplicaciones destinadas a Windows 8.x. En el caso de las aplicaciones que tienen como destino otras versiones del sistema operativo, este valor debe estar presente al llamar al actualizar un método de envío de aplicación, pero se omite el valor especificado. Este puede ser uno de los siguientes valores:
  • Ninguno
  • DirectX93
  • DirectX100
memoriaRAMmínimaDelSistema cuerda / cadena La memoria RAM mínima que se requiere para el paquete de la aplicación. Esto solo se puede establecer para aplicaciones destinadas a Windows 8.x. En el caso de las aplicaciones que tienen como destino otras versiones del sistema operativo, este valor debe estar presente al llamar al actualizar un método de envío de aplicación, pero se omite el valor especificado. Este puede ser uno de los siguientes valores:
  • Ninguno
  • Memory2GB
targetDeviceFamilies arreglo Matriz de cadenas que representan las familias de dispositivos a las que se dirige el paquete. Este valor solo se usa para paquetes destinados a Windows 10; para los paquetes que tienen como destino versiones anteriores, este valor tiene el valor Ninguno. Actualmente se admiten las siguientes cadenas de familia de dispositivos para paquetes de Windows 10 y Windows 11, donde {0} es una cadena de versión de Windows 10 o Windows 11, como 10.0.10.10240.0, 10.0.10586.0 o 10.0.14393.0:
  • Windows.Universal versión mínima {0}
  • Versión mínima de Windows.Desktop {0}
  • Versión mínima de Windows.Mobile {0}
  • Versión mínima de Windows para Xbox {0}
  • Versión mínima de Windows.Holographic {0}

id="certification-report-resource"

Informe de certificación de recursos

Este recurso proporciona acceso a los datos del informe de certificación para un envío. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
fecha cuerda / cadena Fecha y hora en que se generó el informe, en formato ISO 8601.
URL de informe cuerda / cadena Dirección URL en la que puede acceder al informe.

Recurso de opciones de entrega de paquetes

Este recurso contiene el despliegue gradual de paquetes y la configuración de actualización obligatoria para la presentación.

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
packageRollout objeto Un recurso de despliegue de paquetes que contiene la configuración de lanzamiento gradual del paquete para la presentación.
esActualizaciónObligatoria booleano Indica si quieres tratar los paquetes de esta remisión como obligatorios para la autoinstalación de actualizaciones de la aplicación. Para obtener más información sobre los paquetes obligatorios para las actualizaciones de aplicaciones autoinstalados, consulte Descargar e instalar actualizaciones de paquetes para la aplicación.
fechaEfectivaDeActualizaciónObligatoria fecha Fecha y hora en que los paquetes de este envío son obligatorios, en formato ISO 8601 y zona horaria UTC.

Recurso de despliegue de paquetes

Este recurso contiene ajustes de implementación gradual de paquetes para la presentación. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
isPackageRollout booleano Indica si el despliegue gradual de paquetes está habilitado para el envío.
porcentajeDeDespliegueDelPaquete flotante Porcentaje de usuarios que recibirán los paquetes en el lanzamiento gradual.
estado de despliegue del paquete cuerda / cadena Una de las siguientes cadenas que indica el estado del lanzamiento gradual de los paquetes:
  • DespliegueDelPaqueteNoIniciado
  • DespliegueDelPaqueteEnProgreso
  • Despliegue del Paquete Completado
  • DespliegueDePaqueteDetenido
fallbackSubmissionId cuerda / cadena Identificador del envío que recibirán los clientes que no obtengan los paquetes de lanzamiento gradual.

Nota:

El packageRolloutStatus y el fallbackSubmissionId son valores que se asignan mediante el Centro de Socios, y no están destinados a ser establecidos por el desarrollador. Si incluye estos valores en un cuerpo de la solicitud, se omitirán estos valores.

Recurso de Tráilers

Este recurso representa un tráiler de vídeo para el listado de la aplicación. Los valores de este recurso corresponden a las opciones de trailers para los envíos en el Centro de Partners.

Puede agregar hasta 15 recursos de tráiler a la matriz de tráileres en un recurso de envío de aplicaciones . Para cargar archivos de vídeo del tráiler e imágenes en miniatura para un envío, agregue estos archivos al mismo archivo ZIP que contiene los paquetes y las imágenes de la lista para el envío, luego cargue este archivo ZIP en el URI de firma de acceso compartido (SAS) para el envío. Para obtener más información sobre cómo cargar el archivo ZIP en el URI de SAS, consulte Crear un envío de aplicación.

{
  "trailers": [
    {
      "id": "1158943556954955699",
      "videoFileName": "Trailers\\ContosoGameTrailer.mp4",
      "videoFileId": "1159761554639123258",
      "trailerAssets": {
        "en-us": {
          "title": "Contoso Game",
          "imageList": [
            {
              "fileName": "Images\\ContosoGame-Thumbnail.png",
              "id": "1155546904097346923",
              "description": "This is a still image from the video."
            }
          ]
        }
      }
    }
  ]
}

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
identificación cuerda / cadena Identificador del tráiler. El Partner Center proporciona este valor.
NombreDelArchivoDeVideo cuerda / cadena El nombre del archivo de vídeo del tráiler en el archivo ZIP que contiene archivos para la presentación.
videoFileId cuerda / cadena Identificador del archivo de vídeo tráiler. El Partner Center proporciona este valor.
recursosDeTráiler objeto Diccionario de pares clave y valor, donde cada clave es un código de lenguaje y cada valor es un recurso de recursos de finalizador que contiene recursos específicos de la configuración regional adicionales para el finalizador. Para obtener más información sobre los códigos de idioma admitidos, vea Idiomas admitidos.

Nota:

El trailers recurso se agregó en mayo de 2017, después de que la API de envío de Microsoft Store se lanzara por primera vez a los desarrolladores. Si creó un envío para una aplicación a través de la API de envío antes de que se introdujo este recurso y este envío todavía está en curso, este recurso será nulo para los envíos de la aplicación hasta que confirme correctamente el envío o lo elimine. Si los trailers del recurso no están disponibles para envíos en una aplicación, el campo tienePermisoDeListadoAvanzado del recurso Application devuelto por el método get an app es false.

Recurso de activos para tráiler

Este recurso contiene recursos adicionales específicos del local para un tráiler que está definido en un recurso de tráiler . Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
título cuerda / cadena Título adaptado del tráiler. El título se muestra cuando el usuario reproduce el tráiler en modo de pantalla completa.
lista de imágenes arreglo Una matriz que contiene un recurso de imagen que proporciona la imagen en miniatura para el tráiler. Solo puede incluir un recurso imagen en esta matriz.

Recurso de imagen (para un tráiler)

Este recurso describe la imagen en miniatura de un tráiler. Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
Nombre del archivo cuerda / cadena Nombre del archivo de imagen en miniatura en el archivo ZIP que subió para la presentación.
identificación cuerda / cadena Identificador de la imagen en miniatura. El Partner Center proporciona este valor.
descripción cuerda / cadena Descripción de la imagen en miniatura. Este valor es solo metadatos y no se muestra a los usuarios.

Enumeraciones

Estos métodos usan las siguientes enumeraciones.

Planes de tarifa

Los siguientes valores representan los niveles de precios disponibles en el recurso de precios para el envío de una aplicación.

Importancia Descripción
Base El plan de tarifa no está establecido; use el precio base de la aplicación.
No disponible La aplicación no está disponible en la región especificada.
Gratuito La aplicación es gratuita.
xxx nivel Cadena que especifica el plan de tarifa de la aplicación, en el formato Nivelxxxx. Actualmente, se admiten los siguientes intervalos de planes de tarifa:

  • Si el esAdvancedPricingModel valor del recurso de precios de es verdadero, los valores disponibles del plan de tarifa de la cuenta son Tier1012 - Tier1424.
  • Si el valor de esAdvancedPricingModel del recurso de precios es falso, los niveles de precios disponibles para su cuenta son Tier2 - Tier96.
Para ver la tabla completa de niveles de precios disponibles para su cuenta de desarrollador, incluidos los precios específicos del mercado asociados a cada nivel, vaya a la página Precio y disponibilidad para cualquiera de las presentaciones de aplicaciones en el Centro de Partners y haga clic en el vínculo ver tabla en la sección Mercados y precios personalizados (para algunas cuentas de desarrollador, este vínculo se encuentra en la sección Precios).

Valores de licencias empresariales

Los valores siguientes representan el comportamiento de licencias de la organización para la aplicación. Para obtener más información sobre estas opciones, consulte Opciones de licencias organizativas.

Nota:

Aunque puedes configurar las opciones de licencia de la organización para un envío de aplicación a través de la API de envío, no puedes usar esta API para publicar envíos para compras por volumen a través de Microsoft Store para Empresas y Microsoft Store para Educación. Para publicar envíos a Microsoft Store para Empresas y Microsoft Store para Educación, debes usar el Centro de Partners.

Importancia Descripción
Ninguno No hagas que tu aplicación esté disponible para empresas con licencias por volumen administradas por la Tienda (en línea).
En línea Ponga su aplicación a disposición de las empresas con licencias por volumen gestionadas por la Store.
En línea y fuera de línea Haga que la aplicación esté disponible para empresas con licencias por volumen administradas por la Tienda (en línea) y haga que la aplicación esté disponible para las empresas a través de licencias desconectadas (sin conexión).

Código de estado de envío

Los valores siguientes representan el código de estado de un envío.

Importancia Descripción
Ninguno No se especificó ningún código.
ArchivoInválido El archivo ZIP que contiene el paquete no es válido o tiene un formato de archivo no reconocido.
MissingFiles El archivo ZIP no tiene todos los archivos que se mostraron en los datos de envío o se encuentran en la ubicación incorrecta del archivo.
ErrorDeValidacionDelPaquete No se pudo validar uno o varios paquetes del envío.
Valor de Parámetro No Válido Uno de los parámetros del cuerpo de la solicitud no es válido.
Operación no válida La operación que intentó no es válida.
Estado inválido La operación que intentó no es válida para el estado actual del paquete de vuelo.
RecursoNoEncontrado No se encontró el paquete de vuelo especificado.
Error de servicio Un error interno del servicio impedía que la solicitud se realizara correctamente. Vuelva a intentar la solicitud.
Advertencia de exclusión de listado El desarrollador quitó un listado de un envío anterior o no incluyó información de listado admitida por el paquete.
Advertencia para unirse a la lista El desarrollador agregó una lista.
UpdateOnlyWarning El desarrollador está intentando insertar algo que solo tenga compatibilidad con actualizaciones.
Otros El envío está en un estado no reconocido o no clasificado.
AdvertenciaDeValidaciónDePaquete El proceso de validación del paquete produjo una advertencia.