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

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