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. پس از ایجاد اولیه، روش دریافت تماس را برای به دست آوردن برچسب و داده های تنظیم حمل و نقل فعلی قبل از درج تماس دریافت کنید.

  3. به اطلاعات تنظیمات حمل و نقل مورد نظر تغییر دهید.

  4. روش درج تماس با اطلاعات تنظیم حمل و نقل مورد نظر با برچسب به دست آمده از مرحله 2.

  5. اگر داده های تنظیم حمل و نقل بین مرحله 2 و مرحله 4 تغییر کرد. درخواست درج ناموفق خواهد بود زیرا هر بار که داده های تنظیم حمل و نقل تغییر می کند، برچسب تغییر می کند. کاربر باید مرحله 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 )

حداقل ارزش سفارش برای این سرویس. اگر تنظیم شود، نشان می دهد که مشتریان باید حداقل این مبلغ را خرج کنند. همه قیمت‌های یک سرویس باید واحد پولی باشند. نمی توان با minimalOrderValueTable با هم تنظیم کرد.

minimumOrderValueTable

object ( MinimumOrderValueTable )

جدول مقادیر حداقل سفارش در هر فروشگاه برای نوع انجام تحویل. با minimalOrderValue نمی توان با هم تنظیم کرد.

storeConfig

object ( StoreConfig )

لیستی از فروشگاه هایی که محصولات شما از آنها تحویل داده می شود. این فقط برای نوع حمل و نقل محلی معتبر است.

زمان تحویل

زمان صرف شده در جنبه های مختلف از سفارش تا تحویل محصول.

نمایندگی 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 )

روزهای کاری که طی آن سفارش‌ها می‌توانند در حال انتقال باشند. در صورت عدم ارائه، روزهای کاری دوشنبه تا جمعه در نظر گرفته می شود.

زمان قطع

تعریف زمان قطع روزهای کاری

نمایندگی JSON
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
زمینه های
hour

integer

ضروری. ساعتی از زمان قطعی که تا آن زمان باید سفارش داده شود تا در همان روز پردازش شود.

minute

integer

ضروری. دقیقه از زمان قطعی که تا آن زمان باید سفارش داده شود تا در همان روز پردازش شود.

timeZone

string

ضروری. شناسه منطقه زمانی به عنوان مثال "اروپا/زوریخ".

جدول ترانزیت

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان 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 )

ضروری. روزهای کاری منظم ممکنه خالی نباشه

روز هفته

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBased DeliveryTime

نشان می دهد که زمان تحویل باید به ازای هر انبار (محل مبدا حمل و نقل) بر اساس تنظیمات حامل انتخاب شده محاسبه شود. در صورت تنظیم، هیچ فیلد مربوط به زمان حمل و نقل دیگری در 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

اگر درست باشد، محصول قابل ارسال نیست. هنگام تنظیم باید درست باشد، فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

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 )

ضروری. فهرستی از کران های بالای وزن سفارش فراگیر. مقدار آخرین وزن با تنظیم مقدار قیمتMicros = -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 میلیون میکرومتر معادل واحد استاندارد واحد پول است، به عنوان مثال، 1 کیلوگرم = 1000000 میکرو). این فیلد را می توان با تنظیم -1 نیز به عنوان بی نهایت تنظیم کرد. این فیلد فقط از -1 و مقدار مثبت پشتیبانی می کند.

واحد وزن

واحد وزن.

Enums
WEIGHT_UNIT_UNSPECIFIED واحد نامشخص
POUND واحد پوند
KILOGRAM واحد کیلوگرم

LocationIdSet

فهرستی از مجموعه‌های شناسه مکان. باید خالی نباشد تنها در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

نمایندگی JSON
{
  "locationIds": [
    string
  ]
}
زمینه های
locationIds[]

string

ضروری. فهرست غیرخالی شناسه‌های مکان . همه آنها باید از یک نوع مکان باشند (به عنوان مثال، حالت).

ردیف

فهرستی از سلول ها را بگنجانید.

نمایندگی JSON
{
  "cells": [
    {
      object (Value)
    }
  ]
}
زمینه های
cells[]

object ( Value )

ضروری. لیست سلول هایی که ردیف را تشکیل می دهند. باید طولی برابر با columnHeaders برای جداول دو بعدی و طول 1 برای جداول یک بعدی داشته باشد.

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با 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" } $1 به نرخ اضافه می کند، { "amountMicros": -3, "currencyCode" : "USD" } $3 را از نرخ حذف می کند.

نوع حمل و نقل

نوع حمل و نقل خدمات حمل و نقل.

Enums
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

نشان می‌دهد که آیا همه فروشگاه‌ها یا فروشگاه‌های انتخابی فهرست‌شده توسط تاجر، تحویل محلی را ارائه می‌دهند یا خیر.

Enums
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 )

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

واحد

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

Enums
UNIT_UNSPECIFIED واحد نامشخص
MILES واحد بر حسب مایل
KILOMETERS واحد بر حسب کیلومتر

برنامه وفاداری

برنامه وفاداری ارائه شده توسط یک تاجر.

نمایندگی JSON
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
زمینه های
loyaltyProgramTiers[]

object ( LoyaltyProgramTiers )

اختیاری. ردیف برنامه وفاداری این سرویس حمل و نقل.

programLabel

string

این برچسب برنامه وفاداری است که در تنظیمات برنامه وفاداری شما در Merchant Center تنظیم شده است. این ویژگی فرعی به Google اجازه می دهد تا برنامه وفاداری شما را با پیشنهادات واجد شرایط نقشه برداری کند.

LoyaltyProgramTiers

زیرمجموعه برنامه وفاداری بازرگانان.

نمایندگی JSON
{
  "tierLabel": string
}
زمینه های
tierLabel

string

برچسب ردیف [tierLabel] ویژگی های فرعی را متمایز می کند، مزایای سطحی را بین هر ردیف ارائه می دهد. این مقدار همچنین در تنظیمات برنامه شما در Merchant Center تنظیم شده است و برای تغییرات منبع داده لازم است حتی اگر برنامه وفاداری شما فقط 1 ردیف داشته باشد.

انبار

یک انبار تکمیل، که موجودی را ذخیره و رسیدگی می کند. برچسب بعدی: 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

ضروری. دقیقه از زمان قطعی که تا آن زمان باید سفارش داده شود تا در همان روز توسط انبار پردازش شود. دقیقه بر اساس منطقه زمانی انبار است.

،

[تنظیم حمل و نقل] حساب تاجر (( 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. پس از ایجاد اولیه، روش دریافت تماس را برای به دست آوردن برچسب و داده های تنظیم حمل و نقل فعلی قبل از درج تماس دریافت کنید.

  3. به اطلاعات تنظیمات حمل و نقل مورد نظر تغییر دهید.

  4. روش درج تماس با اطلاعات تنظیم حمل و نقل مورد نظر با برچسب به دست آمده از مرحله 2.

  5. اگر داده های تنظیم حمل و نقل بین مرحله 2 و مرحله 4 تغییر کرد. درخواست درج ناموفق خواهد بود زیرا هر بار که داده های تنظیم حمل و نقل تغییر می کند، برچسب تغییر می کند. کاربر باید مرحله 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 )

حداقل ارزش سفارش برای این سرویس. اگر تنظیم شود، نشان می دهد که مشتریان باید حداقل این مبلغ را خرج کنند. همه قیمت‌ها در یک سرویس باید واحد پولی باشند. نمی توان با minimalOrderValueTable با هم تنظیم کرد.

minimumOrderValueTable

object ( MinimumOrderValueTable )

جدول مقادیر حداقل سفارش در هر فروشگاه برای نوع انجام تحویل. با minimalOrderValue نمی توان با هم تنظیم کرد.

storeConfig

object ( StoreConfig )

لیستی از فروشگاه هایی که محصولات شما از آنها تحویل داده می شود. این فقط برای نوع حمل و نقل محلی معتبر است.

زمان تحویل

زمان صرف شده در جنبه های مختلف از سفارش تا تحویل محصول.

نمایندگی 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 )

روزهای کاری که طی آن سفارش‌ها می‌توانند در حال انتقال باشند. در صورت عدم ارائه، روزهای کاری دوشنبه تا جمعه در نظر گرفته می شود.

زمان قطع

تعریف زمان قطع روزهای کاری

نمایندگی JSON
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
زمینه های
hour

integer

ضروری. ساعتی از زمان قطعی که تا آن زمان باید سفارش داده شود تا در همان روز پردازش شود.

minute

integer

ضروری. دقیقه از زمان قطعی که تا آن زمان باید سفارش داده شود تا در همان روز پردازش شود.

timeZone

string

ضروری. شناسه منطقه زمانی به عنوان مثال "اروپا/زوریخ".

جدول ترانزیت

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان 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 )

ضروری. روزهای کاری منظم ممکنه خالی نباشه

روز هفته

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBased DeliveryTime

نشان می دهد که زمان تحویل باید به ازای هر انبار (محل مبدا حمل و نقل) بر اساس تنظیمات حامل انتخاب شده محاسبه شود. در صورت تنظیم، هیچ فیلد مربوط به زمان حمل و نقل دیگری در 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

اگر درست باشد، محصول قابل ارسال نیست. هنگام تنظیم باید درست باشد، فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

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 )

ضروری. فهرستی از کرانهای بالای وزن سفارش. مقدار آخرین وزن با تنظیم مقدار قیمتMicros = -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 میلیون میکرومتر معادل واحد استاندارد واحد پول است، به عنوان مثال، 1 کیلوگرم = 1000000 میکرو). این فیلد را می توان با تنظیم -1 نیز به عنوان بی نهایت تنظیم کرد. این فیلد فقط از -1 و مقدار مثبت پشتیبانی می کند.

واحد وزن

واحد وزن.

Enums
WEIGHT_UNIT_UNSPECIFIED واحد نامشخص
POUND واحد پوند
KILOGRAM واحد کیلوگرم

LocationIdSet

فهرستی از مجموعه‌های شناسه مکان. باید خالی نباشد تنها در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

نمایندگی JSON
{
  "locationIds": [
    string
  ]
}
زمینه های
locationIds[]

string

ضروری. فهرست غیرخالی شناسه‌های مکان . همه آنها باید از یک نوع مکان باشند (به عنوان مثال، حالت).

ردیف

فهرستی از سلول ها را بگنجانید.

نمایندگی JSON
{
  "cells": [
    {
      object (Value)
    }
  ]
}
زمینه های
cells[]

object ( Value )

ضروری. لیست سلول هایی که ردیف را تشکیل می دهند. باید طولی برابر با columnHeaders برای جداول دو بعدی و طول 1 برای جداول یک بعدی داشته باشد.

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با 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" } $1 به نرخ اضافه می کند، { "amountMicros": -3, "currencyCode" : "USD" } $3 را از نرخ حذف می کند.

نوع حمل و نقل

نوع حمل و نقل خدمات حمل و نقل.

Enums
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

نشان می‌دهد که آیا همه فروشگاه‌ها یا فروشگاه‌های انتخابی فهرست‌شده توسط تاجر، تحویل محلی را ارائه می‌دهند یا خیر.

Enums
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 )

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

واحد

واحد می تواند بر اساس کشور متفاوت باشد، پارامتری است که شامل مایل ها و کیلومترها می شود.

Enums
UNIT_UNSPECIFIED واحد نامشخص
MILES واحد بر حسب مایل
KILOMETERS واحد بر حسب کیلومتر

برنامه وفاداری

برنامه وفاداری ارائه شده توسط یک تاجر.

نمایندگی JSON
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
زمینه های
loyaltyProgramTiers[]

object ( LoyaltyProgramTiers )

اختیاری. ردیف برنامه وفاداری این سرویس حمل و نقل.

programLabel

string

این برچسب برنامه وفاداری است که در تنظیمات برنامه وفاداری شما در Merchant Center تنظیم شده است. این زیرمجموعه به Google اجازه می دهد تا برنامه وفاداری شما را به پیشنهادات واجد شرایط نقشه برداری کند.

برنامه نویسان

زیر مجموعه برنامه وفاداری بازرگانان.

نمایندگی JSON
{
  "tierLabel": string
}
زمینه های
tierLabel

string

متمایز بودن برچسب Tier [tierlabel] زیر ATTRIBUTE مزایای سطح بین هر ردیف را ارائه می دهد. این مقدار همچنین در تنظیمات برنامه شما در مرکز بازرگان تنظیم شده است و حتی اگر برنامه وفاداری شما فقط 1 ردیف داشته باشد ، برای تغییر منبع داده لازم است.

انبار

یک انبار تحقق ، که موجودی را ذخیره و کنترل می کند. برچسب بعدی: 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 (به عنوان مثال "ما").

انبار

آخرین زمان روز که می توان یک سفارش را پذیرفت و پردازش را آغاز کرد. سفارشات بعدی در روز بعد پردازش می شوند. زمان بر اساس کد پستی انبار است.

نمایندگی JSON
{
  "hour": integer,
  "minute": integer
}
زمینه های
hour

integer

ضروری. ساعت زمان قطع که تا زمانی که باید سفارش را در همان روز توسط انبار پردازش کند. ساعت بر اساس منطقه زمانی انبار است.

minute

integer

ضروری. دقیقه از زمان قطع ، تا زمانی که باید سفارش را در همان روز توسط انبار پردازش کرد. دقیقه بر اساس منطقه زمانی انبار است.