Bu sayfa, Cloud Translation API ile çevrilmiştir.

Gönderim ayarlarına genel bakış

shippingsettings kaynağı, hesabınızın gönderim ayarlarını almanıza ve güncellemenize olanak tanır.

Google, bazı ürünlerin tahmini teslimat süresini otomatik olarak güncelleyebilir. Daha fazla bilgi için Otomatik iyileştirmeleri etkinleştirme bölümüne bakın.

Gönderim ayarlarını okuma, yazma veya güncelleme

Merchant API gönderim hizmetini kullanmak için aşağıdakileri yapın:

Hesabınızın tüm gönderim ayarlarını almak için GET isteğinde bulunun.
Gönderim ayarlarını değiştirin.
Değiştirilen gönderim ayarlarını kullanarak INSERT isteğinde bulunun.

Etag

Etag, eşzamansız güncellemeleri önlemek için kodlanmış bir jetondur. Gönderim ayarları verilerinden herhangi biri değiştiğinde etiket de değişir. Kullanıcıların, GET isteğinden edindikleri etiketi INSERT istek gövdesine kopyalamaları gerekir.

Gönderim ayarları verileri, GET isteği ile INSERT isteği arasında değişirse en son etag jetonunu almak için bir GET isteği daha isteyen bir hata mesajı alırsınız. Yeni etiket jetonunu almak için GET isteğini çağırmanız ve yeni etag jetonunu INSERT istek gövdesine kopyalamanız gerekir.

Gönderim ayarlarınızı ekleyin

Hesabınıza gönderim ayarları eklemek veya mevcut gönderim ayarlarını güncellemek için shippingsettings.insert öğesini kullanın. 10.hesap altında, GSA Gönderim - 49,99 ABD Doları Üzeri Ücretsiz Kargo adlı Gönderim Hizmeti için maxTransitDays değerini 7 olarak güncelleyen örnek bir isteği aşağıda bulabilirsiniz.

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"
        }
      ]
    }
  ]
}

Depoları ayarlama

Aşağıdaki JSON örneğinde, satıcı hesabınızın depo bilgilerini yönetmek için Satıcı Gönderim ayarları hizmetini nasıl kullanabileceğiniz gösterilmektedir:

"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"
      ]
    }
  }
]

Aşağıdakini değiştirin:

{street_address}: Depo adresinin cadde seviyesindeki bölümü.
{city}: Deponun bulunduğu şehir, ilçe veya komün.
{administrative_area}: Ülkenin idari alt bölümü. Örneğin, bu bir eyalet olabilir.
{postal_code}: Posta kodu.
{region_code}: Dizedeki ülke kodu.
{minutes}: Siparişin depo tarafından aynı gün içinde işlenmesi için son sipariş saatinin içinde kalan dakikadır.
{handling_days}: Bu deponun bir öğeyi paketleyip göndermesi için gereken gün sayısıdır.

warehouses kaynağı, ambarların listesidir. Her depoya, gönderim hizmetinin warehouse.name tarihine kadar olan depo temelli teslimat süresine göre gösterilebilir.

Depolarınızı yönetme

Depolarınızı yönetmek için Merchant API'yi nasıl kullanacağınız aşağıda açıklanmıştır:

Mevcut tüm shippingsettings ve depolarınızı almak için GET isteğinde bulunun.
GET isteğindeki shippingsettings değerini UPDATE isteğine kopyalayın.

Not: Mevcut shippingsettings dokümanın tamamını kopyalamazsanız bu shippingsettings öğeleri hesabınızdan INSERT isteğinde silinir.
INSERT isteği için warehouses bölümünde kullanmak istediğiniz depoları doldurun.
shippingsettings ve warehouses kaynaklarını içeren bir UPDATE isteği yapın.

Aşağıda, Warehouse 1 için New York'tan Mountain View'a güncellenmiş depo içeren örnek bir INSERT istek gövdesi verilmiştir:

{
  "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"
        }
      ]
    }
  ]
}

Aynı gün teslimat ekle

Yerel envanteriniz varsa aynı gün teslimatla ilgili gönderim hizmetlerini yapılandırmak için Content API for Shopping'i kullanabilirsiniz. Aynı gün teslimat kapsamındaki gönderim hizmetlerinin shipment_type değeri local_delivery olarak belirlenmiştir. Şu anda tüm local_delivery gönderim hizmetleri aynı gün teslimat olarak kabul edilmektedir.

Yerel teslimatların delivery_time bilgilerini değiştiremezsiniz. Yerel envanter ürünleriniz için aynı gün teslimatı ayarlamak üzere shippingsettings.insert özelliğini kullanın.

Hesabınız için tüm mağazalara aynı gün teslimat hizmeti ekleyen örnek bir istek gövdesini burada görebilirsiniz:

{
  "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"
        }
      }
    }
  ]
}

Sonraki gün teslimat ekle

Son sipariş saatiniz aynı gün geçtikten sonra verilen siparişler için varsayılan olarak sonraki gün teslimat planlanır. Ertesi gün teslimatı devre dışı bırakmak için no_delivery_post_cutoff alanını true olarak ayarlayın. Ertesi gün teslimatı devre dışı bırakırsanız gönderim hizmetleriniz her gün yalnızca son sipariş saatinden önce gösterilir.

Ertesi gün teslimat yalnızca shipment_type local_delivery olduğunda kullanılabilir.