Mendapatkan profil perusahaan pelanggan

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Mendapatkan profil perusahaan pelanggan.

Prasyarat

• Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial App+User.

• ID pelanggan (customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra. Pilih ruang kerja Pelanggan dari Beranda Pusat Mitra. Pilih pelanggan dari Daftar Pelanggan, lalu pilih Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian detail Akun Pelanggan . ID Microsoft sama dengan ID pelanggan (customer-tenant-id).

Penting

Panggilan API Get Customer Company Profile tidak akan mengembalikan atribut berikut dalam respons jika mitra tidak memiliki akses DAP atau GDAP pada tenant pelanggan.

• Alamat Profil Perusahaan
• Profil Email Perusahaan
• CustomDomain Setidaknya salah satu peran GDAP berikut diperlukan untuk mendapatkan CompanyProfileAddress dan CompanyProfile Email.

• Global Administrator
• Penulis Direktori
• Pembaca Global

Setidaknya salah satu peran GDAP berikut diperlukan untuk mendapatkan CustomDomain.

• Domain Administrator
• Direktori Pembaca
• Global Administrator
• Pembaca Global
• Administrator Identitas Hibrida

Untuk mempelajari selengkapnya tentang peran tersebut, lihat Peran Bawaan Microsoft.

C#

Untuk mendapatkan profil perusahaan bagi pelanggan, hubungi metode IAggregatePartner.Customers.ById dengan ID pelanggan untuk mengidentifikasi pelanggan. Kemudian dapatkan antarmukaICustomerProfileCollectionpelanggan dari propertiProfil, untuk mengakses properti Perusahaannya. Selanjutnya, dapatkan antarmuka ICustomerReadonlyProfile dari properti ICustomerProfileCollection.Company, dan panggil metode Get() atau GetAsync().

// IAggregatePartner partnerOperations;
// string customerId;

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

Sampel: Unduh SDK Pusat Mitra. Project: PartnerSdk.FeatureSamples Class: GetCustomerCompanyProfile.cs

Jawa

Java SDK Pusat Mitra dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda dapat mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.

Untuk mendapatkan profil perusahaan bagi pelanggan, hubungi fungsi IAggregatePartner.getCustomers().byId dengan pengidentifikasi pelanggan untuk mengidentifikasi pelanggan. Selanjutnya, dapatkan antarmuka ICustomerProfileCollection pelanggan dari fungsi [getProfiles], untuk mengakses properti 'Perusahaan' miliknya. Selanjutnya, dapatkan antarmuka ICustomerReadonlyProfile dari fungsi ICustomerProfileCollection.getCompany, dan panggil fungsi get.

// IAggregatePartner partnerOperations;
// String customerId;

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

Permintaan REST

Sintaksis permintaan

Metode	Meminta URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

Parameter pada URI

Gunakan parameter kueri berikut untuk mendapatkan profil perusahaan.

Nama	Jenis	Diperlukan	Deskripsi
id_pelanggan_penyewa	GUID	Y	Nilainya adalah GUID yang diformat customer-tenant-id yang memungkinkan reseller memfilter hasil untuk pelanggan tertentu yang merupakan pelanggan reseller tersebut.

Header permintaan

Untuk informasi selengkapnya, lihat header REST di Pusat Mitra.

Isi permintaan

Tidak

Contoh permintaan

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

Respons REST

Jika berhasil, metode ini mengembalikan informasi dalam isi respons.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat Kode Kesalahan REST Pusat Mitra .

Contoh respons

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