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. צריך להגדיר את שדה ה-ETag כמחרוזת ריקה ליצירה ראשונית של הגדרת משלוח.

  2. אחרי היצירה הראשונית, צריך להפעיל את שיטת get get כדי לקבל את ה-etag ואת הנתונים של הגדרות המשלוח הנוכחיות לפני הוספת השיחה.

  3. משנים את המידע על הגדרות המשלוח הרצויות.

  4. שיטת ההוספה של קריאה עם פרטי הגדרת המשלוח הרצויים עם ה-ETag שהתקבל משלב 2.

  5. אם נתוני הגדרות המשלוח השתנו בין שלב 2 לשלב 4. בקשת ההוספה תיכשל כי ה-ETag משתנה בכל פעם שהנתונים של הגדרות המשלוח משתנים. המשתמש צריך לחזור על שלב 2-4 עם ה-ETag החדש.

שירות

שירות משלוחים.

ייצוג JSON 
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
שדות
deliveryCountries[]

string

חובה. קוד הטריטוריה של מאגר ה-CLDR של המדינות שבהן השירות חל.
rateGroups[]

object (RateGroup)

זה שינוי אופציונלי. הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל applicableShippingLabels ריק, כלומר 'כל השאר'. הערכים מסוג 'applicableShippingLabels' האחרים לא יכולים לחפוף.
loyaltyPrograms[]

object (LoyaltyProgram)

זה שינוי אופציונלי. מועדוני לקוחות ששירות המשלוחים הזה מוגבל אליהם.
serviceName

string

חובה. שם השירות שמופיע בניסוח חופשי. חייב להיות ייחודי בחשבון היעד.
active

boolean

חובה. ערך בוליאני שחושף את הסטטוס הפעיל של שירות המשלוחים.
currencyCode

string

קוד ה-CLDR של המטבע שעליו השירות הזה חל. חייב להיות זהה למחירים בקבוצות תעריפים.
deliveryTime

object (DeliveryTime)

חובה. הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר.
shipmentType

enum (ShipmentType)

סוג המיקומים שאליהם השירות הזה מבצע הזמנות.
minimumOrderValue

object (Price)

ערך הזמנה מינימלי לשירות הזה. אם האפשרות מוגדרת, המשמעות היא שהלקוחות יצטרכו להוציא לפחות סכום זה. לכל המחירים בשירות מסוים צריך להיות מטבע זהה. לא ניתן להגדיר יחד עם minOrderValueTable.
minimumOrderValueTable

object (MinimumOrderValueTable)

טבלה של ערכי ההזמנה המינימליים לכל חנות עבור סוג מילוי ההזמנות לאיסוף. לא ניתן להגדיר יחד עם maxOrderValue.
storeConfig

object (StoreConfig)

רשימה של החנויות שמהן נשלחים המוצרים. תקף רק לסוג משלוח מקומי.

DeliveryTime

הזמן שהוקדש להיבטים שונים, מרגע קבלת המוצר ועד למסירת המוצר.

ייצוג JSON 
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
שדות
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

זה שינוי אופציונלי. מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. אחרי ההגדרה הזו, לא יהיה מוגדר אף שדה אחר שקשור לזמן הובלה במאפיין [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime].
minTransitDays

integer

המספר המינימלי של ימי עסקים למשלוח. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. צריך להגדיר minTransitDays, maxTransitDays או transitTimeTable, אבל לא את שתי העמודות.
maxTransitDays

integer

המספר המקסימלי של ימי עסקים שאפשר להשתמש בהם במעבר. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת. חייב להיות גדול מ-minTransitDays או שווה לו.
cutoffTime

object (CutoffTime)

הגדרת המועד האחרון להזמנה של ימי עסקים. אם לא מגדירים את המועד האחרון להזמנה, ברירת המחדל תהיה 8:00 שעון החוף המערבי.
minHandlingDays

integer

מספר ימי העסקים המינימלי שנדרש לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת.
maxHandlingDays

integer

המספר המקסימלי של ימי עסקים שצריך להמתין לפני שההזמנה תישלח. המשמעות של 0 היא שנשלח ביום הקנייה, המשמעות של 1 היא המשלוח ביום המחרת. חייב להיות גדול מ-minHandlingDays או שווה לו.
transitTimeTable

object (TransitTable)

טבלת זמן הובלה, מספר ימי העסקים שהובלה על סמך מאפייני שורה ועמודה. אפשר להגדיר minTransitDays, maxTransitDays או transitTimeTable, אבל לא את שתיהן.
handlingBusinessDayConfig

object (BusinessDayConfig)

ימי העסקים שבמהלכם אפשר לטפל בהזמנות. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי.
transitBusinessDayConfig

object (BusinessDayConfig)

ימי העסקים שבמהלכם ההזמנות יכולות להישלח. אם לא תספקו כתובת, המערכת תתייחס לימי עסקים בימים שני עד שישי.

CutoffTime

הגדרת המועד האחרון להזמנה של ימי עסקים.

ייצוג JSON 
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
שדות
hour

integer

חובה. השעה המאוחרת ביותר שבמהלכה צריך לבצע הזמנה כדי שהיא תטופל באותו יום.
minute

integer

חובה. הדקה של המועד האחרון שעד אליו צריך לבצע הזמנה כדי שההזמנה תעובד באותו יום.
timeZone

string

חובה. מזהה אזור זמן. לדוגמה, 'אירופה/ציריך'.

TransitTable

טבלת זמן הובלה, מספר ימי העסקים שהובלה על סמך מאפייני שורה ועמודה. אפשר להגדיר minTransitDays, maxTransitDays או transitTimeTable, אבל לא את שתיהן.

ייצוג JSON 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
שדות
postalCodeGroupNames[]

string

חובה. רשימה של שמות האזורים Region.name . הערך האחרון יכול להיות "all other locations". לדוגמה: ["zone 1", "zone 2", "all other locations"]. קבוצות המיקוד שאליהן מתבצעת הפניה צריכות להתאים למדינה שבה השירות זמין.
transitTimeLabels[]

string

חובה. רשימה של תוויות זמן הובלה. הערך האחרון יכול להיות "all other labels". לדוגמה: ["food", "electronics", "all other labels"].
rows[]

object (TransitTimeRow)

חובה. אם קיימת רק קבוצת מאפיינים אחת של postalCodeGroupNames או transitTimeLabels, יש מספר שורות שכל אחת מהן מכילה ערך אחד עבור המאפיין הזה. אם יש שני מאפיינים, כל שורה תואמת למאפיין postalCodeGroupNames, והעמודות (ערכים) תואמות למאפיין transitTimeLabels.

TransitTimeRow

אם קיימת רק קבוצת מאפיינים אחת של postalCodeGroupNames או transitTimeLabels, יש מספר שורות שכל אחת מהן מכילה ערך אחד עבור המאפיין הזה. אם יש שני מאפיינים, כל שורה תואמת למאפיין postalCodeGroupNames, והעמודות (ערכים) תואמות למאפיין transitTimeLabels.

ייצוג JSON 
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
שדות
values[]

object (TransitTimeValue)

חובה. טווח זמן ההובלה (מינימום) בימי עסקים.

TransitTimeValue

טווח זמן ההובלה (מינימום) בימי עסקים.

ייצוג JSON 
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
שדות
minTransitDays

integer

טווח זמן ההובלה המינימלי בימי עסקים. 0 פירושו מסירה ביום הקנייה, 1 פירושו משלוח ביום המחרת.
maxTransitDays

integer

חייב להיות גדול מ-minTransitDays או שווה לו.

BusinessDayConfig

ימי העסקים במחסן.

ייצוג JSON 
{
  "businessDays": [
    enum (Weekday)
  ]
}
שדות
businessDays[]

enum (Weekday)

חובה. ימי עסקים קבועים. השדה לא יכול להיות ריק.

יום חול

טיפוסים בני מנייה (enum)
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

מציין שיש לחשב את זמן האספקה לכל מחסן (מיקום המוצא של המשלוח) על סמך ההגדרות של חברת התובלה שנבחרה. כשההגדרה הזו מוגדרת, לא צריך להגדיר שדה אחר שקשור לזמן הובלה ב-deliveryTime.

ייצוג JSON 
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
שדות
carrier

string

חובה. ספק, למשל "UPS" או "Fedex".
carrierService

string

חובה. השירות של ספק הסלולר, למשל "ground" או "2 days". שם השירות חייב להופיע ברשימה eddSupportedServices.
warehouse

string

חובה. שם המחסן. הוא צריך להיות תואם לערך [warehouse][ShippingSetting.warehouses.name]

RateGroup

הגדרות של קבוצת תעריפי משלוחים. רק התג האחרון יכול להכיל applicableShippingLabels ריק, כלומר 'כל השאר'. הערכים מסוג 'applicableShippingLabels' האחרים לא יכולים לחפוף.

ייצוג JSON 
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
שדות
applicableShippingLabels[]

string

חובה. רשימה של תוויות משלוח שמגדירות את המוצרים שעליהם חלה קבוצת התעריפים הזו. זהו הבדל: רק אחת מהתוויות צריכה להתאים כדי שקבוצת התעריפים תחול. השדה הזה יכול להיות ריק רק לקבוצת התעריפים האחרונה של שירות.
subtables[]

object (Table)

זה שינוי אופציונלי. רשימה של טבלאות משנה שיש להן הפניה אל mainTable. אפשר להגדיר את הערך הזה רק אם השדה mainTable מוגדר.
carrierRates[]

object (CarrierRate)

זה שינוי אופציונלי. רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי mainTable או singleValue.
singleValue

object (Value)

הערך של קבוצת התעריפים (למשל תעריף קבוע של 40 ש"ח). אפשר להגדיר את המדיניות רק אם הערכים mainTable ו-subtables לא מוגדרים.
mainTable

object (Table)

טבלה שמגדירה את קבוצת התעריפים, במקרים שבהם הביטוי singleValue לא מספיק ברור. אפשר להגדיר את הערך רק אם השדה singleValue לא מוגדר.
name

string

זה שינוי אופציונלי. השם של קבוצת התעריפים. אם מוגדר ערך ייחודי בשירות המשלוחים.

ערך

הערך היחיד של קבוצת תעריפים או הערך של התא בטבלת קבוצת תעריפים. יש להגדיר רק אחד מהערכים noShipping, flatRate, pricePercentage, carrier_rateName, subtable_name.

ייצוג JSON 
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
שדות
noShipping

boolean

אם הערך הוא True, לא ניתן לשלוח את המוצר. הערך צריך להיות True כשמגדירים, רק אם לא מוגדרים כל שאר השדות.
flatRate

object (Price)

תעריף קבוע. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
pricePercentage

string

אחוז מהמחיר שמיוצג כמספר בסימון עשרוני (לדוגמה, "5.4"). אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
carrierRate

string

השם של תעריף של חברת תובלה שמתייחס לתעריף של חברת תובלה שמוגדר באותה קבוצת תעריפים. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
subtable

string

השם של טבלת משנה. אפשר להגדיר אותן רק בתאים בטבלה (לדוגמה לא לערכים בודדים) ורק אם כל שאר השדות לא הוגדרו.

טבלה

טבלה שמגדירה את קבוצת התעריפים, במקרים שבהם הביטוי singleValue לא מספיק ברור.

ייצוג JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
שדות
rows[]

object (Row)

חובה. רשימת השורות שמהן מורכב הטבלה. האורך חייב להיות זהה לזה של rowHeaders.
name

string

שם הטבלה. חובה לטבלאות משנה, והמערכת מתעלמת ממנו עבור הטבלה הראשית.
rowHeaders

object (Headers)

חובה. כותרות של שורות הטבלה.
columnHeaders

object (Headers)

הכותרות של עמודות הטבלה. אופציונלי: אם היא לא מוגדרת, יש לטבלה מאפיין אחד בלבד.

כותרות

רשימה לא ריקה של כותרות של שורות או עמודות בטבלה. יש להגדיר רק אחד מהערכים prices, weights, num_items, postalCodeGroupNames או location.

ייצוג JSON 
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
שדות
prices[]

object (Price)

חובה. רשימת גבולות עליון של מחיר הזמנה כולל. ערך המחיר האחרון יכול להיות אינסוף אם מגדירים סכום מחיר ב-Micros = -1. לדוגמה [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] מייצג את הכותרות "<= $10", "<= $500" ו-"> 2,000 ש"ח". לכל המחירים בשירות מסוים צריך להיות מטבע זהה. השדה לא יכול להיות ריק. חייב להיות חיובי מלבד 1-. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.
weights[]

object (Weight)

חובה. רשימת גבולות עליון של משקל ההזמנה כולל. ערך המשקל האחרון יכול להיות אינסוף אם מגדירים סכום מחיר ב-Micros = -1. לדוגמה, [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] מייצג את הכותרות " <= 10kg", " <= 50kg" ו- "> 50 ק"ג". לכל המשקולות בשירות חייבת להיות אותה יחידה. השדה לא יכול להיות ריק. חייב להיות חיובי מלבד 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 ק"ג = 1000,000 מיקרו). ניתן גם להגדיר את השדה הזה כאינסוף על ידי הגדרת הערך 1-. השדה הזה תומך רק בערך 1- ובערך חיובי.

WeightUnit

יחידת המשקל.

טיפוסים בני מנייה (enum)
WEIGHT_UNIT_UNSPECIFIED לא צוינה יחידה
POUND פאונד.
KILOGRAM יחידת ק"ג.

LocationIdSet

רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. אפשר להגדיר את הערך רק אם לא הוגדרו כל שאר השדות.

ייצוג JSON 
{
  "locationIds": [
    string
  ]
}
שדות
locationIds[]

string

חובה. רשימה של מזהי מיקומים שאינה ריקה. על כל המיקומים להיות מאותו סוג מיקום (למשל, מדינה).

שורה

מוסיפים רשימת תאים.

ייצוג JSON 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
שדות
cells[]

object (Value)

חובה. רשימת התאים שמרכיבים את השורה. האורך של הטבלה צריך להיות זהה לזה של columnHeaders בטבלאות דו-ממדיות, והאורך של טבלאות חד-ממדיות יהיה 1.

CarrierRate

רשימה של תעריפים של חברות תובלה שאפשר להתייחס אליהם לפי mainTable או singleValue.

ייצוג JSON 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
שדות
name

string

חובה. שם התעריף של חברת התובלה. חייב להיות ייחודי לכל קבוצת תעריפים.
carrier

string

חובה. השירות של ספק הסלולר, למשל "UPS" או "Fedex".
carrierService

string

חובה. השירות של ספק הסלולר, למשל "ground" או "2 days".
originPostalCode

string

חובה. מקור המשלוח בתעריף הזה של חברת התובלה.
percentageAdjustment

string

זה שינוי אופציונלי. הכפלה של תעריף המשלוח כמספר בסימון עשרוני. יכול להיות שלילי. לדוגמה: הדגל "5.4" מעלה את השיעור ב-5.4%, והשיטה "-3" מקטינה את השיעור ב-3%.
flatAdjustment

object (Price)

זה שינוי אופציונלי. ערך מוסף של תעריף משלוח. יכול להיות שלילי. לדוגמה: { "amountMicros": 1, "currencyCode" : "USD" } מוסיף 1 $לתעריף, { "amountMicros": -3, "currencyCode" : "USD" } מסיר 3 $מהתעריף.

ShipmentType

סוג שירות המשלוחים.

טיפוסים בני מנייה (enum)
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 חייב להיות True.
storeServiceType

enum (StoreServiceType)

מאפיין זה מציין אם כל החנויות או החנויות הנבחרות שצוינו על ידי המוכר הזה מספקות משלוח מקומי.
cutoffConfig

object (CutoffConfig)

הגדרות שקשורות למסירה מקומית מסתיימות באותו היום.
serviceRadius

object (Distance)

רדיוס מסירה מקסימלי. צריך לעשות זאת רק עבור סוג משלוח מקומי.

StoreServiceType

מציין אם כל החנויות או החנויות הנבחרות שצוינו על ידי המוכר מספקות משלוח מקומי.

טיפוסים בני מנייה (enum)
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 ימים. לדוגמה, אם בשירות המשלוחים מוגדר מסירה ביום הקנייה ומועד אחרון להזמנה כבר חלף, אם מזינים בשדה הזה את הערך 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)

היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים.

יחידה

היחידה עשויה להשתנות בהתאם למדינה, היא כוללת פרמטרים שכוללים מיילים וקילומטרים.

טיפוסים בני מנייה (enum)
UNIT_UNSPECIFIED לא צוינה יחידה
MILES יחידה במיילים
KILOMETERS יחידה בקילומטרים

LoyaltyProgram

מועדון לקוחות שסופק על ידי מוכר.

ייצוג JSON 
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
שדות
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

זה שינוי אופציונלי. רמת מועדון הלקוחות של שירות המשלוחים הזה.
programLabel

string

תווית מועדון הלקוחות שנוצרה בהגדרות של מועדון הלקוחות ב-Merchant Center. מאפיין המשנה הזה מאפשר ל-Google למפות את מועדון הלקוחות למוצרים כשירים.

LoyaltyProgramTiers

קבוצת משנה של מועדון לקוחות של מוכר.

ייצוג JSON 
{
  "tierLabel": string
}
שדות
tierLabel

string

מאפיין המשנה לתווית הרמה [tierLabel] יוצר הבדל בין הטבות ברמת המוצר ברמות שונות. הערך הזה מוגדר גם בהגדרות התוכנית ב-Merchant Center, והוא נדרש לשינויים במקור הנתונים גם אם במועדון הלקוחות שלכם יש רק רמה אחת.

מחסן

מחסן לאספקה, שבו מאחסנים ומטפלים במלאי. התג הבא: 7

ייצוג JSON 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
שדות
name

string

חובה. שם המחסן. חייב להיות ייחודי בחשבון.
shippingAddress

object (Address)

חובה. הכתובת למשלוח של המחסן.
cutoffTime

object (WarehouseCutoffTime)

חובה. השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן.
handlingDays

string (int64 format)

חובה. מספר הימים שנדרשים למחסן הזה כדי לארוז ולשלוח פריט. מגדירים את המאפיין הזה ברמת המחסן, אבל אפשר לשנות אותו ברמת המוצר בהתאם למאפיינים של הפריט.
businessDayConfig

object (BusinessDayConfig)

ימי העסקים במחסן. אם לא מגדירים את הערך, ברירת המחדל תהיה שני עד שישי.

כתובת

הכתובת למשלוח של המחסן.

ייצוג JSON 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
שדות
streetAddress

string

חלק של הכתובת ברמת הרחוב. לדוגמה: 111w 31st Street.
city

string

חובה. עיר, עיירה או קהילה. עשוי לכלול גם רשויות מוניציפאליות או אזורי משנה (לדוגמה, שכונות או פרברים).
administrativeArea

string

חובה. חלוקת משנה מנהלית ברמה העליונה של המדינה. לדוגמה, מדינה כמו קליפורניה (CA) או מחוז כמו קוויבק (QC).
postalCode

string

חובה. מיקוד (לדוגמה "94043").
regionCode

string

חובה. קוד מדינה במאגר CLDR (לדוגמה, 'US').

WarehouseCutoffTime

השעה האחרונה ביום שבה אפשר לאשר את ההזמנה ולהתחיל לעבד אותה. הזמנות שיבוצעו מאוחר יותר יטופלו ביום הבא. השעה מבוססת על המיקוד של המחסן.

ייצוג JSON 
{
  "hour": integer,
  "minute": integer
}
שדות
hour

integer

חובה. השעה המאוחרת ביותר שבה צריך לבצע הזמנה כדי שהיא תעובד במחסן באותו יום. השעה מבוססת על אזור הזמן של המחסן.
minute

integer

חובה. דקה של המועד האחרון להזמנה כדי שההזמנה תעובד באותו יום במחסן. הדקות מבוססות על אזור הזמן של המחסן.