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

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 क्षेत्रों को बनाया, अपडेट किया, और मिटाया जा सकता है. ज़्यादा जानकारी के लिए, बैच में क्षेत्रों को मैनेज करना लेख पढ़ें.