Comparteix via

Referencia de la API del portal de socios en la nube

Nota:

Las API de Cloud Partner Portal se integran y seguirán funcionando en el Centro de partners. La transición introduce pequeños cambios. Revise los cambios en las API de CPP enumerados en este documento para asegurarse de que el código sigue funcionando después de la transición al Centro de partners. Las API de CPP solo deben usarse para los productos existentes que ya estaban integrados antes de la transición al Centro de partners; los nuevos productos deben usar las API de envío del Centro de partners.

Las API de REST de Cloud Partner Portal permiten la recuperación y manipulación programáticas de cargas de trabajo, ofertas y perfiles de editores. Las API usan el control de acceso basado en rol de Azure (RBAC de Azure) para aplicar los permisos correctos en el momento del procesamiento.

Esta referencia proporciona los detalles técnicos de las API de REST de Cloud Partner Portal. Los ejemplos de carga útil de este documento son solo de referencia y están sujetos a cambios a medida que se agregan nuevas funcionalidades.

Requisitos previos y consideraciones

Antes de usar las API, debe revisar:

  • El artículo Requisitos previos para obtener información sobre cómo agregar una entidad de servicio a la cuenta y obtener un token de acceso de Microsoft Entra para la autenticación.
  • Las dos estrategias de control de simultaneidad disponibles para llamar a estas API.
  • Otras consideraciones de la API, como el control de versiones y el control de errores.

Cambios en las API de CPP después de la migración al Centro de partners

API Descripción del cambio Impacto
POST Publicar, Transmitir, Cancelar En el caso de las ofertas migradas, el encabezado de respuesta tiene un formato diferente, pero sigue funcionando de la misma manera, lo que indica una ruta de acceso relativa para recuperar el estado de la operación. Al enviar cualquiera de las solicitudes POST correspondientes a una oferta, el encabezado Location tiene uno de estos dos formatos, en función del estado de migración de la oferta:
  • Ofertas no migradas
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Ofertas migradas
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
Operación GET En el caso de los tipos de oferta que anteriormente admitían el campo "correo electrónico de notificación" en la respuesta, este campo quedará en desuso y ya no se devolverá para las ofertas migradas. En el caso de las ofertas migradas, ya no enviaremos notificaciones a la lista de correos electrónicos especificada en las solicitudes. En su lugar, el servicio de API se alinea con el proceso de correo electrónico de notificación en el Centro de partners para enviar correos electrónicos. En concreto, se enviarán notificaciones a la dirección de correo electrónico establecida en la sección Información de contacto del vendedor de la configuración de la cuenta en el Centro de partners, para notificarle el progreso de la operación.

Revise la dirección de correo electrónico establecida en la sección Información de contacto del vendedor de la configuración de la cuenta en el Centro de partners para asegurarse de que se proporciona el correo electrónico correcto para las notificaciones.

Tareas comunes

En esta referencia se detallan las API para realizar las siguientes tareas comunes.

Ofertas

Operaciones

Publicar una aplicación

Otras tareas

Solución de problemas

Versiones y actualizaciones de la API

Actualizar ¿Qué ha cambiado?
12-2022 La API pública de CPP (versión 2017-10-31) ahora se actualiza para capturar clientId y clientSecret para el conector de Marketo mientras se configuran los clientes potenciales. Durante la configuración del cliente potencial, no es necesario proporcionar el campo serverId en el futuro. Esta actualización de la API no implica ninguna actualización de versión ni cambios importantes.
  • Last updated on