Memigrasikan pengelolaan kebijakan pengembalian online

Resource Content API OnlineReturnPolicy dan kolom terkait termasuk ReturnPolicyPolicy dan ReturnPolicySeasonalOverride telah berubah.

Merchant API yang setara dengan resource returnpolicy di Content API adalah accounts.onlineReturnPolicies.

Tabel ini menjelaskan perubahan apa yang terjadi di OnlineReturnPolicy.

Content API Merchant API
"country": string "countries": [ string ]
"policy": { object (ReturnPolicyPolicy) } "policy": { object (Policy) }
"seasonalOverrides": [ { object (ReturnPolicySeasonalOverride) } ] "seasonalOverrides": [ { object (SeasonalOverride) } ],
nonFreeReturnReasons": [ string ] Kolom ini akan dihapus.
kind Kolom ini akan dihapus.
"returnShippingFee": { object (Price) } "returnShippingFee": { object (ReturnShippingFee) }

Selain itu, sejumlah kolom baru tersedia di Merchant API.

Kolom Merchant API Deskripsi
"restockingFee": { object (RestockingFee) }, Opsional. Biaya pengisian ulang stok yang berlaku untuk semua kategori alasan pengembalian. Ini akan diperlakukan sebagai biaya pengisian ulang gratis jika nilainya tidak ditetapkan.
"returnMethods": [ enum (ReturnMethod) ] Opsional. Metode pengembalian tentang cara pelanggan dapat mengembalikan item. Nilai ini harus tidak kosong kecuali jika jenis kebijakan pengembalian adalah noReturns.
"itemConditions": [ enum (ItemCondition) ], Opsional. Kondisi item yang diterima untuk pengembalian tidak boleh kosong kecuali jika jenis kebijakan pengembalian adalah noReturns.
"returnShippingFee": { object (ReturnShippingFee) } Opsional. Biaya pengiriman pengembalian. Hanya boleh ditetapkan jika pelanggan perlu mendownload dan mencetak label pengembalian.
"returnPolicyUri": string Wajib. URI kebijakan pengembalian. Google menggunakannya untuk memvalidasi kebijakan. URL harus valid.
"acceptDefectiveOnly": boolean Wajib. Menentukan bahwa penjual hanya menerima produk yang rusak untuk pengembalian.
"processRefundDays": integer Opsional. Menentukan jumlah hari yang diperlukan penjual untuk memproses pengembalian dana.
"acceptExchange": boolean Opsional. Menentukan apakah penjual mengizinkan pelanggan menukar produk.
"returnLabelSource": enum (ReturnLabelSource) Menentukan sumber label pengembalian. Wajib jika metode pengembalian adalah BY_MAIL.

ReturnPolicyPolicy

ReturnPolicyPolicy Content API menjadi Policy di Merchant API. Berikut perubahan kolom.

Content API Merchant API
"type": string, "type": enum (Type)
Nilai yang memungkinkan mencakup NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
"numberOfDays": string "days": string
"lastReturnDate": string Sebagai gantinya, gunakan days. Kolom ini menunjukkan jumlah hari item dapat dikembalikan setelah pengiriman, dengan satu hari didefinisikan sebagai 24 jam setelah stempel waktu pengiriman. Diperlukan untuk menampilkan NUMBER_OF_DAYS_AFTER_DELIVERY.

ReturnPolicySeasonalOverride

ReturnPolicySeasonalOverride Content API menjadi SeasonalOverride di Merchant API. Selain perubahan pada kolom, kolom tambahan return_window adalah gabungan yang dapat berupa returnDays atau returnUntilDate:

  "returnDays": integer,
  "returnUntilDate": {
    object (Date)

Flag ini memiliki arti sebagai berikut:

  • returnDays: Jumlah hari (terhitung sejak tanggal pengiriman) produk masih dapat dikembalikan.
  • returnUntilDate: Tanggal akhir tetap hingga produk dapat dikembalikan.

Berikut perubahan pada kolom.

Content API Merchant API
"name": string "label": string
"startDate": string "startDate": { object (Date) }
"endDate": string "endDate": { object (Date) }
"policy": { object (ReturnPolicyPolicy) } Sebagai gantinya, gunakan policy.

Definisi objek lainnya

Untuk definisi objek Merchant API baru

  • RestockingFee
  • ReturnMethod
  • ItemCondition
  • ReturnShippingFee
  • Type
  • ReturnLabelSource

lihat accounts.onlineReturnPolicies.

Metode

Dengan Merchant API, ada juga beberapa perubahan dari metode Content API.

Content API Merchant API
customBatch Dengan Mechant API, ada pendekatan yang berbeda. Lihat Memfaktorkan ulang kode untuk permintaan serentak.
delete delete
get get
insert Sebagai gantinya, gunakan create atau update.
list list