Package madden.ingestion.offer

インデックス

• ActionType（列挙型）
• AdditionalFee（メッセージ）
• Coupon（メッセージ）
• Fee（メッセージ）
• FeeType（列挙型）
• FeeUnit（列挙型）
• FixedDenominations（メッセージ）
• FoodOfferRestrictions（メッセージ）
• GiftCardInfo（メッセージ）
• MealType（列挙型）
• MoneyRange（メッセージ）
• Offer（メッセージ）
• OfferCategory（列挙型）
• OfferCondition（メッセージ）
• OfferDetails（メッセージ）
• OfferMode（列挙型）
• OfferRestrictions（メッセージ）
• OfferSource（列挙型）
• OfferTag（列挙型）
• PaymentInstrument（メッセージ）
• PaymentInstrumentItem（メッセージ）
• PaymentInstrumentType（列挙型）
• Subscription（メッセージ）
• Terms（メッセージ）

ActionType

[START action_type_definition] オファーのフルフィルメント モードを表します。複数のフルフィルメント モードでオファーを共有できる場合は、フルフィルメント モードごとに重複するオファーが作成されることが想定されます。

列挙型
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY	この特典は、フード デリバリー サービスに適用されます。
ACTION_TYPE_FOOD_TAKEOUT	この特典は、料理のテイクアウトまたはテイクアウトの注文に適用されます。
ACTION_TYPE_DINING	特典はレストランでの食事に適用されます。
ACTION_TYPE_SHOPPING_IN_STORE	この特典は、オフラインの実店舗での購入に適用されます。

AdditionalFee

[START additional_fee_definition]

フィールド
name	string 追加料金の名前。例: 手数料、取り扱い手数料など。必須。
fee	Fee

クーポン

[START coupon_definition]

フィールド
text	string 特典提供者がユーザーに表示するクーポン テキスト。
code	string 特典を利用するために必要なクーポンコード。必須。

手数料

[START fee_definition] 次の ID: 5

フィールド
unit	FeeUnit
type	FeeType
共用体フィールド cost。 cost は次のいずれかになります。
amount	Money
amount_range	MoneyRange

FeeType

[START fee_type_definition]

列挙型
FEE_TYPE_UNSPECIFIED	フィードでは、UNSPECIFIED またはデフォルトの列挙値を使用しないでください。
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

列挙型
FEE_UNIT_UNSPECIFIED	フィードでは、UNSPECIFIED またはデフォルトの列挙値を使用しないでください。
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

フィールド
amounts[]	Money 利用可能なすべての個別の額面（[100, 500, 1000] など）のリスト。

FoodOfferRestrictions

[START food_offer_restrictions_definition]

フィールド
meal_types[]	MealType 特典を適用できる食事の種類（ランチ、ディナーなど）。設定しない場合、特典はすべての食事タイプに適用できます。
restricted_to_certain_courses	bool 特典を特定のコースにのみ適用できるかどうか。

GiftCardInfo

[START gift_card_info_definition]

フィールド
共用体フィールド denomination_type。 denomination_type は次のいずれかになります。
fixed_denominations	FixedDenominations ギフトカードが特定の固定金額で利用可能な場合に使用します。
custom_range	MoneyRange ブランドが、定義された範囲内でユーザーがカスタム（フレキシブル）の額面を選択できるようにする場合に使用されます。

MealType

[START meal_type_definition]

列挙型
MEAL_TYPE_UNSPECIFIED	UNSPECIFIED またはデフォルトの列挙値は、フィードで使用しないでください。
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

フィールド
min_amount	Money
max_amount	Money

特典

LINT.IfChange(offer_definition) [START offer_definition] 次のタグ: 26

フィールド
offer_id	string 特典の一意の ID。必須。
entity_ids[]	string この特典に参加している販売者のリスト。
add_on_offer_applicable_to_all_entities	bool true の場合、このオファーはアグリゲータのすべてのエンティティに適用されます。アドオン特典にのみ適用されます。
offer_source	OfferSource オファーは、アグリゲーター、個々の販売者、またはサードパーティがアドオンとして提供できます。必須。
action_type	ActionType 特典を提供しているサービス。offer_id は 1 つの action_type にのみ属することができます。オファーを複数のサービスタイプで共有できる場合は、サービスタイプごとに一意の ID を持つ重複するオファーが作成されることが想定されます。必須。
offer_modes[]	OfferMode 特典を利用できる方法（来店、予約、オンラインなど）。必須。
offer_category	OfferCategory 特典のカテゴリ。必須。
source_assigned_priority	int32 ソースによって割り当てられたオファーの優先度レベルを示す負でない整数（[1 ～ 100]、1 が最優先）。同じ販売者に対して複数の特典が利用可能な場合、これは特典のランキングのシグナルになります。0 は優先度が設定されていないことを表します。
offer_details	OfferDetails 割引、予約費用など、オファーの詳細。必須。
offer_restrictions	OfferRestrictions 特典がどのように制限されているかを説明します。たとえば、定期購入やお支払い方法が必要かどうか、この特典を他の特典と組み合わせることができるかどうか（およびその種類）などです。必須。
coupon	Coupon クーポンの詳細。offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER には必須です。
payment_instrument	PaymentInstrument お支払い方法の詳細。offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER には必須です。
subscription	Subscription サブスクリプションの詳細。offer_category が OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER の場合は必須です。
terms	Terms 特典の利用規約。必須。
validity_periods[]	ValidityPeriod 特典の有効期間。オファーが有効な期間（開始時刻、終了時刻、曜日など）を説明します。必須です。
offer_url	string 販売者の商品ページへの URL。offer_category: OFFER_CATEGORY_BASE_OFFER の場合は必須です。
image_url	string 販売者の特典画像の URL。
tags[]	OfferTag 特典に関連付けられた特別なタグ。これは、「祝祭」、「高評価」、「予約数最多」などのスペシャル オファーを識別するために使用されます。
brand_id	string 商品に関連付けられたブランドを指定します。設定されていない場合は、デフォルトのブランドが使用されます。

OfferCategory

[START offer_category_definition] オファーのカテゴリ。基本特典とは、すべてのお客様が利用できる標準的な特典（$100 以上のご利用で 10% 割引など）です。クーポンまたはお支払い方法によって制限されている基本プランには、それぞれのフィールドが設定されます。また、ADD_ON_PAYMENT_OFFER などのアドオン X の特典もあります。このような特典は、他の特典に追加して、追加の割引を受けることができます。

列挙型
OFFER_CATEGORY_UNSPECIFIED	UNSPECIFIED またはデフォルトの列挙値は、フィードで使用しないでください。
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER

OfferCondition

[START offer_condition_definition]

フィールド
description	string

OfferDetails

[START offer_details_definition] 次のタグ: 15

フィールド
offer_display_text	string オファー プロバイダが検索結果ページでユーザーに表示するオファーのテキスト。必須。
max_discount_value	Money 利用できる最大割引額。たとえば、10% 割引（最大 100 ドル）などです。
min_spend_value	Money 割引を利用するための最小利用額。たとえば、合計金額が 10, 000 円以上の場合に 10% 割引。
booking_cost	Money この特典の予約費用。たとえば、15 ドルでテーブルを予約すると、最終請求額から 100 ドル割引されます。
booking_cost_unit	FeeUnit 予約費用の単位。（例: 1 人あたり、1 回の取引あたり）。
convenience_fee	Fee
booking_cost_adjustable	bool 予約料金が調整可能かどうか（予約料金が最終請求額から差し引かれるかどうか）。例: 予約するとディナーが 30% 割引。予約費用は 15 ドルで、最終的な請求額に適用されます。したがって、最終的な請求額は「合計費用 - 30% - $15」となります。
additional_fees[]	AdditionalFee お客様に請求される追加料金。例: コンビニエンス、取り扱い、配送、梱包、サービス手数料など。
gift_card_info	GiftCardInfo ギフトカードの取引に固有の詳細。
共用体フィールド offer_specification。割引は、合計値から差し引かれる割合または固定値にすることができます。例: 1。最終請求額から 10% 割引。2. 1 回のご注文が 15 ドル割引になります。また、関連する仕様フィールドを使用して、「1 つ買うと 1 つ無料」などのカスタム割引を提供することもできます。必須。offer_specification は次のいずれかになります。
discount_percent	float 請求額の割引率。[0, 100] 食事全体に適用される 1+1 または 50% オフの特典（1+1 ビュッフェ、請求額全体が 1+1、セットメニューが 1+1 など）の場合、この値は 50 に設定できます。
discount_value	Money 割引の固定値。
other_offer_detail_text	string 割引を説明する自由形式のテキスト。特定の 1+1 オファー（1+1 ドリンク、+1 メインコース、1+1 選択メニューなど）については、ここで詳細を説明する必要があります。

OfferMode

[START offer_mode_definition] ユーザーが特典を利用できる方法またはチャネルを指定します。

列挙型
OFFER_MODE_OTHER	他の特定のモードでカバーされていない配送方法に使用します。
OFFER_MODE_WALK_IN	この特典は、事前予約なしでご来店いただいた場合にご利用いただけます。
OFFER_MODE_FREE_RESERVATION	この特典は、ユーザーが前払い料金を必要としない予約を行った場合に適用されます。
OFFER_MODE_PAID_RESERVATION	この特典は、ユーザーが前払いが必要な予約を行った場合に適用されます。
OFFER_MODE_ONLINE_ORDER	この特典は、ウェブサイトまたはデジタル プラットフォームから注文した場合に有効です。
OFFER_MODE_GIFT_CARD_PURCHASE	ギフトカードの購入が、特典を獲得するために必要な主なステップであることを示します。

OfferRestrictions

[START offer_restrictions_definition] 次のタグ: 11

フィールド
combinable_with_other_offers	bool この特典を他の特典と併用できるかどうか。true の場合、パートナーはこの特典と併用できる特典を指定できます。combinable_offer_categories と combinable_offer_ids の両方が設定されている場合、上記の条件のいずれかに一致する特典は組み合わせ可能です。
combinable_offer_categories[]	OfferCategory この特典と併用できる特典タイプのリスト。たとえば、この特典は他のクーポンと併用できる場合があります。combinable_with_other_offers が true で、このフィールドが設定されていない場合、すべてのタイプが組み合わせ可能になります。
combinable_offer_ids[]	string この特典と組み合わせることができる offer_id のリスト。一部の特典は、特定の他の offer_id（親特典とみなすことができます）とのみ組み合わせることができます。combinable_with_other_offers が true で、このフィールドが設定されていない場合、すべてのオファー ID を組み合わせることができます。
inclusions[]	OfferCondition 特典が有効になるために満たす必要がある条件のリスト（例: ノンアルコール飲料、食品）。
exclusions[]	OfferCondition 特典が無効になる条件のリスト（例: ビュッフェ、セットメニュー、カクテル）。
min_guest	int32 特典を利用するために必要な最小人数。
food_offer_restrictions	FoodOfferRestrictions フード特典に固有の制限事項。
special_conditions[]	string ユーザーに表示する必要があるこの特典の特別な条件。例: 「[地域] でのお支払いのみ有効」、「オンライン決済は対象外」

OfferSource

[START offer_source_definition]

列挙型
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

列挙型
OFFER_TAG_UNSPECIFIED	フィードでは、UNSPECIFIED またはデフォルトの列挙値を使用しないでください。
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

フィールド
items[]	PaymentInstrumentItem 特典の利用に使用できる支払い方法のリスト。必須。
provider_name	string 支払い方法のプロバイダの名前。銀行パートナー、銀行名など。例: American Express、HDFC、ICICI。

PaymentInstrumentItem

[START payment_instrument_item_definition]

フィールド
type	PaymentInstrumentType 支払い方法の種類。必須。
name	string クレジット カードの名前など、お支払い方法のアイテムの名前。例: HDFC Infinia、American Express Platinum。必須。

PaymentInstrumentType

[START payment_instrument_type_definition]

列挙型
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED	フィードでは、UNSPECIFIED またはデフォルトの列挙値を使用しないでください。
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

サブスクリプション

[START subscription_definition]

フィールド
name	string サブスクリプションの名前。 必須。
subscription_auto_added	bool ユーザーがこの特典を利用したときに定期購入が自動的に追加されるかどうか
cost	Money サブスクリプションの費用。必須。
subscription_duration	Duration 定期購入の費用 [subscription_cost] で定期購入が有効な期間。必須。
terms_and_conditions_url	string このサブスクリプションに関連するパートナーの利用規約の URL。

利用規約

[START terms_definition]

フィールド
url	string パートナーの利用規約の URL。
restricted_to_certain_users	bool 特典が特定のユーザーに限定されているかどうか。
terms_and_conditions	string パートナーから提供されたメインの利用規約テキスト。
additional_terms_and_conditions[]	string パートナーの主な利用規約に加えて適用される利用規約。