Memigrasikan setelan pengiriman dari Content API for Shopping

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:

1. Pengguna Merchant API harus memasukkan accounts/{accountId}/shippingSettings ke kolom {name} agar memiliki perilaku yang sama.
2. 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.
3. Cara menyiapkan WarehouseBasedDeliveryTime berbeda untuk Merchant API dan Content API for Shopping. Jika menggunakan Merchant API, Anda harus menentukan informasi gudang di bagian shippingsettings.warehouses. Kemudian, setiap layanan pengiriman dapat mereferensikan gudang melalui nama gudang di bawah warehouseBaseDeliveryTime.
4. 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:

1. Gudang: Memberikan informasi tentang gudang pemenuhan, yang menyimpan dan menangani inventaris.
2. Program loyalitas: Pengguna Merchant API dapat memasukkan informasi program loyalitas ke setelan pengiriman mereka.
3. 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 Pickup_service Eligibility Scheduling_channel Delivery_time Holiday_cutoff Min_scheduling_time_in_days Max_scheduling_time_in_days Scheduling_business_day_config Rate_group |service: Pickup_service - Eligibility - Scheduling_channel - Delivery_time - Holiday_cutoff - Min_scheduling_time_in_days - Max_scheduling_time_in_days - Scheduling_business_day_config - Rate_group - single_value_alternative_list Metode Berikut ini perbandingan metode di Content API for Shopping dan Merchant Shipping settings API: Metode Content API for Shopping API Penjual customBatch Ya Tidak get Ya Ya ubah Ya Tidak insert Tidak Ya getSupportedCarrier Ya Tidak getSupportedHolidays Ya Tidak