ShippingSettings

[إعدادات الشحن](https://support.google.com/merchants/answer/6069284) في حساب التاجر

تمثيل JSON 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
الحقول
name

string

المُعرّف. اسم المورد لإعدادات الشحن. تنسيق الملف: accounts/{account}/shippingSetting
services[]

object (Service)

اختياريّ. قائمة الخدمات للحساب المستهدف.
warehouses[]

object (Warehouse)

اختياريّ. قائمة بالمستودعات التي يمكن الإشارة إليها في services.
etag

string

مطلوبة. يُستخدم هذا الحقل لتجنُّب حدوث مشكلة غير متزامنة. تأكَّد من عدم تغيُّر بيانات إعدادات الشحن بين تلقّي مكالمة وإدراج مكالمة. يجب على المستخدم اتباع الخطوات التالية:

  1. اضبط حقل العلامة الإلكترونية كسلسلة فارغة لإنشاء إعدادات الشحن الأولية.

  2. بعد الإنشاء الأولي، يمكنك استدعاء الطريقة get للحصول على علامة etag وبيانات إعدادات الشحن الحالية قبل إدراج المكالمة.

  3. التعديل إلى معلومات إعدادات الشحن المطلوبة

  4. طريقة إدراج المكالمات مع معلومات إعداد الشحن المطلوبة باستخدام علامة etag التي تم الحصول عليها من الخطوة 2

  5. إذا تغيّرت بيانات إعدادات الشحن بين الخطوة 2 والخطوة 4: سيتعذر طلب الإدراج لأنّ علامة etag تتغير مع كلّ مرّة تتغيّر فيها بيانات إعدادات الشحن. على المستخدم تكرار الخطوة من 2 إلى 4 باستخدام العلامة الإلكترونية الجديدة.

الخدمة

خدمة الشحن.

تمثيل JSON 
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
الحقول
deliveryCountries[]

string

مطلوبة. رمز CLDR الإقليمي للبلدان التي تنطبق عليها الخدمة.
rateGroups[]

object (RateGroup)

اختياريّ. تعريفات مجموعات تعرفات الشحن يُسمح للحقل الأخير فقط أن يكون حقل applicableShippingLabels فارغًا، أي "كل شيء آخر". يجب ألا تتداخل applicableShippingLabels الأخرى.
loyaltyPrograms[]

object (LoyaltyProgram)

اختياريّ. برامج الولاء التي تقتصر عليها خدمة الشحن هذه
serviceName

string

مطلوبة. اسم الخدمة الحرّ. يجب أن يكون فريدًا ضمن الحساب المستهدف.
active

boolean

مطلوبة. قيمة منطقية تعرض الحالة النشطة لخدمة الشحن.
currencyCode

string

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

object (DeliveryTime)

مطلوبة. الوقت المستغرق في جوانب مختلفة من الطلب إلى تسليم المنتج.
shipmentType

enum (ShipmentType)

نوع المواقع الجغرافية التي تشحن هذه الخدمة الطلبات إليها.
minimumOrderValue

object (Price)

تمثّل هذه السمة الحدّ الأدنى لقيمة طلب الشراء لهذه الخدمة. وفي حال ضبطها، يشير ذلك إلى أنّه سيتعين على العملاء إنفاق هذا المبلغ على الأقل. يجب أن تكون جميع الأسعار ضمن الخدمة العملة نفسها. لا يمكن ضبطها مع الحدّ الأدنى OrderValueTable.
minimumOrderValueTable

object (MinimumOrderValueTable)

جدول يبيّن الحد الأدنى لقيم طلبات الشراء حسب المتجر لنوع طريقة استلام الطلب لا يمكن ضبطها مع الحدّ الأدنى OrderValue.
storeConfig

object (StoreConfig)

قائمة بالمتاجر التي يتمّ تسليم منتجاتك منها لا يصلح هذا الخيار إلا لنوع شحنة التوصيل المحلي.

DeliveryTime

الوقت المستغرق في جوانب مختلفة من الطلب إلى تسليم المنتج.

تمثيل JSON 
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
الحقول
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

اختياريّ. تشير هذه السمة إلى أنّه يجب احتساب مدة التسليم لكل مستودع (موقع مصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذه السياسة، ما مِن حقل آخر مرتبط بمدة النقل في [مدة التسليم][[google.shopping.content.bundles.Shippingsetting.DeliveryTime].
minTransitDays

integer

الحد الأدنى لعدد أيام العمل التي يتم قضاؤها في النقل. تعني القيمة 0 إمكانية التسليم في اليوم نفسه، وتعني 1 التسليم في اليوم التالي. يجب ضبط minTransitDays أو maxTransitDays أو transitTimeTable، ولكن لا يجب ضبط الاثنين معًا.
maxTransitDays

integer

الحد الأقصى لعدد أيام العمل التي يتم قضاؤها في النقل. تعني القيمة 0 إمكانية التسليم في اليوم نفسه، وتعني 1 التسليم في اليوم التالي. يجب أن تكون القيمة أكبر من أو تساوي minTransitDays.
cutoffTime

object (CutoffTime)

تعريف الموعد النهائي لأيام العمل وفي حال عدم ضبط هذا الإعداد، سيتم ضبط الموعد النهائي لطلب المنتجات على الساعة 8 صباحًا بتوقيت المحيط الهادئ.
minHandlingDays

integer

تمثّل هذه السمة الحد الأدنى لعدد أيام العمل قبل شحن الطلب. 0 تعني أن يتم الشحن في اليوم نفسه، و 1 يعني أن يتم الشحن في اليوم التالي.
maxHandlingDays

integer

الحدّ الأقصى لعدد أيام العمل التي يمكن قضاؤها قبل شحن الطلب. 0 تعني أن يتم الشحن في اليوم نفسه، و 1 يعني أن يتم الشحن في اليوم التالي. يجب أن تكون القيمة أكبر من أو تساوي minHandlingDays.
transitTimeTable

object (TransitTable)

جدول مدة النقل، وعدد أيام العمل التي تقضيها في النقل استنادًا إلى سمات الصفوف والأعمدة يمكن ضبط minTransitDays أو maxTransitDays أو transitTimeTable، ولكن لا يمكن ضبط الاثنين معًا.
handlingBusinessDayConfig

object (BusinessDayConfig)

أيام العمل التي يمكن معالجة الطلبات خلالها. وفي حال عدم توفير هذه السمة، ستفترض إضافتها أيام العمل من الاثنين إلى الجمعة.
transitBusinessDayConfig

object (BusinessDayConfig)

أيام العمل التي يمكن أن يتم خلالها نقل الطلبات. وفي حال عدم توفير هذه السمة، ستفترض إضافتها أيام العمل من الاثنين إلى الجمعة.

CutoffTime

تعريف الموعد النهائي لأيام العمل

تمثيل JSON 
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
الحقول
hour

integer

مطلوبة. تمثّل هذه السمة ساعة الموعد النهائي لتقديم الطلب كي تتمّ معالجة الطلب في اليوم نفسه.
minute

integer

مطلوبة. دقيقة من الموعد النهائي لاستلام الطلب يجب تقديم الطلب في اليوم نفسه
timeZone

string

مطلوبة. معرّف المنطقة الزمنية، مثل "أوروبا/زيورخ".

TransitTable

جدول مدة النقل، وعدد أيام العمل التي تقضيها في النقل استنادًا إلى سمات الصفوف والأعمدة يمكن ضبط minTransitDays أو maxTransitDays أو transitTimeTable، ولكن لا يمكن ضبط الاثنين معًا.

تمثيل JSON 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
الحقول
postalCodeGroupNames[]

string

مطلوبة. قائمة بأسماء المناطق Region.name . يمكن أن تكون القيمة الأخيرة "all other locations". مثال: ["zone 1", "zone 2", "all other locations"] يجب أن تتطابق مجموعات الرموز البريدية التي تمت إحالتها مع بلد التسليم الخاص بالخدمة.
transitTimeLabels[]

string

مطلوبة. تمثّل هذه السمة قائمة بتصنيفات مدة النقل. يمكن أن تكون القيمة الأخيرة "all other labels". مثال: ["food", "electronics", "all other labels"]
rows[]

object (TransitTimeRow)

مطلوبة. إذا كانت هناك مجموعة سمات واحدة فقط من postalCodeGroupNames أو transitTimeLabels، ستكون هناك صفوف متعددة تحتوي كل منها على قيمة واحدة لتلك السمة. إذا كانت هناك سمتان، يتجاوب كل صف مع postalCodeGroupNames والأعمدة (القيم) مع transitTimeLabels.

TransitTimeRow

إذا كانت هناك مجموعة سمات واحدة فقط من postalCodeGroupNames أو transitTimeLabels، ستكون هناك صفوف متعددة تحتوي كل منها على قيمة واحدة لتلك السمة. إذا كانت هناك سمتان، يتجاوب كل صف مع postalCodeGroupNames والأعمدة (القيم) مع transitTimeLabels.

تمثيل JSON 
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
الحقول
values[]

object (TransitTimeValue)

مطلوبة. نطاق مدة النقل (الحد الأدنى والأقصى) في أيام العمل

TransitTimeValue

نطاق مدة النقل (الحد الأدنى والأقصى) في أيام العمل

تمثيل JSON 
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
الحقول
minTransitDays

integer

الحدّ الأدنى لنطاق مدة النقل في أيام العمل تعني القيمة 0 إمكانية التسليم في اليوم نفسه، وتعني 1 التسليم في اليوم التالي.
maxTransitDays

integer

يجب أن تكون القيمة أكبر من أو تساوي minTransitDays.

BusinessDayConfig

أيام عمل المخزن:

تمثيل JSON 
{
  "businessDays": [
    enum (Weekday)
  ]
}
الحقول
businessDays[]

enum (Weekday)

مطلوبة. أيام عمل عادية. لا يمكن ترك الحقل فارغًا.

أيام الأسبوع

عمليات التعداد
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

تشير هذه السمة إلى أنّه يجب احتساب مدة التسليم لكل مستودع (موقع مصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذه السياسة، يجب عدم ضبط أي حقل آخر مرتبط بمدة النقل في deliveryTime.

تمثيل JSON 
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
الحقول
carrier

string

مطلوبة. مشغّل شبكة الجوّال، مثل "UPS" أو "Fedex".
carrierService

string

مطلوبة. خدمة مشغّل شبكة الجوّال، مثل "ground" أو "2 days". يجب أن يكون اسم الخدمة في قائمة eddsupportedServices.
warehouse

string

مطلوبة. اسم المستودع. يجب أن تتطابق هذه السمة مع قيمة [warehouse][ShippingSETTING.warehouses.name].

RateGroup

تعريفات مجموعات تعرفات الشحن يُسمح للحقل الأخير فقط أن يكون حقل applicableShippingLabels فارغًا، أي "كل شيء آخر". يجب ألا تتداخل applicableShippingLabels الأخرى.

تمثيل JSON 
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
الحقول
applicableShippingLabels[]

string

مطلوبة. قائمة بتصنيفات الحِزم تحدّد المنتجات التي تنطبق عليها مجموعة الأسعار هذه. وهذا فصل: يجب أن يتطابق تصنيف واحد فقط مع مجموعة الأسعار كي يتم تطبيقها. لا يمكن ترك هذا الحقل فارغًا إلا لمجموعة الأسعار الأخيرة للخدمة.
subtables[]

object (Table)

اختياريّ. هذه قائمة بالجداول الفرعية المُشار إليها من خلال "mainTable". لا يمكن ضبطها إلا في حال ضبط mainTable.
carrierRates[]

object (CarrierRate)

اختياريّ. قائمة بأسعار شركات النقل التي يمكن الإشارة إليها من خلال mainTable أو singleValue.
singleValue

object (Value)

قيمة مجموعة الأسعار (على سبيل المثال، السعر الثابت 10 دولار أمريكي). لا يمكن ضبطها إلا في حال عدم ضبط mainTable وsubtables.
mainTable

object (Table)

جدول يحدّد مجموعة الأسعار عندما لا تكون السمة singleValue معبّرة بما يكفي. لا يمكن ضبطها إلا في حال عدم ضبط singleValue.
name

string

اختياريّ. اسم مجموعة الأسعار ويجب أن يكون فريدًا ضمن خدمة الشحن في حال ضبطه.

القيمة

القيمة المفردة لمجموعة أسعار أو قيمة خلية جدول مجموعة الأسعار. يجب ضبط سمة واحدة فقط من noShipping أو flatRate أو pricePercentage أو carrier_rateName أو subtable_name.

تمثيل JSON 
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
الحقول
noShipping

boolean

إذا كانت القيمة هي true، لا يمكن شحن المنتج. يجب أن تكون القيمة صحيحة عند ضبطها، ولا يمكن ضبطها إلا إذا لم يتم ضبط جميع الحقول الأخرى.
flatRate

object (Price)

سعر ثابت. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
pricePercentage

string

نسبة مئوية من السعر يتم تمثيلها كرقم في التدوين العشري (على سبيل المثال، "5.4"). لا يمكن تحديدها إلا في حال عدم ضبط جميع الحقول الأخرى.
carrierRate

string

اسم سعر شركة النقل الذي يشير إلى سعر شركة النقل محدّد في مجموعة السعر نفسها لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
subtable

string

تمثّل هذه السمة اسم الجدول الفرعي. لا يمكن ضبطها إلا في خلايا الجدول (مثلاً، ليس للقيم الفردية)، وفقط في حال عدم ضبط جميع الحقول الأخرى.

جدول

جدول يحدّد مجموعة الأسعار عندما لا تكون السمة singleValue معبّرة بما يكفي.

تمثيل JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
الحقول
rows[]

object (Row)

مطلوبة. تمثّل هذه السمة قائمة الصفوف التي تشكّل الجدول. يجب أن يتطابق طول السمة مع rowHeaders.
name

string

اسم الجدول. مطلوب للجداول الفرعية، ويتم تجاهلها في الجدول الرئيسي.
rowHeaders

object (Headers)

مطلوبة. عناوين صفوف الجدول.
columnHeaders

object (Headers)

عناوين أعمدة الجدول. اختياري: إذا لم يتم ضبط السياسة، سيضمّ الجدول سمة واحدة فقط.

العناوين

قائمة غير فارغة بعناوين الصفوف أو الأعمدة لجدول. يجب ضبط سمة واحدة فقط من prices أو weights أو num_items أو postalCodeGroupNames أو location.

تمثيل JSON 
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
الحقول
prices[]

object (Price)

مطلوبة. قائمة بالحدود العليا لأسعار الطلبات الشاملة. يمكن أن تكون قيمة السعر الأخير بلا نهاية من خلال تعيين قيمة السعرMicros = -1. على سبيل المثال، يمثل [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] العناوين "<= $10" و"<= $500" و "> 500 دولار أمريكي". يجب أن تكون جميع الأسعار ضمن الخدمة العملة نفسها. يجب ألا يكون الحقل فارغًا. يجب أن تكون موجبة باستثناء -1. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
weights[]

object (Weight)

مطلوبة. تمثّل هذه السمة قائمة بالحدود العليا لوزن الطلب الشامل. يمكن أن تكون قيمة الترجيح الأخيرة بلا نهاية عن طريق تعيين السعر amounticros = -1. على سبيل المثال، تمثّل السمة [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] العناوين "<= 10kg" و"<= 50kg" و "> 50kg". يجب أن تشتمل جميع القيم ضمن الخدمة على الوحدة نفسها. يجب ألا يكون الحقل فارغًا. يجب أن تكون موجبة باستثناء -1. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
numberOfItems[]

string

مطلوبة. قائمة تضم عددًا لا يحصى من العناصر القصوى. يمكن أن تكون القيمة الأخيرة "infinity". على سبيل المثال، يمثل ["10", "50", "infinity"] العناوين "<= 10 عناصر" و"<= 50 عنصرًا" و "> 50 عنصرًا". يجب ألا يكون الحقل فارغًا. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
postalCodeGroupNames[]

string

مطلوبة. قائمة بأسماء المجموعات البريدية. يمكن أن تكون القيمة الأخيرة "all other locations". مثال: ["zone 1", "zone 2", "all other locations"] يجب أن تتطابق مجموعات الرموز البريدية التي تمت إحالتها مع بلد التسليم الخاص بالخدمة. يجب ألا يكون الحقل فارغًا. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.
locations[]

object (LocationIdSet)

مطلوبة. قائمة بمجموعات معرّفات الموقع الجغرافي. يجب ألا يكون الحقل فارغًا. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.

الوزن

الوزن الذي يتم تمثيله كقيمة في السلسلة والوحدة.

تمثيل JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
الحقول
unit

enum (WeightUnit)

مطلوبة. وحدة الوزن. القيم المقبولة هي: كيلوغرام ورطل
amountMicros

string (int64 format)

مطلوبة. يمثّل الوزن رقمًا بالمايكرو (يعادل مليون ميكرو وحدة العملة العادية للفرد، على سبيل المثال، 1 كلغ = 1000000 ميكرو). يمكن أيضًا ضبط هذا الحقل على أنه بلا نهاية من خلال الضبط على -1. يمكن استخدام الرمز -1 فقط في هذا الحقل والقيمة الموجبة.

WeightUnit

وحدة الوزن.

عمليات التعداد
WEIGHT_UNIT_UNSPECIFIED وحدة غير محدّدة
POUND رطل.
KILOGRAM كجم.

LocationIdSet

قائمة بمجموعات معرّفات الموقع الجغرافي. يجب ألا يكون الحقل فارغًا. لا يمكن ضبطها إلا في حال عدم ضبط جميع الحقول الأخرى.

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

string

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

الصف

تضمين قائمة من الخلايا.

تمثيل JSON 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
الحقول
cells[]

object (Value)

مطلوبة. قائمة الخلايا التي تشكل الصف. يجب أن يكون الطول نفسه للجداول الثنائية الأبعاد، مثل columnHeaders للجداول الثنائية الأبعاد.

CarrierRate

قائمة بأسعار شركات النقل التي يمكن الإشارة إليها من خلال mainTable أو singleValue.

تمثيل JSON 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
الحقول
name

string

مطلوبة. اسم سعر شركة النقل يجب أن يكون فريدًا لكل مجموعة أسعار.
carrier

string

مطلوبة. خدمة مشغّل شبكة الجوّال، مثل "UPS" أو "Fedex".
carrierService

string

مطلوبة. خدمة مشغّل شبكة الجوّال، مثل "ground" أو "2 days".
originPostalCode

string

مطلوبة. مصدر الشحن لسعر شركة النقل هذا
percentageAdjustment

string

اختياريّ. معدِّل تعرفة الشحن المضرب كرقم في التدوين العشري يمكن أن تكون سلبية. على سبيل المثال، تؤدي السمة "5.4" إلى زيادة المعدّل بنسبة 5.4%، وخفض "-3" بنسبة 3%.
flatAdjustment

object (Price)

اختياريّ. معدِّل تعرفة الشحن المضاف: يمكن أن تكون سلبية. على سبيل المثال، تتم إضافة دولار أمريكي واحد (أو ما يعادله بالعملة المحلية) إلى السعر من خلال { "amountMicros": 1, "currencyCode" : "USD" }، وإزالة { "amountMicros": -3, "currencyCode" : "USD" } من السعر بقيمة 3 دولار أمريكي (أو ما يعادله بالعملة المحلية).

ShipmentType

نوع شحن خدمة الشحن

عمليات التعداد
SHIPMENT_TYPE_UNSPECIFIED لم تحدّد هذه الخدمة نوع الشحن.
DELIVERY تتيح هذه الخدمة شحن الطلبات إلى عنوان يختاره العميل.
LOCAL_DELIVERY تتيح هذه الخدمة شحن الطلبات إلى عنوان يختاره العميل. يتم شحن الطلب من متجر محلي بالقرب منك.
COLLECTION_POINT تتيح هذه الخدمة شحن الطلبات إلى عنوان يختاره العميل. تمّ شحن الطلب من نقطة استلام.

MinimumOrderValueTable

جدول يبيّن الحد الأدنى لقيم طلبات الشراء حسب المتجر لنوع طريقة استلام الطلب

تمثيل JSON 
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
الحقول
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

مطلوبة. تتوفّر قائمة بمجموعات رموز المتاجر التي تتشارك الحد الأدنى نفسه لقيمة طلب الشراء (MOV). يجب توفير مجموعتَين على الأقل، ويجب أن تكون المجموعة الأخيرة فارغة، ما يشير إلى "كيفية طلب البحث (MOV) لجميع المتاجر الأخرى". يمكن أن يظهر كل رمز متجر مرة واحدة فقط على مستوى جميع المجموعات. يجب أن تكون جميع الأسعار ضمن الخدمة العملة نفسها.

StoreCodeSetWithMov

تتضمّن هذه السمة قائمة بمجموعات رموز المتاجر التي تتشارك الحدّ الأدنى نفسه لقيمة طلب الشراء. يجب توفير مجموعتَين على الأقل، ويجب أن تكون المجموعة الأخيرة فارغة، ما يشير إلى "كيفية طلب البحث (MOV) لجميع المتاجر الأخرى". يمكن أن يظهر كل رمز متجر مرة واحدة فقط على مستوى جميع المجموعات. يجب أن تكون جميع الأسعار ضمن الخدمة العملة نفسها.

تمثيل JSON 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
الحقول
storeCodes[]

string

اختياريّ. قائمة برموز المتاجر الفريدة أو أن تكون فارغة لجميع السلع
value

object (Price)

تمثّل هذه السمة الحدّ الأدنى لقيمة طلب الشراء في المتاجر المحدّدة.

StoreConfig

قائمة بالمتاجر التي يتمّ تسليم منتجاتك منها لا يصلح هذا الخيار إلا لنوع شحنة التوصيل المحلي.

تمثيل JSON 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
الحقول
storeCodes[]

string

اختياريّ. قائمة برموز المتاجر التي توفّر خدمة التوصيل المحلي إذا كانت فارغة، يجب أن تكون القيمة all_stores صحيحة.
storeServiceType

enum (StoreServiceType)

تشير هذه السمة إلى ما إذا كانت كل المتاجر أو المتاجر التي اختارها هذا التاجر تقدّم خدمة التوصيل المحلي.
cutoffConfig

object (CutoffConfig)

تنتهي الإعدادات المرتبطة بالتسليم المحلي في اليوم المحدد.
serviceRadius

object (Distance)

أقصى نطاق جغرافي للتوصيل هذه السمة مطلوبة فقط لنوع شحنة التوصيل المحلي.

StoreServiceType

تشير هذه السمة إلى ما إذا كانت كل المتاجر أو المتاجر التي اختارها التاجر تقدّم خدمة التوصيل المحلي.

عمليات التعداد
STORE_SERVICE_TYPE_UNSPECIFIED لم يتم تحديد نوع خدمة المتجر.
ALL_STORES تشير هذه السمة إلى ما إذا كانت كل المتاجر الحالية والمستقبلية التي يعرضها هذا التاجر توفّر خدمة التوصيل المحلي.
SELECTED_STORES تشير هذه السمة إلى أنّ المتاجر المدرَجة في storeCodes فقط مؤهّلة لخدمة التوصيل المحلي.

CutoffConfig

تنتهي الإعدادات المرتبطة بالتسليم المحلي في اليوم المحدد.

تمثيل JSON 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
الحقول
localCutoffTime

object (LocalCutoffTime)

الوقت الذي ينتهي فيه التسليم المحلي لليوم.
storeCloseOffsetHours

string (int64 format)

يسري العرض فقط عند توفّر خدمة التوصيل المحلي. وتمثّل آخر موعد لاستلام الطلبات عدد الساعات التي تسبق إغلاق المتجر. يمكن استخدامهما حصريًا مع "localCutoffTime".
noDeliveryPostCutoff

boolean

يمكن للتجّار إيقاف عرض خدمة التسليم المحلي خلال يوم واحد أو أكثر إذا ضبطوا خدمة شحن على خدمة التسليم المحلي في اليوم نفسه. على سبيل المثال، إذا كانت خدمة الشحن تحدّد ميزة التسليم في اليوم نفسه وتجاوزت الموعد النهائي لطلب المنتجات، يؤدي ضبط هذا الحقل على true إلى احتساب سعر خدمة الشحن الذي يبلغ NO_DELIVERY_POST_CUTOFF. في المثال نفسه، عند ضبط هذا الحقل على false، يكون وقت الشحن المحسوب هو يومًا واحدًا. يتوفّر هذا الخيار في خدمة التوصيل المحلي فقط.

LocalCutoffTime

الوقت الذي ينتهي فيه التسليم المحلي لليوم.

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

string (int64 format)

يجب تقديم طلبات التسليم المحلي حسب الساعة قبل موعد معالجتها في اليوم نفسه.
minute

string (int64 format)

يجب تقديم طلبات التسليم المحلي المحدّدة في الدقيقة قبل معالجتها في اليوم نفسه.

المسافة

أقصى نطاق جغرافي للتوصيل هذه السمة مطلوبة فقط لنوع شحنة التوصيل المحلي.

تمثيل JSON 
{
  "value": string,
  "unit": enum (Unit)
}
الحقول
value

string (int64 format)

قيمة عددية للمسافة
unit

enum (Unit)

يمكن أن تختلف الوحدة بناءً على البلد، ويمكن أن تتضمن معلمة لتشمل الأميال والكيلومترات.

الوحدة

يمكن أن تختلف الوحدة بناءً على البلد، ويمكن أن تتضمن معلمة لتشمل الأميال والكيلومترات.

عمليات التعداد
UNIT_UNSPECIFIED لم يتم تحديد الوحدة.
MILES وحدة بالميل
KILOMETERS وحدة القياس بالكيلومترات

LoyaltyProgram

برنامج الولاء الذي يقدّمه التاجر

تمثيل JSON 
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
الحقول
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

اختياريّ. فئة برنامج الولاء في خدمة الشحن هذه
programLabel

string

هذا هو تصنيف برنامج الولاء الذي تم ضبطه في إعدادات برنامج الولاء في Merchant Center. من خلال هذه السمة الفرعية، تتمكّن Google من ربط برنامج الولاء بالعروض المؤهَّلة.

LoyaltyProgramTiers

مجموعة فرعية من برنامج الولاء للتجّار

تمثيل JSON 
{
  "tierLabel": string
}
الحقول
tierLabel

string

تهدف السمة الفرعية "تصنيف المستوى" [tierLabel] إلى التفرقة بين مزايا مستوى العرض في كل مستوى. يتم ضبط هذه القيمة أيضًا في إعدادات برنامجك في Merchant Center، وهي مطلوبة لتغييرات مصدر البيانات حتى إذا كان برنامج الولاء يتضمّن مستوًى واحدًا فقط.

مستودع

هو مستودع لتوصيل الطلبات، يخزِّن ويتعامل مع المستودع. العلامة التالية: 7

تمثيل JSON 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
الحقول
name

string

مطلوبة. تمثّل هذه السمة اسم المستودع. يجب أن يكون فريدًا داخل الحساب.
shippingAddress

object (Address)

مطلوبة. عنوان شحن المخزن:
cutoffTime

object (WarehouseCutoffTime)

مطلوبة. تمثّل هذه السمة آخر وقت لقبول الطلب وبدء معالجته. وستتم معالجة الطلبات اللاحقة في اليوم التالي. يستند الوقت إلى الرمز البريدي للمستودع.
handlingDays

string (int64 format)

مطلوبة. تمثّل هذه السمة عدد الأيام التي يستغرقها هذا المستودع في تعبئة سلعة وشحنها. على مستوى المستودع، ولكن يمكن تجاوزه على مستوى العرض استنادًا إلى سمات السلعة.
businessDayConfig

object (BusinessDayConfig)

أيام عمل المخزن: وفي حال تم ترك السياسة بدون ضبط، ستظهر تلقائيًا من الاثنين إلى الجمعة.

العنوان

عنوان شحن المخزن:

تمثيل JSON 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
الحقول
streetAddress

string

جزء من العنوان على مستوى الشارع. مثلاً: 111w 31st Street
city

string

مطلوبة. المدينة أو البلدة أو البلدية وقد تتضمن أيضًا المناطق المحلية التابعة أو المناطق المحلية الفرعية (على سبيل المثال، الأحياء أو الضواحي).
administrativeArea

string

مطلوبة. تقسيم فرعي إداري عالي المستوى للبلد. على سبيل المثال، ولاية مثل كاليفورنيا ("CA") أو مقاطعة مثل كيبك ("QC").
postalCode

string

مطلوبة. الرمز البريدي (على سبيل المثال "94043").
regionCode

string

مطلوبة. رمز CLDR للبلد (على سبيل المثال "US").

WarehouseCutoffTime

تمثّل هذه السمة آخر وقت لقبول الطلب وبدء معالجته. وستتم معالجة الطلبات اللاحقة في اليوم التالي. يستند الوقت إلى الرمز البريدي للمستودع.

تمثيل JSON 
{
  "hour": integer,
  "minute": integer
}
الحقول
hour

integer

مطلوبة. تشير هذه السمة إلى الساعة من الموعد النهائي لتقديم الطلبات لكي يعالجها المستودع في اليوم نفسه. تستند الساعة إلى المنطقة الزمنية للمستودع.
minute

integer

مطلوبة. دقيقة من الموعد النهائي لتقديم الطلبات لكي يعالجها المستودع في اليوم نفسه وتستند الدقيقة إلى المنطقة الزمنية للمخزن.