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 を使用する必要があります。
region_code

string

必須。商品が販売される国の CLDR 地域コード。
content_language

string

必須。商品アイテムの 2 文字の ISO 639-1 言語コードです。
price

Price

省略可。商品の現在の価格。
availability

string

必須。この店舗での商品の在庫状況。使用できる属性値については、ローカル商品在庫データ仕様をご覧ください。
collection_time

Timestamp

省略可。インベントリが収集された時刻。設定されていない場合は、在庫が送信された時間に設定されます。
gtin

string

省略可。商品の国際取引商品番号。
quantity

int64

省略可。この店舗で購入できる商品の数量。0 以上の値を指定してください。
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 を使用する必要があります。
region_code

string

必須。商品が販売される国の CLDR 地域コード。
content_language

string

必須。商品アイテムの 2 文字の 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

省略可。ショップまたは販売者のウェブサイトの URL。
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

必須。LFP パートナー。形式: accounts/{account}
target_account

int64

必須。店舗を一覧表示する販売者の Merchant Center ID。
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 として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。