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

僅供輸出。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

選用設定。這項優惠支援的取貨方式。除非值為「不支援」，否則這個欄位必須與 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

必要欄位。商店的街道地址。範例：臺灣臺北市信義區信義路五段 7 號
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」：相符的 Google 商家檔案商店尚未驗證，因此提供的 LfpStore 無法與任何已連結的 Google 商家檔案商店進行比對。請務必完成 Google 商家檔案驗證程序，才能正確比對。

StoreMatchingState

與 Google 商家檔案相符的「LfpStore」狀態。

列舉
STORE_MATCHING_STATE_UNSPECIFIED 未指定儲存比對狀態。
STORE_MATCHING_STATE_MATCHED LfpStore已成功與 Google 商家檔案商店配對。
STORE_MATCHING_STATE_FAILED LfpStore與 Google 商家檔案商店不相符。

ListLfpStoresRequest

ListLfpStores 方法的要求訊息。

欄位
parent

string

必要欄位。LFP 合作夥伴。格式︰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 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。