A próbaverzió átalakításával kapcsolatos ajánlatok listájának lekéréseGet a list of trial conversion offers

A következőkre vonatkozikApplies To

  • PartnerközpontPartner Center

Próbaverziós konvertálási ajánlatok listájának beolvasása.How to retrieve a list of trial conversion offers.

ElőfeltételekPrerequisites

  • A partner Center-hitelesítésbenleírt hitelesítő adatok.Credentials as described in Partner Center authentication. Ez a forgatókönyv csak az App + felhasználói hitelesítő adatokkal történő hitelesítést támogatja.This scenario supports authentication with App+User credentials only.

  • Ügyfél-azonosító ( customer-tenant-id ).A customer ID (customer-tenant-id). Ha nem ismeri az ügyfél AZONOSÍTÓját, megtekintheti a partner Center irányítópultján.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Válassza a CSP lehetőséget a partner központ menüjében, majd az ügyfelek.Select CSP from the Partner Center menu, followed by Customers. Válassza ki az ügyfelet az ügyfél listából, majd válassza a fiók lehetőséget.Select the customer from the customer list, then select Account. Az ügyfél fiókja lapon keresse meg a Microsoft ID -t az ügyfél fiók adatai szakaszban.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A Microsoft-azonosító megegyezik az ügyfél-AZONOSÍTÓval ( customer-tenant-id ).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Egy aktív próbaverziós előfizetés előfizetési azonosítója.A subscription ID for an active trial subscription.

C#C#

A próbaverziós konverziók listájának lekéréséhez először használja a IAggregatePartner. Customs. ById metódust az ügyfél-azonosítóval az ügyfél azonosításához.To get a list of trial conversions available, start by using the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. Ezután kérjen meg egy illesztőfelületet az előfizetési műveletekhez az előfizetések. ById metódus meghívásával a próbaverziós előfizetés azonosítójával.Then, get an interface to subscription operations by calling the Subscriptions.ById method with the trial subscription ID. Ezután az átalakítások tulajdonsággal szerezzen be egy felületet az elérhető műveletekhez a konverziók között, majd hívja meg a Get vagy a GetAsync metódust a rendelkezésre álló konverziós ajánlatok gyűjteményének lekéréséhez.Next, use the Conversions property to obtain an interface to the available operations on conversions, and then call the Get or GetAsync method to retrieve a collection of available Conversion offers.

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

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

REST-kérelemREST request

Kérelem szintaxisaRequest syntax

MetódusMethod Kérés URI-jaRequest URI
GETGET {baseURL}/v1/Customers/{Customer-ID}/Subscriptions/{Subscription-ID}/Conversions http/1.1{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-paraméterURI parameter

Az ügyfél és a próbaverzió előfizetésének azonosításához használja a következő elérésiút-paramétereket.Use the following path parameters to identify the customer and trial subscription.

NévName TípusType KötelezőRequired LeírásDescription
ügyfél-azonosítócustomer-id sztringstring IgenYes Egy GUID formátumú karakterlánc, amely azonosítja az ügyfelet.A GUID formatted string that identifies the customer.
előfizetés-azonosítósubscription-id sztringstring IgenYes Egy GUID formátumú karakterlánc, amely azonosítja a próba-előfizetést.A GUID formatted string that identifies the trial subscription.

KérésfejlécekRequest headers

További információ: a partneri központ Rest-fejlécei.For more information, see Partner Center REST headers.

A kérés törzseRequest body

Nincsenek.None.

Példa kérésreRequest example

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álaszREST response

Ha ez sikeres, a válasz törzse konverziós erőforrások gyűjteményét tartalmazza.If successful, the response body contains a collection of Conversion resources.

Válasz sikeres és hibakódokResponse success and error codes

Minden válaszhoz tartozik egy HTTP-állapotkód, amely a sikeres vagy sikertelen és a további hibakeresési adatokat jelzi.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. A kód, a hiba típusa és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt.Use a network trace tool to read this code, error type, and additional parameters. A teljes listát a következő témakörben talál: partner Center hibakódok.For the full list, see Partner Center error codes.

Példa válaszraResponse example

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"
    }
}