কার্ট এপিআই বাস্তবায়ন, কার্ট এপিআই বাস্তবায়ন

এই নির্দেশিকাটি 2026-04-08 সংস্করণে ইউনিভার্সাল কমার্স প্রোটোকল (ইউসিপি) কার্ট এপিআই সংহত করার জন্য প্রযুক্তিগত এপিআই রেফারেন্স এবং পেলোড স্কিমা প্রদান করে।

আপনার এন্ডপয়েন্টগুলো তৈরি করার আগে, উচ্চ-স্তরের ধারণা এবং পূর্বশর্তগুলো জানার জন্য কার্ট এপিআই ওভারভিউটি পর্যালোচনা করে নিন।

কার্ট তৈরি করুন

এই এন্ডপয়েন্টটি একটি নতুন কার্ট সেশন তৈরি করার সুযোগ দেয়। এটি ইন্টিগ্রেট করতে, CreateCart এন্ডপয়েন্টটি ( POST /carts ) ইমপ্লিমেন্ট করুন। যখন কোনো ব্যবহারকারী তাদের কার্ট স্থানান্তর করার সিদ্ধান্ত নেন, তখন গুগল সমস্ত লাইন আইটেমের বিবরণ সহ এই এন্ডপয়েন্টটিকে কল করে। আপনার সিস্টেমকে অবশ্যই একটি continue_url দিয়ে সাড়া দিতে হবে, যা ব্যবহারকারীকে আপনার সাইটে তাদের আগে থেকে পূরণ করা কার্টে নির্দেশিত করবে।

• এন্ডপয়েন্ট: POST /carts
• ট্রিগার: একটিমাত্র CreateCart ( POST /carts ) রিকোয়েস্ট তখনই ট্রিগার হয়, যখন ব্যবহারকারী তাদের কার্ট আপনার স্টোরে স্থানান্তর করার জন্য ট্রান্সফার বাটনে (উদাহরণস্বরূপ, চেকআউট অন মার্চেন্ট ) ক্লিক করেন।

কার্ট প্রবাহ

কার্টের প্রবাহ এবং অবস্থা নিম্নরূপভাবে কাজ করে:

• গুগলে সংগ্রহ: যখন কোনো ব্যবহারকারী তার কার্টে আইটেম যোগ করেন, গুগল সেই আইটেমগুলো স্থানীয়ভাবে সংগ্রহ করে। আইটেম যোগ করার সাথে সাথে গুগল একাধিক এপিআই কল করে না।
• পেলোড: একক POST /carts অনুরোধটিতে একবারে সমস্ত জমা হওয়া line_items এর সম্পূর্ণ অ্যারে থাকবে।
• পুনঃনির্দেশনা এবং অবস্থা: মার্চেন্টের ব্যাকএন্ড তাদের ওয়েবসাইটে আগে থেকে পূরণ করা কার্টকে নির্দেশ করে এমন একটি continue_url দিয়ে সাড়া দেয়।

অনুরোধ: গুগল কার্টে যোগ করার জন্য 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"
}

ত্রুটি পরিচালনা

এরর মেসেজ কীভাবে ফরম্যাট করতে হয় এবং প্রোটোকল ও বিজনেস লজিক এররের মধ্যে পার্থক্য সম্পর্কে সম্পূর্ণ নির্দেশনার জন্য, এরর কোডসমূহ দেখুন।