顧客の会社プロファイルを取得するGet a customer's company profile

適用対象Applies To

  • パートナー センターPartner Center
  • 21Vianet が運営するパートナー センターPartner Center operated by 21Vianet
  • Microsoft Cloud ドイツのパートナー センターPartner Center for Microsoft Cloud Germany
  • 米国政府機関向け Microsoft Cloud のパートナー センターPartner Center for Microsoft Cloud for US Government

顧客の会社プロファイルを取得します。Gets the company profile of a customer.

前提条件Prerequisites

  • パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。This scenario supports authentication with App+User credentials only.

  • 顧客 ID です (customer-tenant-id)。A customer ID (customer-tenant-id). お客様の ID がわからない場合は、パートナー センターのダッシュボードで検索できます。If you don't know the customer's ID, you can look it up in the Partner Center dashboard. パートナー センター メニューの [CSP] を選択し、 [顧客] を選択します。Select CSP from the Partner Center menu, followed by Customers. 顧客一覧からお客様を選び、 [アカウント] を選択します。Select the customer from the customer list, then select Account. お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

顧客の会社のプロファイルを取得するには、顧客 ID を指定して ById メソッドを呼び出し、顧客を識別します。To get the company profile for a customer, call the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. その後、Company プロパティにアクセスするために、 Profilesプロパティから顧客のICustomerProfileCollectionインターフェイスを取得します。Then get the customer's ICustomerProfileCollection interface from the Profiles property, in order to access its Company property. 次に、 ICustomerProfileCollectionプロパティからICustomerReadonlyProfileインターフェイスを取得し、そのget ()メソッドまたはGetAsync ()メソッドを呼び出します。Next, get the ICustomerReadonlyProfile interface from the ICustomerProfileCollection.Company property, and call its Get() or GetAsync() methods.

// IAggregatePartner partnerOperations;
// string customerId;

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

サンプル: パートナーセンター SDK をダウンロードします。Sample: Download the Partner Center SDK. プロジェクト: partnersdk. FeatureSamples クラス: GetCustomerCompanyProfile.csProject: PartnerSdk.FeatureSamples Class: GetCustomerCompanyProfile.cs

JavaJava

パートナー センター Java SDK は、パートナーが自分のパートナー センター リソースを管理するために一般的に使用されます。The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. これはパートナー コミュニティによって管理されているオープン ソース プロジェクトです。It's an open-source project maintained by the partner community. このモジュールはパートナー コミュニティによって管理されているため、Microsoft では公式にサポートしていません。Since this module is maintained by the partner community, it isn't officially supported by Microsoft. 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。You can get help from the community or open an issue on GitHub if you experience a problem.

顧客の会社プロファイルを取得するには、顧客識別子を使用して iaggregatepartner.customers () byId 関数を呼び出し、顧客を識別します。To get the company profile for a customer, call the IAggregatePartner.getCustomers().byId function with the customer identifier to identify the customer. その後、会社のプロパティにアクセスするために、[Getprofiles] 関数から顧客のICustomerProfileCollectionインターフェイスを取得します。Then get the customer's ICustomerProfileCollection interface from the [getProfiles] function, in order to access its Company property. 次に、 ICustomerProfileCollection関数からICustomerReadonlyProfileインターフェイスを取得し、 get関数を呼び出します。Next, get the ICustomerReadonlyProfile interface from the ICustomerProfileCollection.getCompany function, and call the get function.

// IAggregatePartner partnerOperations;
// String customerId;

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

REST 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

URI パラメーターURI parameter

次のクエリパラメーターを使用して、会社のプロファイルを取得します。Use the following query parameter to get the company profile.

名前Name 種類Type 必須Required 説明Description
customer-tenant-idcustomer-tenant-id guidguid YY この値は、リセラーがリセラーに属する特定の顧客の結果をフィルター処理できるようにする GUID 形式の 顧客テナント id です。The value is a GUID formatted customer-tenant-id that allows the reseller to filter the results for a given customer that belongs to the reseller.

要求ヘッダーRequest headers

詳細については、「パートナー センター REST ヘッダー」を参照してください。For more information, see Partner Center REST headers.

[要求本文]Request body

なしNone

要求の例Request example

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

成功した場合、このメソッドは応答本文で情報を返します。If successful, this method returns information in the response body.

応答の成功とエラーのコードResponse success and error codes

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。Each response comes with an HTTP status code that indicates success or failure and additional debugging information. このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。Use a network trace tool to read this code, error type, and additional parameters. 完全な一覧については、「 パートナーセンターの REST エラーコード」を参照してください。For the full list, see Partner Center REST Error Codes.

応答の例Response example

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