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

必要欄位。本地動態饋給合作夥伴帳戶格式：accounts/{account}
lfp_store

LfpStore

必要欄位。要插入的商店。

LfpInventory

商家的店面商品目錄資料。

欄位
name

string

僅供輸出。ID。LfpInventory 資源的名稱。格式：accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

必要欄位。要提交商品目錄的商家 Merchant Center ID。
store_code

string

必要欄位。商家商店的 ID。透過 InsertLfpStore 插入的商家代碼，或商家檔案中的商家代碼。
offer_id

string

必要欄位。不可變動。產品的專屬 ID。如果商家同時提交商品目錄和銷售資料，則此 ID 應與相同產品相符。

注意事項：如果商家販售同款的全新產品和二手產品，兩者的 ID 不得相同。
region_code

string

必要欄位。產品銷售國家/地區的 CLDR 地域代碼。
content_language

string

必要欄位。商品的雙字母格式 ISO 639-1 語言編碼。
price

Price

選用設定。產品目前的價格。
availability

string

必要欄位。產品在這個商店的供應情形。如要瞭解可接受的屬性值，請參閱店面產品目錄資料規格
collection_time

Timestamp

選用設定。收集廣告空間的時間。如果未設定，系統會將其設為提交商品目錄的時間。
gtin

string

選用設定。產品的全球交易品項識別碼。
quantity

int64

選用設定。這間商店的產品數量。必須大於或等於零。
pickup_method

string

選用設定。此商品支援的取貨方式。除非值為「not supported」，否則必須與 pickupSla 一併提交這個欄位。如要瞭解系統接受的屬性值，請參閱店面產品目錄資料規格。
pickup_sla

string

選用設定。訂單商品可供取貨的預計日期 (相對於下單時間)。必須與 pickupMethod 一併提交。如要瞭解系統接受的屬性值，請參閱店面產品目錄資料規格。
feed_label

string

選用設定。產品的動態饋給標籤。如未設定，系統會採用預設值 regionCode。

LfpSale

商家的銷售業績。

欄位
name

string

僅供輸出。ID。LfpSale 資源的名稱。格式：accounts/{account}/lfpSales/{sale}
target_account

int64

必要欄位。要提交銷售資料的商家 Merchant Center ID。
store_code

string

必要欄位。商家商店的 ID。透過 API 插入的 storeCode，或是商家檔案中商店的代碼。
offer_id

string

必要欄位。產品的專屬 ID。如果商家同時提交商品目錄和銷售資料，則此 ID 應與相同產品相符。

注意事項：如果商家販售同款的全新產品和二手產品，兩者的 ID 不得相同。
region_code

string

必要欄位。產品銷售國家/地區的 CLDR 地域代碼。
content_language

string

必要欄位。商品的雙字母格式 ISO 639-1 語言編碼。
gtin

string

必要欄位。售出產品的全球交易品項識別碼。
price

Price

必要欄位。產品的單位價格。
quantity

int64

必要欄位。可用數量的相對變化。如果是退回的商品，則為負值。
sale_time

Timestamp

必要欄位。銷售活動時間戳記。
uid

string

僅供輸出。系統為 LfpSale 產生的全球唯一 ID。
feed_label

string

選用設定。產品的動態饋給標籤。如果未設定，則預設為 regionCode。

LfpStore

商家的商店。系統會使用這項資訊，比對目標商家 Google 商家檔案中的商店。如果找不到相符的商店，系統就不會使用透過商店代碼提交的商品目錄或銷售資料。

欄位
name

string

僅供輸出。ID。LfpStore 資源的名稱。格式：accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

必要欄位。要提交商店的商家 Merchant Center ID。
store_code

string

必要欄位。不可變動。目標商家的專屬商店 ID。
store_address

string

必要欄位。商店的街道地址。例如：1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA。
gcid_category[]

string

選用設定。Google 我的商家類別 ID。
matching_state

StoreMatchingState

選用設定。僅供輸出。與 Google 商家檔案比對的狀態。如果沒有找到相符項目，請參閱 matchingStateHint 瞭解詳情。
store_name

string

選用設定。商家或商店名稱。
phone_number

string

選用設定。商店的電話號碼，格式為 E.164。範例：+15556767888
website_uri

string

選用設定。商店或商家的網站網址。
place_id

string

選用設定。商店位置的 Google 地點 ID。
matching_state_hint

string

選用設定。僅供輸出。說明配對失敗的原因，只有在 matchingState=STORE_MATCHING_STATE_FAILED 時才會設定。

可能的值為：

  • linked-store-not-found：沒有可以配對的 Google 商家檔案商店。
  • 「store-match-not-found」：無法將你提供的LfpStore配對至任何已連結的 Google 商家檔案商店。Merchant Center 帳戶已正確連結，Google 商家檔案中也能顯示商店，但 LfpStore 地點地址與 Google 商家檔案商店的地址不符。請更新 LfpStore 地址或 Google 商家檔案商店地址，確保兩者相符。
  • 「store-match-unverified」：你提供的 LfpStore 無法配對至任何已連結的 Google 商家檔案商店，因為配對的 Google 商家檔案商店尚未經過驗證。完成 Google 商家檔案驗證程序，以便進行比對。

StoreMatchingState

LfpStore 與 Google 商家檔案配對的狀態。

列舉
STORE_MATCHING_STATE_UNSPECIFIED 未指定商店比對狀態。
STORE_MATCHING_STATE_MATCHED LfpStore 已成功配對 Google 商家檔案商店。
STORE_MATCHING_STATE_FAILED LfpStore 無法與 Google 商家檔案商店配對。

ListLfpStoresRequest

ListLfpStores 方法的要求訊息。

欄位
parent

string

必要欄位。本地動態饋給合作夥伴。格式：accounts/{account}
target_account

int64

必要欄位。要列出商店的商家 Merchant Center ID。
page_size

int32

選用設定。指定帳戶可傳回的 LfpStore 資源數量上限。如果指定帳戶的商店數量少於 pageSize，服務會傳回少於這個值的數量。預設值為 250。許可的最大值為 1000；如果指定的值高於上限，pageSize 預設值會設為上限。
page_token

string

選用設定。屬於接收自前一個 ListLfpStoresRequest 呼叫的網頁權杖。提供頁面符記即可擷取後續網頁。進行分頁時，提供至 ListLfpStoresRequest 的所有其他參數須與提供網頁權杖的呼叫相符。在先前要求的回應中，以 nextPageToken 形式傳回的權杖。

ListLfpStoresResponse

ListLfpStores 方法的回應訊息。

欄位
lfp_stores[]

LfpStore

指定商家的商店。
next_page_token

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。