تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نظرة عامة على إعدادات الشحن

يتيح لك المرجع ShippingSettings استرداد إعدادات الشحن في حسابك وتعديلها.

يمكن أن تعدّل Google تلقائيًا الوقت المقدَّر للتسليم لبعض المنتجات. لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل التحسينات التلقائية.

قراءة إعدادات الشحن أو كتابتها أو تعديلها

لاستخدام خدمة الشحن في Merchant API، اتّبِع الخطوات التالية:

قدِّم طلبًا إلى GET لاسترداد إعدادات الشحن الكاملة لحسابك.
عدِّل إعدادات الشحن.
قدِّم طلبًا للحصول على INSERT باستخدام إعدادات الشحن المعدَّلة.

علامة Etag

علامة Etag هي رمز مميّز مُشفَّر لتجنُّب التعديلات غير المتزامنة. تتغيّر علامة الهاشتاغ عند تغيُّر أيّ من بيانات إعدادات الشحن. على المستخدمين نسخ علامة الهامش التي حصلوا عليها من طلب GET إلى محتوى طلب INSERT.

إذا تغيّرت بيانات إعدادات الشحن بين طلب GET وINSERT ، ستتلقّى رسالة خطأ تطلب منك إرسال طلب GET آخر ل retrieving the most recent etag token. عليك استدعاء طلب GET ل retrieving the new etag token ونسخ الرمز المميّز الجديد لعلامة etag إلى INSERT request body.

إضافة إعدادات الشحن

استخدِم الرمز shippingsettings.insert لإضافة إعدادات الشحن أو تعديلها في حسابك. في ما يلي نموذج طلب يُعدّل القيمة maxTransitDays إلى 7 للخدمة الشحن التي تحمل الاسم GSA Shipping - Free Ship Over $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 يتضمّن مستودعًا لـ المستودع 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 لإعداد خدمات 👏شحن 👏التوصيل في اليوم نفسه إذا كانت لديك منتجات داخل المتجر. خدمات الشحن التي توفّر التوصيل في اليوم نفسه لها shipment_type‏ local_delivery. في الوقت الحالي، تُعتبر جميع خدمات 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، يُرجى الاطّلاع على مقالة نقل إدارة إعدادات الشحن.