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

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 region batching