更新客户的账单配置文件
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
汇报客户的计费配置文件,包括与配置文件关联的地址。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 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 参数
使用以下查询参数更新计费配置文件。
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
customer-tenant-id | guid | Y | 该值是 GUID 格式 的客户租户 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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈