এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

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

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

এন্ডপয়েন্ট: POST /carts
ট্রিগার: ব্যবহারকারী কোনো পণ্যের 'কার্টে যোগ করুন' বোতামে ক্লিক করলে, সেটি বিক্রেতার কার্টে প্রথম আইটেম হিসেবে যুক্ত হয়।

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

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

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

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

এন্ডপয়েন্ট: POST /carts
ট্রিগার: ব্যবহারকারী কোনো পণ্যের 'কার্টে যোগ করুন' বোতামে ক্লিক করলে, সেটি বিক্রেতার কার্টে প্রথম আইটেম হিসেবে যুক্ত হয়।

অনুরোধ: গুগল কার্টে যোগ করার জন্য line_items এর অ্যারে পাঠায়।

অনুরোধের উদাহরণ:

{
  "line_items": [
    {
      "item": {
        "id": "item_123"
      },
      "quantity": 2
    }
  ]
}

প্রতিক্রিয়ার উদাহরণ:

{
  "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"
}

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

পরবর্তী

প্রোমো কোড এবং ডিসকাউন্ট