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

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

ตอนนี้การตั้งค่า LIA อยู่ในคอมโพเนนต์หลัก 3 อย่างอย่างใดอย่างหนึ่ง ซึ่งแต่ละอย่างมี ทรัพยากรที่เชื่อมโยงกัน

คอมโพเนนต์หลัก แหล่งข้อมูล
การกำหนดค่าบัญชีสำหรับการแสดงโฆษณาแบบ Omnichannel OmnichannelSetting
การเชื่อมต่อกับพาร์ทเนอร์Local Feed Partnership (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

Content API สำหรับ Shopping Merchant API
ฟิลด์ ประเภท ฟิลด์ ประเภท คำอธิบาย
(ไม่มี) (ไม่มี) name string ชื่อทรัพยากรของการตั้งค่า Omnichannel นี้ รูปแบบ
รูปแบบ: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string ต้องระบุ รหัสประเทศของที่เก็บข้อมูลภาษาทั่วไป (CLDR) (เช่น "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) ต้องระบุ ประเภท Local Store Front (LSF) สำหรับ regionCode นี้ ค่าที่เป็นไปได้ ได้แก่
  • GHLSF (หน้าร้านในพื้นที่ที่โฮสต์โดย Google)
  • MHLSF_BASIC (หน้าร้านในพื้นที่ที่ผู้ขายโฮสต์แบบพื้นฐาน ซึ่งหมายถึงหน้าผลิตภัณฑ์ที่ระบุความพร้อมจำหน่ายสินค้าในร้าน)
  • MHLSF_FULL (หน้าร้านในพื้นที่ที่ผู้ขายโฮสต์แบบสมบูรณ์ ซึ่งหมายถึงหน้าผลิตภัณฑ์ที่ระบุความพร้อมจำหน่ายสินค้าในร้าน)
(ไม่มี) (ไม่มี) inStock object
(InStock)
URI (Universal Resource Identifier) ของหน้าผลิตภัณฑ์ที่มีสินค้าพร้อมจำหน่ายและสถานะการแสดง ของ regionCode นี้ ตั้งค่าออบเจ็กต์ inStock หรือ pickup อย่างน้อย 1 รายการใน 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

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

InStock

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

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

รับที่ร้าน

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

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

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

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

OnDisplayToOrder

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

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

เกี่ยวกับ

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

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

InventoryVerification

Content API สำหรับ Shopping 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

Content API สำหรับ Shopping 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