Freigeben über

Erstellen eines privaten Angebots für einen CSP-Partner

  • Artikel

Verwenden Sie diese Methode, um ein neues privates Angebot für einen Kunden zu erstellen.

Anfordern

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

Anforderungsheader

Header Typ Beschreibung
Autorisierung String Erforderlich. Das Microsoft Entra-Zugriffstoken im Formular Bearer <token>.

Anforderungsparameter

$version – erforderlich. Dies ist die Version des Schemas, das in der Anforderung verwendet wird.

Anforderungstext

Geben Sie die Details des privaten Angebots mithilfe des Schemas Private Angebote von ISVs für Handelspartner mit Marge an. Sie müssen einen Namen angeben.

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

Anfordern von Textkörperbeispielen

Beispielanforderung für ein Handelspartnerangebot, das auf einen bestimmten Begünstigten beschränkt ist

Wenn Sie eine Marge für einen Händler erstellen, der für einen bestimmten Kunden gilt, fügen Sie diese Informationen als Objekt im Parameterarray "empfängerrecipients" unter den Begünstigten hinzu.

Der Anforderungstext sieht wie im folgenden Beispiel aus:

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

Antwort

Die Antwort enthält die jobId, die Sie später verwenden können, um den Status abzufragen.

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

Fehlercodes

HTTP-Statuscode Beschreibung
401 Authentifizierungsfehler: Stellen Sie sicher, dass Sie ein gültiges Microsoft Entra-Zugriffstoken verwenden.
400 Schemaüberprüfung. Stellen Sie sicher, dass der Anforderungstext dem richtigen Schema folgt und alle erforderlichen Felder enthält.

Zugehöriger Inhalt