অঞ্চল তৈরি ও আপডেট করুন

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

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

অঞ্চল ফিরিয়ে আনুন

আপনার Merchant Center অ্যাকাউন্টে নির্দিষ্ট করা কোনও অঞ্চল ফিরিয়ে আনতে, 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"
      }
    ]
  }

সব অঞ্চলের তালিকা দেখুন

আপনার Merchant Center অ্যাকাউন্টে অঞ্চল তালিকাভুক্ত করতে, 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
    },
  ]
}

অঞ্চল যোগ করুন

আপনার Merchant Center অ্যাকাউন্টে অঞ্চলের সংজ্ঞা যোগ করতে, 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
}

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

আপনার Merchant Center অ্যাকাউন্টে অঞ্চলের সংজ্ঞা আপডেট করতে, 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
}

কোনও অঞ্চল মুছে ফেলা

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

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

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

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

HTTP/1.1 200
{}

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

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