Administración de ofertas privadas existentes a través de api

Puede usar api para eliminar o retirar ofertas privadas existentes.

Eliminación de una oferta privada existente

Use este método para eliminar una oferta privada existente cuando esté en estado borrador. Debe usar el identificador de la oferta privada para especificar qué oferta privada se va a eliminar. En el caso de las ofertas privadas de varias partes (MPO), solo el originador de MPO puede eliminar la oferta privada.

Solicitud

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización Cuerda Obligatorio. Token de acceso de Microsoft Entra en formato Bearer <token>.

Parámetros de solicitud

$version: requerida. Versión del esquema usado en la solicitud.

Cuerpo de la solicitud para la oferta privada del cliente

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
        {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705",
        "privateOfferType": "customerPromotion",
        "offerPricingType": "editExistingOfferPricingOnly",
        "state": "deleted"
        }
    ]
}

Cuerpo de la solicitud para MPO

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
        {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705",
        "privateOfferType": "multipartyPromotionOriginator",
        "state": "deleted"
        }
    ]
}

Respuesta

La respuesta contiene el jobId que puede usar más adelante para sondear el estado.

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
    "jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
    "jobStatus": "notStarted",
    "jobResult": "pending",
    "jobStart": "2021-12-21T21:29:54.9702903Z",
    "jobEnd": "0001-01-01",
    "errors": []
}

Códigos de error

Código de estado HTTP Descripción
401 Error de autenticación: asegúrese de que usa un token de acceso válido de Microsoft Entra.
400 Validación de esquema. Asegúrese de que el cuerpo de la solicitud sigue el esquema correcto e incluye todos los campos obligatorios.

Retirar una oferta privada existente

Use este método para retirar una oferta privada existente. Retirar una oferta significa que el cliente ya no puede acceder a ella y mueve la oferta privada al estado de borrador.

Nota:

En el caso de las ofertas privadas del cliente, el proveedor de software independiente (ISV) solo puede retirar ofertas privadas del cliente cuando la oferta no está aceptada y en la fase de aceptación pendiente. En el caso de ofertas privadas multipartitas, ISV puede retirar una oferta solo antes de la publicación por parte del socio de canal al cliente final. Una vez publicada la oferta, el asociado del canal solo puede retirarla antes de que el cliente la acepte. Si la oferta ya está disponible para la aceptación del cliente y el ISV debe realizar cambios, el partner del canal primero debe retirar la oferta antes de que el ISV pueda continuar con la retirada.

Debe usar el identificador de oferta privado para especificar qué oferta privada desea retirar.

Administración de una oferta privada retirada

Una vez que se retira una oferta privada, la única acción disponible para el ISV a través de la API es Eliminar. Para eliminar una oferta privada retirada, el ISV debe enviar una solicitud POST con el estado establecido en Eliminar. Para actualizar o volver a enviar esta oferta privada retirada, debe realizarse manualmente a través del portal del Centro de partners.

Una excepción se aplica al asociado de canal (CP) dentro de ofertas privadas de varias partes. Siempre que un ISV no se haya retirado, un asociado de canal puede actualizar y volver a enviar una oferta privada retirada de varias partes de manera programática, haciendo una solicitud POST con el estado establecido en Activo.

Solicitud

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

Encabezado de solicitud

Cabecera Tipo Descripción
Autorización Cuerda Obligatorio. Token de acceso de Microsoft Entra en formato Bearer <token>.

Parámetros de solicitud

$version: requerida. Versión del esquema que se usa en la solicitud.

Cuerpo de la solicitud para la oferta privada para el cliente (para ISV)

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
         {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705", 
        "privateOfferType": "customerPromotion",
        "offerPricingType": "editExistingOfferPricingOnly",
        "state": "draft"
        }
    ]
}

Cuerpo de la solicitud para la oferta privada de varias partes (para ISV)

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
         {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705", 
        "privateOfferType": "multipartyPromotionOriginator",
        "state": "draft"
        }
    ]
}

Cuerpo de la solicitud para la oferta privada de varias partes (para el asociado de Canal)

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
         {
        $schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705", 
        "privateOfferType": "multiPartyPromotionChannelPartner",
        "state": "draft"
        }
    ]
}

Respuesta

La respuesta contiene el jobId que puede usar más adelante para sondear el estado.

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
    "jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
    "jobStatus": "notStarted",
    "jobResult": "pending",
    "jobStart": "2021-12-21T21:29:54.9702903Z",
    "jobEnd": "0001-01-01",
    "errors": []
}

Códigos de error

Código de estado HTTP Descripción
401 Error de autenticación: asegúrese de que usa un token de acceso válido de Microsoft Entra.
400 Validación de esquema. Asegúrese de que el cuerpo de la solicitud sigue el esquema correcto e incluye todos los campos obligatorios.

Contenido relacionado

  • Last updated on