API kemitraan feed lokal

Program kemitraan feed lokal memungkinkan retailer berpartisipasi dalam iklan inventaris lokal dan listingan produk lokal gratis tanpa harus membuat feed inventaris produk lokal dan utama mereka sendiri. Retailer dapat memberikan informasi penjualan dan inventaris mereka kepada penyedia data tepercaya yang dapat membagikan informasi tersebut kepada Google. Untuk mengetahui daftar partner data yang didukung, lihat Tentang program kemitraan feed lokal.

Anda dapat menambahkan inventaris produk lokal dengan mengupload feed inventaris produk lokal.

Agar penyedia data inventaris Anda ditambahkan ke Merchant Center, berikan detail Anda di Masukan Penyedia Data Tempat Penjualan untuk menampilkan produk lokal di Google.

Untuk mempelajari migrasi dari Content API for Shopping, lihat Memigrasikan kemitraan feed lokal.

Mengambil status aktivasi retailer

Anda dapat menggunakan metode lfpMerchantStates.get untuk mengambil status properti tingkat penjual yang terkait dengan integrasi kemitraan feed lokal. Berdasarkan properti yang diberikan, Anda dapat memeriksa apakah integrasi berfungsi sebagaimana mestinya atau apakah ada tindakan tambahan yang diperlukan.

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Menyisipkan inventaris

Untuk menyisipkan inventaris, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Ganti kode berikut:

  • {PARENT}: Formatnya adalah accounts/{ACCOUNT_ID}, dengan {ACCOUNT_ID} adalah ID unik akun Merchant Center.
  • {OFFER_ID}: ID unik produk.
  • {STORE_CODE}: ID toko penjual.
  • {TARGETMERCHANT_ID}: ID akun bisnis yang ingin Anda kirimi inventaris.

Anda akan melihat respons berikut:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.lfpInventories.insert.

Menyisipkan penjualan

Untuk menyisipkan penjualan, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Ganti kode berikut:

  • {TARGETMERCHANT_ID}: ID akun bisnis yang akan mengirimkan penjualan.

Anda akan melihat respons berikut:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.lfpSales.insert

Menyisipkan toko

Untuk menyisipkan toko, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Ganti kode berikut:

  • {STORE_CODE}: ID unik toko.
  • {TARGETMERCHANT_ID}: ID akun bisnis yang akan mengirimkan toko.

Anda akan melihat respons berikut:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

Untuk informasi selengkapnya, lihat accounts.lfpStores.insert.

Mengirim notifikasi ke retailer

Anda dapat menggunakan metode SendLfpNotification untuk mengirim notifikasi ke retailer. Misalnya, Anda dapat menggunakan metode ini untuk mengirim notifikasi aktivasi kepada retailer.

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

Ganti kode berikut:

  • {ACCOUNT_ID}: ID unik akun Merchant Center Anda.
  • {TARGETMERCHANT_ID}: ID unik akun yang ingin Anda kirimi notifikasi.
  • {EMAIL_ADDRESS}: Alamat email akun yang ingin Anda kirimi notifikasi.
  • {TYPE}: Anda hanya dapat meneruskan nilai string ONBOARDING_UI di kolom ini.