Dela via

Hantera befintliga privata erbjudanden via API

  • Artikel

Du kan använda API:er för att ta bort eller ta bort befintliga privata erbjudanden.

Ta bort ett befintligt privat erbjudande

Använd den här metoden för att ta bort ett befintligt privat erbjudande medan det fortfarande är i utkasttillstånd. Du måste använda det privata erbjudande-ID:t för att ange vilket privat erbjudande som ska tas bort. För privata erbjudanden för flera delar kan endast MPO-ursprunget ta bort det privata erbjudandet.

Förfrågan

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

Begärandehuvud

Header Typ Beskrivning
Auktorisering String Obligatoriskt. Microsoft Entra-åtkomsttoken i formuläret Bearer <token>.

Parametrar för begäran

$version - krävs. Det här är den version av schemat som används i begäran.

Request body

{
    "$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"
        }
    ]
}

Response

Svaret innehåller det jobId som du kan använda senare för att avsöka statusen.

{
    "$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": []
}

Felkoder

HTTP-statuskod beskrivning
401 Autentiseringsfel: Kontrollera att du använder en giltig Microsoft Entra-åtkomsttoken.
400 Schemaverifiering. Kontrollera att begärandetexten följer rätt schema och innehåller alla obligatoriska fält.

Dra tillbaka ett befintligt privat erbjudande

Använd den här metoden för att dra tillbaka ett befintligt privat erbjudande. Om du drar tillbaka ett erbjudande kan kunden inte längre komma åt det.

Kommentar

För privata erbjudanden för flera delar kan ISV dra tillbaka ett skickat privat erbjudande om kanalpartnern inte har publicerat och gjort det tillgängligt för slutkund ännu. Kanalpartnern kan bara dra tillbaka ett publicerat privat erbjudande om kunden inte har accepterat det. Om det privata erbjudandet redan har gjorts tillgängligt för kunden att acceptera och ISV måste göra ändringar i det, måste kanalpartnern först dra tillbaka det privata erbjudandet så att ISV sedan kan dra tillbaka och återställa det privata erbjudandet till ett utkasttillstånd för att göra ändringar.

Du måste använda det privata erbjudande-ID:t för att ange vilket privat erbjudande du vill dra tillbaka.

Förfrågan

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

Begärandehuvud

Header Typ Beskrivning
Auktorisering String Obligatoriskt. Microsoft Entra-åtkomsttoken i formuläret Bearer <token>.

Parametrar för begäran

$version - krävs. Det här är den version av schemat som används i begäran.

Begärandetext (för 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"
        }
    ]
}

Begärandetext (för Kanalpartner)

{
    "$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"
        }
    ]
}

Response

Svaret innehåller det jobId som du senare kan använda för att avsöka statusen.

{
    "$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": []
}

Felkoder

HTTP-statuskod beskrivning
401 Autentiseringsfel: Kontrollera att du använder en giltig Microsoft Entra-åtkomsttoken.
400 Schemaverifiering. Kontrollera att begärandetexten följer rätt schema och innehåller alla obligatoriska fält.

Relaterat innehåll