REST Resource: accounts.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

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

  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)
  }
}
فیلدها
delivery Countries[]

string

مورد نیاز. کد قلمرو CLDR کشورهایی که این سرویس به آنها اعمال می شود.

rate Groups[]

object ( RateGroup )

اختیاری. تعاریف گروه نرخ حمل و نقل فقط آخرین مورد مجاز است که یک applicableShippingLabels خالی داشته باشد که به معنی "همه چیز دیگر" است. سایر برچسب applicableShippingLabels نباید همپوشانی داشته باشند.

loyalty Programs[]

object ( LoyaltyProgram )

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

service Name

string

مورد نیاز. نام رایگان سرویس. باید در حساب هدف منحصر به فرد باشد.

active

boolean

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

currency Code

string

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

delivery Time

object ( DeliveryTime )

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

shipment Type

enum ( ShipmentType )

نوع مکان هایی که این سرویس سفارشات را به آنها ارسال می کند.

minimum Order Value

object ( Price )

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

minimum Order Value Table

object ( MinimumOrderValueTable )

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

store Config

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)
  }
}
فیلدها
warehouse Based Delivery Times[]

object ( WarehouseBasedDeliveryTime )

اختیاری. نشان می دهد که زمان تحویل باید به ازای هر انبار (محل مبدا حمل و نقل) بر اساس تنظیمات حامل انتخاب شده محاسبه شود. وقتی تنظیم شد، هیچ فیلد مربوط به زمان حمل و نقل دیگری در [زمان تحویل][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] نباید تنظیم شود.

min Transit Days

integer

حداقل تعداد روزهای کاری که در حمل و نقل سپری می شود. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است. یا minTransitDays ، maxTransitDays یا transitTimeTable باید تنظیم شوند، اما نه هر دو.

max Transit Days

integer

حداکثر تعداد روزهای کاری که در حمل و نقل سپری می شود. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است. باید بزرگتر یا مساوی minTransitDays باشد.

cutoff Time

object ( CutoffTime )

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

min Handling Days

integer

حداقل تعداد روزهای کاری که قبل از ارسال سفارش صرف شده است. 0 به معنای ارسال در همان روز، 1 به معنای ارسال روز بعد است. 'minHandlingDays' و 'maxHandlingDays' باید همزمان تنظیم شوند یا تنظیم نشوند.

max Handling Days

integer

حداکثر تعداد روزهای کاری که قبل از ارسال سفارش صرف شده است. 0 به معنای ارسال در همان روز، 1 به معنای ارسال روز بعد است. باید بزرگتر یا مساوی minHandlingDays باشد. 'minHandlingDays' و 'maxHandlingDays' باید همزمان تنظیم شوند یا تنظیم نشوند.

transit Time Table

object ( TransitTable )

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان minTransitDays ، maxTransitDays یا transitTimeTable را تنظیم کرد، اما نه هر دو.

handling Business Day Config

object ( BusinessDayConfig )

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

transit Business Day Config

object ( BusinessDayConfig )

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

Cutoff Time

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

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

integer

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

minute

integer

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

time Zone

string

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

جدول ترانزیت

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان minTransitDays ، maxTransitDays یا transitTimeTable را تنظیم کرد، اما نه هر دو.

نمایندگی JSON 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
فیلدها
postal Code Group Names[]

string

مورد نیاز. فهرستی از نام‌های منطقه Region.name . آخرین مقدار می تواند "all other locations" باشد. مثال: ["zone 1", "zone 2", "all other locations"] . گروه های کد پستی ارجاع شده باید با کشور تحویل سرویس مطابقت داشته باشند.

transit Time Labels[]

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
}
فیلدها
min Transit Days

integer

حداقل محدوده زمانی حمل و نقل در روزهای کاری. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است.

max Transit Days

integer

باید بزرگتر یا مساوی minTransitDays باشد.

BusinessDayConfig

روزهای کاری انبار.

نمایندگی JSON 
{
  "businessDays": [
    enum (Weekday)
  ]
}
فیلدها
business Days[]

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" . حامل های پشتیبانی شده

carrier Service

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
}
فیلدها
applicable Shipping Labels[]

string

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

subtables[]

object ( Table )

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

carrier Rates[]

object ( CarrierRate )

اختیاری. فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با mainTable یا singleValue به آنها اشاره کرد.

single Value

object ( Value )

ارزش گروه نرخ (به عنوان مثال نرخ ثابت 10 دلار). فقط در صورتی می توان تنظیم کرد که mainTable و subtables تنظیم نشده باشند.

main Table

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
}
فیلدها
no Shipping

boolean

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

flat Rate

object ( Price )

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

price Percentage

string

درصدی از قیمت که به عنوان یک عدد در نماد اعشاری نشان داده می شود (به عنوان مثال، "5.4" ). فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

carrier Rate

string

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

subtable

string

نام یک جدول فرعی فقط در سلول های جدول تنظیم می شود (به عنوان مثال، نه برای مقادیر منفرد)، و فقط در صورتی که همه فیلدهای دیگر تنظیم نشده باشند.

جدول

جدولی که گروه نرخ را تعریف می کند، زمانی که singleValue به اندازه کافی رسا نیست.

نمایندگی JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
فیلدها
rows[]

object ( Row )

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

name

string

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

row Headers

object ( Headers )

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

column Headers

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. فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

number Of Items[]

string

مورد نیاز. فهرستی از شامل تعداد موارد کرانهای بالایی. آخرین مقدار می تواند "infinity" باشد. برای مثال ["10", "50", "infinity"] نشان‌دهنده سرصفحه‌های "<= 10 آیتم"، "<= 50 آیتم" و "> 50 آیتم" است. باید خالی نباشد فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

postal Code Group Names[]

string

مورد نیاز. لیستی از نام گروه های پستی آخرین مقدار می تواند "all other locations" باشد. مثال: ["zone 1", "zone 2", "all other locations"] . گروه های کد پستی ارجاع شده باید با کشور تحویل سرویس مطابقت داشته باشند. باید خالی نباشد فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

locations[]

object ( LocationIdSet )

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

وزن

وزن به عنوان مقدار در رشته و واحد نمایش داده می شود.

نمایندگی JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
فیلدها
unit

enum ( WeightUnit )

مورد نیاز. واحد وزن مقادیر قابل قبول عبارتند از: کیلوگرم و پوند

amount Micros

string ( int64 format)

مورد نیاز. وزن نشان داده شده به عنوان یک عدد در میکرو (1 میلیون میکرومتر معادل واحد استاندارد واحد پول است، به عنوان مثال، 1 کیلوگرم = 1000000 میکرو). این فیلد را می توان با تنظیم -1 نیز به عنوان بی نهایت تنظیم کرد. این فیلد فقط از -1 و مقدار مثبت پشتیبانی می کند.

واحد وزن

واحد وزن

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

LocationIdSet

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

نمایندگی JSON 
{
  "locationIds": [
    string
  ]
}
فیلدها
location Ids[]

string

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

ردیف

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

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

object ( Value )

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

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با mainTable یا singleValue به آنها اشاره کرد. خدمات شرکت مخابراتی پشتیبانی شده در https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-rate-typere% تعریف شده است. UK-and-us-only .

نمایندگی JSON 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
فیلدها
name

string

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

carrier

string

مورد نیاز. خدمات حامل، مانند "UPS" یا "Fedex" .

carrier Service

string

مورد نیاز. خدمات حامل، مانند "ground" یا "2 days" .

origin Postal Code

string

مورد نیاز. مبدا حمل و نقل برای این نرخ حامل.

percentage Adjustment

string

اختیاری. اصلاح کننده ضربی نرخ حمل و نقل به عنوان یک عدد در نماد اعشاری. می تواند منفی باشد. به عنوان مثال "5.4" نرخ را 5.4٪ افزایش می دهد، "-3" نرخ را 3٪ کاهش می دهد.

flat Adjustment

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)
    }
  ]
}
فیلدها
store Code Set With Movs[]

object ( StoreCodeSetWithMov )

مورد نیاز. فهرستی از مجموعه کدهای فروشگاه که دارای حداقل مقدار سفارش (MOV) هستند. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد که به معنای "MOV برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در همه مجموعه ها ظاهر شود. همه قیمت‌های یک سرویس باید واحد پولی باشند.

StoreCodeSetWithMov

فهرستی از مجموعه کدهای فروشگاه که حداقل مقدار سفارش را به اشتراک می‌گذارند. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد که به معنای "MOV برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در همه مجموعه ها ظاهر شود. همه قیمت‌های یک سرویس باید واحد پولی باشند.

نمایندگی JSON 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
فیلدها
store Codes[]

string

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

value

object ( Price )

حداقل ارزش سفارش برای فروشگاه های داده شده.

StoreConfig

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

نمایندگی JSON 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
فیلدها
store Codes[]

string

اختیاری. فهرستی از کدهای فروشگاهی که تحویل محلی را ارائه می دهند. اگر خالی باشد، باید all_stores درست باشد.

store Service Type

enum ( StoreServiceType )

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

cutoff Config

object ( CutoffConfig )

تنظیمات مربوط به تحویل محلی برای آن روز به پایان می رسد.

service Radius

object ( Distance )

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

StoreServiceType

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

Enums
STORE_SERVICE_TYPE_UNSPECIFIED نوع خدمات فروشگاه را مشخص نکرده است.
ALL_STORES نشان می‌دهد که آیا همه فروشگاه‌ها، فعلی و آینده، فهرست‌شده توسط این تاجر، تحویل محلی ارائه می‌دهند یا خیر.
SELECTED_STORES نشان می دهد که فقط فروشگاه های فهرست شده در storeCodes واجد شرایط تحویل محلی هستند.

CutoffConfig

تنظیمات مربوط به تحویل محلی برای آن روز به پایان می رسد.

نمایندگی JSON 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
فیلدها
local Cutoff Time

object ( LocalCutoffTime )

زمانی که تحویل محلی در آن روز به پایان می رسد.

store Close Offset Hours

string ( int64 format)

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

no Delivery Post Cutoff

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
}
فیلدها
loyalty Program Tiers[]

object ( LoyaltyProgramTiers )

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

program Label

string

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

LoyaltyProgramTiers

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

نمایندگی JSON 
{
  "tierLabel": string
}
فیلدها
tier Label

string

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

انبار

یک انبار تکمیل، که موجودی را ذخیره و رسیدگی می کند.

نمایندگی JSON 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
فیلدها
name

string

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

shipping Address

object ( Address )

مورد نیاز. آدرس حمل و نقل انبار.

cutoff Time

object ( WarehouseCutoffTime )

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

handling Days

string ( int64 format)

مورد نیاز. تعداد روزهایی که طول می کشد تا این انبار یک کالا را بسته بندی و ارسال کند. این در سطح انبار است، اما می‌تواند بر اساس ویژگی‌های یک کالا در سطح پیشنهاد لغو شود.

business Day Config

object ( BusinessDayConfig )

روزهای کاری انبار. اگر تنظیم نشود، به طور پیش فرض از دوشنبه تا جمعه خواهد بود.

آدرس

آدرس حمل و نقل انبار.

نمایندگی JSON 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
فیلدها
street Address

string

بخشی از آدرس در سطح خیابان. به عنوان مثال: 111w 31st Street .

city

string

مورد نیاز. شهر، شهر یا کمون. همچنین ممکن است شامل محلات یا مناطق فرعی وابسته (به عنوان مثال محله ها یا حومه) باشد.

administrative Area

string

مورد نیاز. زیرمجموعه اداری عالی کشور. به عنوان مثال، ایالتی مانند کالیفرنیا ("CA") یا استانی مانند کبک ("QC").

postal Code

string

مورد نیاز. کد پستی یا پستی (به عنوان مثال "94043").

region Code

string

مورد نیاز. کد کشور CLDR (به عنوان مثال "US").

WarehouseCutoffTime

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

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

integer

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

minute

integer

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

روش ها

get Shipping Settings

 بازیابی اطلاعات تنظیمات حمل و نقل

insert

 تنظیمات حمل و نقل یک تاجر را با تنظیم ارسال درخواست جایگزین کنید.
،

منبع: تنظیمات حمل و نقل

تنظیمات حمل و نقل حساب تاجر .

نمایندگی 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)
  }
}
فیلدها
delivery Countries[]

string

مورد نیاز. کد قلمرو CLDR کشورهایی که این سرویس به آنها اعمال می شود.

rate Groups[]

object ( RateGroup )

اختیاری. تعاریف گروه نرخ حمل و نقل فقط آخرین مورد مجاز است که یک applicableShippingLabels خالی داشته باشد که به معنی "همه چیز دیگر" است. سایر برچسب applicableShippingLabels نباید همپوشانی داشته باشند.

loyalty Programs[]

object ( LoyaltyProgram )

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

service Name

string

مورد نیاز. نام رایگان سرویس. باید در حساب هدف منحصر به فرد باشد.

active

boolean

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

currency Code

string

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

delivery Time

object ( DeliveryTime )

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

shipment Type

enum ( ShipmentType )

نوع مکان هایی که این سرویس سفارشات را به آنها ارسال می کند.

minimum Order Value

object ( Price )

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

minimum Order Value Table

object ( MinimumOrderValueTable )

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

store Config

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)
  }
}
فیلدها
warehouse Based Delivery Times[]

object ( WarehouseBasedDeliveryTime )

اختیاری. نشان می دهد که زمان تحویل باید به ازای هر انبار (محل مبدا حمل و نقل) بر اساس تنظیمات حامل انتخاب شده محاسبه شود. وقتی تنظیم شد، هیچ فیلد مربوط به زمان حمل و نقل دیگری در [زمان تحویل][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] نباید تنظیم شود.

min Transit Days

integer

حداقل تعداد روزهای کاری که در حمل و نقل سپری می شود. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است. یا minTransitDays ، maxTransitDays یا transitTimeTable باید تنظیم شوند، اما نه هر دو.

max Transit Days

integer

حداکثر تعداد روزهای کاری که در حمل و نقل سپری می شود. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است. باید بزرگتر یا مساوی minTransitDays باشد.

cutoff Time

object ( CutoffTime )

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

min Handling Days

integer

حداقل تعداد روزهای کاری که قبل از ارسال سفارش صرف شده است. 0 به معنای ارسال در همان روز، 1 به معنای ارسال روز بعد است. 'minHandlingDays' و 'maxHandlingDays' باید همزمان تنظیم شوند یا تنظیم نشوند.

max Handling Days

integer

حداکثر تعداد روزهای کاری که قبل از ارسال سفارش صرف شده است. 0 به معنای ارسال در همان روز، 1 به معنای ارسال روز بعد است. باید بزرگتر یا مساوی minHandlingDays باشد. 'minHandlingDays' و 'maxHandlingDays' باید همزمان تنظیم شوند یا تنظیم نشوند.

transit Time Table

object ( TransitTable )

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان minTransitDays ، maxTransitDays یا transitTimeTable را تنظیم کرد، اما نه هر دو.

handling Business Day Config

object ( BusinessDayConfig )

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

transit Business Day Config

object ( BusinessDayConfig )

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

Cutoff Time

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

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

integer

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

minute

integer

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

time Zone

string

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

جدول ترانزیت

جدول زمانی ترانزیت، تعداد روزهای کاری که در ترانزیت صرف شده بر اساس ابعاد سطر و ستون. می‌توان minTransitDays ، maxTransitDays یا transitTimeTable را تنظیم کرد، اما نه هر دو.

نمایندگی JSON 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
فیلدها
postal Code Group Names[]

string

مورد نیاز. فهرستی از نام‌های منطقه Region.name . آخرین مقدار می تواند "all other locations" باشد. مثال: ["zone 1", "zone 2", "all other locations"] . گروه های کد پستی ارجاع شده باید با کشور تحویل سرویس مطابقت داشته باشند.

transit Time Labels[]

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
}
فیلدها
min Transit Days

integer

حداقل محدوده زمانی حمل و نقل در روزهای کاری. 0 به معنای تحویل همان روز، 1 به معنای تحویل روز بعد است.

max Transit Days

integer

باید بزرگتر یا مساوی minTransitDays باشد.

BusinessDayConfig

روزهای کاری انبار.

نمایندگی JSON 
{
  "businessDays": [
    enum (Weekday)
  ]
}
فیلدها
business Days[]

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" . حامل های پشتیبانی شده

carrier Service

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
}
فیلدها
applicable Shipping Labels[]

string

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

subtables[]

object ( Table )

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

carrier Rates[]

object ( CarrierRate )

اختیاری. فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با mainTable یا singleValue به آنها اشاره کرد.

single Value

object ( Value )

ارزش گروه نرخ (به عنوان مثال نرخ ثابت 10 دلار). فقط در صورتی می توان تنظیم کرد که mainTable و subtables تنظیم نشده باشند.

main Table

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
}
فیلدها
no Shipping

boolean

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

flat Rate

object ( Price )

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

price Percentage

string

درصدی از قیمت که به عنوان یک عدد در نماد اعشاری نشان داده می شود (به عنوان مثال، "5.4" ). فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

carrier Rate

string

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

subtable

string

نام یک جدول فرعی فقط در سلول های جدول تنظیم می شود (به عنوان مثال، نه برای مقادیر منفرد)، و فقط در صورتی که همه فیلدهای دیگر تنظیم نشده باشند.

جدول

جدولی که گروه نرخ را تعریف می کند، زمانی که singleValue به اندازه کافی رسا نیست.

نمایندگی JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
فیلدها
rows[]

object ( Row )

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

name

string

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

row Headers

object ( Headers )

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

column Headers

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. فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

number Of Items[]

string

مورد نیاز. فهرستی از شامل تعداد موارد کرانهای بالایی. آخرین مقدار می تواند "infinity" باشد. برای مثال ["10", "50", "infinity"] نشان‌دهنده سرصفحه‌های "<= 10 آیتم"، "<= 50 آیتم" و "> 50 آیتم" است. باید خالی نباشد فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

postal Code Group Names[]

string

مورد نیاز. لیستی از نام گروه های پستی آخرین مقدار می تواند "all other locations" باشد. مثال: ["zone 1", "zone 2", "all other locations"] . گروه های کد پستی ارجاع شده باید با کشور تحویل سرویس مطابقت داشته باشند. باید خالی نباشد فقط در صورتی می توان آن را تنظیم کرد که همه فیلدهای دیگر تنظیم نشده باشند.

locations[]

object ( LocationIdSet )

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

وزن

وزن به عنوان مقدار در رشته و واحد نمایش داده می شود.

نمایندگی JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
فیلدها
unit

enum ( WeightUnit )

مورد نیاز. واحد وزن مقادیر قابل قبول عبارتند از: کیلوگرم و پوند

amount Micros

string ( int64 format)

مورد نیاز. وزن نشان داده شده به عنوان یک عدد در میکرو (1 میلیون میکرومتر معادل واحد استاندارد واحد پول است، به عنوان مثال، 1 کیلوگرم = 1000000 میکرو). این فیلد را می توان با تنظیم -1 نیز به عنوان بی نهایت تنظیم کرد. این فیلد فقط از -1 و مقدار مثبت پشتیبانی می کند.

واحد وزن

واحد وزن

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

LocationIdSet

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

نمایندگی JSON 
{
  "locationIds": [
    string
  ]
}
فیلدها
location Ids[]

string

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

ردیف

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

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

object ( Value )

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

نرخ حامل

فهرستی از نرخ‌های شرکت مخابراتی که می‌توان با mainTable یا singleValue به آنها اشاره کرد. خدمات شرکت مخابراتی پشتیبانی شده در https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-rate-typere% تعریف شده است. UK-and-us-only .

نمایندگی JSON 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
فیلدها
name

string

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

carrier

string

مورد نیاز. خدمات حامل، مانند "UPS" یا "Fedex" .

carrier Service

string

مورد نیاز. خدمات حامل، مانند "ground" یا "2 days" .

origin Postal Code

string

مورد نیاز. مبدا حمل و نقل برای این نرخ حامل.

percentage Adjustment

string

اختیاری. اصلاح کننده ضربی نرخ حمل و نقل به عنوان یک عدد در نماد اعشاری. می تواند منفی باشد. به عنوان مثال "5.4" نرخ را 5.4٪ افزایش می دهد، "-3" نرخ را 3٪ کاهش می دهد.

flat Adjustment

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)
    }
  ]
}
فیلدها
store Code Set With Movs[]

object ( StoreCodeSetWithMov )

مورد نیاز. فهرستی از مجموعه کدهای فروشگاه که دارای حداقل مقدار سفارش (MOV) هستند. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد که به معنای "MOV برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در همه مجموعه ها ظاهر شود. همه قیمت‌های یک سرویس باید واحد پولی باشند.

StoreCodeSetWithMov

فهرستی از مجموعه کدهای فروشگاه که حداقل مقدار سفارش را به اشتراک می‌گذارند. حداقل دو مجموعه مورد نیاز است و آخرین مورد باید خالی باشد که به معنای "MOV برای همه فروشگاه های دیگر" است. هر کد فروشگاه فقط می تواند یک بار در همه مجموعه ها ظاهر شود. همه قیمت‌های یک سرویس باید واحد پولی باشند.

نمایندگی JSON 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
فیلدها
store Codes[]

string

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

value

object ( Price )

حداقل ارزش سفارش برای فروشگاه های داده شده.

StoreConfig

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

نمایندگی JSON 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
فیلدها
store Codes[]

string

اختیاری. فهرستی از کدهای فروشگاهی که تحویل محلی را ارائه می دهند. اگر خالی باشد، باید all_stores درست باشد.

store Service Type

enum ( StoreServiceType )

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

cutoff Config

object ( CutoffConfig )

تنظیمات مربوط به تحویل محلی برای آن روز به پایان می رسد.

service Radius

object ( Distance )

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

StoreServiceType

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

Enums
STORE_SERVICE_TYPE_UNSPECIFIED نوع خدمات فروشگاه را مشخص نکرده است.
ALL_STORES نشان می‌دهد که آیا همه فروشگاه‌ها، فعلی و آینده، فهرست‌شده توسط این تاجر، تحویل محلی ارائه می‌دهند یا خیر.
SELECTED_STORES نشان می دهد که فقط فروشگاه های فهرست شده در storeCodes واجد شرایط تحویل محلی هستند.

CutoffConfig

تنظیمات مربوط به تحویل محلی برای آن روز به پایان می رسد.

نمایندگی JSON 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
فیلدها
local Cutoff Time

object ( LocalCutoffTime )

زمانی که تحویل محلی در آن روز به پایان می رسد.

store Close Offset Hours

string ( int64 format)

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

no Delivery Post Cutoff

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
}
فیلدها
loyalty Program Tiers[]

object ( LoyaltyProgramTiers )

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

program Label

string

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

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

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

نمایندگی JSON 
{
  "tierLabel": string
}
فیلدها
tier Label

string

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

انبار

یک انبار تحقق ، که موجودی را ذخیره و کنترل می کند.

نمایندگی JSON 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
فیلدها
name

string

مورد نیاز. نام انبار. باید در حساب بی نظیر باشد.

shipping Address

object ( Address )

مورد نیاز. آدرس حمل و نقل انبار.

cutoff Time

object ( WarehouseCutoffTime )

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

handling Days

string ( int64 format)

مورد نیاز. تعداد روزهای لازم برای بسته بندی و ارسال کالای این انبار. این در سطح انبار است ، اما بر اساس ویژگی های یک مورد می تواند در سطح پیشنهاد نادیده گرفته شود.

business Day Config

object ( BusinessDayConfig )

روزهای کاری انبار. اگر تنظیم نشده باشد ، به طور پیش فرض دوشنبه تا جمعه خواهد بود.

آدرس

آدرس حمل و نقل انبار.

نمایندگی JSON 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
فیلدها
street Address

string

قسمت سطح خیابان آدرس. به عنوان مثال: 111w 31st Street .

city

string

مورد نیاز. شهر ، شهر یا کمون. همچنین ممکن است شامل مناطق وابسته یا سلامت (به عنوان مثال محلات یا حومه) باشد.

administrative Area

string

مورد نیاز. تقسیم اداری سطح بالا کشور. به عنوان مثال ، ایالتی مانند کالیفرنیا ("CA") یا استانی مانند کبک ("QC").

postal Code

string

مورد نیاز. کد پستی یا زیپ (به عنوان مثال "94043").

region Code

string

مورد نیاز. کد کشور CLDR (به عنوان مثال "ما").

انبار

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

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

integer

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

minute

integer

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

روش ها

get Shipping Settings

 بازیابی اطلاعات تنظیم حمل و نقل.

insert

 تنظیم حمل و نقل یک بازرگان را با تنظیمات حمل و نقل درخواست کنید.