Package google.shopping.merchant.lfp.v1beta

Chỉ mục

LfpInventoryService

Dịch vụ 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 mục tiêu đã cho. Nếu tài nguyên đã tồn tại, tài nguyên đó sẽ được thay thế. Khoảng không quảng cáo này 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 OAuth 2.0 Overview.

LfpSaleService

Dịch vụ 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 OAuth 2.0 Overview.

LfpStoreService

Dịch vụ 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á một cửa hàng của 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 OAuth 2.0 Overview.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Truy xuất thông tin về một 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 OAuth 2.0 Overview.
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, thì 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 OAuth 2.0 Overview.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Liệt kê các cửa hàng của người bán mục tiêu, được chỉ định bằng bộ lọc 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 OAuth 2.0 Overview.

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 cửa hàng cần xoá cho tài khoản người bán mục tiêu. Đị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 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 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 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á cần chèn.

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 nhà cung cấp LFP: accounts/{account}
lfp_store

LfpStore

Bắt buộc. Cửa hàng cầ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 mà bạn muốn gửi kho hàng.
store_code

string

Bắt buộc. Giá trị 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ảng không quảng cáo và lượt bán hàng cho một người bán, thì mã nhận dạng 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 của 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 tiêu chuẩn 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 sản phẩm tại cửa hàng địa phương
collection_time

Timestamp

Không bắt buộc. Thời điểm thu thập khoảng không quảng cáo. Nếu bạn không đặt giá trị này, thì giá trị này sẽ được đặt thành thời điểm bạn gửi khoảng không quảng cáo.
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òn 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. Trừ phi giá trị là "not supported" (không được hỗ trợ), bạn phải gửi trường này cùng với pickupSla. Để 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 cửa hàng đị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 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 cửa hàng địa phương.
feed_label

string

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

LfpSale

Một giao dịch bán hà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 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 mà bạn muốn gửi chương trình ưu đãi.
store_code

string

Bắt buộc. Giá trị 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 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ảng không quảng cáo và lượt bán hàng cho một người bán, thì mã nhận dạng 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 của 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 tiêu chuẩn 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. Giá đơn vị của sản phẩm.
quantity

int64

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

Timestamp

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

string

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

string

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

LfpStore

Cửa hàng của người bán. Mã 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 mục tiêu. Nếu không tìm thấy cửa hàng phù hợp, thì kho hàng hoặc lượt bán hàng mà bạn gửi bằng 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 mà bạn muốn gửi cửa hàng.
store_code

string

Bắt buộc. Không thể thay đổi. Giá trị nhận dạng cửa hàng riêng biệt của 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 Trang doanh nghiệp trên Google. Hãy xem matchingStateHint để biết thêm thông tin 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 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. Việc 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 mà bạn cung cấp không khớp với bất kỳ cửa hàng nào được kết nối 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": LfpStore mà bạn cung cấp không khớp với bất kỳ cửa hàng nào trong Trang doanh nghiệp trên Google đã kết nối, vì cửa hàng trong Trang doanh nghiệp trên Google được so khớp chưa được xác minh. Hãy thực hiện quy trình xác minh Trang doanh nghiệp trên Google để đảm bảo thông tin khớp chính xác.

StoreMatchingState

Trạng thái so 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 cửa hàng.
STORE_MATCHING_STATE_MATCHED LfpStore đã khớp thành công với một cửa hàng trên Trang doanh nghiệp trên Google.
STORE_MATCHING_STATE_FAILED LfpStore không khớp với 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 mà bạn muốn thêm cửa hàng.
page_size

int32

Không bắt buộc. Số lượng tài nguyên LfpStore tối đa mà tài khoản nhất định trả về. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng cửa hàng của tài khoản nhất định ít hơn pageSize. Giá trị mặc định là 250. Giá trị tối đa là 1000; Nếu bạn chỉ định một giá trị cao hơn giá trị tối đa, 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 đã chỉ định.
next_page_token

string

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