顧客の請求プロファイルを取得するGet a customer's billing 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 billing profile of a customer.

パートナーセンターのダッシュボードでは、最初に 顧客を選択することでこの操作を実行できます。In the Partner Center dashboard, this operation can be performed by first selecting a customer. 次に、左側のサイドバーで、顧客の名前の下にある [Account] \ ( アカウント) を選択します。Then, under the customer's name in the left sidebar, select Account. 請求プロファイルは、[ 請求先情報 ] 見出しの下にあります。The billing profile can be found under the Bill-to info heading.

前提条件Prerequisites

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

  • 顧客 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#

顧客の請求プロファイルを取得するには、 Ipartner. Customers コレクションを使用して、 ById () メソッドを呼び出します。To get a customer's billing profile, use your IPartner.Customers collection and call the ById() method. 次に、 Profiles プロパティを呼び出し、その後に Billing プロパティを呼び出します。Then call the Profiles property, followed by the Billing property. 最後に、 Get () メソッドまたは GetAsync () メソッドを呼び出します。Finally, call the Get() or GetAsync() methods.

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();

サンプル: コンソールテストアプリSample: Console test app. プロジェクト: partnersdk. FeatureSamples クラス: GetCustomerBillingProfile.csProject: PartnerSDK.FeatureSamples Class: GetCustomerBillingProfile.cs

REST 要求REST request

要求の構文Request syntax

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

URI パラメーターURI parameter

請求プロファイルを取得するには、次のクエリパラメーターを使用します。Use the following query parameter to get the billing 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/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
MS-CorrelationId: 51d521b3-62db-4682-b75d-fb8ab09113b2

REST 応答REST response

成功した場合、このメソッドは、応答本文に プロファイル リソースのコレクションを返します。If successful, this method returns a collection of Profile resources 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. 完全な一覧については、エラー コードに関するページを参照してください。For the full list, see Error Codes.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 1206
Content-Type: application/json
MS-CorrelationId: 51d521b3-62db-4682-b75d-fb8ab09113b2
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
Date: Mon, 23 Nov 2015 18:13:43 GMT

{
    "id": "<billing-profile-id>",
    "firstName": "FirstName",
    "lastName": "LastName",
    "email": "email@sample.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "CompanyName",
    "defaultAddress": {
        "country": "US",
        "city": "Redmond",
        "state": "WA",
        "addressLine1": "1 Microsoft Way",
        "postalCode": "98052",
        "firstName": "FirstName",
        "lastName": "LastName",
        "phoneNumber": "4255555555"
    },
    "links": {
        "self": {
            "uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "etag": "<etag>",
        "objectType": "CustomerBillingProfile"
    }
}