Ottenere il profilo società di un cliente

Articolo
07/25/2024

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

Ottiene il profilo aziendale di un cliente.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i 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 nel Centro per i partner. Selezionare l'area di lavoro Clienti nella home page del Centro per i partner. Selezionare il cliente dall'elenco Clienti, quindi selezionare Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Dettagli account cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

Importante

La chiamata all'API Get Customer Company Profile non restituisce gli attributi seguenti nella risposta se il partner non ha accesso DAP o GDAP nel tenant del cliente.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain Almeno uno dei ruoli GDAP seguenti è necessario per ottenere l'indirizzo di posta elettronica CompanyProfileAddress e CompanyProfile.

Amministratore globale
Ruolo con autorizzazioni di scrittura nella directory
Ruolo con autorizzazioni di lettura globali

Per ottenere CustomDomain è necessario almeno uno dei ruoli GDAP seguenti.

Amministratore di dominio
Ruolo con autorizzazioni di lettura nella directory
Amministratore globale
Ruolo con autorizzazioni di lettura globali
Amministratore delle identità ibride

Per altre informazioni sui ruoli, vedere Ruoli predefiniti di Microsoft.

C#

Per ottenere il profilo della società di un cliente, chiamare il metodo IAggregatePartner.Customers.ById con l'ID cliente, che consente di identificare il cliente. Ottenere quindi l'interfaccia ICustomerProfileCollection del cliente dalla proprietà Profiles per accedere alla proprietà Company. Ottenere quindi l'interfaccia ICustomerReadonlyProfile dalla proprietà ICustomerProfileCollection.Company e chiamare i metodi Get() o GetAsync().

// IAggregatePartner partnerOperations;
// string customerId;

var companyProfile = partnerOperations.Customers.ById(customerId).Profiles.Company.Get();

Esempio: scaricare l'SDK del Centro per i partner. Progetto: Classe PartnerSdk.FeatureSamples: GetCustomerCompanyProfile.cs

Java

L'SDK Java del Centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.

Per ottenere il profilo aziendale per un cliente, chiamare la funzione IAggregatePartner.getCustomers().byId con l'identificatore del cliente per identificare il cliente. Ottenere quindi l'interfaccia ICustomerProfileCollection del cliente dalla funzione [getProfiles] per accedere alla relativa proprietà Company. Ottenere quindi l'interfaccia ICustomerReadonlyProfile dalla funzione ICustomerProfileCollection.getCompany e chiamare la funzione get .

// IAggregatePartner partnerOperations;
// String customerId;

CustomerCompanyProfile companyProfile = partnerOperations.getCustomers().byId(customerId).getProfiles().getCompany().get();

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

Parametro URI

Usare il parametro di query seguente per ottenere il profilo aziendale.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	guid	Y	Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.

Intestazioni delle richieste

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

Testo della richiesta

None

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Risposta REST

In caso di esito positivo, questo metodo restituisce informazioni nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedere Codici di errore REST del Centro per i partner.

Risposta di esempio

HTTP/1.1 200 OK
Content-Length: 488
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "domain": "dtdemocspcustomer005.onmicrosoft.com",
    "companyName": "DT Demo CSP Customer 005",
    "address": {
        "country": "US",
        "region": "WA",
        "city": "Redmond ",
        "addressLine1": "1 Microsoft Way",
        "postalCode": "98052",
        "phoneNumber": "4155551212"
    },
    "email": "daniel@hotmail.com.tw",
    "links": {
        "self": {
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}

Condividi tramite