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 より少ない場合、サービスは pageSize より少ない値を返します。デフォルト値は 250 です。最大値は 1, 000 です。最大値を超える値を指定すると、pageSize はデフォルトで最大値になります。
page_token

string

省略可。前回の ListLfpStoresRequest 呼び出しから受け取ったページトークン。ページトークンを指定して、後続のページを取得します。ページ分割を行う場合、ListLfpStoresRequest に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。前のリクエストのレスポンスで nextPageToken として返されたトークン。

ListLfpStoresResponse

ListLfpStores メソッドのレスポンス メッセージ。

フィールド
lfp_stores[]

LfpStore

指定された販売者の店舗。
next_page_token

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。