Ottieni un elenco di offerte di conversione della versione di valutazione

Articolo
03/07/2025

Come recuperare un elenco di offerte di conversione da prova.

Prerequisiti

Credenziali come descritto in autenticazione del Centro partner. Questo scenario supporta l'autenticazione solo con le credenziali app+utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare il ID Microsoft nella sezione Informazioni sull'Account Cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
ID sottoscrizione per una sottoscrizione di valutazione attiva.

C#

Per ottenere un elenco delle conversioni di prova disponibili, inizia utilizzando il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente. Ottieni quindi un'interfaccia per le operazioni di sottoscrizione chiamando il metodo Subscriptions.ById con l'ID abbonamento di prova. Usare quindi la proprietà conversioni per ottenere un'interfaccia per le operazioni disponibili sulle conversioni e quindi chiamare il metodo Get o GetAsync per recuperare una raccolta disponibile di offerte di conversione .

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

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

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

Parametro URI

Usare i parametri di percorso seguenti per identificare il cliente e la sottoscrizione di prova.

Nome	Tipo	Obbligatorio	Descrizione
ID cliente	corda	Sì	Stringa con formato GUID che identifica il cliente.
ID sottoscrizione	corda	Sì	Stringa formattata GUID che identifica l'abbonamento di prova.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST di Centro Partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una raccolta di risorse conversione.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore del Centro Partner.

Esempio di risposta

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

Condividi tramite