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

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

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

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

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

لاستخدام خدمة الشحن من Merchant API، يُرجى اتّباع الخطوات التالية:

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

علامة

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

إذا تغيّرت بيانات إعدادات الشحن بين طلب GET وطلب INSERT، ستظهر لك رسالة خطأ تطلب منك طلب GET آخر لاسترداد أحدث رمز مميّز لعلامة etag. عليك طلب الرمز البرمجي للعلامة GET لاسترداد رمز eTag الجديد ونسخ الرمز المميز الجديد للعلامة التجارية إلى نص طلب INSERT.

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

استخدِم shippingsettings.insert لإضافة إعدادات الشحن أو تعديلها في حسابك. في ما يلي نموذج طلب يعدّل maxTransitDays إلى 7 لخدمة شحن تُسمى GSA Shipping - Free shiped أكثر من 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 في 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 على "صحيح". إذا أوقفت التسليم في اليوم التالي، لن تظهر خدمات الشحن إلا قبل الموعد النهائي لطلب المنتجات كل يوم.

تتوفّر خدمة التسليم في اليوم التالي فقط عندما تكون قيمة shipment_type هي local_delivery.