Hämta en kunds företagsprofil
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"
}
}