إنشاء المناطق وتعديلها

في 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