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 Overview

LfpSaleService

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

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

LfpStoreService

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

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

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 ค่าสูงสุดคือ 1, 000 หากระบุค่าที่สูงกว่าค่าสูงสุด pageSize จะมีค่าเริ่มต้นเป็นค่าสูงสุด
page_token

string

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

ListLfpStoresResponse

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

ช่อง
lfp_stores[]

LfpStore

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

string

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