Een lijst met aanbiedingen voor proefconversie ophalen

Artikel
03/09/2025

Hoe u een lijst met aanbiedingen voor proefconversie kunt ophalen.

Voorwaarden

Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
Een abonnements-id voor een actief proefabonnement.

C#

Als u een lijst met beschikbare proefconversies wilt ophalen, gebruikt u eerst de IAggregatePartner.Customers.ById methode met de klant-id om de klant te identificeren. Haal vervolgens een interface op voor abonnementsbewerkingen door de methode Subscriptions.ById aan te roepen met de id van het proefabonnement. Gebruik vervolgens de eigenschap Conversies om een interface te verkrijgen voor de beschikbare bewerkingen voor conversies en roep vervolgens de Get of GetAsync methode aan om een verzameling beschikbare Conversie--aanbiedingen op te halen.

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get the available conversions.
var conversions =
    partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId).Conversions.Get();

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-parameter

Gebruik de volgende padparameters om het klant- en proefabonnement te identificeren.

Naam	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een GUID-geformatteerde tekenreeks die de klant identificeert.
abonnements-id	string	Ja	Een tekenreeks met GUID-indeling waarmee het proefabonnement wordt geïdentificeerd.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoeklichaam

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling Conversie resources.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het succesvol of mislukt is, en extra informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 305
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CV: feJByqU1X0ObaTQr.0
MS-ServerId: 030011719
Date: Thu, 15 Jun 2017 23:10:01 GMT

 {
    "totalCount": 1,
    "items": [{
            "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
            "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
            "orderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
            "quantity": 25,
            "billingCycle": "monthly",
            "attributes": {
                "objectType": "Conversion"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Delen via