Memigrasikan pengelolaan kebijakan pengembalian online

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

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

Tabel ini menjelaskan perubahan dalam 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 dengan 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 pengiriman ulang gratis jika nilainya tidak ditetapkan.
"returnMethods": [ enum (ReturnMethod) ] Opsional. Metode pengembalian yang dapat digunakan pelanggan untuk mengembalikan item. Nilai ini tidak boleh kosong kecuali jika jenis kebijakan pengembalian adalah noReturns.
"itemConditions": [ enum (ItemCondition) ], Opsional. Kondisi item yang diterima untuk pengembalian tidak boleh kosong kecuali jenis kebijakan pengembalian adalah noReturns.
"returnShippingFee": { object (ReturnShippingFee) } Opsional. Biaya pengiriman pengembalian. Harus ditetapkan hanya jika pelanggan perlu mendownload dan mencetak label pengembalian.
"returnPolicyUri": string Wajib. URI kebijakan pengembalian. Google menggunakannya untuk memvalidasi kebijakan. Harus berupa URL yang 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

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

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

ReturnPolicySeasonalOverride

Content API ReturnPolicySeasonalOverride 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)

Nilai 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 kolomnya.

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 Merchant API, ada pendekatan yang berbeda. Lihat Memfaktorkan ulang kode untuk permintaan serentak.
delete delete
get get
insert create
list list