Ringkasan setelan pengiriman

Resource shippingsettings memungkinkan Anda mengambil dan memperbarui setelan pengiriman akun.

Catatan: Resource shippingsettings tidak berfungsi untuk setelan pengiriman yang dibuat melalui penautan akun atau dengan mengupload histori pelacakan pesanan secara manual. Setelan pengiriman tersebut tidak akan ditampilkan, diubah, atau dihapus oleh panggilan ke endpoint ini.

Google dapat memperbarui perkiraan waktu pengiriman untuk beberapa produk secara otomatis. Untuk informasi selengkapnya, lihat Mengaktifkan peningkatan otomatis.

Membaca, menulis, atau memperbarui setelan pengiriman

Untuk menggunakan layanan pengiriman Merchant API, lakukan hal berikut:

1. Buat permintaan GET untuk mengambil setelan pengiriman lengkap akun Anda.
2. Ubah setelan pengiriman.
3. Buat permintaan INSERT dengan setelan pengiriman yang diubah.

Etag

Etag adalah token yang dienkode untuk menghindari update asinkron. Etag akan berubah jika data setelan pengiriman berubah. Pengguna harus menyalin etag yang mereka peroleh dari permintaan GET ke isi permintaan INSERT.

Jika data setelan pengiriman berubah antara permintaan GET dan permintaan INSERT, Anda akan menerima pesan error yang meminta permintaan GET lain untuk mengambil token etag terbaru. Anda harus memanggil permintaan GET untuk mengambil token etag baru dan menyalin token etag yang baru ke isi permintaan INSERT.

Tambahkan setelan pengiriman

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

Penting: Isi permintaan INSERT harus berisi isi resource lengkap dari resource shippingsettings meskipun Anda hanya memperbarui satu atribut, karena setiap NULL atau nilai yang tidak ada dalam isi permintaan akan menghasilkan nilai yang sudah ada menjadi null.

Menetapkan gudang

Contoh JSON berikut menunjukkan cara menggunakan layanan setelan Pengiriman Penjual untuk 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, atau komunitas tempat gudang berada.
• {administrative_area}: Subdivisi administratif negara. Misalnya, negara bagian.
• {postal_code}: Kode pos atau kode pos.
• {region_code}: Kode negara dalam string.
• {minutes}: Menit yang merupakan bagian dari batas waktu hingga pesanan harus diproses pada hari yang sama oleh gudang.
• {handling_days}: Jumlah hari yang diperlukan gudang ini untuk mengemas dan mengirim item.

Resource warehouses adalah daftar gudang. Setiap gudang dapat disebut dengan waktu pengiriman berbasis gudang milik layanan pengiriman hingga warehouse.name.

Kelola gudang Anda

Berikut cara menggunakan Merchant API untuk mengelola gudang:

1. Buat permintaan GET untuk mengambil semua shippingsettings dan gudang yang ada.

2. Salin shippingsettings dari permintaan GET ke permintaan UPDATE.

   Catatan: Jika Anda tidak menyalin semua shippingsettings yang ada, semuanya akan dihapus dari akun Anda dalam permintaan INSERT.

3. Isi warehouse jika Anda ingin menggunakannya di bagian warehouses untuk permintaan INSERT.

4. Buat permintaan UPDATE yang berisi resource shippingsettings dan warehouses.

Berikut adalah contoh isi permintaan INSERT dengan warehouse untuk Warehouse 1 yang diperbarui dari New York ke Mountain View:

{
  "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 di hari yang sama

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

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

Berikut adalah 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 pengiriman di hari berikutnya secara default. Untuk menonaktifkan pengiriman di hari berikutnya, tetapkan kolom no_delivery_post_cutoff ke benar (true). Jika Anda menonaktifkan pengiriman di hari berikutnya, layanan pengiriman Anda hanya akan terlihat sebelum batas waktu setiap hari.

Pengiriman di hari berikutnya hanya tersedia jika shipment_type adalah local_delivery.