API ของพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในพื้นที่

โปรแกรมพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้านช่วยให้ผู้ค้าปลีกเข้าร่วมในโฆษณาสินค้าคงคลังในร้านและข้อมูลสินค้าในร้านที่แสดงฟรีโดยไม่ต้องสร้างฟีดหลักและฟีดสินค้าคงคลังของสินค้าในร้านของตนเอง ผู้ค้าปลีกสามารถให้ข้อมูลการขายและสินค้าคงคลังแก่ผู้ให้บริการข้อมูลที่เชื่อถือได้ ซึ่งสามารถแชร์ข้อมูลดังกล่าวกับ Google ได้ ดูรายชื่อพาร์ทเนอร์ด้านข้อมูลที่รองรับได้ที่ เกี่ยวกับโปรแกรมพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้าน

คุณสามารถเพิ่มสินค้าคงคลังของผลิตภัณฑ์ในร้านได้โดยอัปโหลดฟีดสินค้าคงคลังของสินค้าในร้าน

หากต้องการเพิ่มผู้ให้บริการข้อมูลสินค้าคงคลังลงใน Merchant Center ให้ระบุ รายละเอียดที่ ความคิดเห็นของผู้ให้บริการข้อมูล ณ จุดขายเพื่อแสดงผลิตภัณฑ์ในร้านบน Google

ดูข้อมูลเกี่ยวกับการย้ายข้อมูลจาก Content API for Shopping ได้ที่ ย้ายข้อมูลพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้าน

ดึงข้อมูลสถานะการเริ่มต้นใช้งานของผู้ค้าปลีก

คุณสามารถใช้เมธอด lfpMerchantStates.get เพื่อดึงข้อมูลสถานะของพร็อพเพอร์ตี้ระดับผู้ขายที่เกี่ยวข้องกับการผสานรวมพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้าน คุณสามารถตรวจสอบได้ว่าการผสานรวมทำงานตามที่ตั้งใจไว้หรือไม่ หรือต้องดำเนินการเพิ่มเติมหรือไม่ โดยพิจารณาจากพร็อพเพอร์ตี้ที่ระบุ

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

แทรกสินค้าคงคลัง

หากต้องการแทรกสินค้าคงคลัง ให้ใช้คำขอต่อไปนี้

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": "{TARGET_MERCHANT_ID}"
}

แทนที่ค่าต่อไปนี้

  • {PARENT}: รูปแบบคือ accounts/{ACCOUNT_ID} โดยที่ {ACCOUNT_ID} คือตัวระบุที่ไม่ซ้ำกันของ บัญชี Merchant Center
  • {OFFER_ID}: ตัวระบุที่ไม่ซ้ำกันของ ผลิตภัณฑ์
  • {STORE_CODE}: ตัวระบุร้านค้าของผู้ขาย
  • {TARGET_MERCHANT_ID}: รหัสบัญชีของ ธุรกิจที่คุณต้องการส่งสินค้าคงคลัง

คุณจะเห็นการตอบกลับต่อไปนี้

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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"
}

ดูข้อมูลเพิ่มเติมได้ที่ เมธอด: accounts.lfpInventories.insert

แทรกการขาย

หากต้องการแทรกการขาย ให้ใช้คำขอต่อไปนี้

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": "{TARGET_MERCHANT_ID}"
}

แทนที่ค่าต่อไปนี้

  • {TARGET_MERCHANT_ID}: รหัสบัญชีของ ธุรกิจที่ต้องการส่งการขาย

คุณจะเห็นการตอบกลับต่อไปนี้

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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"
}

ดูข้อมูลเพิ่มเติมได้ที่ เมธอด: accounts.lfpSales.insert

แทรกร้านค้า

หากต้องการแทรกร้านค้า ให้ใช้คำขอต่อไปนี้

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

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

แทนที่ค่าต่อไปนี้

  • {STORE_CODE}: ตัวระบุที่ไม่ซ้ำกันของ ร้านค้า
  • {TARGET_MERCHANT_ID}: รหัสบัญชีของ ธุรกิจที่ต้องการส่งร้านค้า

คุณจะเห็นการตอบกลับต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ accounts.lfpStores.insert

ส่งการแจ้งเตือนไปยังผู้ค้าปลีก

คุณสามารถใช้เมธอด SendLfpNotification เพื่อส่งการแจ้งเตือนไปยังผู้ค้าปลีก เช่น คุณสามารถใช้เมธอดนี้เพื่อส่งการแจ้งเตือนการเริ่มต้นใช้งานไปยังผู้ค้าปลีก

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

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

แทนที่ค่าต่อไปนี้

  • {ACCOUNT_ID}: ตัวระบุที่ไม่ซ้ำกันของ บัญชี Merchant Center
  • {TARGETMERCHANT_ID}: ตัวระบุที่ไม่ซ้ำกัน ของบัญชีที่คุณต้องการส่งการแจ้งเตือน
  • {EMAIL_ADDRESS}: อีเมลของบัญชีที่คุณต้องการส่งการแจ้งเตือน
  • {TYPE}: คุณส่งค่าสตริง ONBOARDING_UI ในช่องนี้ได้เท่านั้น