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 ke 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. Feed inventaris produk lokal memberikan daftar item yang dapat dijual di toko dengan atribut untuk mendeskripsikannya.

Agar penyedia data inventaris Anda ditambahkan ke Merchant Center, berikan detailnya di formulir ini.

Mengambil status aktivasi retailer

Anda dapat menggunakan metode GetLfpState untuk mengambil status properti tingkat penjual yang terkait dengan integrasi kemitraan feed lokal. Berdasarkan properti yang diberikan, Anda dapat memeriksa apakah integrasi berfungsi seperti yang diinginkan atau apakah tindakan tambahan diperlukan.

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

Menyisipkan inventaris

Untuk menyisipkan inventaris, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

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 promo

Untuk menyisipkan promo, gunakan permintaan berikut:

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

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/v1beta/{PARENT}/lfpStores:insert

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

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 mengetahui informasi selengkapnya, lihat Metode: 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 orientasi kepada retailer.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

Ganti kode berikut:

• {accountId}: ID unik akun Merchant Center Anda
• {targetMerchantId}: ID unik akun yang ingin Anda kirimi notifikasi
• {emailAddress}: Alamat email akun yang ingin Anda kirimi notifikasi
• {Type}: Anda hanya dapat meneruskan nilai string ONBOARDING_UI di kolom ini