REST Resource: accounts.regions

المرجع: المنطقة

يمثل منطقة جغرافية يمكنك استخدامها كهدف مع كل من الخدمتين RegionalInventory وShippingSettings. يمكنك تحديد المناطق كمجموعات من الرموز البريدية أو في بعض البلدان باستخدام استهدافات جغرافية محدّدة مسبقًا. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد المناطق للحصول على مزيد من المعلومات.

تمثيل JSON
{
  "name": string,
  "postalCodeArea": {
    object (PostalCodeArea)
  },
  "geotargetArea": {
    object (GeoTargetArea)
  },
  "regionalInventoryEligible": boolean,
  "shippingEligible": boolean,
  "displayName": string
}
الحقول
name

string

المُعرّف. اسم المورد للمنطقة. تنسيق الملف: accounts/{account}/regions/{region}

postalCodeArea

object (PostalCodeArea)

اختياريّ. تمثّل هذه السمة قائمة بالرموز البريدية التي تحدّد منطقة المنطقة.

geotargetArea

object (GeoTargetArea)

اختياريّ. قائمة بالأهداف الجغرافية التي تحدد مساحة المنطقة.

regionalInventoryEligible

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا كانت المنطقة مؤهَّلة للاستخدام في إعدادات المستودع الإقليمي.

shippingEligible

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا كانت المنطقة مؤهّلة للاستخدام في إعدادات خدمات الشحن.

displayName

string

اختياريّ. الاسم المعروض للمنطقة.

PostalCodeArea

تمثّل هذه السمة قائمة بالرموز البريدية التي تحدّد منطقة المنطقة. ملاحظة: يمكن الوصول إلى جميع المناطق المحدّدة باستخدام الرموز البريدية من خلال مرجع ShippingSettings.postalCodeGroups الخاص بالحساب.

تمثيل JSON
{
  "regionCode": string,
  "postalCodes": [
    {
      object (PostalCodeRange)
    }
  ]
}
الحقول
regionCode

string

مطلوبة. رمز CLDR للمنطقة أو البلد الذي تنطبق عليه مجموعة الرموز البريدية

postalCodes[]

object (PostalCodeRange)

مطلوبة. نطاق من الرموز البريدية

PostalCodeRange

تمثّل هذه السمة مجموعة من الرموز البريدية التي تحدّد منطقة المنطقة.

تمثيل JSON
{
  "begin": string,
  "end": string
}
الحقول
begin

string

مطلوبة. رمز بريدي أو نمط لبادئة النموذج* يشير إلى الحد الأدنى الشامل للنطاق الذي يحدّد المنطقة. أمثلة على القيم: 94108 و9410* و9*.

end

string

اختياريّ. رمز بريدي أو نمط للنموذج prefix* يشير إلى الحد الأعلى الشامل للنطاق الذي يحدّد المنطقة. يجب أن يكون طوله متطابق تمامًا مثلpostCodeRangeges: إذا كان postCodeRangeStart رمزًا بريديًا، فيجب أن يكون mailCodeRangeEnd رمزًا بريديًا أيضًا. وإذا كان postCodeRangeges هو نمط، يجب أن يكون mailCodeRangeEnd نمطًا له طول البادئة نفسه. اختياري: في حال عدم ضبط هذه السياسة، يتم تحديد المنطقة على أنّها جميع الرموز البريدية التي تتطابق مع mailCodeRangeStart.

GeoTargetArea

قائمة بالأهداف الجغرافية التي تحدد مساحة المنطقة.

تمثيل JSON
{
  "geotargetCriteriaIds": [
    string
  ]
}
الحقول
geotargetCriteriaIds[]

string (int64 format)

مطلوبة. قائمة غير فارغة من أرقام تعريف المواقع الجغرافية. ويجب أن تكون جميعها من نوع الموقع الجغرافي نفسه (على سبيل المثال، الولاية).

الطُرق

create

تنشئ تعريفًا للمنطقة في حسابك على Merchant Center.

delete

يتم حذف تعريف المنطقة من حسابك على Merchant Center.

get

يسترد منطقة تم تحديدها في حسابك على Merchant Center.

list

يسرد المناطق في حسابك على Merchant Center.

patch

عدِّل تعريف المنطقة في حسابك على Merchant Center.