Memigrasikan setelan pengiriman dari Content API for Shopping

Tujuan ShippingSettings memungkinkan Anda mengambil dan memperbarui setelan pengiriman akun dan semua sub-akun yang terkait dengannya. Untuk informasi selengkapnya tentang cara menambahkan atau mengelola setelan pengiriman akun Anda, lihat Ringkasan pengiriman setelan.

Agar dapat menggunakan Merchant API untuk membaca informasi setelan pengiriman, gunakan hal berikut permintaan:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

Ganti {accountId} dengan ID unik Anda akun Merchant Center Anda.

Agar dapat menggunakan Merchant API untuk membaca informasi setelan pengiriman, gunakan hal berikut permintaan:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

Untuk informasi selengkapnya, lihat Metode: accounts.shippingSettings.insert.

Perbandingan antara Content API for Shopping dan Merchant API

Berikut contoh perbandingan Content API for Shopping dengan Penjual API setelan pengiriman:

	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
Pengenal	{accountId}/shippingsettings/{accountId}	{name}

Daftar berikut menyebutkan update besar di Merchant Shipping settings API dibandingkan dengan Content API for Shopping:

1. Pengguna API Merchant harus memasukkan accounts/{accountId}/shippingSettings ke dalam {name} agar memiliki perilaku yang sama.
2. Merchant API tidak mendukung operasi baca dan tulis di area kustom, seperti sebagai grup lokasi. Area khusus seperti grup lokasi hanya dapat dibaca atau yang ditulis menggunakan layanan region.
3. Cara menyiapkan WarehouseBasedDeliveryTime berbeda untuk Merchant API dibandingkan dengan Content API for Shopping. Jika Anda menggunakan Merchant API, Anda harus menentukan informasi gudang berdasarkan 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

Merchant Shipping settings API mendukung kolom baru berikut dibandingkan dengan Content API for Shopping:

1. Pergudangan: Memberikan informasi tentang gudang pemenuhan, yang menyimpan dan menangani inventaris.
2. Program loyalitas: Pengguna Merchant API dapat memasukkan informasi program loyalitas untuk setelan pengirimannya.
3. Etag: Etag dirancang untuk menyelesaikan masalah asinkron saat berbagai pengguna mencoba perbarui setelan pengiriman menggunakan Merchant API dan UI Merchant Center di perangkat lain di waktu yang sama.

Kolom yang telah 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 layanan bentuk bebas yang harus unik di 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 menggunakan layanan ini.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Jumlah hari kerja minimum yang dihabiskan pesanan dalam pengiriman. Misalnya, 0 berarti pengiriman di hari yang sama dan 1 berarti pengiriman di hari berikutnya.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Jumlah hari kerja maksimum yang dihabiskan pesanan dalam pengiriman.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Jumlah hari kerja minimum yang dihabiskan sebelum pesanan dikirimkan.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirimkan.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	ID zona waktu untuk batas waktu.
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 set 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 dari Content API tidak digunakan lagi di Merchant API. Penjual API tidak menyediakan alternatif untuk kolom ini.

• postal_code_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 adalah perbandingan metode dalam Content API for Shopping dan API setelan Pengiriman Penjual:

Metode	Content API for Shopping	API Penjual
customBatch	Ya	Tidak
get	Ya	Ya
update	Ya	Tidak
insert	Tidak	Ya
getSupportedCarrier	Ya	Tidak
getSupportedHolidays	Ya	Tidak