ShippingSettings

הגדרת המשלוח בחשבון המוכר.

ייצוג JSON 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
שדות
name

string

מזהה. שם המשאב של הגדרת המשלוח. פורמט: accounts/{account}/shippingSetting
services[]

object (Service)

זה שינוי אופציונלי. רשימת השירותים של חשבון היעד.
warehouses[]

object (Warehouse)

זה שינוי אופציונלי. רשימה של מחסנים שאפשר להפנות אליהם ב-services.
etag

string

חובה. השדה הזה משמש למניעת בעיה אסינכרונית. חשוב לוודא שהנתונים של הגדרות המשלוח לא השתנו בין הקריאה ל-get לבין הקריאה ל-insert. המשתמש צריך לבצע את השלבים הבאים:

  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)

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

object (StoreConfig)

רשימה של החנויות שמהן המוצרים נשלחים. האפשרות הזו תקפה רק לסוג המשלוח 'איסוף עצמי'.

DeliveryTime

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

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

object (WarehouseBasedDeliveryTime)

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

integer

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

integer

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

object (CutoffTime)

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

integer

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

integer

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

object (TransitTable)

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

object (BusinessDayConfig)

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

object (BusinessDayConfig)

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

CutoffTime

הגדרת מועד הסגירה בימי עסקים.

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

integer

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

integer

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

string

חובה. מזהה אזור זמן. לדוגמה, 'Europe/Zurich'.

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)

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

object (Weight)

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

חובה. יחידת המשקל. הערכים הקבילים הם: kg ו-lb
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

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