क्षेत्र बनाना और अपडेट करना

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

सफल कॉल से मिला जवाब का एक उदाहरण यह है:

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

बैच कार्रवाइयां

अगर एक से ज़्यादा क्षेत्रों को मैनेज किया जा रहा है, तो Merchant API बैच एंडपॉइंट उपलब्ध कराता है. इनकी मदद से, एक ही कॉल में 100 क्षेत्रों को बनाया, अपडेट किया, और मिटाया जा सकता है. ज़्यादा जानकारी के लिए, क्षेत्रों को बैच में मैनेज करना लेख पढ़ें.