顧客の請求プロファイルを更新する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
プロファイルに関連付けられているアドレスを含む、顧客の課金プロファイルを更新します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、パートナー センターで検索できます。 ホーム ページから [ 顧客 ] を選択し、顧客の一覧から顧客を選択し、[アカウント] を選択 します。 顧客の [アカウント] ページで、[顧客アカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。
C#
顧客の課金プロファイルを更新するには、課金プロファイルを取得し、必要に応じてプロパティを更新します。 次に、IPartner.Customers コレクションを取得し、ById() メソッドを呼び出します。 次に、Profiles プロパティを呼び出し、その後に Billing プロパティを呼び出します。 次に、Update() または UpdateAsync() メソッドを呼び出して終了します。
// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();
// Apply changes to profile;
billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Update(billingProfile);
サンプル: コンソール テスト アプリ。 プロジェクト: PartnerSDK.FeatureSamples クラス: UpdateCustomerBillingProfile.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
PUT | {baseURL}/v1/customers/{customer-tenant-id}/profiles/billing HTTP/1.1 |
URI パラメーター
課金プロファイルを更新するには、次のクエリ パラメーターを使用します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
customer-tenant-id | guid | 年 | この値は、リセラーがリセラーに 属する特定の顧客の結果をフィルター処理できるようにする、GUID 形式の customer-tenant-id です。 |
要求ヘッダー
- If-Match: コンカレンシー検出には "<ETag>" が必要です。 詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
完全なリソース。
要求の例
PUT https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
MS-CorrelationId: ff1b757d-cfaf-463a-b48b-0f96d05e95d7
Content-Type: application/json
Content-Length: 639
Expect: 100-continue
{
"Id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
"FirstName": "FirstName",
"LastName": "LastName",
"Email": "email@sample.com",
"Culture": "en-US",
"Language": "en",
"CompanyName": "CompanyName",
"DefaultAddress": {
"Country": "US",
"Region": null,
"City": "Redmond",
"State": "WA",
"AddressLine1": "One Microsoft Way",
"AddressLine2": null,
"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"
}
}
REST 応答
成功した場合、このメソッドは更新された プロファイル リソースプロパティを応答本文で返します。 この呼び出しでは、コンカレンシー検出に ETag を必要とします。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 1210
Content-Type: application/json
MS-CorrelationId: ff1b757d-cfaf-463a-b48b-0f96d05e95d7
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
Date: Mon, 23 Nov 2015 18:20:43 GMT
{
"id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
"firstName": "FirstName",
"lastName": "LastName",
"email": "email@sample.com",
"culture": "en-US",
"language": "en",
"companyName": "companyName",
"defaultAddress": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "One 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"
}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示