ID で顧客を取得する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
顧客 ID に 対応する Customer リソースを取得します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリ +ユーザー資格情報またはアプリ専用認証がサポートされます。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、パートナー センターで検索できます。 パートナー センターの ホーム ページから [顧客 ] ワークスペースを選択します。 顧客の一覧から顧客を選択し、[アカウント] を選択します。 顧客の [アカウント] ページで、[顧客アカウントの詳細] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。
重要
パートナーが顧客テナントに DAP アクセス権を持っていない場合、Get Customer ID API 呼び出しは応答で次の属性を返しません。 それ以外の場合は、応答サンプルに記載されているすべての属性が返されます。
- CompanyProfileAddress
- CompanyProfileEmail
- CustomDomain
GDAP ロール
CompanyProfileAddress、CompanyProfileEmail、および CustomDomain の顧客カスタム ドメインを取得するための顧客組織の取得を呼び出すには、次のいずれかの GDAP ロールが必要です。
- 全体管理者
- ディレクトリ ライター
- グローバル閲覧者
C#
ID で顧客を取得するには、IAggregatePartner.Customers コレクションを使用し、ById() メソッドを呼び出してから、Get() または GetAsync() メソッドを呼び出します。
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
Customer customerInfo = partnerOperations.Customers.ById(customerIdToRetrieve).Get();
サンプル: コンソール テスト アプリ。 プロジェクト: PartnerSDK.FeatureSamples クラス: CustomerInformation.cs
Java
パートナー センター Java SDK を使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
ID で顧客を取得するには、IAggregatePartner.getCustomers 関数を使用し、byId() 関数を呼び出してから、get() 関数を呼び出します。
// IAggregatePartner partnerOperations;
// String customerIdToRetrieve;
Customer customerInfo = partnerOperations.getCustomers().byId(customerIdToRetrieve).get();
PowerShell
パートナー センター PowerShell モジュールを使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
ID で顧客を取得するには、Get-PartnerCustomer コマンドを実行し、CustomerId パラメーターを指定します。
Get-PartnerCustomer -CustomerId '2ca7de6c-c05c-46b5-b689-32e53573a97a'
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id} HTTP/1.1 |
URI パラメーター
特定の顧客に対して次のクエリ パラメーターを使用します。
名前 | 種類 | 必須 | 説明 |
---|---|---|---|
customer-tenant-id | guid | Y | この値は、リセラーがリセラーに 属する特定の顧客の結果をフィルター処理できるようにする、GUID 形式の customer-tenant-id です。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
[なし] :
要求の例
GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b
REST 応答
成功した場合、このメソッドは 応答本文で Customer リソースを返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b
{
"id": "eebd1b55-5360-4438-a11d-5c06918c3014",
"commerceId": "99e6a635-48e7-424d-9059-c9db944e3c54",
"companyProfile": {
"tenantId": "eebd1b55-5360-4438-a11d-5c06918c3014",
"domain": "abcdefgh1234.onmicrosoft.com",
"companyName": "1kl as kjk",
"address": {
"country": "US",
"region": "wa",
"city": "redmond",
"addressLine1": "1 ms way",
"postalCode": "98052",
"phoneNumber": "1234567890"
},
"email": "a@a.com",
"links": {
"self": {
"uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/profiles/company",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerCompanyProfile"
}
},
"billingProfile": {
"id": "eeada110-69d6-4cc9-b093-75feb7ca9d3f",
"firstName": "d0d89d776d03471c819bf772191ed728",
"lastName": "kjkAJJAAAAAAAAAAAAAAAAAAAA",
"email": "a@a.com",
"culture": "en-US",
"language": "en",
"companyName": "1kl as kjkAAAAAAAAAAAAAAAJJJJJJJJJJJAAAAAJJJJJJJJJJJAAJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJAJJJJJAJJAAAAJAJJAAAAAAAAAAAAAAAAAAAA",
"defaultAddress": {
"country": "US",
"city": "redmond",
"state": "WA",
"addressLine1": "1 ms way",
"postalCode": "98052",
"firstName": "1kl as",
"lastName": "kjk",
"phoneNumber": "1234567890"
},
"links": {
"self": {
"uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/profiles/billing",
"method": "GET",
"headers": [
]
}
},
"attributes": {
"etag": "-4242348048554929329",
"objectType": "CustomerBillingProfile"
}
},
"relationshipToPartner": "reseller",
"allowDelegatedAccess": true,
"customDomains": [
"abcdefgh1234.onmicrosoft.com"
],
tags": [
"TestCustomer",
"USCustomer"
],
"links": {
"self": {
"uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Customer"
}
}