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 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 dengan inventory.set (kecuali yang eksklusif untuk localinventory). 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 resource accounts sepenuhnya, bukan hanya memperbarui kolom yang disertakan dalam permintaan. Agar kolom di resource accounts tidak dihapus, perbarui permintaan panggilan Anda agar menyertakan semua kolom.

  • reviewsUrl telah dihapus.

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

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 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. Pada 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 di 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 angka (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. Mengupdate panggilan ke layanan productstatuses

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

  • Parameter includeInvalidInsertedItems telah dihapus. productId setiap produk kini akan 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. Mengupdate 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. 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 dan ReturnRefundLineItem, amountPretax dan amountTax, masing-masing telah diganti dengan priceAmount dan taxAmount. priceAmount dapat berupa sebelum atau sesudah pajak, bergantung pada lokasi pesanan.

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

  • billingAddress dan predefinedBillingAddress kini masing-masing menjadi kolom level 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 yang dikembalikan dananya kini dihitung secara otomatis.

  • CustomBatch telah dihapus.

  • Refund telah dihapus. Gunakan refundOrder atau refundItem saja.

  • 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. Mengupdate panggilan ke layanan orderinvoice

  • Kolom amountPretax dan amountTax masing-masing telah diganti dengan priceAmount dan taxAmount. Kolom priceAmount 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, 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 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 layanan inventory di v2).

    • Layanan orderreturns baru mempermudah pengelolaan Beli dengan Google (sebelumnya disebut 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. 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 layanan productstatus:

      • 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 kolom value yang asli. Hanya satu kolom yang harus ditetapkan.