Gönderim ayarlarına genel bakış

İlgili içeriği oluşturmak için kullanılan ShippingSettings kaynağı, hesabınızın kargo ayarlarını almanızı ve güncellemenizi sağlar.

Google, bazı ürünler için tahmini teslimat süresini otomatik olarak güncelleyebilir. Daha fazla bilgi için Otomatik ödemeyi etkinleştirme iyileştirmeler başlıklı makaleye göz atın.

Kargo ayarlarını okuma, yazma veya güncelleme

Merchant API kargo hizmetini kullanmak için aşağıdakileri yapın:

  1. Hesabınızın kargo ayarlarının tamamını almak için GET isteğinde bulunun. hesap.
  2. Kargo ayarlarını değiştirin.
  3. Değiştirilen kargo ayarlarını kullanarak INSERT isteğinde bulunun.

Etag

Etag, eşzamansız güncellemelerden kaçınmak için kodlanmış bir jetondur. Etag şu durumlarda değişir: veri değişikliklerinden herhangi biri. Kullanıcıların e-postanızı kopyalaması gerekir INSERT istek gövdesine yapılan GET isteğinden alındı.

Kargo ayarları verileri GET isteği ile INSERT arasında değişiyorsa başka bir GET isteği için bir hata mesajı alırsınız. En son etag jetonunu alma. GET isteğini şunun için aramanız gerekiyor: yeni etag jetonunu alma ve yeni etag jetonunu INSERT isteğine kopyalama gövde.

Kargo ayarlarınızı ekleyin

Ürününüzün kargo ayarlarını eklemek veya güncellemek için shippingsettings.insert kullanın. hesap. Aşağıda, maxTransitDays değerini Hesap altında GSA Kargo - 49, 99 ABD Doları Üzeri Ücretsiz Kargo adlı kargo hizmeti 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"
        }
      ]
    }
  ]
}

Depo oluşturma

Aşağıdaki JSON örneğinde, satıcı kargo ayarlarını nasıl kullanabileceğiniz gösterilmektedir hizmeti kullanabilirsiniz:

"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 sokak düzeyindeki bölümü.
  • {city}: Deponun bulunduğu şehir, ilçe veya mahalle.
  • {administrative_area}: Bölgenin idari alt bölümü ülke. Örneğin, bu bir eyalet olabilir.
  • {postal_code}: Posta kodu.
  • {region_code}: Dizedeki ülke kodu.
  • {minutes}: Son sipariş saatinin belirli bir kısmında sipariş, depo tarafından aynı gün içinde işlenmek üzere verilmelidir.
  • {handling_days}: Bu işlem için gereken gün sayısı bir ürünü paketleyip gönderecek bir depoya ihtiyacınız vardır.

warehouses kaynağı, depoların bir listesidir. Her depo gönderim hizmetinin depoya dayalı teslimat süresi ile ifade edilir. warehouse.name

Depolarınızı yönetin

Depolarınızı yönetmek için Merchant API'yi şu şekilde kullanabilirsiniz:

  1. Mevcut tüm shippingsettings ve verilerinizi almak için bir GET isteğinde bulunun. emin olmanız gerekir.
  2. GET isteğindeki shippingsettings öğesini UPDATE isteğine kopyalayın.

  3. Kullanmak istediğiniz depoları warehouses bölümünde doldurun (INSERT isteği için)

  4. shippingsettings ve warehouses içeren bir UPDATE isteği gönderin kaynaklar.

Warehouse 1 için deponun güncellendiği örnek bir INSERT isteği gövdesini burada bulabilirsiniz. New York'tan Mountain View'a:

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

Aynı gün teslimat gönderimini yapılandırmak için Content API for Shopping'i kullanabilirsiniz yerel envanteriniz varsa bunu kullanın. Aynı gün teslimat kargo hizmetleri local_delivery, shipment_type rolünde. Tüm local_delivery kargoları hizmetler şu anda aynı gün teslimat olarak kabul edilmektedir.

Yerel teslimatlarla ilgili delivery_time bilgilerini değiştiremezsiniz. Tekliflerinizi otomatikleştirmek ve optimize etmek için Yerel envanterinizde aynı gün teslimatı ayarlamak için shippingsettings.insert ürünler.

Tüm mağazalara aynı gün teslimat hizmeti ekleyen örnek bir istek gövdesini aşağıda görebilirsiniz hesabınız için:

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

Aynı gün teslimat için son sipariş saatinden sonra verilen siparişler sonraki gün olarak planlandı günde teslimat varsayılan olarak belirlenebilir. Sonraki gün teslimatı devre dışı bırakmak için no_delivery_post_cutoff alanını doğru değerine ayarlayın. Ertesi gün teslimatı devre dışı bırakırsanız kargo hizmetleri yalnızca her gün son sipariş saatinden önce görünür.

Sonraki gün teslimat yalnızca shipment_type şu durumlarda kullanılabilir: local_delivery.

Daha fazla bilgi

Content API for Shopping'den taşıma hakkında bilgi edinmek için Kargoyu taşıma başlıklı makaleyi inceleyin. Ayarlar'ın yönetimi bölümünde daha fazla bilgi edinebilirsiniz.