Compartir vía

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

  • Artículo

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 mientras sigue en estado de 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, solo el originador de MPO puede eliminar la oferta privada.

Solicitar

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

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización Cadena Necesario. Token de acceso de Microsoft Entra con el formato Bearer <token>.

Parámetros de solicitud

$version: obligatorio. Esta es la versión del esquema que se usa en la solicitud.

Cuerpo de la solicitud

{
    "$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.

Retirada de una oferta privada existente

Use este método para retirar una oferta privada existente. Retirar una oferta significa que el cliente ya no podrá acceder a ella.

Nota:

En el caso de las ofertas privadas de varias partes, el ISV puede retirar una oferta privada enviada si el asociado del canal aún no lo ha publicado y lo ha puesto a disposición del cliente final. El asociado de canal solo puede retirar una oferta privada publicada si el cliente no la ha aceptado. Si la oferta privada ya está disponible para que el cliente acepte e ISV tenga que realizar cambios en ella, el asociado de canal debe retirar primero la oferta privada para que el ISV pueda retirar y revertir la oferta privada a un estado de borrador para realizar modificaciones.

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

Solicitar

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

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización Cadena Necesario. Token de acceso de Microsoft Entra con el formato Bearer <token>.

Parámetros de solicitud

$version: obligatorio. Esta es la versión del esquema que se usa en la solicitud.

Cuerpo de la solicitud (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": "withdrawn"
        }
    ]
}

Cuerpo de la solicitud (para partner 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": "withdrawn"
        }
    ]
}

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