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

หากคุณใช้การตั้งค่าโฆษณาสินค้าคงคลังในร้านใน Content API สำหรับ Shopping จะมีการเปลี่ยนแปลงที่สำคัญหลายอย่างใน 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 ต้องระบุ Common Locale Data Repository (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 รายการใน 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

หากต้องการตรวจสอบเวอร์ชันของคอนเทนต์ช็อปปิ้ง โปรดดู LiaCountrySettings และ LiaOmnichannelExperience

รับที่ร้าน

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

หากต้องการตรวจสอบเวอร์ชันของคอนเทนต์ช็อปปิ้ง โปรดดู LiaCountrySettings และ LiaOmnichannelExperience

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

หากต้องการตรวจสอบเวอร์ชันของคอนเทนต์ช็อปปิ้ง โปรดดู LiaPosDataProvider

OnDisplayToOrder

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

หากต้องการตรวจสอบเวอร์ชันคอนเทนต์ช็อปปิ้ง โปรดดู LiaOnDisplayToOrderSettings

เกี่ยวกับ

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

หากต้องการตรวจสอบเวอร์ชันของคอนเทนต์ช็อปปิ้ง โปรดดู 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

หากต้องการตรวจสอบเวอร์ชันคอนเทนต์ช็อปปิ้ง โปรดดู 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

หากต้องการตรวจสอบเวอร์ชันของคอนเทนต์ช็อปปิ้ง โปรดดู 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