Menetapkan waktu pengiriman produk

Waktu pengiriman produk adalah perkiraan waktu yang diperlukan agar pesanan dikirimkan setelah dibuat. Partner sinyal pengiriman dapat menggunakan fitur ini untuk menetapkan waktu pengiriman untuk wilayah tertentu atas nama penjual yang berpartner dengan mereka.

Penting: Penjual tidak dapat mengedit ProductDeliveryTime secara langsung. Metode create dan delete menampilkan error jika pemohon adalah penjual, bukan partner sinyal pengiriman.

Partner sinyal pengiriman dapat menggunakan referensi ini untuk menetapkan waktu pengiriman bagi pasangan penawaran-wilayah, dan untuk melihat atau menghapus waktu pengiriman yang ada atas nama penjual yang tertaut. Satu resource ProductDeliveryTime menyimpan beberapa waktu pengiriman, dan hanya boleh ada satu instance ProductDeliveryTime per penawaran.

Untuk menggunakan resource ProductDeliveryTime, lakukan autentikasi sebagai akun Merchant Center Anda sendiri, bukan akun penjual yang Anda perbarui.

create

Partner sinyal pengiriman dapat membuat atau memperbarui waktu pengiriman produk dengan memanggil create dengan merchantIdakun penjual yang akan diperbarui, dan instance ProductDeliveryTime. Untuk memperbarui waktu pengiriman produk yang ada, pastikan Anda memberikan semua kolom ProductDeliveryTime, termasuk kolom yang belum diubah. Setiap permintaan create menimpa instance sebelumnya, sehingga kolom yang tidak Anda sertakan akan hilang. Metode ini menampilkan instance ProductDeliveryTime dengan informasi terbaru yang Anda kirimkan.

Setiap ProductDeliveryTime dapat memiliki maksimal 100 entri areaDeliveryTimes.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

Berikut adalah contoh isi permintaan:

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

Dapatkan waktu pengiriman produk dengan memanggil get menggunakan merchantId penjual dan productId. Metode ini menampilkan instance ProductDeliveryTime untuk productId yang diberikan.

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

hapus

Partner sinyal pengiriman dapat menghapus waktu pengiriman produk dengan memanggil delete dengan merchantId penjual dan productId. Metode ini menampilkan respons kosong.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId