Package google.shopping.merchant.lfp.v1beta

Chỉ mục

LfpInventoryService

Dịch vụ dành cho đối tác LFP để gửi kho hàng tại địa phương cho người bán.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Chèn tài nguyên LfpInventory cho tài khoản người bán đích cụ thể. Tài nguyên đó sẽ bị thay thế nếu đã tồn tại. Khoảng không quảng cáo sẽ tự động hết hạn sau 30 ngày.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

LfpSaleService

Dịch vụ dành cho đối tác LFP để gửi dữ liệu bán hàng cho người bán.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Chèn LfpSale cho người bán đã cho.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

LfpStoreService

Dịch vụ dành cho đối tác LFP để gửi cửa hàng địa phương cho người bán.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Xoá cửa hàng cho người bán mục tiêu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Truy xuất thông tin về cửa hàng.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Chèn một cửa hàng cho người bán mục tiêu. Nếu cửa hàng có cùng mã cửa hàng đã tồn tại, cửa hàng đó sẽ được thay thế.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Liệt kê các cửa hàng của người bán được mục tiêu, do bộ lọc chỉ định trong ListLfpStoresRequest.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

DeleteLfpStoreRequest

Thông báo yêu cầu cho phương thức DeleteLFPStore.

Trường
name

string

Bắt buộc. Tên cửa hàng cần xoá đối với tài khoản người bán đích. Định dạng accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Thông báo yêu cầu cho phương thức GetLfpStore.

Trường
name

string

Bắt buộc. Tên cửa hàng cần truy xuất. Định dạng accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Thông báo yêu cầu cho phương thức InsertLfpInventory.

Trường
parent

string

Bắt buộc. Tài khoản của nhà cung cấp LFP. Định dạng accounts/{account}
lfp_inventory

LfpInventory

Bắt buộc. Khoảng không quảng cáo cần chèn.

InsertLfpSaleRequest

Thông báo yêu cầu cho phương thức InsertLFPSale.

Trường
parent

string

Bắt buộc. Tài khoản của nhà cung cấp LFP. Định dạng accounts/{lfp_partner}
lfp_sale

LfpSale

Bắt buộc. Chương trình giảm giá.

InsertLfpStoreRequest

Thông báo yêu cầu cho phương thức InsertLFPStore.

Trường
parent

string

Bắt buộc. Định dạng tài khoản của nhà cung cấp LFP: accounts/{account}
lfp_store

LfpStore

Bắt buộc. Cửa hàng mà bạn muốn chèn.

LfpInventory

Kho hàng tại địa phương cho người bán.

Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên của tài nguyên LfpInventory. Định dạng: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Bắt buộc. Mã truy cập Merchant Center của người bán để gửi kho hàng.
store_code

string

Bắt buộc. Mã nhận dạng cửa hàng của người bán. Mã cửa hàng được chèn thông qua InsertLfpStore hoặc mã cửa hàng trong Trang doanh nghiệp.
offer_id

string

Bắt buộc. Không thể thay đổi. Giá trị nhận dạng duy nhất của sản phẩm. Nếu bạn gửi cả kho hàng và doanh số cho người bán, thì mã này phải khớp với cùng một sản phẩm.

Lưu ý: Nếu người bán kinh doanh cả loại mới và đã qua sử dụng của cùng một sản phẩm, thì những sản phẩm đó cần có mã khác nhau.
region_code

string

Bắt buộc. Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán.
content_language

string

Bắt buộc. Mã ngôn ngữ gồm hai chữ cái theo ISO 639-1 của mặt hàng.
price

Price

Không bắt buộc. Giá hiện tại của sản phẩm.
availability

string

Bắt buộc. Tình trạng còn hàng của sản phẩm tại cửa hàng này. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương
collection_time

Timestamp

Không bắt buộc. Thời điểm kho hàng được thu thập. Nếu bạn không đặt chính sách này, hệ thống sẽ đặt thành thời điểm gửi kho hàng.
gtin

string

Không bắt buộc. Mã số sản phẩm thương mại toàn cầu của sản phẩm.
quantity

int64

Không bắt buộc. Số lượng sản phẩm có hàng tại cửa hàng này. Phải lớn hơn hoặc bằng 0.
pickup_method

string

Không bắt buộc. Phương thức nhận hàng được hỗ trợ cho mặt hàng này. Bạn phải gửi trường này cùng với pickupSla trừ phi giá trị là "not supported". Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương.
pickup_sla

string

Không bắt buộc. Ngày dự kiến mà khách hàng có thể đến lấy đơn đặt hàng so với ngày đặt hàng. Phải được gửi cùng với pickupMethod. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương.
feed_label

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu cho sản phẩm. Nếu bạn không đặt thuộc tính này, giá trị mặc định sẽ là regionCode.

LfpSale

Giao dịch bán cho người bán.

Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên của tài nguyên LfpSale. Định dạng: accounts/{account}/lfpSales/{sale}
target_account

int64

Bắt buộc. Mã truy cập Merchant Center của người bán để gửi chương trình giảm giá.
store_code

string

Bắt buộc. Mã nhận dạng cửa hàng của người bán. storeCode được chèn thông qua API hoặc mã cửa hàng trong Trang doanh nghiệp.
offer_id

string

Bắt buộc. Giá trị nhận dạng duy nhất của sản phẩm. Nếu bạn gửi cả kho hàng và doanh số cho người bán, thì mã này phải khớp với cùng một sản phẩm.

Lưu ý: Nếu người bán kinh doanh cả loại mới và đã qua sử dụng của cùng một sản phẩm, thì những sản phẩm đó cần có mã khác nhau.
region_code

string

Bắt buộc. Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán.
content_language

string

Bắt buộc. Mã ngôn ngữ gồm hai chữ cái theo ISO 639-1 của mặt hàng.
gtin

string

Bắt buộc. Mã số sản phẩm thương mại toàn cầu của sản phẩm đã bán.
price

Price

Bắt buộc. Đơn giá của sản phẩm.
quantity

int64

Bắt buộc. Mức thay đổi tương đối của số lượng hàng hiện có. Âm cho các mặt hàng được trả lại.
sale_time

Timestamp

Bắt buộc. Dấu thời gian của chương trình giảm giá.
uid

string

Chỉ có đầu ra. Mã nhận dạng chung duy nhất do hệ thống tạo ra cho LfpSale.
feed_label

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu cho sản phẩm. Nếu bạn không đặt thuộc tính này, giá trị mặc định sẽ là regionCode.

LfpStore

Cửa hàng dành cho người bán. Thông tin này sẽ được dùng để so khớp với một cửa hàng trong Trang doanh nghiệp trên Google của người bán được nhắm đến. Nếu không tìm thấy cửa hàng trùng khớp, những kho hàng hoặc doanh số bán hàng mà bạn gửi kèm mã cửa hàng sẽ không được sử dụng.

Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên của tài nguyên LfpStore. Định dạng: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Bắt buộc. Mã truy cập Merchant Center của người bán để gửi cửa hàng.
store_code

string

Bắt buộc. Không thể thay đổi. Mã nhận dạng cửa hàng dành riêng cho người bán mục tiêu.
store_address

string

Bắt buộc. Địa chỉ đường phố của cửa hàng. Ví dụ: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcid_category[]

string

Không bắt buộc. Mã danh mục trên Google Doanh nghiệp của tôi.
matching_state

StoreMatchingState

Không bắt buộc. Chỉ có đầu ra. Trạng thái so khớp với một Trang doanh nghiệp trên Google. Hãy xem matchingStateHint để biết thêm chi tiết nếu không tìm thấy kết quả trùng khớp.
store_name

string

Không bắt buộc. Tên người bán hoặc tên cửa hàng.
phone_number

string

Không bắt buộc. Số điện thoại cửa hàng ở định dạng E.164. Ví dụ: +15556767888
website_uri

string

Không bắt buộc. URL của trang web cho cửa hàng hoặc người bán.
place_id

string

Không bắt buộc. Mã địa điểm trên Google của vị trí cửa hàng.
matching_state_hint

string

Không bắt buộc. Chỉ có đầu ra. Gợi ý lý do vì sao không so khớp được. Thuộc tính này chỉ được thiết lập khi matchingState=STORE_MATCHING_STATE_FAILED.

Các giá trị có thể là:

  • "linked-store-not-found": Không có cửa hàng nào trong Trang doanh nghiệp trên Google để so khớp.
  • "store-match-not-found": LfpStore đã cung cấp không khớp với bất kỳ cửa hàng được kết nối nào trong Trang doanh nghiệp trên Google. Tài khoản Merchant Center được kết nối đúng cách và các cửa hàng có trong Trang doanh nghiệp trên Google, nhưng địa chỉ của vị trí LfpStore không khớp với địa chỉ của cửa hàng trong Trang doanh nghiệp trên Google. Hãy cập nhật địa chỉ LfpStore hoặc địa chỉ cửa hàng trong Trang doanh nghiệp trên Google để so khớp chính xác.
  • "store-match-unverified": Không thể so khớp LfpStore được cung cấp với bất kỳ cửa hàng được kết nối nào trong Trang doanh nghiệp trên Google, vì cửa hàng được so khớp trên Trang doanh nghiệp trên Google chưa được xác minh. Làm theo quy trình xác minh Trang doanh nghiệp trên Google để so khớp chính xác.

StoreMatchingState

Trạng thái khớp LfpStore với một Trang doanh nghiệp trên Google.

Enum
STORE_MATCHING_STATE_UNSPECIFIED Chưa chỉ định trạng thái so khớp cửa hàng.
STORE_MATCHING_STATE_MATCHED Đã so khớp xong LfpStore với một cửa hàng trong Trang doanh nghiệp trên Google.
STORE_MATCHING_STATE_FAILED LfpStore này không khớp với một cửa hàng trong Trang doanh nghiệp trên Google.

ListLfpStoresRequest

Thông báo yêu cầu cho phương thức ListLFPStores.

Trường
parent

string

Bắt buộc. Đối tác LFP. Định dạng accounts/{account}
target_account

int64

Bắt buộc. Mã truy cập Merchant Center của người bán để đăng cửa hàng.
page_size

int32

Không bắt buộc. Số lượng tài nguyên tối đa LfpStore để trả về tài khoản cụ thể. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng cửa hàng của một tài khoản cụ thể ít hơn pageSize. Giá trị mặc định là 250. Giá trị tối đa là 1000; Nếu giá trị cao hơn giá trị tối đa được chỉ định thì pageSize sẽ mặc định là giá trị tối đa.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListLfpStoresRequest trước đó. Cung cấp mã thông báo trang để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho ListLfpStoresRequest phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Mã thông báo được trả về dưới dạng nextPageToken trong phản hồi cho yêu cầu trước đó.

ListLfpStoresResponse

Thông báo phản hồi cho phương thức ListLFPStores.

Trường
lfp_stores[]

LfpStore

Các cửa hàng của người bán được chỉ định.
next_page_token

string

Mã thông báo này có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì không có trang tiếp theo nào.