Menggunakan feed tambahan dengan Content API

Anda dapat menggunakan feed tambahan untuk melakukan pembaruan parsial pada data produk dengan menambahkan feedId sebagai parameter kueri saat melakukan panggilan ke products.insert, products.delete, products.custombatch.insert, dan products.custombatch.delete metode.

Misalnya, Anda dapat membuat panggilan metode feed tambahan products.insert untuk URL berikut:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

products.insert

Metode products.insert feed tambahan menambahkan kolom produk yang Anda kirimkan dalam isi permintaan, menimpa kolom tersebut jika ada. Saat menggunakan feed tambahan, metode ini tidak mengubah semua kolom produk lainnya, kecuali kolom telah disertakan dalam permintaan sebelumnya untuk feed yang sama. Meskipun data yang ditambahkan melalui feed lain tidak akan terpengaruh. Setiap permintaan akan menimpa permintaan sebelumnya permintaan untuk feed yang sama. Artinya, jika Anda menambahkan atau memperbarui kolom melalui permintaan feed tambahan, lalu tidak menyertakan kolom tersebut dalam permintaan, data untuk kolom yang dihilangkan akan dihapus dari feed. Perilaku ini berbeda dengan memanggil products.insert tanpa feed tambahan, yang menghapus semua data produk yang ada dan menggantinya dengan kolom yang Anda kirim isi permintaan.

Gunakan URL berikut untuk membuat permintaan ke feed tambahan Layanan Product.insert:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

Anda harus menyertakan offerId, feedLabel, channel, dan Kolom contentLanguage dalam isi permintaan. Semua kolom lainnya bersifat opsional.

Contoh

Untuk mengubah ketersediaan produk dari "tersedia" menjadi "stok habis", Anda dapat dapat menggunakan isi permintaan berikut untuk membuat feed tambahan Panggilan metode Product.insert:

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

Metode products.delete menghapus semua data tambahan yang sebelumnya ditambahkan oleh products.insert panggilan menggunakan feed Anda. Memanggil metode ini untuk feed tambahan tidak memengaruhi versi asli data produk yang ditambahkan sebelum feed tambahan Product.insert panggilan dilakukan. Anggap saja ini seperti menghapus lapisan data untuk feed tertentu; data yang ditambahkan melalui feed lain tidak akan terpengaruh, dan produk akan efektif kembali ke keadaan sebelumnya sebelum lapisan feed tambahan ditambahkan. Ini berbeda dengan memanggil products.delete tanpa feed tambahan, yang menghapus seluruh produk dan semua datanya.

Gunakan URL berikut untuk mengajukan permintaan feed tambahan products.delete layanan, dengan productId sebagai ID REST dari produk, direpresentasikan sebagai: channel:contentLanguage:feedLabel:offerId:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

Tidak ada isi permintaan yang diperlukan untuk panggilan metode products.delete feed tambahan.

products.custombatch

Metode custombatch memungkinkan Anda insert atau delete feed tambahan data untuk beberapa produk menggunakan satu panggilan API untuk meminimalkan jumlah API panggilan yang dilakukan.

Gunakan URL permintaan berikut untuk melakukan panggilan custombatch:

https://shoppingcontent.googleapis.com/content/v2.1/products/batch

Untuk semua panggilan custombatch feed tambahan, Anda harus menyertakan batchId, Parameter merchantID, method, dan feedId dalam permintaan {i>body <i}itu.

products.custombatch:insert

Saat melakukan panggilan feed tambahan ke metode products.custombatch:insert, Anda harus menyertakan offerId, feedLabel, channel, dan contentLanguage dalam isi permintaan, selain batchId yang diperlukan, Parameter merchantID, dan method. Semua kolom produk lainnya bersifat opsional.

Contoh

Untuk memperbarui nilai price untuk dua produk yang ada, Anda dapat menggunakan permintaan berikut untuk melakukan panggilan metode products.custombatch:insert:.

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "1111111111",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "30.99",
          "currency": "USD"
         }
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "2222222222",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "33.99",
          "currency": "USD"
         },
      },
    }
}

products.custombatch:delete

Untuk menghapus semua pembaruan yang dilakukan pada dua produk melalui feed tambahan yang ditentukan, Anda dapat menggunakan permintaan berikut untuk membuat products.custombatch:delete pemanggilan metode:

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:2222222222"
    }
  ]
}