REST Resource: accounts.shippingSettings

المرجع: ShippingSettings

إعدادات الشحن في حساب التاجر

تمثيل 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

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

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

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

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

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

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

الخدمة

خدمة الشحن

تمثيل 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)

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

object (MinimumOrderValueTable)

جدول يعرض الحد الأدنى لقيم طلبات الشراء لكل متجر لنوع خدمة استلام الطلب. لا يمكن ضبطه مع minimumOrderValue.
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)

اختيارية: يشير ذلك إلى أنّه يجب احتساب وقت التسليم لكل مستودع (الموقع الجغرافي لمصدر الشحن) استنادًا إلى إعدادات شركة النقل المحدّدة. عند ضبط هذه السمة، يجب عدم ضبط أي حقل آخر مرتبط بمدة النقل في [delivery time][[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 إلى الشحن في اليوم التالي. يجب ضبط minHandlingDays وmaxHandlingDays أو عدم ضبطهما في الوقت نفسه.
maxHandlingDays

integer

الحد الأقصى لعدد أيام العمل التي يتم خلالها معالجة الطلب قبل شحنه يشير الرقم 0 إلى الشحن في اليوم نفسه، ويشير الرقم 1 إلى الشحن في اليوم التالي. يجب أن تكون أكبر من أو تساوي minHandlingDays. يجب ضبط minHandlingDays وmaxHandlingDays أو عدم ضبطهما في الوقت نفسه.
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)

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

object (Weight)

مطلوب. قائمة بالحدود العليا لوزن الطلبات الشاملة يمكن أن تكون قيمة آخر وزن بلا حدود من خلال ضبط price amountMicros = -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)

مطلوب. وحدة الوزن. القيم المقبولة هي: kg وlb
amountMicros

string (int64 format)

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

WeightUnit

وحدة الوزن.

عمليات التعداد
WEIGHT_UNIT_UNSPECIFIED الوحدة غير محدّدة
POUND وحدة الوزن بـ lb
KILOGRAM وحدة الوزن بالكيلوغرام

LocationIdSet

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

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

string

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

الصف

أدرِج قائمة بالخلايا.

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

object (Value)

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

CarrierRate

قائمة بأسعار مشغّلي شبكات الجوّال التي يمكن الإشارة إليها باستخدام mainTable أو singleValue يمكنك الاطّلاع على خدمات مشغّلي شبكات الجوّال المتوافقة على الرابط https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

تمثيل 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 لجميع المتاجر الأخرى". يمكن أن يظهر كل رمز متجر مرة واحدة فقط في جميع المجموعات. يجب أن تكون جميع الأسعار ضمن الخدمة بالعملة نفسها.

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

يمكن للتجّار إيقاف عرض ميزة التوصيل خلال n+1 يوم داخل المتجر إذا كانت لديهم خدمة شحن تم ضبطها على التوصيل خلال n يوم داخل المتجر. على سبيل المثال، إذا كانت خدمة الشحن تحدّد التوصيل في اليوم نفسه، وبعد انقضاء الموعد النهائي، يؤدي ضبط هذا الحقل على 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، وهي مطلوبة لتغييرات مصدر البيانات حتى إذا كان برنامج الولاء يتضمّن مستوى واحدًا فقط.

مستودع

مستودع للتوصيل، يخزّن المخزون ويعالجه

تمثيل 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

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

الطُرق

getShippingSettings

 استرداد معلومات إعدادات الشحن

insert

 استبدِل إعدادات الشحن للتاجر بإعدادات الشحن المطلوبة.