Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Usa la API de envío de Microsoft Store para consultar y crear envíos para aplicaciones, complementos y vuelos de paquetes para tu cuenta del Centro de partners o de tu organización. Esta API es útil si su cuenta administra muchas aplicaciones o complementos, y desea automatizar y optimizar el proceso de envío de estos recursos. Esta API usa Azure Active Directory (Azure AD) para autenticar las llamadas desde la aplicación o el servicio.
En los pasos siguientes se describe el proceso de un extremo a otro para usar la API de envío de Microsoft Store:
- Asegúrate de haber completado todos los requisitos previos .
- Antes de llamar a un método en la API de envío de Microsoft Store, obtén un token de acceso de Azure AD. Después de obtener un token, tienes 60 minutos para usar este token en llamadas a la API de envío de Microsoft Store antes de que expire el token. Una vez que expire el token, puede generar un nuevo token.
- Llamar a la API de envío de Microsoft Store.
Importante
Si utiliza esta API para crear una publicación para una aplicación, distribución de paquete o complemento, asegúrese de realizar cambios adicionales en la publicación solo mediante la API, en lugar de en el Centro de Partners. 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 publicar la presentación en el Centro de partners.
Nota:
Esta API no se puede usar con aplicaciones o complementos que usan actualizaciones de aplicaciones obligatorias y complementos consumibles administrados por la Tienda. Si usas la API de envío de Microsoft Store con una aplicación o complemento que usa una de estas características, la API devolverá un código de error 409. En este caso, debes usar el Centro de partners para administrar los envíos de la aplicación o el complemento.
Nota:
No puede usar esta API con aplicaciones o complementos que están en Pricing Version 2. Un producto está en precios versión 2 si hay un botón Revisar precio por mercado en la sección Precios de la página Precios y disponibilidad . Si usas la API de envío de Microsoft Store con una aplicación o un complemento que se encuentra en la versión de precios 2, la API devolverá un plan desconocido para la parte de precios. Puede seguir usando esta API para actualizar módulos distintos de Precios y disponibilidad.
Paso 1: Completar los requisitos previos para usar la API de envío de Microsoft Store
Antes de empezar a escribir código para llamar a la API de envío de Microsoft Store, asegúrese de que ha completado los siguientes requisitos previos.
Usted (o su organización) debe tener un directorio de Azure AD y debe tener administrador global permiso para el directorio. Si ya usa Microsoft 365 u otros servicios empresariales de Microsoft, ya tiene el directorio de Azure AD. De lo contrario, puede crear un nuevo Azure AD en el Centro de partners sin cargo adicional.
Debe asociar una aplicación de Azure AD a su cuenta del Centro de asociados y obtener su ID de inquilino, el ID de cliente y la clave. Necesita estos valores para obtener un token de acceso de Azure AD, que usará en llamadas a la API de envío de Microsoft Store.
Prepare la aplicación para usarla con la API de envío de Microsoft Store:
Si la aplicación aún no existe en el Centro de Partners, debes crear la aplicación reservando su nombre en el Centro de Partners. No puedes usar la API de envío de Microsoft Store para crear una aplicación en el Centro de partners; Debes trabajar en el Centro de partners para crearlo y, después, puedes usar la API para acceder a la aplicación y crear envíos mediante programación para ella. Sin embargo, puede usar la API para crear programáticamente complementos y paquetes de vuelos antes de crear submisiones para ellos.
Para poder crear un envío para una aplicación determinada mediante esta API, primero debe crear un envío para la aplicación en el Centro de partners, incluida la respuesta a las clasificaciones por edades de cuestionario. Después de hacerlo, podrá crear mediante programación nuevos envíos para esta aplicación mediante la API. No es necesario crear un envío de complemento ni un envío de paquete de vuelo antes de usar la API para esos tipos de envíos.
Si va a crear o actualizar un envío de aplicación y necesita incluir un paquete de aplicación, prepara el paquete de la aplicación.
Si vas a crear o actualizar un envío de aplicación y necesitas incluir capturas de pantalla o imágenes para la descripción de la Tienda, prepara las capturas de pantalla e imágenes de la aplicación.
Si va a crear o actualizar el envío de un complemento y necesita incluir un icono, prepare el icono.
Asociación de una aplicación de Azure AD con la cuenta del Centro de socios
Para poder usar la API de envío de Microsoft Store, debes asociar una aplicación de Azure AD a tu cuenta del Centro de partners, recuperar el identificador de inquilino y el identificador de cliente de la aplicación y generar una clave. La aplicación de Azure AD representa la aplicación o servicio desde la que quieres llamar a la API de envío de Microsoft Store. Necesitas el ID de inquilino, el ID de cliente y la clave para obtener un token de acceso de Azure AD que se pasa a la API.
Nota:
Solo tiene que realizar esta tarea una vez. Una vez que tenga el identificador de inquilino, el identificador de cliente y la clave, puede reutilizarlos cada vez que necesite crear un nuevo token de acceso de Azure AD.
En el Centro de Partners, asegúrese de asociar la cuenta del Centro de Partners de su organización con el directorio de Azure AD de su organización.
A continuación, en la sección Configuración de la cuenta del Centro de Partners, en la página Usuarios, agregue la aplicación de Azure AD que representa la aplicación o el servicio que usará para acceder a las presentaciones de la cuenta del Centro de Partners. Asegúrese de asignar a esta aplicación el rol de Manager. Si la aplicación aún no existe en el directorio de Azure AD, puede crear una nueva aplicación de Azure AD en el Centro de partners.
Vuelva a la página Usuarios, haga clic en el nombre de su aplicación de Azure AD para ir a la configuración de la aplicación, y copie los valores de ID de inquilino y ID de cliente .
Haga clic en Agregar nueva clave. En la pantalla siguiente, copie el valor de la clave . No podrá acceder a esta información de nuevo después de salir de esta página. Para más información, consulte Administración de claves para una aplicación de Azure AD.
Paso 2: Obtención de un token de acceso de Azure AD
Antes de llamar a cualquiera de los métodos de la API de envío de Microsoft Store, primero debe obtener un token de acceso de Azure AD que pase al encabezado de autorización de de cada método de la API. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede actualizar el token para poder seguir utilizándolo en llamadas adicionales a la API.
Para obtener el token de acceso, siga las instrucciones de Llamadas de servicio a servicio mediante credenciales de cliente para enviar un POST HTTP al punto de conexión https://login.microsoftonline.com/<tenant_id>/oauth2/token. Esta es una solicitud de ejemplo.
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com
Para el valor de tenant_id en el URI POST y los parámetros client_id y client_secret, especifique el ID de inquilino, el ID de cliente y la clave de la aplicación que recuperó del Centro de Socios en la sección anterior. Para el parámetro del recurso
Una vez que expire el token de acceso, puede capturar uno nuevo mediante la realización de la misma llamada HTTP de nuevo.
Para obtener ejemplos que muestran cómo obtener un token de acceso mediante código de C#, Java o Python, consulte los ejemplos de código de la API de envío de Microsoft Store.
Paso 3: Usar la API de envío de Microsoft Store
Una vez que disponga de un token de acceso de Azure AD, puede invocar métodos de la API de envío de Microsoft Store. La API incluye muchos métodos que se agrupan en escenarios para aplicaciones, complementos y versiones de paquetes. Para crear o actualizar envíos, normalmente llamas a varios métodos en la API de envío de Microsoft Store siguiendo un orden específico. Para obtener información sobre cada escenario y la sintaxis de cada método, consulte los artículos de la tabla siguiente.
Nota:
Después de obtener un token de acceso, tienes 60 minutos para invocar métodos en la API de envío de Microsoft Store antes de que expire el token.
| Escenario | Descripción |
|---|---|
| Aplicaciones | Recupera datos de todas las aplicaciones registradas en tu cuenta de Partner Center y crea publicaciones para las aplicaciones. Para obtener más información sobre estos métodos, consulte los siguientes artículos: |
| Complementos | Obtén, crea o elimina complementos para tus aplicaciones y, a continuación, obtén, crea o elimina envíos para dichos complementos. Para obtener más información sobre estos métodos, consulte los siguientes artículos: |
| Vuelos en paquete | Obtenga, cree o elimine vuelos de paquetes para sus aplicaciones y, a continuación, obtenga, cree o elimine envíos para los vuelos de paquetes. Para obtener más información sobre estos métodos, consulte los siguientes artículos: |
Ejemplos de código
En los artículos siguientes se proporcionan ejemplos de código detallados que muestran cómo usar la API de envío de Microsoft Store en varios lenguajes de programación diferentes:
- Ejemplo de código C#: presentaciones de aplicaciones, complementos y vuelos
- ejemplo de C#: envío de aplicaciones con opciones de juego y tráilers
- ejemplo de código Java: propuestas para aplicaciones, complementos y vuelos
- ejemplo de Java: envío de aplicaciones con opciones de juego y tráilers
- Muestra de Python: presentaciones para aplicaciones, complementos y vuelos
- Ejemplo en Python: envío de aplicaciones con opciones de juego y tráilers
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.
Solución de problemas
| Cuestión | Resolución |
|---|---|
| Después de llamar a la API de envío de Microsoft Store desde PowerShell, los datos de respuesta de la API están dañados si los convierte de formato JSON a un objeto de PowerShell mediante el cmdlet ConvertFrom-Json y, a continuación, vuelven al formato JSON mediante el cmdlet ConvertTo-Json . | De forma predeterminada, el parámetro -Depth para el cmdlet ConvertTo-Json se establece en 2 niveles de objetos, que es demasiado superficial para la mayoría de los objetos JSON devueltos por la API de envío de Microsoft Store. Al llamar al cmdlet ConvertTo-Json , establezca el parámetro -Depth en un número mayor, como 20. |
Ayuda adicional
Si tiene preguntas sobre la API de envío de Microsoft Store o necesita ayuda para administrar los envíos con esta API, use los siguientes recursos:
- Haga sus preguntas en nuestros foros.
- Visite nuestra página de soporte y solicite una de las opciones de asistencia técnica para el Centro de socios. Si se le pide que elija un tipo de problema y una categoría, elija Envío y certificación de la aplicación y Enviar una aplicación, respectivamente.