Crear y administrar usuarios
Usa la API de envío de Microsoft Store para consultar y crear envíos mediante programación para aplicaciones, complementos y paquetes piloto para tu cuenta del Centro de partners 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 utiliza Azure Active Directory (Azure AD) para autenticar las llamadas desde la aplicación o el servicio.
En los pasos siguientes se describe el proceso completo para utilizar la API de envío de Microsoft Store:
- Asegúrese de que ha completado todos los requisitos previos.
- Antes de llamar a un método en la API de envío de Microsoft Store, obtenga un token de acceso de Azure AD. Después de obtener un token, tiene 60 minutos para utilizar este token en llamadas a la API de envío de Microsoft Store antes de que el token expire. Después de que el token expire, puede generar uno nuevo.
- Llame a la API de envío de Microsoft Store.
Importante
Si usa esta API para crear un envío para una aplicación, paquete piloto o complemento, asegúrese de realizar cambios adicionales en el envío 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 quedar en un estado de error que le impedirá continuar con el proceso de envío. Si esto ocurre, debe eliminar el envío y crear uno nuevo.
Importante
No puede usar esta API para publicar envíos de compras por volumen a través de la Microsoft Store para Empresas y Microsoft Store para Educación o publicar envíos para aplicaciones loB directamente en empresas. En ambos escenarios, debe usar publicar el envío 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.
Paso 1: Completar los requisitos previos para utilizar 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) tiene que tener un directorio de Azure AD y el permiso de Administrador global para el directorio. Si usa Microsoft 365 u otros servicios empresariales de Microsoft, ya tiene el directorio de Azure AD. De lo contrario, puede crear una nueva instancia de Azure AD en el Centro de partners sin cargo adicional.
Tiene que asociar una aplicación Azure AD a su cuenta del Centro de partners y obtener el identificador de inquilino, el identificador de cliente y la clave. Necesitará estos valores para obtener un token de acceso de Azure AD, que usará en las 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, para crearla, debe reservar el nombre en el Centro de partners. No puede utilizar la API de envío de Microsoft Store para crear una aplicación en el Centro de partners; debe trabajar en el Centro de partners para crearla y, después, puede utilizar 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 complementos y paquetes piloto mediante programación antes de crear envíos 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 al cuestionario de clasificaciones por edades . Después de esto, podrá crear mediante programación nuevos envíos para esta aplicación a través de la API. No es necesario crear un envío de complemento ni un envío de paquete piloto 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, prepare el paquete de la aplicación.
Si va a crear o actualizar un envío de aplicación y tiene que incluir capturas de pantalla o imágenes para la descripción de Store, prepare las capturas de pantalla e imágenes de la aplicación.
Si va a crear o actualizar un envío de complemento y necesita incluir un icono, prepare el icono.
Cómo asociar una aplicación de Azure AD con la cuenta del Centro de partners
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 el servicio desde donde desea llamar a la API de envío de Microsoft Store. Necesita el identificador de inquilino, el identificador de cliente y la clave para obtener un token de acceso de Azure AD para pasar 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 volver a usarlos cada vez que tenga que crear un nuevo token de acceso de Azure AD.
En el Centro de partners, asocie la cuenta del Centro de partners de la organización con el directorio de Azure AD de la organización.
A continuación, en la página Usuarios en la sección Configuración de la cuenta del Centro de partners, agregue la aplicación de Azure AD que representa la aplicación o el servicio que usará para obtener acceso a los envíos de la cuenta del Centro de partners. Asegúrese de asignar a esta aplicación el rol Administrador. 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 la aplicación de Azure AD para ir a la configuración de la aplicación y, a continuación, copie los valores de Identificador de inquilino e Identificador de cliente.
Haga clic en Agregar nueva clave. En la pantalla siguiente, copie el valor de Clave. Después de salir de esta página no podrá tener acceso de nuevo a esta información. Para más información, consulta Administrar claves para una aplicación de Azure AD.
Paso 2: Obtener 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 Authorization de cada método de la API. 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 actualizarlo para poder seguir utilizándolo en llamadas adicionales a la API.
Para obtener el token de acceso, siga las instrucciones de Llamadas entre servicios mediante las credenciales del cliente para enviar una solicitud HTTP POST 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 tenant_id en el URI POST y los parámetros client_id y client_secret, especifique el identificador de inquilino, el identificador de cliente y la clave de la aplicación que recuperó del Centro de partners en la sección anterior. Para el parámetro resource, tiene que especificar https://manage.devcenter.microsoft.com.
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: Utilizar la API de envío de Microsoft Store
Después de tener un token de acceso de Azure AD, puede llamar a métodos en la API de envío de Microsoft Store. La API incluye muchos métodos que se agrupan en escenarios para aplicaciones, complementos y paquetes piloto. Para crear o actualizar envíos, normalmente llamas a varios métodos en la API de envío de Microsoft Store en un orden específico. Para obtener información acerca de cada escenario y la sintaxis de cada método, consulte los artículos en la tabla siguiente:
Nota:
Después de obtener un token de acceso, tienes 60 minutos para llamar a 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 del Centro de partners y crea envíos para aplicaciones. Para obtener más información sobre estos métodos, consulte los siguientes artículos: |
| Complementos | Obtenga, cree o elimine complementos para las aplicaciones y, a continuación, obtenga, cree o elimine envíos para los complementos. Para obtener más información sobre estos métodos, consulte los siguientes artículos: |
| Paquetes piloto | Obtenga, cree o elimine paquetes piloto para las aplicaciones y, a continuación, obtenga, cree o elimine envíos para los paquetes piloto. 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#: envíos para aplicaciones, complementos y vuelos
- Ejemplo de C#: envío de aplicaciones con opciones de juego y finalizadores
- Ejemplo de Java: envíos para aplicaciones, complementos y vuelos
- Ejemplo de Java: envío de aplicaciones con opciones de juego y finalizadores
- Ejemplo de Python: envíos para aplicaciones, complementos y vuelos
- Ejemplo de Python: envío de aplicaciones con opciones de juego y finalizadores
Módulo StoreBroker de PowerShell
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 la línea de comandos sobre la API. Este módulo se denomina StoreBroker. Puede utilizar este módulo para administrar los envíos de aplicaciones, versiones piloto y complementos desde la línea de comandos en lugar de llamar directamente a la API de envío de Microsoft Store, o simplemente puede 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 principal forma en que muchas aplicaciones propias se envían al almaceń.
Para obtener más información, consulte nuestra página StoreBroker en GitHub.
Solución de problemas
| Problema | 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, utilice los siguientes recursos:
- Formule preguntas en nuestros foros.
- Visite nuestra página de soporte técnico y solicite una de las opciones de soporte técnico asistido para el Centro de partners. 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 Envío de una aplicación, respectivamente.