इस गाइड में, यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी) कार्ट एपीआई को वर्शन 2026-04-08 में इंटिग्रेट करने के लिए, तकनीकी एपीआई का संदर्भ और पेलोड स्कीमा दिए गए हैं.
अपने एंडपॉइंट बनाने से पहले, पक्का करें कि आपने Cart API की खास जानकारी पढ़ ली हो. इसमें, ज़रूरी शर्तें और सामान्य कॉन्सेप्ट के बारे में बताया गया है.
कार्ट बनाएं
इस एंडपॉइंट की मदद से, नया कार्ट सेशन बनाया जा सकता है. इंटिग्रेट करने के लिए, CreateCart एंडपॉइंट (POST /carts) लागू करें. जब कोई व्यक्ति अपना कार्ट ट्रांसफ़र करने का विकल्प चुनता है, तो Google इस एंडपॉइंट को लाइन आइटम का ब्यौरा के साथ कॉल करता है. आपके सिस्टम को continue_url के साथ जवाब देना होगा. इससे उपयोगकर्ता को आपकी साइट पर पहले से भरे गए कार्ट पर रीडायरेक्ट किया जा सकेगा.
- एंडपॉइंट:
POST /carts - ट्रिगर: जब कोई उपयोगकर्ता किसी प्रॉडक्ट पर "कार्ट में जोड़ें" पर क्लिक करता है और कारोबारी या कंपनी के लिए कार्ट में पहला आइटम जोड़ता है.
अनुरोध: Google, कार्ट में जोड़े जाने वाले line_items का ऐरे भेजता है.
अनुरोध का उदाहरण:
{
"line_items": [
{
"item": {
"id": "item_123"
},
"quantity": 2
}
]
}
जवाब: आपको शुरू किया गया कार्ट सेशन वापस मिलता है. इसमें लाइन आइटम की जानकारी, कुल कीमत, और continue_url शामिल होता है. जवाब में मौजूद continue_url फ़ील्ड, उपयोगकर्ता को आपकी साइट के उस पेज पर वापस ले जाना चाहिए जहां वह कार्ट को मैनेज करना जारी रख सके. आम तौर पर, यह आपके कार्ट या चेकआउट पेज से लिंक होता है. इसमें id पहले से लोड किए गए सेशन की जानकारी होती है.
जवाब का उदाहरण:
{
"ucp": {
"version": "2026-04-08",
"capabilities": {
"dev.ucp.shopping.cart": [{"version": "2026-04-08"}]
}
},
"id": "cart_abc123",
"line_items": [
{
"id": "li_1",
"item": {
"id": "item_123",
"title": "Red T-Shirt",
"price": 2500
},
"quantity": 2,
"totals": [
{"type": "subtotal", "amount": 5000},
{"type": "total", "amount": 5000}
]
}
],
"currency": "USD",
"totals": [
{
"type": "subtotal",
"amount": 5000
},
{
"type": "total",
"amount": 5000,
"display_text": "Estimated total (taxes calculated at checkout)"
}
],
// Used for redirecting the user back to the merchant's cart experience from Google surfaces.
"continue_url": "https://business.example.com/checkout?cart=cart_abc123",
// Indicate the timestamp at which the cart session will expire and become invalid.
"expires_at": "2026-01-16T12:00:00Z"
}
गड़बड़ी ठीक करना
गड़बड़ी के मैसेज को फ़ॉर्मैट करने और प्रोटोकॉल और कारोबारी नियम से जुड़ी गड़बड़ियों के बीच अंतर करने के बारे में पूरी जानकारी के लिए, गड़बड़ी के कोड देखें.