Partager via

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

  • Article

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.

Contenu connexe