Kosár frissítése
Vásárlói rendelés frissítése a kosárban.
Vegye figyelembe, hogy a kocsik a kezdeti létrehozástól számított hét napon belül lejárnak.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Ügyfélazonosító (
customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).Egy meglévő kosár kosárazonosítója.
C#
Az ügyfél megrendelésének frissítéséhez kérje le a kosárt a Get() metódussal úgy, hogy átadja az ügyfél és a kosár azonosítóját a ById() függvény használatával. Végezze el a szükséges módosításokat a kosárban. Most hívja meg a Put metódust ügyfél- és kosárazonosítók használatával a ById() metódussal.
Végül hívja meg a Put() vagy a PutAsync() metódust a rendelés létrehozásához.
IAggregatePartner partnerOperations;
string customerId;
string cartId;
var cart = partnerOperations.Customers.ById(customerId).Cart.ById(cartId).Get();
cart.LineItems.ToArray()[0].Quantity++;
var updatedCart = partnerOperations.Customers.ById(customerId).Cart.ById(cartId).Put(cart);
Az igazolás befejezéséhez és más viszonteladók hozzáadásához tekintse meg az alábbi mintát.
API-minta – Kosár kivétele
{
"orders": [
{
"id": "f76c6b7f449d",
"alternateId": "f76c6b7f449d",
"referenceCustomerId": "f81d98dd-c2f4-499e-a194-5619e260344e",
"billingCycle": "monthly",
"currencyCode": "USD",
"currencySymbol": "$",
"lineItems": [
{
"lineItemNumber": 0,
"offerId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
"subscriptionId": "ebc0beef-7ffb-4044-c074-16f324432139",
"termDuration": "P1M",
"transactionType": "New",
"friendlyName": "AI Builder Capacity add-on",
"quantity": 1,
"links": {
"product": {
"uri": "/products/CFQ7TTC0LH0Z?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/CFQ7TTC0LH0Z/skus/0001?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/CFQ7TTC0LH0Z/skus/0001/availabilities/CFQ7TTC0K18P?country=US",
"method": "GET",
"headers": []
}
}
},
{
"lineItemNumber": 1,
"offerId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
"subscriptionId": "261bac40-7d88-4327-dfa3-dacd09222d62",
"termDuration": "P1Y",
"transactionType": "New",
"friendlyName": "Azure Active Directory Premium P1",
"quantity": 2,
"partnerIdOnRecord": "517285",
"additionalPartnerIdsOnRecord":
"5357564",
"5357563"
],
"links": {
"product": {
"uri": "/products/CFQ7TTC0LFLS?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/CFQ7TTC0LFLS/skus/0002?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/CFQ7TTC0LFLS/skus/0002/availabilities/CFQ7TTC0KDLJ?country=US",
"method": "GET",
"headers": []
}
}
}
],
"creationDate": "2021-08-18T07:52:23.1921872Z",
"status": "pending",
"transactionType": "UserPurchase",
"links": {
"self": {
"uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/f76c6b7f449d",
"method": "GET",
"headers": []
},
"provisioningStatus": {
"uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/f76c6b7f449d/provisioningstatus",
"method": "GET",
"headers": []
},
"patchOperation": {
"uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/orders/f76c6b7f449d",
"method": "PATCH",
"headers": []
}
},
"client": {},
"attributes": {
"objectType": "Order"
}
}
],
"attributes": {
"objectType": "CartCheckoutResult"
}
}
REST-kérés
Kérés szintaxisa
| Metódus | Kérés URI-ja |
|---|---|
| PUT | {baseURL}/v1/customers/{customer-id}/carts/{cart-id} HTTP/1.1 |
URI-paraméterek
Az ügyfél azonosításához használja az alábbi elérésiút-paramétereket, és adja meg a frissíteni kívánt kosárt.
| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
| ügyfél-azonosító | sztring | Igen | Guid formátumú ügyfél-azonosító, amely azonosítja az ügyfelet. |
| kosárazonosító | sztring | Igen | Guid formátumú kocsiazonosító, amely azonosítja a kosárt. |
Kérésfejlécek
További információ: Partnerközpont – REST fejlécek.
Kérés törzse
Ez a táblázat a kérelem törzsében található Kosár tulajdonságokat ismerteti.
| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| id | húr | Nem | A kosár sikeres létrehozásakor megadott kosárazonosító. |
| creationTimeStamp | Dátum/idő | Nem | A kosár létrehozásának dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor. |
| lastModifiedTimeStamp | Dátum/idő | Nem | A kosár utolsó frissítésének dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor. |
| expirationTimeStamp | Dátum/idő | Nem | A kosár lejárati dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor. |
| lastModifiedUser | húr | Nem | A felhasználó, aki legutóbb frissítette a kosárt. Alkalmazva a kosár sikeres létrehozásakor. |
| lineItems | Objektumok tömbje | Igen | CartLineItem-erőforrások tömbje. |
Ez a táblázat a kérelem törzsében található CartLineItem tulajdonságokat ismerteti.
| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| id | húr | Nem | Egy kosársorelem egyedi azonosítója. Alkalmazva a kosár sikeres létrehozásakor. |
| catalogId | sztring | Igen | A katalóguselem azonosítója. |
| friendlyName | húr | Nem | Opcionális. A partner által definiált elem rövid neve, amely segít a egyértelműségben. |
| promotionId | húr | Nem | Opcionális. A legtöbb NCE-előléptetés automatikusan érvényes lesz, de ha az opcionális promóciók (például a Bridge to the Cloud 2) egy kosársorra vonatkoznak, a partnereknek tartalmazniuk kell az előléptetés azonosítóját a kosárhoz való hozzáadási kérelemben. |
| mennyiség | egész | Igen | A licencek vagy példányok száma. |
| currencyCode | húr | Nem | A pénznem kódja. |
| billingCycle | Objektum | Igen | Az aktuális időszakhoz beállított számlázási ciklus típusa. |
| Résztvevők | Objektumsztring-párok listája | Nem | A vásárlás résztvevőinek gyűjteménye. |
| provisioningContext | Szótári sztring<, sztring> | Nem | Az ajánlat kiépítéséhez használt környezet. |
| orderGroup | húr | Nem | Egy csoport, amely jelzi, hogy mely elemek helyezhetők el együtt. |
| error | Objektum | Nem | A kosár létrehozása után alkalmazott hiba. |
| AdditionalPartnerIdsOnRecord | Sztring | Nem | Ha egy közvetett szolgáltató megrendelést ad egy közvetett viszonteladó nevében, töltse ki ezt a mezőt csak a További közvetett viszonteladó partnerazonosítójával (a közvetett szolgáltató azonosítója soha nem). Ezekre a más viszonteladókra nem vonatkoznak ösztönzők. Legfeljebb öt közvetett viszonteladó adható meg. Ez csak az EU-n/EFTA-országokon/régiókon belül működő alkalmazandó partnerek. |
Példa kérése
PUT /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts/65faf57b-0205-47ee-92b3-08dcf233ea73/ HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
MS-CorrelationId: 0e93c70c-977a-4a88-9580-7cf084c73286
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 496
Expect: 100-continue
{
{
"Id":"b4c8fdea-cbe4-4d17-9576-13fcacbf9605",
"CreationTimestamp":"2018-03-15T17:15:02.3840528Z",
"LastModifiedTimestamp":"2018-03-15T17:15:02.3840528Z",
"ExpirationTimestamp":"0001-01-01T00:00:00",
"LastModifiedUser":"2713ccd7-ea3b-470a-9cfb-451d5d0482cc",
"LineItems":[
{
"Id":0,
"CatalogItemId":"DG7GMGF0DWTL:0001:DG7GMGF0DSJB",
"FriendlyName":"A_sample_Azure_RI",
"Quantity":2,
"BillingCycle":"one_time",
"ProvisioningContext": {
"SubscriptionId": "3D5ECED6-1151-44C7-AEE6-70A4BB725666",
"Scope": "shared",
"Duration": "1Year"
}
}
],
}
}
Fontos
2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.
A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.
REST-válasz
Ha sikeres, ez a metódus a válasz törzsében lévő feltöltött Kosár erőforrást adja vissza.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Ezt a kódot, hibatípust és további paramétereket egy hálózati nyomkövetési eszközzel olvashatja el. A teljes listát a Hibakódok című témakörben találja.
Példa válaszra
HTTP/1.1 201 Created
Content-Length: 764
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 0e93c70c-977a-4a88-9580-7cf084c73286
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
X-Locale: en-US,en-US
MS-CV: sF/wRa2ih0CzbABc.0
MS-ServerId: 000001
Date: Thu, 15 Mar 2018 17:15:01 GMT
{
"id": "b4c8fdea-cbe4-4d17-9576-13fcacbf9605",
"creationTimestamp": "2018-03-15T17:15:02.3840528Z",
"lastModifiedTimestamp": "2018-03-15T17:15:02.3840528Z",
"lastModifiedUser": "2713ccd7-ea3b-470a-9cfb-451d5d0482cc",
"lineItems": [
{
"id": 0,
"catalogItemId": "DG7GMGF0DWTL:0001:DG7GMGF0DSJB",
"friendlyName": "A_sample_Azure_RI",
"quantity": 2,
"currencyCode": "USD",
"billingCycle": "one_time",
"ProvisioningContext": {
"subscriptionId": "3D5ECED6-1151-44C7-AEE6-70A4BB725666",
"scope": "shared",
"duration": "1Year"
}
"orderGroup": "0"
}
],
"links": {
"self": {
"uri": "/v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts/b4c8fdea-cbe4-4d17-9576-13fcacbf9605/",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: