مهم: «میانای برنامه‌سازی کاربردی محتوا برای خرید» در ۱۸ اوت ۲۰۲۶ متوقف شد.

از ۱ سپتامبر ۲۰۲۶، درخواست‌های «میانای برنامه‌سازی کاربردی محتوا برای خرید» با خطاهای پیش‌رونده مواجه خواهند شد. راهنمای توقف تدریجی Content API را مرور کنید.

اگر برای انتقال به Merchant API به زمان بیشتری نیاز دارید، برای دسترسی تمدیدشده به Content API ویژه Shopping درخواست دهید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

مدیریت تنظیمات ارسال

از زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» برای مدیریت تنظیمات ارسال برای همه محصولات تحت حسابتان و همه حساب‌های فرعی مرتبط استفاده کنید.

تغییراتی که در تنظیمات ارسال ایجاد می‌کنید بر همه محصولات اعمال خواهد شد. برای به‌روزرسانی ارسال برای محصولات تکی، از میانای برنامه‌سازی کاربردی Merchant Products استفاده کنید.

برای اطلاعات بیشتر، راه‌اندازی تنظیمات ارسال را ببینید.

نمای کلی تنظیمات ارسال

منبع accounts.shippingSettings به شما امکان می‌دهد تنظیمات ارسال حساب پیشرفته و همه حساب‌های فرعی مرتبط را بازیابی و به‌روز کنید.

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

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

افزودن تنظیمات ارسال کالا

برای افزودن یا به‌روزرسانی تنظیمات ارسال برای حسابتان، از روش accounts.shippingSettings.insert استفاده کنید.

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

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/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/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"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"}}}]}]}' \
--compressed

موارد زیر را جایگزین کنید:

‫{ACCOUNT_ID}: شناسه یکتای حساب Merchant Center شما.
{COUNTRY_CODE}: کد CLDR (مخزن داده‌های محلی مشترک) کشوری که این سرویس برای آن اعمال می‌شود. باید با قیمت‌های موجود در گروه‌های نرخ مطابقت داشته باشد.
‫{SERVICE_NAME}: نام سرویس.
‫{PROGRAM_LABEL}: برچسب برنامه وفاداری که در تنظیمات برنامه وفاداری شما در Merchant Center تنظیم شده است.
‫{SHIPPING_LABEL}: فهرستی از برچسب‌های ارسال که محصولاتی را که این گروه نرخ بر آن‌ها اعمال می‌شود تعریف می‌کند.
{PRICE}: قیمت به‌صورت عدد در میکرو نشان داده شده است. برای مثال، ۱ دلار امریکا = ۱۰۰۰۰۰۰ میکرو.
‫{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"
}

در اینجا نمونه‌ای آورده شده است که می‌توانید از آن برای به‌روزرسانی تنظیمات ارسال برای یک حساب مشخص بااستفاده از کتابخانه‌های مشتری استفاده کنید:

جاوا

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.DeliveryTime;
import com.google.shopping.merchant.accounts.v1.InsertShippingSettingsRequest;
import com.google.shopping.merchant.accounts.v1.RateGroup;
import com.google.shopping.merchant.accounts.v1.Service;
import com.google.shopping.merchant.accounts.v1.Service.ShipmentType;
import com.google.shopping.merchant.accounts.v1.ShippingSettings;
import com.google.shopping.merchant.accounts.v1.ShippingSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.ShippingSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1.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\V1\Client\ShippingSettingsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\DeliveryTime;
use Google\Shopping\Merchant\Accounts\V1\InsertShippingSettingsRequest;
use Google\Shopping\Merchant\Accounts\V1\RateGroup;
use Google\Shopping\Merchant\Accounts\V1\Service;
use Google\Shopping\Merchant\Accounts\V1\Service\ShipmentType;
use Google\Shopping\Merchant\Accounts\V1\ShippingSettings;
use Google\Shopping\Merchant\Accounts\V1\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_v1 import DeliveryTime
from google.shopping.merchant_accounts_v1 import InsertShippingSettingsRequest
from google.shopping.merchant_accounts_v1 import RateGroup
from google.shopping.merchant_accounts_v1 import Service
from google.shopping.merchant_accounts_v1 import ShippingSettings
from google.shopping.merchant_accounts_v1 import ShippingSettingsServiceClient
from google.shopping.merchant_accounts_v1 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/v1/accounts/{ACCOUNT_ID}/shippingSettings

cURL

curl \
'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--compressed

در اینجا نمونه‌ای آورده شده است که می‌توانید از آن برای بازیابی اطلاعات تنظیمات ارسال برای حسابی مشخص بااستفاده از کتابخانه‌های مشتری استفاده کنید:

جاوا

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.GetShippingSettingsRequest;
import com.google.shopping.merchant.accounts.v1.ShippingSettings;
import com.google.shopping.merchant.accounts.v1.ShippingSettingsName;
import com.google.shopping.merchant.accounts.v1.ShippingSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.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\V1\Client\ShippingSettingsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\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_v1 import GetShippingSettingsRequest
from google.shopping.merchant_accounts_v1 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/v1/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}: کد پستی. برای مثال، 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 خود به‌صورت زیر استفاده کنید:

برای بازیابی همه shippingsettings و postalCodeGroups، تماس get برقرار کنید.
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/v1/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» و فهرستگان‌های رایگان مراجعه کنید.
کارمزد برگرداندن کالا
روش‌های مرجوع کردن
وضعیت محصول برگردانده‌شده
دسته دلیل برگرداندن
نشانی‌های وب خط‌مشی برگرداندن کالا، به راه‌اندازی خط‌مشی‌های برگرداندن کالا برای «آگهی‌های Shopping» و فهرستگان‌های رایگان مراجعه کنید.

محصولاتی که ازطریق «آگهی‌های Shopping» یا فهرستگان‌های طبیعی فروخته می‌شوند به نشانی برگشت نیاز ندارند.

برای جزئیات بیشتر، راه‌اندازی خط‌مشی‌های برگرداندن کالا برای «آگهی‌های Shopping» و فهرستگان‌های طبیعی را ببینید.

می‌توانید از returnpolicyonline.create برای افزودن خط‌مشی برگرداندن محصولات استفاده کنید. پاسخ شامل خط‌مشی به‌روزشده است.

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

قبلی

Filter syntax

بعدی

Manage online return policies

مدیریت تنظیمات ارسال با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

نمای کلی تنظیمات ارسال

افزودن تنظیمات ارسال کالا

HTTP

cURL

جاوا

PHP

Python

بازیابی تنظیمات ارسال

HTTP

cURL

جاوا

PHP

Python

افزودن تنظیمات انبار

تنظیم گروه‌های کد پستی

افزودن تحویل در همان روز

افزودن تحویل در روز بعد

افزودن خط‌مشی برگرداندن محصولات

مدیریت تنظیمات ارسال