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

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

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

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

पीछे जाएं
Manage Terms of Service
आगे बढ़ें
Manage region batching