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

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