REST Resource: accounts.shippingSettings

משאב: ShippingSettings

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

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

string

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

object (Service)

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

object (Warehouse)

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

string

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

  1. מגדירים את השדה etag כמחרוזת ריקה ליצירת ההגדרות הראשוניות של המשלוח.

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

  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)

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

object (MinimumOrderValueTable)

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

object (StoreConfig)

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

DeliveryTime

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

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

object (WarehouseBasedDeliveryTime)

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

integer

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

integer

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

object (CutoffTime)

הגדרת מועד הסגירה בימי עסקים. אם לא תגדירו את השעה, ברירת המחדל תהיה 8: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)

הערך של קבוצת התעריפים (לדוגמה, תשלום קבוע בסך 10$). אפשר להגדיר את השדה הזה רק אם השדות mainTable ו-subtables לא מוגדרים.
mainTable

object (Table)

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

string

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

ערך

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

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

boolean

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

object (Price)

תעריף קבוע. ניתן להגדיר את השדה הזה רק אם כל שאר השדות לא מוגדרים.
pricePercentage

string

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

string

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

string

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

טבלה

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

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

object (Row)

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

string

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

object (Headers)

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

object (Headers)

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

כותרות

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

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

object (Price)

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

object (Weight)

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

string

חובה. רשימה של גבולות עליונים של מספר הפריטים, כולל. הערך האחרון יכול להיות "infinity". לדוגמה, הערך ["10", "50", "infinity"] מייצג את הכותרות "<= 10 פריטים", "<= 50 פריטים" וגם "> 50 פריטים". השדה לא יכול להיות ריק. ניתן להגדיר את השדה הזה רק אם כל שאר השדות לא מוגדרים.
postalCodeGroupNames[]

string

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

object (LocationIdSet)

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

משקל

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

ייצוג ב-JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
שדות
unit

enum (WeightUnit)

חובה. יחידת המשקל. הערכים הקבילים הם: kg ו-lb
amountMicros

string (int64 format)

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

WeightUnit

יחידת המשקל.

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

LocationIdSet

רשימה של קבוצות של מזהי מיקומים. השדה לא יכול להיות ריק. ניתן להגדיר את השדה הזה רק אם כל שאר השדות לא מוגדרים.

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

string

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

שורה

כוללים רשימה של תאים.

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

object (Value)

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

CarrierRate

רשימה של תעריפי ספקים שאפשר להפנות אליה באמצעות mainTable או singleValue. שירותי הספקים הנתמכים מוגדרים בכתובת https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

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

string

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

string

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

string

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

string

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

string

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

object (Price)

זה שינוי אופציונלי. משתנה לשינוי תעריף המשלוח. יכול להיות שלילי. לדוגמה, { "amountMicros": 1, "currencyCode" : "USD" } מוסיף 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

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

מחסן

מחסן לטיפול בהזמנות, שבו מאוחסן המלאי וממנו הוא מטופל.

ייצוג ב-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 (לדוגמה, 'IL').

WarehouseCutoffTime

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

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

integer

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

integer

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

Methods

getShippingSettings

 אחזור פרטי הגדרות המשלוח.

insert

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