Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan setelan pengiriman

Tujuan ShippingSettings memungkinkan Anda mengambil dan memperbarui setelan pengiriman akun.

Google dapat memperbarui estimasi waktu pengiriman untuk beberapa produk secara otomatis. Untuk informasi selengkapnya, lihat Mengaktifkan setelan otomatis pengoptimalan.

Membaca, menulis, atau memperbarui setelan pengiriman

Untuk menggunakan layanan pengiriman Merchant API, lakukan hal berikut:

Buat permintaan GET untuk mengambil setelan pengiriman lengkap produk Anda menggunakan akun layanan.
Ubah setelan pengiriman.
Buat permintaan INSERT dengan setelan pengiriman yang diubah.

Etag

Etag adalah token yang dienkode untuk menghindari update asinkron. {i>Etag<i} berubah bila perubahan data setelan pengiriman. Pengguna harus menyalin etag yang yang diperoleh dari permintaan GET ke isi permintaan INSERT.

Jika data setelan pengiriman berubah antara permintaan GET dan INSERT Anda akan menerima pesan error yang meminta permintaan GET lainnya untuk mengambil token etag terbaru. Anda perlu memanggil permintaan GET ke mengambil token etag baru dan menyalin token etag baru ke permintaan INSERT {i>body <i}itu.

Tambahkan setelan pengiriman

Gunakan shippingsettings.insert untuk menambahkan atau memperbarui setelan pengiriman untuk menggunakan akun layanan. Berikut adalah contoh permintaan yang memperbarui maxTransitDays menjadi 7 untuk Layanan Pengiriman bernama Pengiriman GSA - Pengiriman Gratis Lebih dari $49,99, sesuai akun 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"
        }
      ]
    }
  ]
}

Tetapkan gudang

Contoh JSON berikut menunjukkan cara menggunakan setelan Pengiriman Penjual guna mengelola informasi gudang untuk akun penjual Anda:

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

Ganti kode berikut:

{street_address}: Bagian tingkat jalan dari alamat gudang.
{city}: Kota, kota besar, atau komune tempat gudang berada.
{administrative_area}: Subdivisi administratif negara. Misalnya, negara bagian.
{postal_code}: Kode pos.
{region_code}: Kode negara dalam string.
{minutes}: Bagian menit dari batas waktu hingga pesanan harus dilakukan agar diproses pada hari yang sama oleh gudang.
{handling_days}: Jumlah hari yang diperlukan untuk ini gudang untuk mengemas dan mengirimkan barang.

Resource warehouses adalah daftar gudang. Setiap gudang dapat yang dirujuk oleh waktu pengiriman berdasarkan gudang layanan pengiriman melalui warehouse.name.

Mengelola gudang Anda

Berikut cara menggunakan Merchant API untuk mengelola gudang Anda:

Buat permintaan GET untuk mengambil semua shippingsettings yang ada dan gudang.
Salin shippingsettings dari permintaan GET ke permintaan UPDATE.

Catatan: Jika Anda tidak menyalin semua shippingsettings yang ada, file tersebut akan dihapus dari akun Anda dalam permintaan INSERT.
Isi gudang jika Anda ingin menggunakannya di bagian warehouses untuk permintaan INSERT.
Buat permintaan UPDATE yang berisi shippingsettings dan warehouses Google Cloud Platform.

Berikut adalah contoh isi permintaan INSERT dengan gudang untuk Warehouse 1 yang diperbarui dari New York ke Jakarta:

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

Tambahkan pengiriman pada hari yang sama

Anda dapat menggunakan Content API for Shopping untuk mengonfigurasi pengiriman pada hari yang sama jika Anda memiliki inventaris lokal. Layanan pengiriman di hari yang sama memiliki local_delivery sebagai shipment_type-nya. Semua pengiriman local_delivery layanan dianggap sebagai pengiriman di hari yang sama untuk saat ini.

Anda tidak dapat mengubah informasi delivery_time untuk pengiriman lokal. Gunakan shippingsettings.insert guna menyiapkan pengiriman di hari yang sama untuk inventaris lokal Anda Google.

Berikut contoh isi permintaan yang menambahkan layanan pengiriman di hari yang sama ke semua toko untuk akun Anda:

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

Tambahkan pengiriman di hari berikutnya

Pesanan yang dilakukan setelah batas waktu pengiriman di hari yang sama akan dijadwalkan untuk tanggal berikutnya pengiriman harian secara default. Untuk menonaktifkan pengiriman di hari berikutnya, setel Kolom no_delivery_post_cutoff ke true. Jika Anda menonaktifkan pengiriman di hari berikutnya, Layanan pengiriman hanya terlihat sebelum batas waktu setiap hari.

Pengiriman di hari berikutnya hanya tersedia jika shipment_type local_delivery.

Pelajari lebih lanjut

Untuk mempelajari cara bermigrasi dari Content API for Shopping, lihat Memigrasikan pengiriman pengelolaan setelan.