Müşterinin şirket profilini alma

Makale
10/18/2023

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Bir müşterinin şirket profilini alır.

Ön koşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, bunu İş Ortağı Merkezi'nde arayabilirsiniz. İş Ortağı Merkezi Giriş sayfasından Müşteriler çalışma alanını seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında, Müşteri Hesabı ayrıntıları bölümünde Microsoft Kimliğini bulun. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

Önemli

İş ortağının müşteri kiracısında DAP erişimi yoksa, Müşteri Şirket Profili Api'sini Al çağrısı yanıtta aşağıdaki öznitelikleri geri döndürmez. Aksi takdirde, yanıt örneğinde listelenen tüm öznitelikleri döndürür.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain

C#

Bir müşterinin şirket profilini almak için müşteri kimliğini kullanarak IAggregatePartner.Customers.ById yöntemini çağırarak müşteriyi tanımlayın. Ardından Profiles özelliğinden müşterinin ICustomerProfileCollection arabirimini alın ve Company özelliğine erişin. Ardından, ICustomerProfileCollection.Company özelliğinden ICustomerReadonlyProfile arabirimini alın ve Get() veya GetAsync() yöntemlerini çağırın.

// IAggregatePartner partnerOperations;
// string customerId;

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

Örnek: İş Ortağı Merkezi SDK'sını indirin. Proje: PartnerSdk.FeatureSamples Sınıfı: GetCustomerCompanyProfile.cs

Java

İş Ortağı Merkezi Java SDK'sı, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.

Bir müşterinin şirket profilini almak için müşteri tanımlayıcısıyla birlikte IAggregatePartner.getCustomers().byId işlevini çağırarak müşteriyi tanımlayın. Ardından, Company özelliğine erişmek için [getProfiles] işlevinden müşterinin ICustomerProfileCollection arabirimini alın. Ardından, ICustomerProfileCollection.getCompany işlevinden ICustomerReadonlyProfile arabirimini alın ve get işlevini çağırın.

// IAggregatePartner partnerOperations;
// String customerId;

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

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/şirket HTTP/1.1

URI parametresi

Şirket profilini almak için aşağıdaki sorgu parametresini kullanın.

Ad	Tür	Zorunlu	Tanım
customer-tenant-id	Guıd	Y	Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir .

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

None

İstek örneği

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

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesindeki bilgileri döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST Hata Kodları.

Yanıt örneği

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

Aracılığıyla paylaş