API de envío del Centro de partners para incorporar aplicaciones de Azure en el centro de Partners

  • Artículo

Use la API de envío del Centro de partners para consultar, crear envíos y publicar ofertas de Azure mediante programación. Esta API es útil si su cuenta administra muchas ofertas y desea automatizar y optimizar el proceso de envío de estas ofertas.

Requisitos previos de la API

Para usar la API del Centro de partners para los productos de Azure necesita algunos recursos de programación:

  • una aplicación de Azure Active Directory.
  • un token de acceso de Azure Active Directory (Azure AD).

Paso 1: Cumplimentación los requisitos previos para el uso de la API de envío del Centro de partners

Antes de empezar a escribir código para llamar a la API de envío del Centro de partners, asegúrese de que ha completado los requisitos previos a continuación.

Cómo asociar una aplicación de Azure AD con la cuenta del Centro de partners

Para usar la API de envío de Microsoft Store, tiene que asociar una aplicación Azure AD a su cuenta del Centro de partners, recuperar el identificador de inquilino y el identificador de cliente para 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 del Centro de partners. 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 operación 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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, consulte Administrar 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 del Centro de partners, primero tiene que obtener un token de acceso de Azure AD que pase al encabezado de autorización 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 futuras a la API.

Para obtener el token de acceso, siga las instrucciones de Llamadas entre servicios mediante las credenciales del cliente para enviar una HTTP POST al punto de conexión https://login.microsoftonline.com/<tenant_id>/oauth2/token. Esta es una solicitud de ejemplo:

JSONCopy

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://api.partner.microsoft.com

Para el valor tenant_id en el POST URI 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://api.partner.microsoft.com.

Paso 3: Uso de la API de envío de Microsoft Store

Una vez que tenga un token de acceso de Azure AD, puede llamar a los métodos en la API de envío del Centro de partners. Para crear o actualizar envíos, normalmente se llama a varios métodos en la API de envío del Centro de partners en un orden específico. Para obtener información acerca de cada escenario y la sintaxis de cada método, consulte el swagger de la API de ingesta.

https://ingestionapi-swagger.azureedge.net/#/

Pasos siguientes