Pada Maret 2019, kami merilis Content API for Shopping versi 2.1, dan pada April 2021, kami mengumumkan bahwa v2 akan dihentikan pada 30 September 2021. Versi v2 telah dihentikan. Segera migrasikan ke v2.1.
Memigrasikan aplikasi Anda
Migrasi dari v2 ke v2.1 melibatkan update URL endpoint untuk memanggil versi v2.1 yang baru dan memodifikasi aplikasi untuk memperhitungkan perubahan yang dapat menyebabkan gangguan yang diperkenalkan pada v2.1.
Mengupdate panggilan API untuk menggunakan endpoint v2.1
Untuk melakukan panggilan ke v2.1, perbarui permintaan Anda agar menggunakan endpoint v2.1 yang baru.
Misalnya, untuk memanggil metode products.get
dengan v2, gunakan:
GET https://shoppingcontent.googleapis.com/content/v2/merchantId/products/productId
Untuk v2.1, perbarui URL menjadi:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId
Untuk mendapatkan informasi lebih lanjut tentang layanan dan endpoint v2.1, baca Referensi API.
Membuat perubahan yang diperlukan
Selain mengupdate URL untuk panggilan API, Anda juga harus mengupdate aplikasi untuk memperhitungkan beberapa perubahan yang dapat menyebabkan gangguan yang diperkenalkan di v2.1. Tinjau bagian berikut dan perbarui permohonan Anda, jika perlu.
1. Perbarui integrasi dengan layanan inventory
Layanan inventory
v2 telah dihapus, dan fungsi yang setara
tersedia dengan fitur v2.1 berikut:
Gunakan Feed Tambahan atau
products.update
baru untuk pembaruan produk sebagian. Pembaruan dapat dilakukan pada semua kolom produk yang dapat berubah, termasuk semua kolom yang sebelumnya diperbarui denganinventory.set
(kecuali yang eksklusif untuklocalinventory
). Lihat Bermigrasi ke feed tambahan untuk mengetahui detail selengkapnya.Gunakan layanan
localinventory
baru untuk info terbaru produk lokal.
2. Mengupdate panggilan ke layanan accounts
Panggilan ke metode
accounts.update
di v2.1 akan menimpa resourceaccounts
sepenuhnya, bukan hanya memperbarui kolom yang disertakan dalam permintaan. Agar kolom di resourceaccounts
tidak dihapus, perbarui permintaan panggilan Anda agar menyertakan semua kolom.reviewsUrl
telah dihapus.Status link
inactive
telah dihapus untukadsLinks
,googleMyBusinessLink
, danyoutubeChannelLinks
.
3. Mengupdate panggilan ke layanan products
Atribut khusus tidak lagi berisi jenis dan unit. Sebagai gantinya, satuan akan ditambahkan ke nilai dan jenis harus dideteksi secara otomatis.
Kolom berulang
productTypes
telah menggantikanproductType
danadditionalProductTypes
.Kolom berulang
includedDestinations
danexcludedDestinations
telah menggantikan kolom berulangdestinations
.Kolom terkait AdWords berikut telah diganti namanya:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
Kolom berikut telah dihapus:
aspects
destinations
onlineOnly
validatedDestinations
warnings
Parameter
includeInvalidInsertedItems
telah dihapus. Pada v2.1, semua produk ditampilkan secara default.Sekarang ada penundaan beberapa menit sebelum produk yang dimasukkan dapat diambil melalui
products.get
atauproducts.list
.offerId
yang ditampilkan tidak lagi dijamin sama denganofferId
input. v2.1 memangkas spasi kosong di awal dan di akhir dalamofferId
dan menggabungkan beberapa karakter spasi kosong menjadi satu. Perubahan ini tidak memengaruhi nilaiofferId
yang sesuai dengan sintaksisofferId
yang direkomendasikan.Harga kini divalidasi sebelum penyisipan produk. Hanya karakter berikut yang diizinkan dalam string nilai:
+
,-
,.
, dan angka (yaitu,0
-9
). Koma tidak lagi diterima.Respons dari panggilan
products.insert
atauproducts.update
hanya berisi atribut berikut:channel
contentLanguage
id
offerId
feedLabel
Opsi v2
includeAttributes
tidak digunakan lagi. Sebagai gantinya, gunakanproducts.get
denganProductId
untuk melihat informasi produk lengkap.
4. Mengupdate panggilan ke layanan productstatuses
Atribut
product
telah dihapus, beserta parameterincludeAttributes
. Untuk mengambil atribut produk yang sesuai dengan suatu status, gunakan layananproducts
dan teruskan nilai kolomproductId
yang baru.Parameter
includeInvalidInsertedItems
telah dihapus.productId
setiap produk kini akan ditampilkan, terlepas dari apakah produk tersebut valid atau tidak.Kolom
intention
,approvalStatus
, danapprovalPending
didestinationStatuses
telah diganti denganstatus
, yang merupakan string yang dapat berupa salah satu dariapproved
,disapproved
, ataupending
.dataQualityIssues
telah diganti denganitemLevelIssues
.
5. Mengupdate panggilan ke layanan datafeeds
Kolom target berikut telah diganti:
contentLanguage
->language
targetCountry
->country
intendedDestinations
->includedDestinations
, danexcludedDestinations
Feed data dengan
contentType = "product inventory update"
telah dihapus.
6. Mengupdate panggilan ke layanan orders
dan TestOrders
Pada v2.1, panggilan tidak boleh menyertakan data pajak karena data pajak dihitung secara otomatis. Jika pesanan dipenuhi di negara bagian yang memberlakukan Marketplace Fairness Act (MFA) atau yang serupa, panggilan yang menyertakan data pajak akan gagal. Jika pesanan dipenuhi dalam negara bagian non-MFA, pajak akan dihitung berdasarkan setelan yang dikonfigurasi di Merchant Center. Jika tidak dikonfigurasi, pajak yang dihitung adalah 0.
Kolom
InStoreRefundLineItem
danReturnRefundLineItem
,amountPretax
danamountTax
, masing-masing telah diganti denganpriceAmount
dantaxAmount
.priceAmount
dapat berupa sebelum atau sesudah pajak, bergantung pada lokasi pesanan.Kolom
ShipLineItem
carrier
,shipmentId
, dantrackingId
dalam permintaan telah dipindahkan keshipmentInfos
.billingAddress
danpredefinedBillingAddress
kini masing-masing menjadi kolom level teratas diorders
danTestOrder
.customer.explicitMarketingPreference
telah diganti dengancustomer.marketingRightsInfo
.Kolom
netAmount
telah dibagi menjadinetPriceAmount
dannetTaxAmount
.shippingOption
telah diganti denganlineItems[].shippingDetails
.Kolom
CancelLineItem
amount
,amountPretax
, danamountTax
dalam permintaan telah dihapus. Jumlah yang dikembalikan dananya kini dihitung secara otomatis.CustomBatch
telah dihapus.Refund
telah dihapus. GunakanrefundOrder
ataurefundItem
saja.Kolom
paymentMethod
telah dihapus.Metode v2
orders.returnlineitem
danorders.refund
diganti denganorderreturns.creatOrderReturn
danorderreturns.process
.Kolom
customer.email
,channelType
, danlineItem.product.channel
telah dihapus.Kolom
promotions
telah dihapus dari layananTestOrder
dan formatnya diubah diOrder
.
7. Mengupdate panggilan ke layanan orderinvoice
Kolom
amountPretax
danamountTax
masing-masing telah diganti denganpriceAmount
dantaxAmount
. KolompriceAmount
dapat berupa sebelum pajak atau setelah pajak, bergantung pada lokasi pesanan.Menghapus saldo (penjual, pelanggan, Google) di
invoiceSummary
dan kolom terkait biaya promosi.
8. Menghapus fungsi yang tidak disertakan dalam v2.1
Beberapa fitur lainnya telah dihapus dari Content API di v2.1. Tinjau daftar berikut dan update aplikasi Anda sesuai kebutuhan:
XML sudah tidak didukung. Untuk mengetahui informasi selengkapnya tentang cara beralih ke JSON, lihat Penghentian dukungan XML di Content API for Shopping.
Parameter
dryRun
telah dihapus. Perubahan ini berlaku untuk semua panggilan API.Semua metode
HTTP BATCH
telah dihapus. Sebagai gantinya, gunakancustomBatch
.Metode
patch
telah dihapus dari layanan berikut:accounts
accounttax
datafeeds
liasettings
shippingsettings
Layanan
orderpayments
telah dihapus.
Menguji migrasi Anda
Untuk mengetahui informasi selengkapnya tentang pengujian perubahan pada aplikasi Anda setelah bermigrasi ke v2.1, lihat Menguji Penggunaan Content API for Shopping. Jika mengalami masalah saat menguji update, Anda dapat memposting masalah tersebut di forum Content API.
Perubahan lainnya di v2.1
Selain perubahan yang memerlukan update, v2.1 juga memperkenalkan beberapa fitur baru dan perubahan yang tidak menyebabkan gangguan:
Layanan baru:
Layanan
localinventory
baru memungkinkan Anda melakukan pembaruan produk lokal (sebagai pengganti layananinventory
di v2).Layanan
orderreturns
baru mempermudah pengelolaan Beli dengan Google (sebelumnya disebut Shopping Actions) dengan memungkinkan Anda memproses pengembalian tanpa harus menggunakan layananorders
.
Feed Tambahan memungkinkan Anda melakukan pembaruan produk sebagian.
Perubahan tambahan pada layanan
products
:Permintaan
products.insert
tidak lagi melaporkan error atau peringatan non-fatal. Dengan demikian, Anda dapat menyisipkan produk dan melakukan pembaruan berikutnya untuk menyelesaikan masalah melalui aturan feed di Merchant Center, seperti yang Anda lakukan pada feed yang dikelola di luar Content API.products.update
telah ditambahkan agar Anda dapat melakukan pembaruan pada kumpulan kolom produk yang dipilih. Untuk mengetahui informasi selengkapnya tentang kemungkinan penggunaan, lihat panduan.Nilai yang tidak valid untuk atribut berikut tidak lagi memicu error penyisipan, dan ditampilkan sebagai bagian dari
itemLevelIssues
oleh layananproductstatus
:ageGroup
availability
condition
energyEfficiencyClass
gender
maxEnergyEfficiencyClass
minEnergyEfficiencyClass
sizeSystem
sizeType
Atribut khusus kini bersifat berulang, yang menghilangkan kebutuhan akan grup kustom.
Atribut khusus kini memiliki kolom
groupValues
, selain kolomvalue
yang asli. Hanya satu kolom yang harus ditetapkan.