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

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

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

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

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/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"
      }
    ]
  }

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

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/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/v1beta/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/v1beta/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/v1beta/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/v1beta/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/v1beta/accounts/102959835/regions/987654?key=[YOUR_API_KEY] HTTP/1.1

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

HTTP/1.1 200
{}