Hämta en kunds företagsprofil

Artikel
07/25/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Hämtar en kunds företagsprofil.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du leta upp det i Partnercenter. Välj arbetsytan Kunder på startsidan för Partnercenter. Välj kunden i kundlistan och välj sedan Konto. På kundens kontosida letar du efter Microsoft-ID:t i avsnittet Kundkontoinformation. Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

Viktigt!

API-anropet Hämta kund företagsprofil returnerar inte följande attribut i svaret om partnern inte har DAP- eller GDAP-åtkomst på kundklientorganisationen.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain Minst en av följande GDAP-roller krävs för att få CompanyProfileAddress och CompanyProfile Email.

Global administratör
Katalogskrivare
Global läsare

Minst en av följande GDAP-roller krävs för att hämta CustomDomain.

Domänadministratör
Katalogläsare
Global administratör
Global läsare
Hybrididentitetsadministratör

Mer information om rollerna finns i Microsofts inbyggda roller.

C#

Om du vill hämta företagsprofilen för en kund anropar du metoden IAggregatePartner.Customers.ById med kund-ID:t för att identifiera kunden. Hämta sedan kundens ICustomerProfileCollection-gränssnitt från egenskapen Profiler för att få åtkomst till dess företagsegenskap. Hämta sedan gränssnittet ICustomerReadonlyProfile från egenskapen ICustomerProfileCollection.Company och anropa metoderna Get() eller GetAsync().

// IAggregatePartner partnerOperations;
// string customerId;

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

Exempel: Ladda ned SDK:n för Partnercenter. Projekt: PartnerSdk.FeatureSamples Class: GetCustomerCompanyProfile.cs

Java

Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Om du vill hämta företagsprofilen för en kund anropar du funktionen IAggregatePartner.getCustomers().byId med kundidentifieraren för att identifiera kunden. Hämta sedan kundens ICustomerProfileCollection-gränssnitt från funktionen [getProfiles] för att få åtkomst till dess företagsegenskap. Hämta sedan gränssnittet ICustomerReadonlyProfile från funktionen ICustomerProfileCollection.getCompany och anropa funktionen get.

// IAggregatePartner partnerOperations;
// String customerId;

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

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

URI-parameter

Använd följande frågeparameter för att hämta företagsprofilen.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Y	Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen

Exempel på begäran

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

REST-svar

Om det lyckas returnerar den här metoden information i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

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

Dela via