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

إدارة إعدادات الشحن

استخدِم واجهة برمجة التطبيقات الفرعية "الحسابات" لإدارة إعدادات الشحن لجميع المنتجات ضمن حسابك وجميع الحسابات الفرعية المرتبطة به.

سيتم تطبيق التغييرات التي تجريها على إعدادات الشحن على جميع المنتجات. لتعديل معلومات الشحن الخاصة بالمنتجات الفردية، استخدِم Merchant Products API.

لمزيد من المعلومات، يُرجى الاطّلاع على ضبط إعدادات الشحن.

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

يتيح لك المرجع accounts.shippingSettings استرداد إعدادات الشحن وتعديلها في حسابك المتقدّم وجميع الحسابات الفرعية المرتبطة به.

يستخدم عادةً الحسابات المتقدّمة جهات الدمج والتجميع وشركاء القنوات الذين يديرون متاجر على الإنترنت وخدمات واجهة برمجة التطبيقات لعدة أنشطة تجارية. يمكن أيضًا للأنشطة التجارية التي لديها متاجر أو علامات تجارية متعدّدة على الإنترنت يتم بيعها على مواقع إلكترونية منفصلة أن تختار الحصول على حسابات فرعية ضمن حساب واحد بامتيازات متقدّمة.

يمكن أن تعدّل Google تلقائيًا الوقت المقدَّر للتسليم لبعض المنتجات.

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

لإضافة إعدادات الشحن أو تعديلها في حسابك، استخدِم طريقة accounts.shippingSettings.insert

يضبط نموذج الطلب التالي سعر الشحن وبرامج الولاء التي تقتصر عليها خدمة الشحن هذه ورمز العملة.

HTTP

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

{
  "etag": "",
  "name": "accounts/ACCOUNT_ID/shippingSetting",
  "services": [
    {
      "deliveryCountries": [
        "COUNTRY_CODE"
      ],
      "serviceName": "SERVICE_NAME",
      "active": false,
      "deliveryTime": {},
      "loyaltyPrograms": [
        {
          "programLabel": "PROGRAM_LABEL"
        }
      ],
      "minimumOrderValue": {
        "amountMicros": PRICE,
        "currencyCode": "CURRENCY_CODE"
      },
      "currencyCode": "USD",
      "rateGroups": [
        {
          "applicableShippingLabels": [
            "SHIPPING_LABEL"
          ],
          "singleValue": {
            "flatRate": {
              "amountMicros": 10000000,
              "currencyCode": "USD"
            }
          }
        }
      ]
    }
  ]
}

cURL

curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/shippingSettings:insert' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"name":"SHIPPING_SETTING_NAME","services":[{"serviceName":"SERVICE_NAME","currencyCode":"CURRENCY_CODE","rateGroups":[{"applicableShippingLabels":["SHIPPING_LABEL"],"carrierRates":[{"name":"new","carrier":"CARRIER_NAME","carrierService":"CARRIER_SERVICE","originPostalCode":"ZIPCODE"}],"singleValue":{"flatRate":{"amountMicros":10000000,"currencyCode":"USD"}}}],"deliveryCountries":["COUNTRY_CODE"],"deliveryTime":{"maxHandlingDays":2,"minHandlingDays":1},"minimumOrderValue":{"amountMicros":50000000,"currencyCode":"USD"},"active":false}]}' \
--compressed

غيِّر القيم في السلسلة على الشكل التالي:

ACCOUNT_ID: المعرّف الفريد لحسابك على Merchant Center.
‫COUNTRY_CODE: رمز CLDR (مستودع بيانات اللغات المشتركة) الخاص بالبلد الذي تنطبق عليه هذه الخدمة يجب أن تتطابق مع أسعار المجموعات ذات الأسعار المحدّدة.
SERVICE_NAME: اسم الخدمة
CARRIER_NAME: اسم شركة النقل على سبيل المثال، UPS وFedex.
CARRIER_SERVICE: الخدمة المتوافقة مع شركة النقل للاطّلاع على القائمة الكاملة بخدمات شركات النقل، يُرجى الرجوع إلى تعرفة شركة النقل (أستراليا وألمانيا والمملكة المتحدة والولايات المتحدة فقط).
PROGRAM_LABEL: تشير هذه السمة إلى تصنيف برنامج الولاء الذي تم ضبطه في إعدادات برنامج الولاء في Merchant Center.
SHIPPING_LABEL: قائمة بتصنيفات الشحن التي تحدّد المنتجات التي تنطبق عليها مجموعة الأسعار هذه.
PRICE: السعر ممثَّلاً كرقم بالفئات الصغيرة للعملة على سبيل المثال، 1 دولار أمريكي = 1,000,000 وحدة ميكرو.
CURRENCY_CODE: عملة السعر باستخدام اختصارات مكوّنة من ثلاثة أحرف

لمزيد من المعلومات حول الحقول المحدّدة، يُرجى الاطّلاع على المستندات المرجعية.

يجب أن يحتوي نص الطلب على نص المرجع الكامل للمرجع accounts.shippingSettings، حتى إذا كنت تعدّل سمة واحدة فقط، لأنّ أي قيم NULL أو قيم ناقصة في نص الطلب ستؤدي إلى إلغاء القيم الحالية.

في ما يلي نموذج ردّ من مكالمة ناجحة:

{
  "name": "accounts/ACCOUNT_ID/shippingSettings",
  "services": [
    {
      "serviceName": "SERVICE_NAME",
      "active": false,
      "deliveryCountries": [
        "COUNTRY_CODE"
      ],
      "currencyCode": "CURRENCY_CODE",
      "rateGroups": [
        {
          "applicableShippingLabels": [
            "SHIPPING_LABEL"
          ],
          "singleValue": {
            "flatRate": {
              "amountMicros": "PRICE",
              "currencyCode": "CURRENCY_CODE"
            }
          }
        }
      ],
      "shipmentType": "LOCAL_DELIVERY",
      "storeConfig": {
        "storeServiceType": "ALL_STORES",
        "cutoffConfig": {
          "localCutoffTime": {
            "hour": "7",
            "minute": "40"
          },
          "noDeliveryPostCutoff": false
        },
        "serviceRadius": {
          "value": "40",
          "unit": "KILOMETERS"
        }
      }
    }
  ],
  "etag": "OAJCTQgBEAAaRwoEdGVzdBIEIgJVUxoDVVNEIggiBggHECgoACoeCAESDwoNCAESCU9WRVJTSVpFRBoJIgcIAhCAwtcvWAWSAQCaAQQIAhAo"
}

في ما يلي نموذج يمكنك استخدامه لتعديل إعدادات الشحن لحساب معيّن باستخدام مكتبات البرامج:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.DeliveryTime;
import com.google.shopping.merchant.accounts.v1beta.InsertShippingSettingsRequest;
import com.google.shopping.merchant.accounts.v1beta.RateGroup;
import com.google.shopping.merchant.accounts.v1beta.Service;
import com.google.shopping.merchant.accounts.v1beta.Service.ShipmentType;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettings;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1beta.Value;
import com.google.shopping.type.Price;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to insert a ShippingSettings for a Merchant Center account. */
public class InsertShippingSettingsSample {

  private static String getParent(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void insertShippingSettings(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    ShippingSettingsServiceSettings shippingSettingsServiceSettings =
        ShippingSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent to identify where to insert the shippingsettings.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (ShippingSettingsServiceClient shippingSettingsServiceClient =
        ShippingSettingsServiceClient.create(shippingSettingsServiceSettings)) {

      InsertShippingSettingsRequest request =
          InsertShippingSettingsRequest.newBuilder()
              .setParent(parent)
              .setShippingSetting(
                  ShippingSettings.newBuilder()
                      // Etag needs to be an empty string on initial insert
                      // On future inserts, call GET first to get the Etag
                      // Then use the retrieved Etag on future inserts.
                      // NOTE THAT ON THE INITIAL INSERT, YOUR SHIPPING SETTINGS WILL
                      // NOT BE STORED, YOU HAVE TO CALL INSERT AGAIN WITH YOUR
                      // RETRIEVED ETAG.
                      // .setEtag("")
                      .setEtag("PPa=")
                      .addServices(
                          Service.newBuilder()
                              .setServiceName("Canadian Postal Service")
                              .setActive(true)
                              .addDeliveryCountries("CA")
                              .setCurrencyCode("CAD")
                              .setDeliveryTime(
                                  DeliveryTime.newBuilder()
                                      .setMinTransitDays(0)
                                      .setMaxTransitDays(3)
                                      .setMinHandlingDays(0)
                                      .setMaxHandlingDays(3)
                                      .build())
                              .addRateGroups(
                                  RateGroup.newBuilder()
                                      .addApplicableShippingLabels("Oversized")
                                      .addApplicableShippingLabels("Perishable")
                                      .setSingleValue(Value.newBuilder().setPricePercentage("5.4"))
                                      .setName("Oversized and Perishable items")
                                      .build())
                              .setShipmentType(ShipmentType.DELIVERY)
                              .setMinimumOrderValue(
                                  Price.newBuilder()
                                      .setAmountMicros(10000000)
                                      .setCurrencyCode("CAD")
                                      .build())
                              .build())
                      .build())
              .build();

      System.out.println("Sending insert ShippingSettings request");
      ShippingSettings response = shippingSettingsServiceClient.insertShippingSettings(request);
      System.out.println("Inserted ShippingSettings Name below");
      System.out.println(response.getName());
      // You can apply ShippingSettings to specific products by using the `shippingLabel` field
      // on the product.
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    insertShippingSettings(config);
  }
}InsertShippingSettingsSample.java

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1beta\Client\ShippingSettingsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\DeliveryTime;
use Google\Shopping\Merchant\Accounts\V1beta\InsertShippingSettingsRequest;
use Google\Shopping\Merchant\Accounts\V1beta\RateGroup;
use Google\Shopping\Merchant\Accounts\V1beta\Service;
use Google\Shopping\Merchant\Accounts\V1beta\Service\ShipmentType;
use Google\Shopping\Merchant\Accounts\V1beta\ShippingSettings;
use Google\Shopping\Merchant\Accounts\V1beta\Value;
use Google\Shopping\Type\Price;

/**
 * This class demonstrates how to insert a ShippingSettings for a Merchant Center account.
 */
class InsertShippingSettings
{
    /**
     * A helper function to create the parent string.
     *
     * @param string $accountId The account ID.
     * @return string The parent in the format "accounts/{accountId}".
     */
    private static function getParent(string $accountId): string
    {
        return sprintf("accounts/%s", $accountId);
    }

    /**
     * Inserts shipping settings for the specified Merchant Center account.
     *
     * @param array $config The configuration data containing the account ID.
     * @return void
     */
    public static function insertShippingSettings($config)
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $shippingSettingsServiceClient = new ShippingSettingsServiceClient($options);

        // Creates parent to identify where to insert the shippingsettings.
        $parent = self::getParent($config['accountId']);

        // Calls the API and catches and prints any network failures/errors.
        try {
            $request = (new InsertShippingSettingsRequest())
                ->setParent($parent)
                ->setShippingSetting(
                    (new ShippingSettings())
                        // Etag needs to be an empty string on initial insert
                        // On future inserts, call GET first to get the Etag
                        // Then use the retrieved Etag on future inserts.
                        // NOTE THAT ON THE INITIAL INSERT, YOUR SHIPPING SETTINGS WILL
                        // NOT BE STORED, YOU HAVE TO CALL INSERT AGAIN WITH YOUR
                        // RETRIEVED ETAG.
                        ->setEtag("")
                        ->setServices([
                            (new Service())
                                ->setServiceName("Canadian Postal Service")
                                ->setActive(true)
                                ->setDeliveryCountries(["CA"])
                                ->setCurrencyCode("CAD")
                                ->setDeliveryTime(
                                    (new DeliveryTime())
                                        ->setMinTransitDays(0)
                                        ->setMaxTransitDays(3)
                                        ->setMinHandlingDays(0)
                                        ->setMaxHandlingDays(3)
                                )
                                ->setRateGroups(
                                    [(new RateGroup())
                                        ->setApplicableShippingLabels(["Oversized","Perishable"])
                                        ->setSingleValue((new Value())->setPricePercentage("5.4"))
                                        ->setName("Oversized and Perishable items")]
                                )
                                ->setShipmentType(ShipmentType::DELIVERY)
                                ->setMinimumOrderValue(
                                    (new Price())
                                        ->setAmountMicros(10000000)
                                        ->setCurrencyCode("CAD")
                                )
                        ])
                );

            print "Sending insert ShippingSettings request" . PHP_EOL;
            $response = $shippingSettingsServiceClient->insertShippingSettings($request);
            print "Inserted ShippingSettings below" . PHP_EOL;
            print_r($response);
            // You can apply ShippingSettings to specific products by using the `shippingLabel` field
            // on the product.
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }

    /**
     * Helper to execute the sample.
     *
     * @return void
     */
    public function callSample(): void
    {
        $config = Config::generateConfig();

        // Makes the call to insert shipping settings for the MC account.
        self::insertShippingSettings($config);
    }
}

// Run the script
$sample = new InsertShippingSettings();
$sample->callSample();InsertShippingSettingsSample.php

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1beta import DeliveryTime
from google.shopping.merchant_accounts_v1beta import InsertShippingSettingsRequest
from google.shopping.merchant_accounts_v1beta import RateGroup
from google.shopping.merchant_accounts_v1beta import Service
from google.shopping.merchant_accounts_v1beta import ShippingSettings
from google.shopping.merchant_accounts_v1beta import ShippingSettingsServiceClient
from google.shopping.merchant_accounts_v1beta import Value

_ACCOUNT = configuration.Configuration().read_merchant_info()
_PARENT = f"accounts/{_ACCOUNT}"


def insert_shipping_settings():
  """Inserts a ShippingSettings for a Merchant Center account."""

  # Gets OAuth Credentials.
  credentials = generate_user_credentials.main()

  # Creates a client.
  client = ShippingSettingsServiceClient(credentials=credentials)

  # Creates the request.
  request = InsertShippingSettingsRequest(
      parent=_PARENT,
      shipping_setting=ShippingSettings(
          # Etag needs to be an empty string on initial insert
          # On future inserts, call GET first to get the Etag
          # Then use the retrieved Etag on future inserts.
          # NOTE THAT ON THE INITIAL INSERT, YOUR SHIPPING SETTINGS WILL
          # NOT BE STORED, YOU HAVE TO CALL INSERT AGAIN WITH YOUR
          # RETRIEVED ETAG.
          etag="",
          services=[
              Service(
                  service_name="Canadian Postal Service",
                  active=True,
                  delivery_countries=["CA"],
                  currency_code="CAD",
                  delivery_time=DeliveryTime(
                      min_transit_days=0,
                      max_transit_days=3,
                      min_handling_days=0,
                      max_handling_days=3,
                  ),
                  rate_groups=[
                      RateGroup(
                          applicable_shipping_labels=[
                              "Oversized",
                              "Perishable",
                          ],
                          single_value=Value(price_percentage="5.4"),
                          name="Oversized and Perishable items",
                      )
                  ],
                  shipment_type=Service.ShipmentType.DELIVERY,
                  minimum_order_value={
                      "amount_micros": 10000000,
                      "currency_code": "CAD",
                  },
              )
          ],
      ),
  )

  # Makes the request and prints the inserted ShippingSettings name.
  try:
    response = client.insert_shipping_settings(request=request)
    print("Inserted ShippingSettings below")
    print(response)
    # You can apply ShippingSettings to specific products by using the
    # `shippingLabel` field on the product.
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  insert_shipping_settings()
insert_shipping_settings_sample.py

استرداد إعدادات الشحن

توضّح الطلبات التالية كيف يمكنك استرداد إعدادات الشحن الخاصة بحساب على Merchant Center:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings

cURL

curl \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

في ما يلي نموذج يمكنك استخدامه لاسترداد معلومات إعدادات الشحن لحساب معيّن باستخدام مكتبات البرامج:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.GetShippingSettingsRequest;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettings;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettingsName;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.ShippingSettingsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to get the ShippingSettings for a given Merchant Center account. */
public class GetShippingSettingsSample {

  public static void getShippingSettings(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    ShippingSettingsServiceSettings shippingSettingsServiceSettings =
        ShippingSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates ShippingSettings name to identify ShippingSettings.
    String name =
        ShippingSettingsName.newBuilder()
            .setAccount(config.getAccountId().toString())
            .build()
            .toString();

    // Calls the API and catches and prints any network failures/errors.
    try (ShippingSettingsServiceClient shippingSettingsServiceClient =
        ShippingSettingsServiceClient.create(shippingSettingsServiceSettings)) {

      // The name has the format: accounts/{account}/shippingSettings
      GetShippingSettingsRequest request =
          GetShippingSettingsRequest.newBuilder().setName(name).build();

      System.out.println("Sending Get ShippingSettings request:");
      ShippingSettings response = shippingSettingsServiceClient.getShippingSettings(request);

      System.out.println("Retrieved ShippingSettings below");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    getShippingSettings(config);
  }
}GetShippingSettingsSample.java

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1beta\Client\ShippingSettingsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\GetShippingSettingsRequest;

/**
 * This class demonstrates how to get the ShippingSettings for a given Merchant Center account.
 */
class GetShippingSettings
{

    /**
     * Retrieves the shipping settings for the specified Merchant Center account.
     *
     * @param array $config The configuration data containing the account ID.
     * @return void
     */
    public static function getShippingSettings($config)
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $shippingSettingsServiceClient = new ShippingSettingsServiceClient($options);

        // Creates ShippingSettings name to identify ShippingSettings.
        // The name has the format: accounts/{account}/shippingSettings
        $name = "accounts/" . $config['accountId'] . "/shippingSettings";


        // Calls the API and catches and prints any network failures/errors.
        try {
            $request = (new GetShippingSettingsRequest())
                ->setName($name);

            print "Sending Get ShippingSettings request:" . PHP_EOL;
            $response = $shippingSettingsServiceClient->getShippingSettings($request);

            print "Retrieved ShippingSettings below" . PHP_EOL;
            print_r($response);
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }

    /**
     * Helper to execute the sample.
     *
     * @return void
     */
    public function callSample(): void
    {
        $config = Config::generateConfig();
        // Makes the call to get shipping settings for the MC account.
        self::getShippingSettings($config);
    }
}

// Run the script
$sample = new GetShippingSettings();
$sample->callSample();GetShippingSettingsSample.php

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1beta import GetShippingSettingsRequest
from google.shopping.merchant_accounts_v1beta import ShippingSettingsServiceClient

_ACCOUNT = configuration.Configuration().read_merchant_info()
_PARENT = f"accounts/{_ACCOUNT}"


def get_shipping_settings():
  """Gets the ShippingSettings for a given Merchant Center account."""

  # Gets OAuth Credentials.
  credentials = generate_user_credentials.main()

  # Creates a client.
  client = ShippingSettingsServiceClient(credentials=credentials)

  # Creates the Shipping Settings name
  name = _PARENT + "/shippingSettings"

  # Creates the request.
  request = GetShippingSettingsRequest(name=name)

  # Makes the request and prints the retrieved ShippingSettings.
  try:
    response = client.get_shipping_settings(request=request)
    print("Retrieved ShippingSettings below")
    print(response)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  get_shipping_settings()
get_shipping_settings_sample.py

إضافة إعدادات المستودع

لإضافة إعدادات المستودع أو تعديلها، والتي تخزّن المستودع وتتعامل معه في حسابك، استخدِم طريقة accounts.shippingSettings.insert.

إليك كيفية استخدام Merchant API لإدارة مستودعاتك:

لاسترداد كل shippingsettings وwarehouses الحالية، أرسِل طلب GET باستخدام طريقة accounts.shippingSettings.getShippingSettings.
أنشئ طلبًا باستخدام الطريقة account.shippingSettings.insert. انسخ مورد shippingsettings من ردّ طلب الإدراج إلى طلب GET.

ملاحظة: إذا لم تنسخ جميع الحقول الحالية التي تم عرضها في الردّ الذي تم الحصول عليه من طلب GET، سيتم حذف قيم هذه الحقول من حسابك في طلب accounts.shippingSettings.insert.
لإضافة معلومات حول المستودعات باستخدام طلب الإدراج، املأ التفاصيل حول المستودع في مورد warehouses في نص الطلب.
نفِّذ طلب الإدراج.

يوضّح نموذج الطلب التالي كيفية استخدام طريقة accounts.shippingSettings.insert لتعديل إعدادات المستودع لحسابك. يحدّد الطلب الوقت من اليوم الذي يمكن فيه قبول الطلب وبدء معالجته، وأيام المناولة، وعنوان الشحن.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/shippingSettings:insert

{
  "etag": "",
  "name": "accounts/ACCOUNT_ID/shippingSetting",
  "warehouses": [
    {
      "cutoffTime": {
        "hour": 7,
        "minute": 50
      },
      "handlingDays": 7,
      "name": "WAREHOUSE_NAME",
      "shippingAddress": {
        "streetAddress": "ADDRESS",
        "administrativeArea": "CA",
        "city": "CITY_NAME",
        "postalCode": "POSTAL_CODE",
        "regionCode": "REGION_CODE"
      }
    }
  ]
}

غيِّر القيم في السلسلة على الشكل التالي:

ACCOUNT_ID: المعرّف الفريد لحسابك على Merchant Center.
WAREHOUSE_NAME: تمثّل اسم المستودع.
‫ADDRESS: عنوان الشحن الخاص بالمستودع
CITY_NAME: تمثّل هذه السمة مدينة أو بلدة أو بلدية. ويمكن أن يشمل أيضًا المناطق التابعة أو المناطق الفرعية. على سبيل المثال، الأحياء أو الضواحي
استبدِل POSTAL_CODE بالرمز البريدي أو رمز ZIP. مثلاً، 94043.
REGION_CODE: رمز البلد وفقًا لمعيار CLDR على سبيل المثال، "US".

في ما يلي نموذج ردّ من مكالمة ناجحة:

{
  "name": "accounts/ACCOUNT_ID/shippingSettings",
  "warehouses": [
    {
      "name": "WAREHOUSE_NAME",
      "shippingAddress": {
        "streetAddress": "ADDRESS",
        "city": "CITY_NAME",
        "administrativeArea": "CA",
        "postalCode": "POSTAL_CODE",
        "regionCode": "REGION_CODE"
      },
      "cutoffTime": {
        "hour": 7,
        "minute": 50
      },
      "handlingDays": "7",
      "businessDayConfig": {
        "businessDays": [
          "MONDAY",
          "TUESDAY",
          "WEDNESDAY",
          "THURSDAY",
          "FRIDAY"
        ]
      }
    }
  ],
  "etag": "OAJiUAjB0au+FBABGgR0ZXN0Ii4KAlVTGgJDQSoKQ2FsaWZvcm5pYWIFOTQwNDNyETExMXcgMzFzdCBTdHJlZXQuKgQIBxAyMAc4ATgCOAM4BDgF"
}

ضبط مجموعات الرموز البريدية

استخدِم واجهة برمجة التطبيقات الفرعية "الحسابات" لإدارة المناطق، التي تُعرف باسم postalCodeGroups، لحساب على Merchant Center.

مورد postalCodeGroups هو قائمة بالمجموعات، حيث تكون كل مجموعة عبارة عن قائمة برموز بريدية متعددة تشترك في إعدادات الشحن نفسها.

استخدِم Merchant API لإدارة postalCodeGroups على النحو التالي:

أرسِل طلب get لاسترداد جميع shippingsettings وpostalCodeGroups.
انسخ shippingsettings من طلب get إلى طلب update.

ملاحظة: في حال عدم نسخ كل shippingsettings، سيؤدي طلب update إلى حذفها من حسابك.
إذا كنت لا تستخدم تصنيفات مدة النقل في خدمة الشحن، أزِل الإدخال التالي من نص الطلب.
```
    "transitTimeLabels": [
    "all other labels"
],
```
املأ المناطق التي تريد استخدامها في قسم postalCodeGroups لطلب update.
أجرِ طلب تعديل باستخدام المَرجِعين shippingsettings وpostalCodeGroups.

إضافة خدمة تسليم في اليوم نفسه

يمكنك استخدام Merchant API لإعداد خدمات شحن تتيح التوصيل في اليوم نفسه إذا كان لديك مخزون متوفر في المتجر. راجِع إضافة معلومات المتجر إلى المنتجات المحلية (addlocalinventory).

تستخدم خدمات التوصيل في اليوم نفسه القيمة local_delivery في السمة shipmentType.

تنطبق التحذيرات التالية:

تُعتبر جميع خدمات الشحن local_delivery عمليات توصيل في اليوم نفسه.
لا يمكنك تغيير معلومات deliveryTime لعمليات التسليم المحلية.

لإعداد ميزة "التسليم في اليوم نفسه" للمنتجات المتوفرة داخل المتجر، استخدِم طريقة accounts.shippingSettings.insert.

في ما يلي نموذج طلب يحدّد نوع الشحن، storeConfig (قائمة بالمتاجر التي يتم تسليم منتجاتك منها)، ومجموعات الأسعار.

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

{
  "etag": "",
  "name": "accounts/ACCOUNT_ID/shippingSetting",
  "services": [
    {
      "deliveryCountries": [
        "COUNTRY_CODE"
      ],
      "serviceName": "SERVICE_NAME",
      "active": false,
      "currencyCode": "CURRENCY_CODE",
      "shipmentType": "SHIPMENT_TYPE",
      "storeConfig": {
        "cutoffConfig": {
          "localCutoffTime": {
            "hour": 7,
            "minute": 40
          }
        },
        "serviceRadius": {
          "unit": "KILOMETERS",
          "value": 40
        },
        "storeCodes": [],
        "storeServiceType": "ALL_STORES"
      },
      "rateGroups": [
        {
          "applicableShippingLabels": [
            "SHIPPING_LABEL"
          ],
          "singleValue": {
            "flatRate": {
              "amountMicros": PRICE,
              "currencyCode": "CURRENCY_CODE"
            }
          }
        }
      ]
    }
  ]
}

غيِّر القيم في السلسلة على الشكل التالي:

‫SHIPMENT_TYPE: نوع المواقع الجغرافية التي تشحن إليها هذه الخدمة الطلبات، ويشمل:
- SHIPMENT_TYPE_UNSPECIFIED
- DELIVERY
- LOCAL_DELIVERY
- COLLECTION_POINT
SHIPPING_LABEL: قائمة بتصنيفات الشحن التي تحدّد المنتجات التي تنطبق عليها مجموعة الأسعار هذه.

في ما يلي نموذج ردّ من مكالمة ناجحة:

{
  "name": "accounts/ACCOUNT_ID/shippingSettings",
  "services": [
    {
      "serviceName": "SERVICE_NAME",
      "active": false,
      "deliveryCountries": [
        "COUNTRY_CODE"
      ],
      "currencyCode": "CURRENCY_CODE",
      "rateGroups": [
        {
          "applicableShippingLabels": [
            "SHIPPING_LABEL"
          ],
          "singleValue": {
            "flatRate": {
              "amountMicros": "PRICE",
              "currencyCode": "CURRENCY_CODE"
            }
          }
        }
      ],
      "shipmentType": "SHIPMENT_TYPE",
      "storeConfig": {
        "storeServiceType": "ALL_STORES",
        "cutoffConfig": {
          "localCutoffTime": {
            "hour": "7",
            "minute": "40"
          },
          "noDeliveryPostCutoff": false
        },
        "serviceRadius": {
          "value": "40",
          "unit": "KILOMETERS"
        }
      }
    }
  ],
  "etag": "OAJCTQgBEAAaRwoEdGVzdBIEIgJVUxoDVVNEIggiBggHECgoACoeCAESDwoNCAESCU9WRVJTSVpFRBoJIgcIAhCAwtcvWAWSAQCaAQQIAhAo"
}

إضافة خدمة التسليم في اليوم التالي

يتم تلقائيًا تحديد موعد لتسليم الطلبات في اليوم التالي إذا تم تقديمها بعد الموعد النهائي لطلب المنتجات التي يمكن تسليمها في اليوم نفسه.

لإيقاف ميزة "التوصيل في اليوم التالي"، اضبط قيمة no_delivery_post_cutoff على true.

في حال إيقاف خدمة "التوصيل في اليوم التالي"، لن تظهر خدمات الشحن إلا قبل الموعد النهائي لطلب المنتجات كل يوم.

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

إضافة سياسة إرجاع

إذا كنت تعرض منتجاتك من خلال "إعلانات Shopping" أو البيانات المجانية، يمكنك استخدام السمة returnpolicyonline لإنشاء سياسات الإرجاع على الإنترنت أو عرضها أو تعديلها أو حذفها، وذلك باستخدام السمات التالية:

البلدان المستهدَفة، يمكنك الاطّلاع على إعداد سياسات الإرجاع لإعلانات Shopping والبيانات المجانية.
رسوم إعادة التخزين
طُرق الإرجاع
حالة السلعة المرجَعة
فئة سبب الإرجاع
عناوين URL لسياسة الإرجاع، يمكنك الاطّلاع على إعداد سياسات الإرجاع لإعلانات Shopping والبيانات المجانية.

لا تتطلّب المنتجات التي يتم بيعها من خلال "إعلانات Shopping" أو البيانات المجانية عنوان إرجاع.

لمزيد من التفاصيل، اطّلِع على إعداد سياسات الإرجاع لإعلانات Shopping والبيانات المجانية.

يمكنك استخدام returnpolicyonline.create لإضافة سياسة إرجاع. يتضمّن الرد السياسة المعدَّلة.

POST https://merchantapi.googleapis.com/v1beta/{ACCOUNT_ID}/returnpolicyonline

إدارة إعدادات الشحن تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

HTTP

cURL

Java

PHP

Python

استرداد إعدادات الشحن

HTTP

cURL

Java

PHP

Python

إضافة إعدادات المستودع

ضبط مجموعات الرموز البريدية

إضافة خدمة تسليم في اليوم نفسه

إضافة خدمة التسليم في اليوم التالي

إضافة سياسة إرجاع

إدارة إعدادات الشحن