A próbaverzió átalakításával kapcsolatos ajánlatok listájának lekérése

  • Cikk

A próbakonvertálási ajánlatok listájának lekérése.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • Egy aktív próbaverziós előfizetés előfizetés-azonosítója.

C#

A próbakonverziók listájának lekéréséhez először használja az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval az ügyfél azonosításához. Ezután szerezze be az előfizetési műveletek felületét az Subscriptions.ById metódus meghívásával a próba-előfizetés azonosítójával. Ezután a Konverziók tulajdonság használatával szerezze be a konverziókon elérhető műveletek felületét, majd hívja meg a Get vagy a GetAsync metódust az elérhető konverziós ajánlatok gyűjteményének lekéréséhez.

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

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

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-paraméter

Az ügyfél- és próbaverziós előfizetés azonosításához használja az alábbi elérésiút-paramétereket.

Name Type Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
előfizetés-azonosító sztring Igen A próbaverziós előfizetést azonosító GUID formátumú sztring.

Kérelemfejlécek

További információ: Partnerközpont – REST fejlécek.

A kérés törzse

Nincs.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/488745B5-2086-4912-802C-6ABB9F7C3638/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, a válasz törzse konverziós erőforrások gyűjteményét tartalmazza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont hibakódjaiban találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 305
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
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"
    }
}