Bermigrasi dari Content API v2 ke v2.1

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 pembaruan URL endpoint untuk memanggil versi v2.1 baru dan memodifikasi aplikasi Anda untuk memperhitungkan perubahan yang tidak kompatibel yang diperkenalkan di v2.1.

Memperbarui panggilan API untuk menggunakan endpoint v2.1

Untuk melakukan panggilan ke v2.1, perbarui permintaan Anda untuk menggunakan endpoint v2.1 baru.

Misalnya, untuk memanggil metode products.get dengan v2, Anda akan menggunakan:

GET https://shoppingcontent.googleapis.com/content/v2/merchantId/products/productId

Untuk v2.1, perbarui URL ke:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId

Untuk mengetahui informasi lengkap tentang layanan dan endpoint v2.1, lihat Referensi API.

Membuat perubahan yang diperlukan

Selain memperbarui URL untuk panggilan API, Anda juga perlu memperbarui aplikasi untuk memperhitungkan beberapa perubahan yang tidak kompatibel yang diperkenalkan di v2.1. Tinjau bagian berikut dan perbarui aplikasi Anda, jika diperlukan.

1. Memperbarui integrasi dengan layanan inventory

Layanan inventory v2 telah dihapus, dan fungsi yang setara tersedia dengan fitur v2.1 berikut:

  • Gunakan Feed Tambahan baru atau products.update untuk pembaruan produk sebagian. Pembaruan dapat dilakukan pada semua kolom produk yang dapat diubah, termasuk semua kolom yang sebelumnya diperbarui dengan inventory.set (tidak termasuk kolom yang eksklusif untuk localinventory). Lihat Bermigrasi ke feed tambahan untuk mengetahui detail selengkapnya.

  • Gunakan layanan baru localinventory untuk pembaruan produk lokal.

2. Memperbarui panggilan ke layanan accounts

  • Panggilan ke metode accounts.update di v2.1 akan sepenuhnya menimpa resource accounts, bukan hanya memperbarui kolom yang disertakan dalam permintaan. Untuk menghindari penghapusan kolom pada resource accounts, perbarui permintaan panggilan Anda untuk menyertakan semua kolom.

  • reviewsUrl telah dihapus.

  • Status link inactive telah dihapus untuk adsLinks, googleMyBusinessLink, dan youtubeChannelLinks.

3. Memperbarui panggilan ke layanan products

  • Atribut kustom tidak lagi berisi jenis dan unit. Sebagai gantinya, unit harus ditambahkan ke nilai dan jenis harus terdeteksi secara otomatis.

  • Kolom berulang productTypes telah menggantikan productType dan additionalProductTypes.

  • Kolom berulang includedDestinations dan excludedDestinations telah menggantikan kolom berulang destinations.

  • 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. Di v2.1, semua produk ditampilkan secara default.

  • Sekarang ada penundaan beberapa menit sebelum produk yang dimasukkan dapat diambil melalui products.get atau products.list.

  • offerId yang ditampilkan tidak lagi dijamin sama dengan offerId input. v2.1 memangkas spasi kosong di awal dan akhir di offerId dan menggabungkan beberapa karakter spasi kosong menjadi satu. Perubahan ini tidak memengaruhi offerId nilai yang sesuai dengan sintaksis offerId yang direkomendasikan.

  • Harga kini divalidasi sebelum penyisipan produk. Hanya karakter berikut yang diizinkan dalam string nilai: +, -, ., dan digit (yaitu, 0-9). Koma tidak lagi diterima.

  • Respons dari panggilan products.insert atau products.update hanya berisi atribut berikut:

    • channel
    • contentLanguage
    • id
    • offerId
    • feedLabel

  • Opsi includeAttributes v2 tidak digunakan lagi. Sebagai gantinya, gunakan products.get dengan ProductId untuk melihat informasi produk lengkap.

4. Memperbarui panggilan ke layanan productstatuses

  • Atribut product telah dihapus, bersama dengan parameter includeAttributes. Untuk mengambil atribut produk yang sesuai dengan status, gunakan layanan products dan teruskan nilai kolom productId baru.

  • Parameter includeInvalidInsertedItems telah dihapus. productId setiap produk kini ditampilkan, terlepas dari apakah produk tersebut valid atau tidak.

  • Kolom intention, approvalStatus, dan approvalPending di destinationStatuses telah diganti dengan status, yang merupakan string yang dapat berupa salah satu dari approved, disapproved, atau pending.

  • dataQualityIssues telah diganti dengan itemLevelIssues.

5. Memperbarui panggilan ke layanan datafeeds

  • Kolom target berikut telah diganti:

    • contentLanguage -> language
    • targetCountry -> country
    • intendedDestinations -> includedDestinations, dan excludedDestinations

  • Feed data dengan contentType = "product inventory update" telah dihapus.

6. Memperbarui panggilan ke layanan orders dan TestOrders

  • Di v2.1, panggilan tidak boleh menyertakan data pajak karena data pajak dihitung secara otomatis. Jika pesanan dipenuhi di negara bagian dengan Marketplace Fairness Act (MFA) atau yang serupa, panggilan yang menyertakan data pajak akan gagal. Jika pesanan dipenuhi di negara bagian non-MFA, pajak akan dihitung berdasarkan setelan yang dikonfigurasi di Merchant Center. Jika tidak dikonfigurasi, pajak yang dihitung adalah 0.

  • Kolom InStoreRefundLineItem dan ReturnRefundLineItem amountPretax dan amountTax telah diganti dengan priceAmount dan taxAmount, masing-masing. priceAmount dapat berupa harga sebelum pajak atau harga setelah pajak, bergantung pada lokasi pesanan.

  • Kolom ShipLineItem carrier, shipmentId, dan trackingId dalam permintaan telah dipindahkan ke shipmentInfos.

  • billingAddress dan predefinedBillingAddress kini merupakan kolom tingkat atas di orders dan TestOrder, masing-masing.

  • customer.explicitMarketingPreference telah diganti dengan customer.marketingRightsInfo.

  • Kolom netAmount telah dibagi menjadi netPriceAmount dan netTaxAmount.

  • shippingOption telah diganti dengan lineItems[].shippingDetails.

  • Kolom CancelLineItem amount, amountPretax, dan amountTax dalam permintaan telah dihapus. Jumlah pengembalian dana kini dihitung secara otomatis.

  • CustomBatch telah dihapus.

  • Refund telah dihapus. Gunakan refundOrder atau refundItem sebagai gantinya.

  • Kolom paymentMethod telah dihapus.

  • Metode v2 orders.returnlineitem dan orders.refund diganti dengan orderreturns.creatOrderReturn dan orderreturns.process.

  • Kolom customer.email, channelType, dan lineItem.product.channel telah dihapus.

  • Kolom promotions telah dihapus dari layanan TestOrder dan formatnya diubah di Order.

7. Memperbarui panggilan ke layanan orderinvoice

  • Kolom amountPretax dan amountTax telah diganti dengan priceAmount dan taxAmount, masing-masing. Kolom priceAmount dapat berupa harga sebelum pajak atau harga setelah pajak, bergantung pada lokasi pesanan.

  • Saldo yang dihapus (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 perbarui aplikasi Anda, jika diperlukan:

  • XML tidak lagi 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. Gunakan customBatch sebagai gantinya.

  • Metode patch telah dihapus dari layanan berikut:

    • accounts
    • accounttax
    • datafeeds
    • liasettings
    • shippingsettings

  • Layanan orderpayments telah dihapus.

Menguji migrasi

Untuk mengetahui informasi selengkapnya tentang cara menguji perubahan pada aplikasi Anda setelah bermigrasi ke v2.1, lihat Menguji Penggunaan Content API for Shopping. Jika Anda mengalami masalah saat menguji pembaruan, Anda dapat menghubungi kami.

Perubahan tambahan di v2.1

Selain perubahan yang memerlukan pembaruan, v2.1 juga memperkenalkan beberapa fitur baru dan perubahan yang tidak kompatibel:

  • Layanan baru:

    • Layanan localinventory baru memungkinkan Anda melakukan pembaruan produk lokal (sebagai pengganti layanan inventory di v2).

    • Layanan orderreturns baru memudahkan pengelolaan Beli dengan Google (sebelumnya dikenal sebagai Shopping Actions) dengan memungkinkan Anda memproses pengembalian tanpa harus menggunakan layanan orders.

  • Feed Tambahan memungkinkan Anda melakukan pembaruan produk sebagian.

  • Perubahan tambahan pada layanan products:

    • Permintaan products.insert tidak lagi melaporkan error atau peringatan non-fatal. Hal ini memungkinkan Anda menyisipkan produk dan melakukan pembaruan berikutnya untuk menyelesaikan masalah melalui aturan feed di Merchant Center, seperti yang biasa Anda lakukan pada feed yang dikelola di luar Content API.

    • products.update telah ditambahkan untuk memungkinkan Anda 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 layanan productstatus:

      • ageGroup
      • availability
      • condition
      • energyEfficiencyClass
      • gender
      • maxEnergyEfficiencyClass
      • minEnergyEfficiencyClass
      • sizeSystem
      • sizeType

    • Atribut kustom kini bersifat rekursif, yang menghilangkan kebutuhan akan grup kustom.

    • Atribut kustom kini memiliki kolom groupValues selain kolom value asli. Tepatnya salah satu kolom harus ditetapkan.