顧客の会社プロファイルを取得する

2025-03-28

適用対象: パートナーセンター | 21Vianet が運営するパートナーセンター | Microsoft Cloud for US Government のパートナーセンター

顧客の会社プロファイルを取得します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、App+User 資格情報のみを使用した認証がサポートされます。
顧客 ID です (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで検索できます。パートナーセンターのホームページから [顧客] ワークスペースを選択します。 [顧客一覧] から顧客を選択した後、[アカウント] を選択します。顧客の [アカウント] ページの [顧客アカウントの詳細セクション] で Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

重要

パートナーが顧客テナントで DAP または GDAP アクセス権を持っていない場合、Get Customer Company Profile API 呼び出しは応答で次の属性を返しません。

会社プロフィール住所
会社プロフィールメール
CustomDomain CompanyProfileAddress と CompanyProfile Email を取得するには、次の GDAP ロールの少なくとも 1 つが必要です。

グローバル管理者
ディレクトリライター
グローバル閲覧者

CustomDomain を取得するには、次のいずれかの GDAP ロールが必要です。

ドメイン管理者
ディレクトリ閲覧者
グローバル管理者
グローバル閲覧者
ハイブリッド ID 管理者

ロールの詳細については、「Microsoft 組み込みロールを参照してください。

C#

顧客の会社プロファイルを取得するには、IAggregatePartner.Customers.ById メソッドを顧客 ID と共に呼び出して顧客を識別します。次に、会社のプロパティにアクセスするために、Profiles プロパティから顧客の ICustomerProfileCollection インターフェイスを取得します。次に、ICustomerProfileCollection.Company プロパティから ICustomerReadonlyProfile インターフェイスを取得し、その Get() または GetAsync()メソッド呼び出します。

// IAggregatePartner partnerOperations;
// string customerId;

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

サンプル: パートナーセンター SDK をダウンロードします。 プロジェクト: PartnerSdk.FeatureSamples クラス: GetCustomerCompanyProfile.cs

ジャワ

パートナーセンター Java SDK を使用して、パートナーセンターリソースを管理できます。これは、パートナーコミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソースプロジェクトです。問題が発生した場合は、コミュニティからサポートを受けるか、GitHub で問題を提起することができます。

顧客の会社プロファイルを取得するには、IAggregatePartner.getCustomers().byId 関数を顧客識別子と共に呼び出して顧客を識別します。次に、[getProfiles] 関数から顧客の ICustomerProfileCollection インターフェイスを取得し、会社のプロパティにアクセスします。次に、ICustomerProfileCollection.getCompany 関数から ICustomerReadonlyProfile インターフェイスを取得し、get 関数を呼び出します。

// IAggregatePartner partnerOperations;
// String customerId;

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

REST 要求

リクエスト構文

メソッド	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

URI パラメーター

会社のプロファイルを取得するには、次のクエリパラメーターを使用します。

名前	タイプ	必須	説明
customer-tenant-id	guid	Y	この値は、GUID 形式の customer-tenant-id で、これによってリセラーは、リセラーに属する特定の顧客の結果をフィルター処理できます。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

なし

要求の例

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 応答

成功した場合、このメソッドは応答本文で情報を返します。

応答の成功とエラーコード

各応答には、成功または失敗を示す HTTP ステータスコードと、追加のデバッグ情報が付属しています。このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワークトレースツールを使用します。完全な一覧については、「パートナーセンターの REST エラーコード参照してください。

応答の例

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