หากคุณใช้การตั้งค่าโฆษณาสินค้าคงคลังในร้านใน 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นี้
      ค่าที่เป็นไปได้ ได้แก่
 | 
| (ไม่มี) | (ไม่มี) | inStock | object | URI (Universal Resource Identifier) ของหน้าผลิตภัณฑ์ที่มีสินค้าพร้อมจำหน่ายและสถานะการแสดงของ regionCodeนี้ ตั้งค่าออบเจ็กต์inStockหรือpickupอย่างน้อย 1 รายการใน create API หากคุณเลือกMHLSFประเภทใดประเภทหนึ่ง แต่ตั้งค่าinStockเฉพาะในกรณีที่lsfTypeเป็นGHLSF | 
| storePickupActive | boolean | pickup | object | URI ของหน้าผลิตภัณฑ์สำหรับการรับสินค้าและสถานะการแสดงผลของ regionCodeนี้ ตั้งค่าออบเจ็กต์inStockหรือPickupอย่างน้อย 1 รายการใน create API หากคุณเลือกประเภทMHLSFรายการใดรายการหนึ่ง แต่อย่าตั้งค่าเมื่อตั้งค่าGHLSFเป็นlsfType | 
| posDataProvider | object | lfpLink | object | เอาต์พุตเท่านั้น ลิงก์ที่สร้างขึ้นกับผู้ให้บริการ LFP | 
| onDisplayToOrder | object | odo | object | URI และสถานะนโยบาย "สั่งซื้อได้" (ODO) ของ regionCodeนี้ | 
| about | object | about | object | URI ของหน้า "เกี่ยวกับ" และสถานะของ regionCodeนี้ | 
| inventory | object | inventoryVerification | object | สถานะขั้นตอนการยืนยันสินค้าคงคลังและข้อมูลติดต่อสำหรับ regionCodeนี้ | 
| omnichannelExperience | object (LiaOmnichannelExperience) | (ไม่มี) | (ไม่มี) | ใช้ lsfTypeและpickup(ด้านบน) | 
LsfType
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| lsfType | string | lsfType | enum (LsfType) | ประเภทหน้าร้านในพื้นที่ (LSF) ค่าที่เป็นไปได้มีดังนี้ 
 | 
InStock
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| (ไม่มี) | (ไม่มี) | uri | string | URI ของหน้า Landing Page ของผลิตภัณฑ์ ต้องระบุหากเลือก MHLSFประเภทใดประเภทหนึ่งข้างต้น ต้องระบุหากตั้งค่าออบเจ็กต์ไว้ สำหรับGHLSFฟิลด์ต้องว่างเปล่า แต่สำหรับMHLSFฟิลด์ต้องไม่ว่างเปล่า บริการจะใช้ข้อมูลนี้เพื่อตรวจสอบการแสดงโฆษณาสินค้าพร้อมจําหน่ายเท่านั้น โดเมน URI นี้ควรตรงกับหน้าแรกของผู้ขาย | 
| (ไม่มี) | (ไม่มี) | state | enum | เอาต์พุตเท่านั้น สถานะการแสดงสินค้าพร้อมจำหน่าย ค่าที่ใช้ได้มีดังนี้ 
         | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูLiaCountrySettings และ LiaOmnichannelExperience
รับที่ร้าน
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| (ไม่มี) | (ไม่มี) | uri | string | URI ของหน้าผลิตภัณฑ์สำหรับการรับสินค้า ต้องระบุหากตั้งค่าออบเจ็กต์ไว้ API จะใช้ข้อมูลนี้เพื่อตรวจสอบการแสดงโฆษณาแบบรับสินค้าเท่านั้น โดเมน URI นี้ควรตรงกับหน้าแรกของผู้ขาย | 
| LiaInventorySettings.status | string | state | enum (ReviewState.State) | เอาต์พุตเท่านั้น สถานะการแสดงโฆษณาแบบรับสินค้า ค่าที่ใช้ได้มีดังนี้ 
 
     | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูLiaCountrySettings และ LiaOmnichannelExperience
LfpLink
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| posDataProviderId | string | lfpProvider | string | ต้องระบุ ชื่อทรัพยากรของผู้ให้บริการ LFP | 
| posExternalAccountId | string | externalAccountId | string | ต้องระบุ รหัสบัญชีที่ผู้ให้บริการ LFP รู้จักผู้ขายรายนี้ | 
| (ไม่มี) | (ไม่มี) | state | enum (ReviewState.State) | เอาต์พุตเท่านั้น สถานะของ LfpLink ค่าที่ใช้ได้มีดังนี้ 
 
     | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดูที่ LiaPosDataProvider
OnDisplayToOrder
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| shippingCostPolicyUrl | string | uri | string | ต้องระบุ URI ของนโยบาย "สั่งซื้อได้" (ODO) | 
| status | string | state | enum (ReviewState.State) | เอาต์พุตเท่านั้น สถานะของ URI ค่าที่เป็นไปได้มีดังนี้ 
       | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู LiaOnDisplayToOrderSettings
เกี่ยวกับ
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| url | string | uri | string | ต้องระบุ URI ของหน้าเกี่ยวกับ | 
| status | string | state | enum (ReviewState.State) | เอาต์พุตเท่านั้น สถานะของ URI ค่าที่เป็นไปได้มีดังนี้ 
 | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู LiaAboutPageSettings
InventoryVerification
| Shopping Content API | Merchant API | |||
|---|---|---|---|---|
| ฟิลด์ | ประเภท | ฟิลด์ | ประเภท | คำอธิบาย | 
| status | string | state | enum (InventoryVerification.State) | เอาต์พุตเท่านั้น สถานะขั้นตอนการยืนยันสินค้าคงคลัง ค่าที่เป็นไปได้มีดังนี้ 
       | 
| inventoryVerificationContactName | string | contact | string | ต้องระบุ ชื่อผู้ติดต่อสำหรับกระบวนการยืนยันสินค้าคงคลัง | 
| inventoryVerificationContactEmail | string | contactEmail | string | ต้องระบุ อีเมลของรายชื่อติดต่อสำหรับขั้นตอนการยืนยันสินค้าคงคลัง | 
| inventoryVerificationContactStatus | string | contactState | enum (ReviewState.State) | เอาต์พุตเท่านั้น สถานะการยืนยันรายชื่อติดต่อ ค่าที่เป็นไปได้มีดังนี้ 
       | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา 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  ค่าที่ใช้ได้มีดังนี้ 
 | 
| email | string | gbpAccountName | string | ชื่อ Business Profile 
 | 
| listingCount | string | listingCount | int64 | จำนวนข้อมูลผลิตภัณฑ์ที่เชื่อมโยงกับบัญชีนี้ | 
หากต้องการตรวจสอบเวอร์ชันเนื้อหา Shopping โปรดดู GmbAccountsGmbAccount