মার্চেন্ট API v1beta বন্ধ করে দেওয়া হয়েছিল এবং ২৮শে ফেব্রুয়ারী, ২০২৬ তারিখে বন্ধ করে দেওয়া হয়েছিল। সর্বশেষ স্থিতিশীল সংস্করণে স্থানান্তরের পদক্ষেপগুলির জন্য, v1beta থেকে v1 এ স্থানান্তর দেখুন।

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

অঞ্চলগুলি তৈরি এবং আপডেট করুন

মার্চেন্ট এপিআই-তে আপনি accounts.products.regionalInventories রিসোর্স সম্পর্কিত পরিষেবাগুলির জন্য টার্গেট হিসেবে ভৌগোলিক অঞ্চল ব্যবহার করতে পারেন। আপনি পোস্টাল কোডের সংগ্রহ হিসেবে অথবা, কিছু দেশে, পূর্বনির্ধারিত জিওটার্গেট ব্যবহার করে অঞ্চলগুলি সংজ্ঞায়িত করতে পারেন। আরও তথ্যের জন্য, "অঞ্চল সেট আপ করুন" দেখুন।

অঞ্চল তৈরি ও হালনাগাদ করতে, আপনি নিম্নলিখিত পদ্ধতিগুলো ব্যবহার করতে পারেন:

Get
List
Create
Patch
Delete

একটি অঞ্চল পুনরুদ্ধার করুন

আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে সংজ্ঞায়িত কোনো অঞ্চল পুনরুদ্ধার করতে, accounts.regions.get পদ্ধতিটি ব্যবহার করুন।

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions/234567

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

HTTP/1.1 200

{
  "name": "accounts/125222396/regions/234567",
  "displayName": "Canada",
  "postalCodeArea": {
    "regionCode": "CA",
    "postalCodes": [
      {
        "begin": "L6A"
      }
    ]
  }

সমস্ত অঞ্চল তালিকাভুক্ত করুন

আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের অঞ্চলগুলো তালিকাভুক্ত করতে, accounts.regions.list পদ্ধতিটি ব্যবহার করুন।

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions?pageSize=100

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

HTTP/1.1 200

{
  "regions": [
    {
      "name": "accounts/125222396/regions/234567",
      "displayName": "Canada",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "L6A"
          }
        ]
      },
      "regionalInventoryEligible": true,
      "shippingEligible": true
    },
    {
      "name": "accounts/125222396/regions/Inline region",
      "displayName": "Inline region",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "M7B"
          }
        ]
      },
      "regionalInventoryEligible": false,
      "shippingEligible": true
    },
  ]
}

একটি অঞ্চল সন্নিবেশ করুন

আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে একটি অঞ্চল সংজ্ঞা যুক্ত করতে, accounts.regions.create মেথডটি ব্যবহার করুন। এই মেথডটি কার্যকর করার জন্য অ্যাডমিনিস্ট্রেটর অ্যাক্সেস প্রয়োজন।

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=987654

{
  "displayName": "TestRegion",
  "name": "987654",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98109"
      }
    ],
    "regionCode": "US"
  }
}

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

{
     "name": "accounts/102959835/regions/987654",
  "displayName": "TestRegion",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98109"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

AreaCode ব্যবহার করে নতুন অঞ্চল তৈরি করতে:

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=168888 HTTP/1.1

{
  "displayName": "WA_test",
  "name": "168888",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20101
    ]
  }
}

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "WA_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20101"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

তৈরি করা অঞ্চলের displayName এবং GeoTargetCriteriaIds আপডেট করতে:

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea HTTP/1.1

{
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20100
    ]
  }
}

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

HTTP/1.1 200

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20100"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

একটি অঞ্চল আপডেট করুন

আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে কোনো অঞ্চলের সংজ্ঞা আপডেট করতে, accounts.regions.patch মেথডটি ব্যবহার করুন। এই মেথডটি কার্যকর করার জন্য অ্যাডমিনিস্ট্রেটর অ্যাক্সেস প্রয়োজন।

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654?updateMask=displayName%2CpostalCodeArea HTTP/1.1

Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "displayName": "Test",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98108"
      }
    ],
    "regionCode": "US"
  }
}

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

{
  "name": "accounts/102959835/regions/987654",
  "displayName": "Test",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98108"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

একটি অঞ্চল মুছে ফেলুন

আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে কোনো রিজিওন ডেফিনিশন মুছে ফেলার জন্য, accounts.regions.delete মেথডটি ব্যবহার করুন। এই মেথডটি কার্যকর করার জন্য অ্যাডমিনিস্ট্রেটর অ্যাক্সেস প্রয়োজন।

এখানে একটি নমুনা অনুরোধ দেওয়া হলো:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654 HTTP/1.1

একটি সফল কলের নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:

HTTP/1.1 200
{}

ব্যাচ অপারেশন

আপনি যদি একাধিক অঞ্চল পরিচালনা করেন, তাহলে মার্চেন্ট এপিআই ব্যাচ এন্ডপয়েন্ট সরবরাহ করে, যা আপনাকে একটিমাত্র কলে ১০০টি পর্যন্ত অঞ্চল তৈরি, আপডেট এবং মুছে ফেলার সুবিধা দেয়। আরও তথ্যের জন্য, ‘অঞ্চল ব্যাচিং পরিচালনা ’ দেখুন।

পূর্ববর্তী

Manage Terms of Service

পরবর্তী

Manage region batching