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 bermigrasi 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.

Perbarui panggilan API Anda untuk menggunakan endpoint v2.1

Untuk melakukan panggilan ke v2.1, perbarui permintaan Anda agar 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 sesuai kebutuhan.

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 (kecuali yang eksklusif untuk localinventory). Lihat Bermigrasi ke feed tambahan untuk mengetahui detail selengkapnya.

  • Gunakan layanan localinventory baru untuk pembaruan produk lokal.

2. Memperbarui panggilan ke layanan accounts

  • Panggilan ke metode accounts.update di v2.1 akan sepenuhnya menggantikan 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 penautan inactive telah dihapus untuk adsLinks, googleMyBusinessLink, dan youtubeChannelLinks.

3. Memperbarui panggilan ke layanan products

  • Atribut kustom tidak lagi berisi jenis dan unit. Sebagai gantinya, satuan 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 disisipkan 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 dalam offerId dan menggabungkan beberapa karakter spasi kosong menjadi satu. Perubahan ini tidak memengaruhi nilai offerId 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 v2 includeAttributes 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 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 dalam status non-MFA, pajak 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 atau setelah pajak, bergantung pada lokasi pesanan.

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

  • billingAddress dan predefinedBillingAddress kini menjadi kolom tingkat teratas di orders dan TestOrder.

  • 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 saja.

  • Kolom paymentMethod telah dihapus.

  • Metode v2orders.returnlineitem dan orders.refund digantikan oleh 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. Kolom priceAmount dapat berupa harga 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 perbarui aplikasi Anda, jika perlu:

  • XML tidak lagi didukung. Untuk mengetahui informasi selengkapnya tentang 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, gunakan customBatch.

  • 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 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 update, v2.1 juga memperkenalkan beberapa fitur baru dan perubahan yang tidak merusak:

  • Layanan baru:

    • Layanan localinventory baru memungkinkan Anda melakukan update produk lokal (menggantikan layanan inventory di v2).

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

  • Feed Tambahan memungkinkan Anda melakukan pembaruan produk parsial.

  • Perubahan tambahan pada layanan products:

    • Permintaan products.insert tidak lagi melaporkan peringatan atau error non-fatal. Dengan begitu, Anda dapat 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 memperbarui serangkaian kolom produk yang dipilih. Untuk mengetahui informasi selengkapnya tentang kemungkinan penggunaan, lihat panduan.

    • Nilai 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, sehingga tidak memerlukan grup kustom.

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