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

في 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?key=[YOUR_API_KEY]

في ما يلي نموذج ردّ من مكالمة ناجحة:

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&key=[YOUR_API_KEY]

في ما يلي نموذج ردّ من مكالمة ناجحة:

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&key=[YOUR_API_KEY]

{
  "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&key=[YOUR_API_KEY] 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&key=[YOUR_API_KEY] 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&key=[YOUR_API_KEY] 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?key=[YOUR_API_KEY] HTTP/1.1

في ما يلي نموذج ردّ من مكالمة ناجحة:

HTTP/1.1 200
{}

عمليات مجمعة

إذا كنت تدير مناطق متعدّدة، توفّر Merchant API نقاط نهاية مجمّعة تتيح لك إنشاء ما يصل إلى 100 منطقة وتعديلها وحذفها في طلب واحد. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة تجميع المناطق.