Memigrasikan setelan pengiriman dari Content API for Shopping

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

Untuk menggunakan Merchant API guna membaca informasi setelan pengiriman, gunakan permintaan berikut:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

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

Untuk menggunakan Merchant API guna memperbarui informasi setelan pengiriman, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

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

Perbandingan antara Content API for Shopping dan Merchant API

Berikut contoh perbandingan Content API for Shopping dengan resource setelan pengiriman di sub-API Akun:

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
Pengenal {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

Daftar berikut menyebutkan pembaruan utama dalam resource setelan Pengiriman di sub-API Akun dibandingkan dengan Content API for Shopping:

  1. Pengguna Merchant API harus memasukkan accounts/{ACCOUNT_ID}/shippingSettings ke dalam kolom {NAME} agar memiliki perilaku yang sama.
  2. Merchant API tidak mendukung operasi baca dan tulis di area kustom, seperti grup lokasi. Area kustom seperti grup lokasi hanya dapat dibaca atau ditulis menggunakan layanan wilayah.
  3. Satu layanan di Merchant API mendukung beberapa negara pengiriman.
  4. Merchant API tidak menyediakan metode daftar untuk setelan pengiriman, tidak seperti metode shippingsettings.list di Content API.

Kolom baru yang didukung

Resource setelan pengiriman di sub-API Akun mendukung kolom baru berikut dibandingkan dengan Content API for Shopping:

  1. warehouses: Memberikan informasi tentang gudang pemenuhan pesanan, 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 resource setelan Pengiriman di sub-API Akun:

Content API for Shopping Resource setelan pengiriman Deskripsi
service services Satu layanan pengiriman.
service.name services.serviceName Nama layanan bentuk bebas 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 dihabiskan pesanan dalam transit. Misalnya, 0 berarti pengiriman pada hari yang sama dan 1 berarti pengiriman pada hari berikutnya.
service.deliveryTime.maxTransitTimeInDays services.deliveryTime.maxTransitDays Jumlah maksimum hari kerja yang dihabiskan pesanan dalam 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 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 sub-tabel.
service.rate_group.carrier_rate services.rateGroups.carrierRates Daftar tarif ekspedisi.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Daftar set kode toko yang memiliki nilai pesanan minimum yang sama.

Metode yang dihapus

Anda tidak dapat menggunakan shippingsettings.custombatch untuk mengambil dan memperbarui setelan pengiriman beberapa akun dalam satu permintaan.

Kolom yang dihapus

Kolom berikut dari Content API for Shopping dihapus di Merchant API. Merchant API tidak menyediakan alternatif untuk kolom ini.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

Metode

Berikut perbandingan metode di Content API for Shopping dan referensi setelan pengiriman:

Metode Content API for Shopping Merchant API
customBatch Ya Tidak
get Ya Ya
update Ya Tidak
insert Tidak Ya
list Ya Tidak
getSupportedCarrier Ya Tidak
getSupportedHolidays Ya Tidak
Sebelumnya
Migrate data sources management
Berikutnya
Migrate conversion sources management