Uppdatera en kunds faktureringsprofil
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Uppdateringar en kunds faktureringsprofil, inklusive adressen som är associerad med profilen.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du leta upp det i Partnercenter. Välj Kunder på startsidan, välj sedan kunden i kundlistan och välj sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id
).
C#
Om du vill uppdatera en kunds faktureringsprofil hämtar du faktureringsprofilen och uppdaterar egenskaperna efter behov. Hämta sedan din IPartner.Customers-samling och anropa sedan metoden ById(). Anropa sedan egenskapen Profiler följt av egenskapen Fakturering. Slutför sedan genom att anropa metoderna Update() eller 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);
Exempel: Konsoltestapp. Projekt: PartnerSDK.FeatureSamples Class: UpdateCustomerBillingProfile.cs
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
PUT | {baseURL}/v1/customers/{customer-tenant-id}/profiles/billing HTTP/1.1 |
URI-parameter
Använd följande frågeparameter för att uppdatera faktureringsprofilen.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
customer-tenant-id | Guid | Y | Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren. |
Begärandehuvuden
- If-Match: "<ETag>" krävs för samtidighetsidentifiering. Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Den fullständiga resursen.
Exempel på begäran
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: aaaa0000-bb11-2222-33cc-444444dddddd
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-svar
Om det lyckas returnerar den här metoden uppdaterade egenskaper för profilresurser i svarstexten. Det här anropet kräver en ETag för samtidighetsidentifiering.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.
Svarsexempel
HTTP/1.1 200 OK
Content-Length: 1210
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}
}