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

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