نمای کلی تنظیمات حمل و نقل

منبع ShippingSettings به شما امکان می دهد تنظیمات حمل و نقل حساب خود را بازیابی و به روز کنید.

Google می‌تواند زمان تخمینی تحویل را برای برخی محصولات به‌طور خودکار به‌روزرسانی کند. برای اطلاعات بیشتر، فعال کردن بهبودهای خودکار را ببینید.

تنظیمات حمل و نقل را بخوانید، بنویسید یا به‌روزرسانی کنید

برای استفاده از سرویس ارسال Merchant API، موارد زیر را انجام دهید:

  1. برای بازیابی تنظیمات حمل و نقل کامل حساب خود، درخواست GET کنید.
  2. تنظیمات حمل و نقل را تغییر دهید.
  3. با تنظیمات حمل و نقل تغییریافته درخواست INSERT کنید.

Etag

Etag یک توکن رمزگذاری شده برای جلوگیری از به روز رسانی ناهمزمان است. وقتی هر یک از داده های تنظیمات حمل و نقل تغییر می کند، اتگ تغییر می کند. کاربران باید اتگی را که از درخواست GET به دست آورده اند در بدنه درخواست INSERT کپی کنند.

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

تنظیمات حمل و نقل خود را اضافه کنید

از shippingsettings.insert برای افزودن یا به‌روزرسانی تنظیمات ارسال برای حساب خود استفاده کنید. در اینجا یک نمونه درخواست وجود دارد که maxTransitDays به 7 برای یک سرویس حمل و نقل به نام حمل و نقل GSA - ارسال رایگان بیش از 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 برای مدیریت انبارهای خود آورده شده است:

  1. یک درخواست GET برای بازیابی همه shippingsettings و انبارهای موجود خود ارائه دهید.

  2. shippingsettings از درخواست GET در درخواست UPDATE کپی کنید.

  3. اگر می خواهید از آنها در بخش warehouses برای درخواست INSERT استفاده کنید، انبارها را پر کنید.

  4. درخواست UPDATE کنید که حاوی shippingsettings و منابع warehouses است.

در اینجا یک نمونه بدنه درخواست INSERT با انبار برای Warehouse 1 است که از نیویورک به Mountain View به روز شده است: 

{
  "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 برای خرید برای پیکربندی خدمات حمل و نقل تحویل همان روز استفاده کنید. خدمات حمل و نقل تحویل همان روز، 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 برای خرید، به مدیریت تنظیمات حمل و نقل مهاجرت مراجعه کنید.