Ottenere la conferma dell'accettazione del Contratto del cliente Microsoft da parte di un cliente

Articolo
03/05/2024

Si applica a: Centro per i partner

Non si applica a: Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

La risorsa contratto è attualmente supportata dal Centro per i partner solo nel cloud pubblico Microsoft.

Questo articolo illustra come recuperare le conferme dell'accettazione del Contratto del cliente Microsoft da parte di un cliente.

Prerequisiti

Se si usa .NET SDK del Centro per i partner, è necessaria la versione 1.14 o successiva.

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner.
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta solo l'autenticazione app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel 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 l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

.NET

Per recuperare le conferme dell'accettazione del cliente fornita in precedenza:

Usare la raccolta IAggregatePartner.Customers e chiamare il metodo ById con l'identificatore del cliente specificato.
Recuperare la proprietà Agreements e filtrare i risultati per Contratto del cliente Microsoft chiamando il metodo ByAgreementType.
Chiamare il metodo Get o GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Un esempio completo è disponibile nella classe GetCustomerAgreements del progetto di app di test della console.

Richiesta REST

Per recuperare la conferma dell'accettazione del cliente fornita in precedenza:

Creare una richiesta REST per recuperare la raccolta Agreements per il cliente.
Usare il parametro di query agreementType per definire l'ambito dei risultati solo per il Contratto del cliente Microsoft.

Sintassi della richiesta

Usare la sintassi di richiesta seguente:

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parametri URI

È possibile usare i parametri URI seguenti con la richiesta:

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	GUID	Sì	Il valore è un GUID formattato CustomerTenantId che consente di specificare un cliente.
tipo di contratto	string	No	Questo parametro restituisce tutti i metadati del contratto. Usare questo parametro per definire l'ambito della risposta di query a un tipo di contratto specifico. I valori supportati sono: MicrosoftCloudAgreement che include solo i metadati del contratto del tipo MicrosoftCloudAgreement. MicrosoftCustomerAgreement che include solo i metadati del contratto del tipo MicrosoftCustomerAgreement. * che restituisce tutti i metadati del contratto. Non usare * a meno che il codice non abbia la logica necessaria per gestire i tipi di contratto imprevisti. Nota: se il parametro URI non è specificato, per impostazione predefinita la query è MicrosoftCloudAgreement per la compatibilità con le versioni precedenti. Microsoft potrebbe introdurre metadati di contratto con nuovi tipi di contratto in qualsiasi momento.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Risposta REST

In caso di esito positivo, questo metodo restituisce una raccolta di risorse Agreement nel corpo della risposta.

Codici di errore e di esito 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 questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}

Share via