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

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

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

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

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

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

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

علامة Etag

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

في حال تغيّرت بيانات إعدادات الشحن بين طلب GET وINSERT تلقيت رسالة خطأ تطلب منك تقديم طلب GET آخر لاسترداد أحدث رمز etag. عليك الاتصال بطلب واحد (GET) من أجل استرداد الرمز المميّز الجديد للعلامة etag ونسخ الرمز المميّز الجديد للعلامة etag إلى طلب INSERT جسم.

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

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

خدمة التسليم في اليوم التالي متاحة فقط عند بلوغ قيمة shipment_type local_delivery

مزيد من المعلومات

للمزيد من المعلومات حول نقل البيانات من Content API for Shopping، يُرجى الاطّلاع على المقالة نقل بيانات الشحن. إدارة الإعدادات.