Obtenir le profil d’entreprise d’un client

Article
10/18/2023

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Obtient le profil d’entreprise d’un client.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires. Sélectionnez l’espace de travail Clients dans la page d’accueil de l’Espace partenaires. Sélectionnez le client dans la liste Des clients, puis sélectionnez Compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Détails du compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

Important

L’appel de l’API Get Customer Company Profile ne renvoie pas les attributs suivants dans la réponse si le partenaire n’a pas d’accès DAP sur le locataire client. Sinon, elle retourne tous les attributs répertoriés dans l’exemple de réponse.

CompanyProfileAddress
CompanyProfileEmail
Domainepersonnalisé

C#

Pour obtenir le profil de société d’un client, appelez la méthode IAggregatePartner.Customers.ById avec l’ID client dans le but d’identifier le client. Obtenez ensuite l’interface ICustomerProfileCollection du client à partir de la propriété Profiles afin d’accéder à sa propriété Company. Ensuite, obtenez l’interface ICustomerReadonlyProfile à partir de la propriété ICustomerProfileCollection.Company et appelez ses méthodes Get() ou GetAsync().

// IAggregatePartner partnerOperations;
// string customerId;

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

Exemple : Téléchargez le Kit de développement logiciel (SDK) de l’Espace partenaires. Projet : PartnerSdk.FeatureSamples , classe : GetCustomerCompanyProfile.cs

Java

Le Kit de développement logiciel (SDK) Java de l’Espace partenaires peut être utilisé pour gérer les ressources de l’Espace partenaires. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.

Pour obtenir le profil d’entreprise d’un client, appelez la fonction IAggregatePartner.getCustomers().byId avec l’identificateur du client pour identifier le client. Obtenez ensuite l’interface ICustomerProfileCollection du client à partir de la fonction [getProfiles] afin d’accéder à sa propriété Company. Ensuite, obtenez l’interface ICustomerReadonlyProfile à partir de la fonction ICustomerProfileCollection.getCompany, puis appelez la fonction get.

// IAggregatePartner partnerOperations;
// String customerId;

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

Demande REST

Syntaxe de la requête

Méthode	URI de demande
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour obtenir le profil d’entreprise.

Nom	Type	Obligatoire	Description
id-locataire-client	guid	Y	La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné qui appartient au revendeur.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucun

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Réponse REST

Si elle réussit, cette méthode retourne des informations dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 488
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
    "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/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}

Partager via