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

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

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

• Get
• List
• Create
• Patch
• Delete

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

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

এখানে একটি নমুনা অনুরোধ:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions/234567?key=[YOUR_API_KEY]

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

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&key=[YOUR_API_KEY]

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

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&key=[YOUR_API_KEY]

{
  "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&key=[YOUR_API_KEY] 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&key=[YOUR_API_KEY] 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&key=[YOUR_API_KEY] 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?key=[YOUR_API_KEY] HTTP/1.1

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

HTTP/1.1 200
{}

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

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