ย้ายข้อมูลการตั้งค่าโฆษณาสินค้าคงคลังในร้าน (LIA)

หากคุณใช้การตั้งค่าโฆษณาสินค้าคงคลังในร้านใน Shopping Content API โปรดทราบว่า Merchant API มีการเปลี่ยนแปลงที่สำคัญหลายประการ

ตอนนี้การตั้งค่า LIA เป็นส่วนหนึ่งของคอมโพเนนต์หลัก 1 ใน 3 รายการ ซึ่งแต่ละรายการมีทรัพยากรที่เกี่ยวข้อง

คอมโพเนนต์หลัก แหล่งข้อมูล
การกําหนดค่าบัญชีสําหรับการแสดงโฆษณาแบบ Omnichannel OmnichannelSetting
การเชื่อมต่อกับพาร์ทเนอร์พาร์ทเนอร์ทางธุรกิจสำหรับฟีดในพื้นที่ (LFP) เพื่อรับข้อมูลสินค้าคงคลัง LfpProvider
การเชื่อมต่อกับบัญชี Google Business Profile (GBP) สำหรับข้อมูลร้านค้าในพื้นที่ GbpAccount

นอกจากนี้ การตั้งค่า LIA ยังมีทรัพยากรเพียงรายการเดียวต่อบัญชี และมีรายการการตั้งค่าสำหรับนิติบุคคลในประเทศแต่ละราย OmnichannelSettings ช่วยให้คุณเชื่อมโยงทรัพยากรหลายรายการกับบัญชีได้ แหล่งข้อมูลแต่ละรายการแสดงการตั้งค่าสำหรับนิติบุคคลในประเทศหนึ่งๆ

การเปลี่ยนแปลงเกี่ยวกับคำขอและทรัพยากรมีดังนี้

คำขอ

โดเมนใหม่ ชื่อเมธอด Content API ชื่อเมธอด Merchant API
accounts.omnichannelSettings liasettings.custombatch วิธีนี้จะหยุดให้บริการ Merchant API รองรับความสามารถในการส่งคำขอหลายรายการพร้อมกัน
liasettings.get accounts.omnichannelSettings.list
liasettings.list วิธีการรับการตั้งค่า LIA ทั้งหมดสําหรับบัญชีย่อยทั้งหมดจะใช้ไม่ได้โดยตรงอีกต่อไป แต่ให้ค้นหาบัญชีย่อยทั้งหมดและใช้ accounts.omnichannelSettings.list เพื่อรับ omnichannelSettings ของบัญชีย่อยที่ต้องการ
liasettings.update accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
liasettings.requestinventoryverification accounts.omnichannelSettings.requestInventoryVerification
liasettings.setinventoryverificationcontact วิธีนี้จะหยุดให้บริการ แต่ให้ใช้ accounts.omnichannelSettings.create หรือ accounts.omnichannelSettings.update ที่มีมาสก์ที่อัปเดตแล้วแทน
liasettings.setomnichannelexperience วิธีนี้จะหยุดให้บริการ แต่ให้ใช้ accounts.omnichannelSettings.create หรือ accounts.omnichannelSettings.update ที่มีมาสก์ที่อัปเดตแล้วแทน
accounts.omnichannelSettings.lfpProvider liasettings.listposdataproviders accounts.omnichannelSettings.lfpProviders.findLfpProviders
liasettings.setposdataprovider accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount liasettings.getaccessiblegmbaccounts accounts.gbpAccount.list
liasettings.requestgmbaccess accounts.gbpAccount.linkGbpAccount

แหล่งข้อมูล

นอกจากนี้ บริการจะทำงานแตกต่างกันสำหรับ PickupType ดูหัวข้อการรับสินค้า

OmnichannelSetting

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
(ไม่มี) (ไม่มี) name string ชื่อทรัพยากรของการตั้งค่าแบบหลายช่องทางนี้ รูปแบบ:
รูปแบบ: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string ต้องระบุ รหัสประเทศของที่เก็บข้อมูลภาษาที่พบได้ทั่วไป (CLDR) (เช่น "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) ต้องระบุ ประเภท หน้าร้านในพื้นที่ (LSF) สำหรับ regionCode นี้ ค่าที่เป็นไปได้ ได้แก่
  • GHLSF (หน้าร้านในพื้นที่ที่โฮสต์โดย Google)
  • MHLSF_BASIC (หน้าร้านในพื้นที่ที่ผู้ขายโฮสต์แบบพื้นฐาน ซึ่งหมายถึงหน้าผลิตภัณฑ์ที่ระบุความพร้อมจำหน่ายผลิตภัณฑ์ในร้าน)
  • MHLSF_FULL (หน้าร้านในพื้นที่ที่ผู้ขายโฮสต์ (แบบสมบูรณ์) ซึ่งหมายถึงหน้าผลิตภัณฑ์ที่ระบุความพร้อมจำหน่ายผลิตภัณฑ์ในร้าน)
(ไม่มี) (ไม่มี) inStock object
(InStock)
URI (Universal Resource Identifier) ของหน้าผลิตภัณฑ์ที่มีสินค้าพร้อมจำหน่ายและสถานะการแสดงของ regionCode นี้ ตั้งค่าออบเจ็กต์ inStock หรือ pickup อย่างน้อย 1 รายการใน create API หากคุณเลือก MHLSF ประเภทใดประเภทหนึ่ง แต่ตั้งค่า inStock เฉพาะในกรณีที่ lsfType เป็น GHLSF
storePickupActive boolean pickup object
(Pickup)
URI ของหน้าผลิตภัณฑ์สำหรับการรับสินค้าและสถานะการแสดงผลของ regionCode นี้ ตั้งค่าออบเจ็กต์ inStock หรือ Pickup อย่างน้อย 1 รายการใน create API หากคุณเลือกประเภท MHLSF รายการใดรายการหนึ่ง แต่อย่าตั้งค่าเมื่อตั้งค่า GHLSF เป็น lsfType
posDataProvider object
(LiaPosDataProvider)
lfpLink object
(LfpLink)
เอาต์พุตเท่านั้น ลิงก์ที่สร้างขึ้นกับผู้ให้บริการ LFP
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
URI และสถานะนโยบาย "สั่งซื้อได้" (ODO) ของ regionCode นี้
about object
(LiaAboutPageSettings)
about object
(About)
URI ของหน้า "เกี่ยวกับ" และสถานะของ regionCode นี้
inventory object
(LiaInventorySettings)
inventoryVerification object
(InventoryVerification)
สถานะขั้นตอนการยืนยันสินค้าคงคลังและข้อมูลติดต่อสำหรับ regionCode นี้
omnichannelExperience object (LiaOmnichannelExperience) (ไม่มี) (ไม่มี) ใช้ lsfType และ pickup (ด้านบน)

LsfType

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
lsfType string lsfType enum (LsfType) ประเภทหน้าร้านในพื้นที่ (LSF) ค่าที่เป็นไปได้มีดังนี้
  • GHLSF (หน้าร้านในพื้นที่ที่โฮสต์โดย Google)
  • MHLSF_BASIC (หน้าร้านในพื้นที่แบบพื้นฐานที่ผู้ขายโฮสต์)
  • MHLSF_FULL (หน้าร้านในพื้นที่ที่ผู้ขายโฮสต์แบบสมบูรณ์)

InStock

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
(ไม่มี) (ไม่มี) uri string URI ของหน้า Landing Page ของผลิตภัณฑ์ ต้องระบุหากเลือกMHLSFประเภทใดประเภทหนึ่งข้างต้น ต้องระบุหากตั้งค่าออบเจ็กต์ไว้ สำหรับ GHLSF ฟิลด์ต้องว่างเปล่า แต่สำหรับ MHLSF ฟิลด์ต้องไม่ว่างเปล่า บริการจะใช้ข้อมูลนี้เพื่อตรวจสอบการแสดงโฆษณาสินค้าพร้อมจําหน่ายเท่านั้น โดเมน URI นี้ควรตรงกับหน้าแรกของผู้ขาย
(ไม่มี) (ไม่มี) state enum
(ReviewState.State)
เอาต์พุตเท่านั้น สถานะการแสดงสินค้าพร้อมจำหน่าย ค่าที่ใช้ได้มีดังนี้
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูLiaCountrySettings และ LiaOmnichannelExperience

รับที่ร้าน

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
(ไม่มี) (ไม่มี) uri string URI ของหน้าผลิตภัณฑ์สำหรับการรับสินค้า ต้องระบุหากตั้งค่าออบเจ็กต์ไว้ API จะใช้ข้อมูลนี้เพื่อตรวจสอบการแสดงโฆษณาแบบรับสินค้าเท่านั้น โดเมน URI นี้ควรตรงกับหน้าแรกของผู้ขาย
LiaInventorySettings.status string state enum (ReviewState.State) เอาต์พุตเท่านั้น สถานะการแสดงโฆษณาแบบรับสินค้า ค่าที่ใช้ได้มีดังนี้
  • ACTIVE
  • FAILED
  • RUNNING

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูLiaCountrySettings และ LiaOmnichannelExperience

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
posDataProviderId string lfpProvider string ต้องระบุ ชื่อทรัพยากรของผู้ให้บริการ LFP
posExternalAccountId string externalAccountId string ต้องระบุ รหัสบัญชีที่ผู้ให้บริการ LFP รู้จักผู้ขายรายนี้
(ไม่มี) (ไม่มี) state enum (ReviewState.State) เอาต์พุตเท่านั้น สถานะของ LfpLink ค่าที่ใช้ได้มีดังนี้
  • ACTIVE
  • RUNNING

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูที่ LiaPosDataProvider

OnDisplayToOrder

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
shippingCostPolicyUrl string uri string ต้องระบุ URI ของนโยบาย "สั่งซื้อได้" (ODO)
status string state enum (ReviewState.State) เอาต์พุตเท่านั้น สถานะของ URI ค่าที่เป็นไปได้มีดังนี้
  • ACTIVE
  • FAILED
  • RUNNING

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู LiaOnDisplayToOrderSettings

เกี่ยวกับ

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
url string uri string ต้องระบุ URI ของหน้าเกี่ยวกับ
status string state enum (ReviewState.State) เอาต์พุตเท่านั้น สถานะของ URI ค่าที่เป็นไปได้มีดังนี้
  • ACTIVE
  • FAILED
  • RUNNING

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู LiaAboutPageSettings

InventoryVerification

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
status string state enum (InventoryVerification.State) เอาต์พุตเท่านั้น สถานะขั้นตอนการยืนยันสินค้าคงคลัง ค่าที่เป็นไปได้มีดังนี้
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
inventoryVerificationContactName string contact string ต้องระบุ ชื่อผู้ติดต่อสำหรับกระบวนการยืนยันสินค้าคงคลัง
inventoryVerificationContactEmail string contactEmail string ต้องระบุ อีเมลของรายชื่อติดต่อสำหรับขั้นตอนการยืนยันสินค้าคงคลัง
inventoryVerificationContactStatus string contactState enum (ReviewState.State) เอาต์พุตเท่านั้น สถานะการยืนยันรายชื่อติดต่อ ค่าที่เป็นไปได้มีดังนี้
  • ACTIVE
  • RUNNING

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูLiaCountrySettings และ LiaInventorySettings

LfpProvider

Shopping Content API Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
fullName string name string ชื่อทรัพยากรของผู้ให้บริการ LFP
รูปแบบ: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(ไม่มี) (ไม่มี) regionCode string ต้องระบุ รหัสประเทศ CLDR
providerId string (ไม่มี) (ไม่มี) ช่องนี้จะหายไป
displayName string displayName string ชื่อที่แสดงของผู้ให้บริการ LFP

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู PosDataProvidersPosDataProvider

GbpAccount

Shopping Content API Merchant API
Field Type ฟิลด์ ประเภท คำอธิบาย
name string name string ชื่อทรัพยากรของบัญชี GBP
รูปแบบ: accounts/{account}/gbpAccount/{gbp_account}
(ไม่มี) (ไม่มี) gbpAccountId string รหัสของ Business Profile
type string type enum (GbpAccount.Type) ประเภทของ Business Profile ค่าที่ใช้ได้มีดังนี้
  • USER (บัญชีส่วนตัว)
  • BUSINESS_ACCOUNT (บัญชีธุรกิจ)
email string gbpAccountName string ชื่อ Business Profile
  • สำหรับบัญชีส่วนตัว อีเมลนี้คือรหัสอีเมลของเจ้าของ
  • สำหรับบัญชีของธุรกิจ ชื่อนี้จะตรงกับชื่อบัญชีธุรกิจ
listingCount string listingCount int64 จำนวนข้อมูลผลิตภัณฑ์ที่เชื่อมโยงกับบัญชีนี้

หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู GmbAccountsGmbAccount