Package google.shopping.merchant.lfp.v1beta

ดัชนี

LfpInventoryService

บริการสำหรับพาร์ทเนอร์ LFP ในการส่งสินค้าคงคลังในร้านสำหรับผู้ขาย

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

แทรกทรัพยากร LfpInventory สำหรับบัญชีผู้ขายเป้าหมายที่ระบุ หากมีทรัพยากรอยู่แล้ว ระบบจะแทนที่ทรัพยากรดังกล่าว สินค้าคงคลังจะหมดอายุโดยอัตโนมัติหลังจากผ่านไป 30 วัน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

LfpSaleService

บริการสำหรับพาร์ทเนอร์ LFP เพื่อส่งข้อมูลการขายสำหรับผู้ขาย

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

แทรก LfpSale สำหรับผู้ขายที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

LfpStoreService

บริการสำหรับพาร์ทเนอร์ LFP ในการส่งร้านค้าในพื้นที่สำหรับผู้ขาย

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

ลบร้านค้าสำหรับผู้ขายเป้าหมาย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

เรียกข้อมูลเกี่ยวกับร้านค้า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

แทรกร้านค้าสำหรับผู้ขายเป้าหมาย หากมีร้านค้าที่ใช้รหัสร้านค้าเดียวกันอยู่แล้ว ระบบจะแทนที่ร้านค้าดังกล่าว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

แสดงรายการร้านค้าของผู้ขายเป้าหมายซึ่งระบุโดยตัวกรองใน ListLfpStoresRequest

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

DeleteLfpStoreRequest

ข้อความคำขอสำหรับเมธอด DeleteLfpStore

ช่อง
name

string

ต้องระบุ ชื่อร้านค้าที่จะลบสำหรับบัญชีผู้ขายเป้าหมาย รูปแบบ: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

ข้อความคำขอสำหรับเมธอด GetLfpStore

ช่อง
name

string

ต้องระบุ ชื่อร้านค้าที่จะเรียกข้อมูล รูปแบบ: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

ข้อความคำขอสำหรับเมธอด InsertLfpInventory

ช่อง
parent

string

ต้องระบุ บัญชีผู้ให้บริการ LFP รูปแบบ: accounts/{account}
lfp_inventory

LfpInventory

ต้องระบุ พื้นที่โฆษณาที่จะแทรก

InsertLfpSaleRequest

ข้อความขอสำหรับเมธอด InsertLfpSale

ช่อง
parent

string

ต้องระบุ บัญชีผู้ให้บริการ LFP รูปแบบ: accounts/{lfp_partner}
lfp_sale

LfpSale

ต้องระบุ การขายที่จะแทรก

InsertLfpStoreRequest

ข้อความคำขอสำหรับเมธอด InsertLfpStore

ช่อง
parent

string

ต้องระบุ รูปแบบบัญชีผู้ให้บริการ LFP: accounts/{account}
lfp_store

LfpStore

ต้องระบุ ร้านค้าที่จะแทรก

LfpInventory

สินค้าคงคลังในร้านสำหรับผู้ขาย

ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อสำหรับทรัพยากร LfpInventory รูปแบบ: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

ต้องระบุ รหัส Merchant Center ของผู้ขายที่จะส่งสินค้าคงคลัง
store_code

string

ต้องระบุ ตัวระบุร้านค้าของผู้ขาย รหัสร้านค้าที่แทรกผ่าน InsertLfpStore หรือรหัสร้านค้าใน Business Profile ก็ได้
offer_id

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ หากส่งทั้งสินค้าคงคลังและยอดขายสำหรับผู้ขาย รหัสนี้ควรตรงกับผลิตภัณฑ์เดียวกัน

หมายเหตุ: หากผู้ขายขายผลิตภัณฑ์เดียวกันทั้งแบบสินค้าใหม่และมือสอง ผู้ขายควรใช้รหัสที่ต่างกัน
region_code

string

ต้องระบุ รหัสเขตแดน CLDR ของประเทศที่มีการขายผลิตภัณฑ์
content_language

string

ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับสินค้า
price

Price

ไม่บังคับ ราคาปัจจุบันของผลิตภัณฑ์
availability

string

ต้องระบุ ความพร้อมจำหน่ายของผลิตภัณฑ์ในร้านค้านี้ ดูค่าแอตทริบิวต์ที่ยอมรับได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน
collection_time

Timestamp

ไม่บังคับ เวลาที่มีการรวบรวมสินค้าคงคลัง หากไม่ได้ตั้งค่า ระบบจะตั้งเป็นเวลาที่ส่งสินค้าคงคลัง
gtin

string

ไม่บังคับ หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์
quantity

int64

ไม่บังคับ จำนวนผลิตภัณฑ์ที่มีจำหน่ายในร้านค้านี้ ต้องมากกว่าหรือเท่ากับ 0
pickup_method

string

ไม่บังคับ วิธีรับสินค้าที่รองรับสำหรับข้อเสนอนี้ ต้องส่งช่องนี้ร่วมกับ pickupSla เว้นแต่จะเป็น "ไม่รองรับ" ดูค่าแอตทริบิวต์ที่ยอมรับได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน
pickup_sla

string

ไม่บังคับ วันที่คาดว่าจะรับสินค้าได้ซึ่งสัมพันธ์กับวันที่สั่งซื้อ ต้องส่งพร้อมกับ pickupMethod ดูค่าแอตทริบิวต์ที่ยอมรับได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน
feed_label

string

ไม่บังคับ ป้ายกำกับฟีดของผลิตภัณฑ์ หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้นเป็น regionCode

LfpSale

การขายสำหรับผู้ขาย

ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อของทรัพยากร LfpSale รูปแบบ: accounts/{account}/lfpSales/{sale}
target_account

int64

ต้องระบุ รหัส Merchant Center ของผู้ขายที่จะส่งการขาย
store_code

string

ต้องระบุ ตัวระบุร้านค้าของผู้ขาย ใส่ storeCode ที่แทรกผ่าน API หรือโค้ดของร้านค้าใน Business Profile
offer_id

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ หากส่งทั้งสินค้าคงคลังและยอดขายสำหรับผู้ขาย รหัสนี้ควรตรงกับผลิตภัณฑ์เดียวกัน

หมายเหตุ: หากผู้ขายขายผลิตภัณฑ์เดียวกันทั้งแบบสินค้าใหม่และมือสอง ผู้ขายควรใช้รหัสที่ต่างกัน
region_code

string

ต้องระบุ รหัสเขตแดน CLDR ของประเทศที่มีการขายผลิตภัณฑ์
content_language

string

ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับสินค้า
gtin

string

ต้องระบุ หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ที่ขายได้
price

Price

ต้องระบุ ราคาต่อหน่วยของผลิตภัณฑ์
quantity

int64

ต้องระบุ การเปลี่ยนแปลงสัมพัทธ์ของจำนวนที่พร้อมใช้งาน เป็นค่าลบสำหรับสินค้าที่ถูกส่งคืน
sale_time

Timestamp

ต้องระบุ การประทับเวลาสำหรับการขาย
uid

string

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันทั่วโลกที่ระบบสร้างสำหรับ LfpSale
feed_label

string

ไม่บังคับ ป้ายกำกับฟีดของผลิตภัณฑ์ หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้นเป็น regionCode

LfpStore

ร้านค้าสำหรับผู้ขาย ซึ่งจะใช้ในการจับคู่กับร้านค้าภายใต้ Google Business Profile ของผู้ขายเป้าหมาย หากไม่พบร้านค้าที่ตรงกัน ระบบจะไม่ใช้สินค้าคงคลังหรือยอดขายที่ส่งพร้อมกับรหัสร้านค้า

ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อของทรัพยากร LfpStore รูปแบบ: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

ต้องระบุ รหัส Merchant Center ของผู้ขายที่จะส่งร้านค้า
store_code

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุร้านค้าที่ไม่ซ้ำกันสำหรับผู้ขายเป้าหมาย
store_address

string

ต้องระบุ ที่อยู่ของร้านค้า ตัวอย่างเช่น 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA
gcid_category[]

string

ไม่บังคับ รหัสหมวดหมู่ Google My Business
matching_state

StoreMatchingState

ไม่บังคับ เอาต์พุตเท่านั้น สถานะของการจับคู่กับ Google Business Profile ดูรายละเอียดเพิ่มเติมได้ที่ matchingStateHint หากไม่พบข้อมูลที่ตรงกัน
store_name

string

ไม่บังคับ ชื่อผู้ขายหรือร้านค้า
phone_number

string

ไม่บังคับ หมายเลขโทรศัพท์ของร้านค้าในรูปแบบ E.164 ตัวอย่าง: +15556767888
website_uri

string

ไม่บังคับ URL ของเว็บไซต์สำหรับร้านค้าหรือผู้ขาย
place_id

string

ไม่บังคับ รหัส Google Place ของตำแหน่งร้านค้า
matching_state_hint

string

ไม่บังคับ เอาต์พุตเท่านั้น คำแนะนำว่าเหตุใดการจับคู่จึงล้มเหลว มีการตั้งค่าเฉพาะเมื่อ matchingState=STORE_MATCHING_STATE_FAILED

ค่าที่เป็นไปได้มีดังนี้

  • "linked-store-not-found": ไม่มีร้านค้า Google Business Profile สำหรับการจับคู่
  • "store-match-not-found": LfpStore ที่ระบุไม่สามารถจับคู่กับร้านค้า Google Business Profile ใดๆ ที่เชื่อมต่ออยู่ได้ บัญชี Merchant Center เชื่อมต่อกันอย่างถูกต้องและมีร้านค้าพร้อมให้บริการใน Google Business Profile แต่ที่อยู่ของสถานที่ตั้งใน LfpStore ไม่ตรงกับที่อยู่ของร้านค้า Google Business Profile อัปเดตที่อยู่ LfpStore หรือที่อยู่ร้านค้าของ Google Business Profile ให้ถูกต้อง
  • "store-match-unverified": LfpStore ที่ระบุไม่สามารถจับคู่กับร้านค้า Google Business Profile ใดๆ ที่เชื่อมต่ออยู่ได้ เนื่องจากร้านค้า Google Business Profile ที่ตรงกันไม่ได้รับการยืนยัน ทำตามกระบวนการยืนยัน Google Business Profile เพื่อจับคู่อย่างถูกต้อง

StoreMatchingState

สถานะการจับคู่ LfpStore กับ Google Business Profile

Enum
STORE_MATCHING_STATE_UNSPECIFIED จัดเก็บสถานะการจับคู่โดยไม่ได้ระบุ
STORE_MATCHING_STATE_MATCHED จับคู่ LfpStore กับร้านค้า Google Business Profile เรียบร้อยแล้ว
STORE_MATCHING_STATE_FAILED LfpStore ไม่ตรงกับร้านค้า Google Business Profile

ListLfpStoresRequest

ข้อความคำขอสำหรับเมธอด ListLfpStores

ช่อง
parent

string

ต้องระบุ พาร์ทเนอร์ LFP รูปแบบ: accounts/{account}
target_account

int64

ต้องระบุ รหัส Merchant Center ของผู้ขายที่จะแสดงร้านค้า
page_size

int32

ไม่บังคับ จำนวนทรัพยากรสูงสุด LfpStore รายการสำหรับบัญชีที่กำหนดที่จะส่งคืน บริการจะแสดงผลน้อยกว่าค่านี้หากจำนวนร้านค้าสำหรับบัญชีที่ระบุน้อยกว่า pageSize ค่าเริ่มต้นคือ 250 ค่าสูงสุดคือ 1000 หากระบุค่าสูงกว่าค่าสูงสุด pageSize จะใช้ค่าเริ่มต้นเป็นค่าสูงสุด
page_token

string

ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการโทร ListLfpStoresRequest ครั้งก่อน ระบุโทเค็นของหน้าเว็บเพื่อเรียกหน้าถัดไป เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้ ListLfpStoresRequest ต้องตรงกับการเรียกที่ระบุโทเค็นของหน้า โทเค็นแสดงผลเป็น nextPageToken ในการตอบกลับคำขอก่อนหน้า

ListLfpStoresResponse

ข้อความตอบกลับสำหรับเมธอด ListLfpStores

ช่อง
lfp_stores[]

LfpStore

ร้านค้าจากผู้ขายที่ระบุ
next_page_token

string

โทเค็นที่ส่งเป็น pageToken เพื่อเรียกดูหน้าถัดไปได้ หากเว้นช่องนี้ไว้ ก็จะไม่เห็นหน้าต่อๆ ไป