דף זה תורגם על ידי Cloud Translation API.

סקירה כללית של הגדרות המשלוח

ShippingSettings מאפשר לאחזר ולעדכן את הגדרות המשלוח של החשבון.

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

קריאה, כתיבה או עדכון של הגדרות משלוח

כדי להשתמש בשירות המשלוחים של Merchant API:

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

Etag

Etag הוא אסימון מקודד למנוע עדכונים אסינכרוניים. ה-ETag משתנה כאשר חל שינוי בנתוני הגדרות המשלוח. המשתמשים צריכים להעתיק את ה-etag שהם התקבל מהבקשה GET לגוף הבקשה INSERT.

אם נתוני הגדרות המשלוח משתנים בין הבקשה של GET לבין INSERT התקבלה הודעת שגיאה עם בקשה לבקשת GET נוספת מאחזרים את אסימון ה-etag האחרון. עליך להתקשר לבקשה של GET כדי מאחזרים את אסימון ה-etag החדש ומעתיקים את אסימון ה-etag החדש לבקשת INSERT גוף ההודעה.

הוספת הגדרות המשלוח

באמצעות shippingsettings.insert אפשר להוסיף או לעדכן את הגדרות המשלוח של חשבון. הנה בקשה לדוגמה שמעדכנת את maxTransitDays ל-7 עבור שירות משלוחים שנקרא תשלומים חריגים - משלוח חינם מעל 49.99 $, בחשבון 10.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

הגדרת מחסנים

הדוגמה הבאה של JSON מראה איך משתמשים בהגדרות המשלוח של המוכר שירות לניהול פרטי המחסן בחשבון המוכר/ת שלך:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

מחליפים את מה שכתוב בשדות הבאים:

{street_address}: חלק ברמת הרחוב מכתובת המחסן.
{city}: עיר, עיירה או קהילה שבה נמצא המחסן.
{administrative_area}: חלוקת המשנה הניהולית של מדינה. לדוגמה, מדינה.
{postal_code}: המיקוד.
{region_code}: קוד המדינה במחרוזת.
{minutes}: דקות חלק מהזמן האחרון שעד אליו ההזמנה צריכה להתבצע באותו יום על ידי המחסן.
{handling_days}: מספר הימים שנדרשים לכך הוא מחסן לאריזה ולמשלוח של פריט.

המשאב warehouses הוא רשימה של מחסנים. כל מחסן יכול להיות צריך להפנות לפי זמן אספקה מבוסס-מחסן של שירות המשלוחים דרך warehouse.name

ניהול המחסנים

כדי לנהל את המחסנים שלכם באמצעות Merchant API:

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

הערה: אם לא מעתיקים את כל הפריטים הקיימים shippingsettings, הם יימחקו מהחשבון שלך בבקשת INSERT.
צריך לאכלס את המחסנים אם רוצים להשתמש בהם בקטע warehouses. לבקשה INSERT.
שליחת בקשת UPDATE שמכילה את shippingsettings ואת warehouses המשאבים.

הנה דוגמה לגוף בקשה של INSERT עם מחסן של Warehouse 1 מניו יורק למאונטיין ויו:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

הוספת משלוח ביום הקנייה

אפשר להשתמש ב-Content API for Shopping כדי להגדיר משלוח ביום הקנייה שירותים, אם יש לכם מלאי בחנות מקומית. יש שירותי משלוח ביום הקנייה local_delivery בתור shipment_type. כל שירותי המשלוח במחיר local_delivery בשלב זה, שירותים מסוימים נחשבים כמשלוחים ביום הקנייה.

אי אפשר לשנות את המידע בdelivery_time לגבי משלוחים מקומיים. כדאי להשתמש shippingsettings.insert כדי להגדיר מסירה ביום הקנייה למלאי בחנות המקומית שלך מוצרים.

דוגמה לגוף בקשה שמוסיף לכל החנויות שירות מסירה ביום הקנייה לחשבון שלך:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

הוספת משלוח ביום המחרת

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

משלוח ביום המחרת זמין רק כאשר shipment_type local_delivery.

מידע נוסף

מידע נוסף על מיגרציה מ-Content API for Shopping זמין במאמר העברת משלוחים ניהול הגדרות.