Untuk menggunakan Merchant API guna membaca informasi setelan pengiriman, gunakan permintaan berikut:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
Ganti {accountId} dengan ID unik akun Merchant Center Anda.
Untuk menggunakan Merchant API guna membaca informasi setelan pengiriman, gunakan permintaan berikut:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Perbandingan antara Content API for Shopping dan Merchant API
Berikut ini contoh perbandingan Content API for Shopping dengan Merchant Shipping settings API:
Content API | API Penjual | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
ID | {accountId}/shippingsettings/ {accountId} |
{name} |
Daftar berikut menyebutkan pembaruan utama pada Merchant Shipping settings API dibandingkan dengan Content API for Shopping:
- Pengguna Merchant API harus memasukkan
accounts/{accountId}/shippingSettings
ke kolom {name} agar memiliki perilaku yang sama. - Merchant API tidak mendukung operasi baca dan tulis di area kustom, seperti grup lokasi. Area khusus seperti grup lokasi hanya dapat dibaca atau ditulis menggunakan layanan region.
- Cara menyiapkan
WarehouseBasedDeliveryTime
berbeda untuk Merchant API dan Content API for Shopping. Jika menggunakan Merchant API, Anda harus menentukan informasi gudang di bagianshippingsettings.warehouses
. Kemudian, setiap layanan pengiriman dapat mereferensikan gudang melalui nama gudang di bawahwarehouseBaseDeliveryTime
. - Satu layanan di Merchant API mendukung beberapa negara pengiriman.
Kolom baru yang didukung
API setelan Pengiriman Penjual mendukung kolom baru berikut dibandingkan dengan Content API for Shopping:
- Gudang: Memberikan informasi tentang gudang pemenuhan, yang menyimpan dan menangani inventaris.
- Program loyalitas: Pengguna Merchant API dapat memasukkan informasi program loyalitas ke setelan pengiriman mereka.
- Etag: Etag dirancang untuk menyelesaikan masalah asinkron saat pengguna yang berbeda mencoba memperbarui setelan pengiriman menggunakan Merchant API dan UI Merchant Center secara bersamaan.
Kolom yang diganti namanya
Kolom berikut telah diganti namanya di Merchant API:
Content API for Shopping | API setelan Pengiriman Penjual | Deskripsi |
---|---|---|
service |
services |
Layanan pengiriman tunggal. |
service.name |
services.serviceName |
Nama dalam format bebas layanan yang harus unik dalam akun Merchant Center Anda. |
service.deliveryCountry |
services.deliveryCountries |
Kode wilayah CLDR negara tempat layanan pengiriman berlaku. |
service.currency |
services.currencyCode |
Kode CLDR mata uang yang berlaku untuk layanan ini. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
Jumlah minimum hari kerja yang dibelanjakan pesanan saat transit. Misalnya, 0 berarti pengiriman di hari yang sama dan 1 berarti pengiriman di hari berikutnya. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
Jumlah maksimum hari kerja yang dibelanjakan pesanan saat transit. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Jumlah minimum hari kerja yang dihabiskan sebelum pesanan dikirim. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirim. |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
ID zona waktu untuk waktu batas. |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
Nama grup kode pos. |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
Label waktu transit produk. |
service.rate_group |
services.rateGroups |
Definisi grup tarif pengiriman. |
service.rate_group.subtable |
services.rateGroups.subtables |
Daftar subtabel. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
Daftar tarif ekspedisi. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
Daftar rangkaian kode toko dengan nilai pesanan minimum yang sama. |
Metode yang tidak digunakan lagi
Anda tidak dapat menggunakan shippingsettings.custombatch
untuk mengambil dan memperbarui setelan pengiriman beberapa akun dalam satu permintaan.
Kolom yang tidak digunakan lagi
Kolom berikut tidak digunakan lagi di Merchant API. Perhatikan bahwa Merchant API tidak menyediakan alternatif untuk kolom ini.
Content API for Shopping | API Penjual | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| MetodeBerikut ini perbandingan metode di Content API for Shopping dan Merchant Shipping settings API:
|