Créer une offre privée pour un partenaire CSP

Article
06/14/2024

Utilisez cette méthode pour créer une nouvelle offre privée pour un client.

Requête

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

En-tête de requête

En-tête	Type	Description
Autorisation	Chaîne	Obligatoire. Jeton d’accès Microsoft Entra dans le formulaire `Bearer <token>`.

Paramètres de la demande

$version - obligatoire. Il s’agit de la version du schéma utilisé dans la requête.

Corps de la demande

Fournissez les détails de l’offre privée à l’aide du schéma Offre privée d’éditeur de logiciels indépendant pour clients. Vous devez inclure un nom.

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

Exemples de corps de requête

Exemple de demande d’offre de revendeur limitée à un bénéficiaire spécifié

Si vous créez une marge pour un revendeur qui s’applique à un client spécifique, ajoutez ces informations en tant qu’objet dans le tableau de paramètres bénéficiaireRecipients sous les bénéficiaires.

Le corps de la requête ressemble à l’exemple suivant :

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

Response

La réponse contient l’id de travail que vous pouvez utiliser ultérieurement pour interroger l’état.

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

Codes d’erreur

Code d’état HTTP	Description
401	Erreur d’authentification : vérifiez que vous utilisez un jeton d’accès Microsoft Entra valide.
400	Validation de schéma. Vérifiez que le corps de votre demande suit le schéma correct et inclut tous les champs obligatoires.

Partager via