Dela via

Skapa ett privat erbjudande för en CSP-partner

  • Artikel

Använd den här metoden för att skapa ett nytt privat erbjudande för en kund.

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

Ange information om det privata erbjudandet med hjälp av schemat isv för att återförsäljare marginal privat erbjudande . Du måste inkludera ett namn.

{
 "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01", 
  "resources": [ 
    { 
       "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15", 
       "privateOfferType": "cspPromotion",
       "name": "privateOffercsp1034",
       "state": "live",
       "variableStartDate": false,
       "start": "2022-01-31",
       "end": "2022-02-28",
       "preparedBy": "amy@contoso.com",
       "notificationContacts": [ "amy@contoso.com" ],
       "beneficiaries": [ 
          { "id": "xxxxxxx-0a32-4b44-b904-39dd964dd790", "description": "Top First CSP"}
       ], 
       "pricing": [ 
          { "product": "product/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage","discountPercentage": 5 }
       ]
    }
  ]
}

Exempel på begärandetext

Exempelbegäran för ett återförsäljarerbjudande begränsat till en angiven mottagare

Om du skapar en marginal för en återförsäljare som gäller för en specifik kund lägger du till den informationen som ett objekt i parametermatrisen beneficiaryRecipients under mottagare.

Begärandetexten ser ut som följande exempel:

[
    {
        "id": "xxxxxxx-0a32-4b44-b904-39dd964dd790",
        "description": "Top First CSP",
        "beneficiaryRecipients": [
            {
                "id": "xxxxxxx-48b4-af80-66333cd9c609",
                "recipientType": "cspCustomer"
            }
        ]
    }
],

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.

Relaterat innehåll