Package google.maps.booking.v1alpha

string

このアクション リンクのエントリポイント URL。

string

この URI のコンテンツを利用できる言語を識別する BCP-47 言語タグ。

string

ISO 3166-1 alpha-2 の国コード。表示を制限しない場合は空のままにします。

ActionPlatform

このアクションを実行するプラットフォーム。このフィールドが設定されていない場合は、代替として ACTION_PLATFORM_WEB_APPLICATION が使用されます。

ActionLinkType

事前定義されたアクションのタイプ。

OrderOnlineMetadata

注文オンライン リンクのメタデータ。ActionLinkType が ACTION_LINK_TYPE_SHOP_Online のアクションをサポートします。

FoodOrderingMetadata

料理の注文リンクのメタデータ。サポートされるアクション タイプ: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT ACTION_LINK_TYPE_ORDER_FOOD はサポートしていません。

Text

「Google で予約」で予約する際にユーザーに表示されるカスタム メッセージ。

Timestamp

予約スロットの開始時刻。

Duration

予約枠の期間

int64

この予約枠の合計スポット数と空きスポット数。例:

• 10 個のスポットがあるヨガクラスで 3 個が予約済みの場合: availability {spots_total: 10, spots_open: 7 ...}
• チェア マッサージの 1 回の施術が完全に予約済みの場合: availability {spots_total: 1, spots_open: 0 ...}

注: 以下で定義されている空き状況の圧縮形式を使用してリクエストを送信すると、これら 2 つのフィールドが推定されます。

• Recurrence では、spots_total=1 と spots_open=1 が推定されます。
• ScheduleException では、spots_total=1 と spots_open=0 が推定されます。

int64

空きスポットの数。

string

この予約枠を識別するための不透明型文字列（省略可）。設定すると、予約の予約、更新、キャンセルのリクエストに含まれます。

Resources

異なるスタッフや部屋がサービスに含まれている場合に、個々の予約枠を区別するために使用されるリソース（省略可）。

たとえば、1 つのヨガクラスに 2 人のインストラクターがいる場合:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

このスロットの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。

このフィールドは、サービス メッセージで指定された payment_option_id をオーバーライドします。同様に、ここで指定された payment_option_id はサービス メッセージに存在する必要はありませんが、Merchant レベルで定義する必要があります。

Recurrence

空き状況の繰り返しに関する情報で、複数の開始時刻を表します。繰り返しには、1 営業日の予約を含める必要があります。

ScheduleException

このサービスをスケジュールできない時間。schedule_exception メッセージの数を制限するには、隣接する例外を結合することを検討してください。

Deposit

この空き情報の保証料（省略可）。サービス デポジットが指定されている場合は、オーバーライドします。

NoShowFee

この空き状況用の無断キャンセル料（省略可）。サービスの無断欠席料金が指定されている場合は、オーバーライドします。

RequireCreditCard

この予約枠を予約するために、ユーザがクレジット カードを提供する必要があるかどうかを示します。値が設定されていない場合、サービスレベルから値が継承されます（設定されている場合）。（省略可）

string

この空き状況スロットでサポートされているチケットタイプのリストを示します。設定されていない場合、親サービスのすべてのチケットタイプをこのスロットで使用できます。なお、このフィールドの値は親サービスで定義する必要があります。たとえば、次のように定義します。

• 4 つのチケットタイプがあるサービスの場合: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

平日の空き情報を表す場合: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}。休日の空き情報を表す場合: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}。

• 3 つのチケットタイプがあるサービスの場合: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

この時間枠で 3 つのチケットタイプすべてを使用できることを示すには、availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} または availability {...} を使用します（この予約枠に ticket_type_id は設定しないでください）。

（省略可）

DurationRequirement

スロットの期間や終了時間を表示するための要件。時間枠が利用できない場合、このフィールドは無視されます。おすすめスポットのカテゴリでは使用されません。（省略可）

SchedulingRuleOverrides

空き状況のスケジュール設定ルール。フィールドに値が入力されている場合は、サービスレベルの SchedulingRules の対応するスケジューリング ルールがすべてオーバーライドされます。

ConfirmationMode

この空き状況の予約時に使用される確認モード。CONFIRMATION_MODE_SYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に確認または拒否されます。確認モードが CONFIRMATION_MODE_ASYNCHRONOUS の空室状況の予約を作成しようとすると、直ちに拒否するか、ステータスが PENDING として作成する必要があります。

Timestamp

空き状況が繰り返される最終時間として含める UTC タイムスタンプ。

Duration

後続の予約枠との間隔を定義します。

例: duration が 20 分、repeat_every が 30 分、start_time が午前 9:00、repeat_until が午前 11:00 の空き情報は、午前 9:00～9:20、午前 9:30～9:50、午前 10:00～10:20、午前 10:30～10:50、午前 11:00～11:20 となります。（必須）

TimeRange

例外の時間帯。繰り返しで記述された予約枠内で、例外の時間帯（左閉右開）が重複する時間帯は、利用不可と見なされます。

例: duration が 20 分、repeat_every が 30 分、start_time が午前 9:00、repeat_until が午前 11:00 で繰り返しが指定され、time_range が午前 9:45～11:00 で ScheduleException が指定されている場合、午前 9:30～9:50、午前 10:00～10:20、午前 10:30～10:50 は利用できません。

例外の時間帯は左閉右開であるため、午前 11:00 から始まる予約枠は影響を受けません。

int64

この予約枠を予約できる最終時間（秒）。このタイムスタンプは、遵守されるべき予約枠の start_sec より前にくる必要があります（ユーザーが開始時刻を過ぎてから予約できる場合は、サービスレベルで SchedulingRules.min_booking_before_end_time を使用します）。この要素が存在する場合、対応する Service の SchedulingRules の min_booking_buffer で指定された値をオーバーライドします。

int64

この予約枠を予約できる開始時刻（秒）。このタイムスタンプは、スロットの start_sec より前にする必要があります。指定する場合は last_bookable_sec より前にする必要があります。

int64

設定した場合、この予約枠を Google で予約でキャンセルできる最後の時間（Unix エポックからの経過秒数）。この項目は、サービスレベルのキャンセル ルールよりも優先されます。（省略可）

string

リソース名（partners/{partner_id}/feeds/{feed_name} の形式）。

GenericDeleteRecord

削除するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。

string

リソース名（partners/{partner_id}/feeds/{feed_name} の形式）。

GenericRecord

挿入または更新するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。

string

partners/{partner_id} の形式。

ExtendedServiceAvailability

既存の予約枠を置き換えるために使用される、サービスの延長された可用性。

ExtendedServiceAvailability

既存の予約枠を置き換えるために使用された拡張サービスの空き時間メッセージが正常に更新されました。

string

予約のリソース名: partners/{partner ID}/bookings/{booking ID}

string

スロットの販売者の ID

string

販売者サービスの ID

Timestamp

予約枠の開始時刻

Duration

予約枠の期間

ClientInformation

予約を取るクライアントの個人情報

BookingStatus

予約のステータス

PaymentInformation

予約に関連する支払い取引に関する情報。

int64

予約の人数

Cause

予約が失敗した理由。（必須）

CreditCardType

（原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合のみ必須）

string

パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。（省略可）

PaymentFailureInformation

支払いのエラーに関する情報。

ThreeDS1Parameters

ユーザーとの 3DS1 認証プロトコルを開始するために、RwG アグリゲータによって使用されるパラメータ。BookingFailure.cause が PAYMENT_REQUIRES_3DS1 に設定されていない限り、無視されます。

string

認証のためにユーザーに提示するフォームの読み込み元となる URL。

string

PaymentAuthentication リクエスト。ACSUrl フォームに送信されます（指定されている場合）。

string

ACS プロバイダにより使用される識別子。ACSUrl フォームに送信されます（指定されている場合）。

string

販売者データ。ACSUrl フォームに送信されます（指定されている場合）。

RefundCondition

ポリシーに適用される 0 個以上の払い戻し条件。

Duration

開始時刻までの期間。顧客は、この時刻まで refund_percent で指定されたサービス価格の一部の払い戻しを受け取ることができます。0（デフォルト）に設定すると、サービスはいつでもキャンセルできます。

uint32

サービス開始時刻の min_duration_before_start_time 以前にサービス予約がキャンセルされる限り、払い戻し可能な金額の割合（[0, 100] の範囲）。0（デフォルト）に設定すると、サービスは払い戻しできません。100 に設定すると、このサービスは全額払い戻しされます。

string

お客様の名

string

クライアントの姓

PostalAddress

クライアントの住所

string

クライアントの電話番号

string

クライアントのメールアドレス

string

この販売者を所有するパートナーの親リソース名。partners/{partner_id} の形式で指定します。

string

この販売者に使用する販売者 ID。

Merchant

作成する販売者。

string

このサービスを所有する販売者の親リソース名。partners/{partner_id}/merchants/{merchant_id} の形式で指定します。

string

このサービスに使用するサービス ID。

Service

作成するサービス。

CreditCardType

サポートされているクレジット カードのリスト。空白の場合、クレジット カードはサポートされません。

string

削除する販売者のリソース名形式は Partners/{partner_id}/merchants/{merchant_id} です。

string

削除するサービスのリソース名partners/{partner_id}/merchants/{merchant_id}/services/{service_id} の形式

Price

デポジットの金額。

int64

デポジット事前キャンセルの最低額。

PriceType

在庫状況から保証料を決定する方法を定義します。

Text

お支払いには、下記のお支払い方法のみをおすすめします。

Duration

最小期間。

Duration

最大期間。

string

以下の空き情報メッセージが属する販売者を指定するために必要なフィールドです。

string

以下の空き情報メッセージが属するサービスを指定するために必要なフィールドです。

Timestamp

指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

duration メッセージが設定されている場合、条件はさらに制限されます。

  availability.duration == duration_restrict

resource_restrict メッセージが設定されている場合、条件はさらに制限されます。

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。

start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。

Timestamp

start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までの時間と解釈されます。

Duration

duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。

Resources

resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。

Availability

空き情報の新しいリスト。

int64

このフィードにより新しく追加された項目。フィードの種類に応じて、販売者、サービス、予約枠のいずれかがアイテムになります。

int64

既存の商品アイテム。必要に応じてフィードの新しい情報から更新されます。

int64

このフィードに存在しなくなったため、結果として削除された商品アイテム。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

このフィードの処理ステータス。

string

このフィードを処理できなかった場合に詳細情報を提供する、人が読める形式の文字列。

FeedStatistics

このフィードに固有の統計情報。

FeeDetails

アイテムの合計額に加えて、ユーザーに請求された手数料の詳細。サービス手数料や配送料など、さまざまな料金について繰り返します。

AdvanceOrderDetails

事前注文とも呼ばれ、ユーザーが今よりも後でフルフィルメントを注文できる、事前注文サポートの詳細。

Duration

固定期間。例: 30 分。

DurationRange

期間の範囲。例: × 30 分～ 45 分 * 30 分超 * 50 分未満

bool

事前注文（事前注文とも呼ばれます）がサポートされている場合は true。（必須）

FeeType

料金タイプ。（必須）

FeeAmount

単位通貨、カートの金額に対する割合、または両方の組み合わせで表現した料金。（必須）

QuantitativeValue

カートの金額の割合で表した料金。範囲（制限ありおよび制限なし）または固定の割合を指定できます。値は 0 ～ 100 の範囲で指定してください。例: * 固定 5.5% * 少なくとも 5.5% * 最大 5.5% * 4.5% ～ 5.5%

Money

固定額。例: USD 3.5

MoneyRange

金額の範囲。例: * 3.5 米ドル～ 5.5 米ドル * 3.5 米ドル以上 * 5.5 米ドル以下

bool

金額は不明です。

FulfillmentType

必須。フルフィルメント タイプ。

AvailableDay

必須。この納品方法を利用できる日数のリスト（できれば 2 日以上）。

FeeDetails

必須。フルフィルメント方法の手数料の詳細。

Price

必須。アクション リンクに関連付けられたフルフィルメント メソッドの最低注文額。

Date

必須。納品方法を利用できる日付。販売者のタイムゾーンに基づきます。

Timestamp

必須。Unix タイムスタンプ。ユーザーが最後に注文し、商品を受け取れた日時（fulfillment_date）。つまり、last_ordering_time の後は、fulfillment_date が在庫として表示されなくなります。

たとえば、fulfillment_date が 2020-08-10 の場合: - last_ordering_time の値が 2020-08-10 18:00 の場合、2020-08-10 に注文を受け取るには、その日の午後 6 時までに注文を行う必要があります。- last_ordering_time の値が 2020-08-08 20:00 の場合、顧客は 2020-08-10 に注文を受けるには、2 日前の午後 8 時までに注文を行う必要があります。

NoFee

フルフィルメントの方法に手数料はかかりません。

MinimumFee

フルフィルメント方法に関連付けられた基本料金。

FixedFee

フルフィルメント方法に関連付けられた固定料金。

Price

必須。フルフィルメント方法の固定料金の金額。

Price

必須。フルフィルメントの方法の基本料金。

Timestamp

必須。このタイムスタンプは、在庫が削除される順序を決定するために使用されます。

bytes

proto を使用しないフィードの場合。

Any

proto ベースのフィード用。

Timestamp

必須。このタイムスタンプは、在庫更新の正しい順序を保証するために使用されます。

bytes

proto を使用しないフィードの場合。

Any

proto ベースのフィード用。

double

緯度。（省略可）

double

経度。（省略可）

PostalAddress

場所の住所（推奨）。

string

非構造化住所例:「東京都千代田区神田錦町 3-22 テラススクエア 8 階 | 03-4577-4401」

string

必須。リソース名。Partners/{partner_id}/merchants/{merchant_id}/status の形式で指定します。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

このホームサービスが属する上位カテゴリ。例:配管工、電気工など

string

特定のホームサービスが属するカテゴリの職種。例:unclog_drain、install_faucet は、配管工カテゴリの職種です。

string

無効化するリソースの名前。

たとえば、Pickup リソースの場合、名前は partners/{partner_id}/pickups/{pickup_id} の形式にする必要があります。実装は、識別されたリソースのキャッシュ バージョンを削除しなければなりません。

string

販売者の Service の ID。

int64

予約枠の開始時間（Unix エポックからの UTC 時間）。

int64

予約枠の長さ（秒）。

OrderedTickets

チケットタイプ別に注文されたチケットの数。

Price

この広告申込情報の合計金額（税抜き）。

BookingStatus

広告申込情報のステータス。

string

チケットタイプの ID。

int32

このタイプで注文されたチケットの数。

string

必須。この販売者ステータスのコレクションを所有する親。形式: partners/{partner_id}/merchants

int32

必須。返される最大アイテム数。サーバーがページサイズを小さくする可能性があるので注意してください。

string

省略可。前の ListMerchantStatusResponse から返された nextPageToken 値（存在する場合）。

BookingInventoryStatus

省略可。予約広告枠のステータスで結果をフィルタするオプションの制限。

WaitlistInventoryStatus

省略可。順番待ちリストの在庫ステータスで結果をフィルタするオプションの制限。

GeoMatchingStatus

省略可。地域の一致ステータスで結果をフィルタするオプションの制限。

MerchantStatus

フィルタ条件を満たす販売者のステータスのリスト。

string

次の結果ページを取得するためのトークン。空の場合、リストにそれ以上の結果はありません。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

返す最大アイテム数。

string

前の List リクエストから返された next_page_token 値（存在する場合）。

State

フィードの状態によって結果をフィルタするオプションの制限。

TimeRange

（省略可）結果を上限と下限でフィルタするための制限。start_time が設定されていない場合は、デフォルトで Unix 時間の起点に設定されます。end_time が設定されていない場合は、デフォルトで現在に設定されます。

FeedStatus

アップロードしたフィードのステータスを日付の新しい順に並べ替えます。返されるアイテムの最大数はリクエストの page_size フィールドに基づきます。

string

次の結果ページを取得するためのトークン。空の場合、リストにそれ以上の結果はありません。

string

IETF BCP 47 言語コード（「en」、「mas」、「zh-Hant」、「de-CH-1901」など）。詳しくは http://www.w3.org/International/articles/language-tags/ をご覧ください。

string

上記のロケール（UTF-8）のメッセージ。

string

Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定されている場合、Google は場所とこの場所を照合します。

string

場所の名前、電話番号、URL、地域は、その場所を Google マップにすでに表示されている場所とマッチングするために使用されます。

このフィールドは省略可能ですが、状況によっては必須の場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、事業体には一致しません。（省略可）

string

国番号と市外局番を含む、ビジネス拠点の電話番号（例: +14567891234）。（省略可）

string

ビジネス拠点の公開ウェブサイトの URL。（省略可）

GeoCoordinates

ビジネス拠点の地理情報（緯度、経度、住所など）。（省略可）

LocationType

ロケーションのタイプ。このロケーションが Service に対して指定されている場合は指定する必要があります。

string

サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービス フィールドでこのビジネス拠点を参照できます。例:カスタム登録フォームでは、地域 ID のセットを使用して乗車場所のオプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。（省略可）

string

販売者のリソース名。partners/{partner_id}/merchants/{merchant_id} の形式で指定します。

string

merchant_name、電話番号、URL、地域は、パートナーの空き情報を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。

販売者の名前。

string

国コードと市外局番を含む販売者の公開電話番号。例:+14567891234。

string

販売者の公開ウェブサイトの URL。

GeoCoordinates

販売者の地理情報（緯度、経度、住所など）。

string

アグリゲータのプラットフォームにおけるビジネスのカテゴリ。

int64

このフィールドのサポートは終了しました。

uint32

販売者の税率（ベーシス ポイント: 1% の 100 分の 1）。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。

このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。

このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。

このフィールドは非推奨です。代わりに、tax_rate を使用してください。

TaxRate

販売者の税率。指定されている場合、このフィールドは非推奨の tax_rate_basis_points フィールドをオーバーライドします。空のメッセージ（例: tax_rate { }）は、適用される税率を 0 にリセットします。

PaymentRestrictions

この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合は、制限はないものとみなされます。

PaymentOption

この販売者で利用可能な支払いオプション。この販売者のサービスは、許可する支払い方法を個別に制限できます。

PaymentProcessorConfig

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

TokenizationConfig

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

Terms

「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。これらに加えて、アグリゲータ パートナーの利用規約は常にユーザーに表示されるものであり、ここでは提供しないでください。

string

パートナーの帰属を表示する際に使用する、消費者向けのブランドを識別する不透明型の文字列。このフィールドを使用すると、複数の消費者向けブランドを所有するパートナーが、同じフィード内のすべてのブランドの販売者を指定できます。

ブランドは、名前、ロゴ、利用規約、プライバシー ポリシーなど、消費者向けのプロパティで構成されます。

消費者向けのパートナー ブランドが 1 つしかない場合は、このフィールドを設定する必要はなく、無視してかまいません。

パートナーの種類別の処理方法:

消費者向けのブランドが 1 つしかない場合は、このフィールドは無視します。

複数のブランドが設定されている場合は、次のように処理されます。

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

注意: ほとんどのパートナーは、このフィールドを設定する必要はありません。パートナーがこのフィールドを使用する場合は、各ブランド（デフォルトのブランドを含む）を個別に設定する必要がありますので、Google までご連絡ください。

MerchantMatchingHints

販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。（省略可）

ServiceAttribute

この販売者のサービスを説明するために使用されるサービス属性の定義。（省略可）

ActionLink

省略可。アクションの URL（関連する言語、制限されている国のリスト、タイプ、このアクションを実行するプラットフォームを示すオプションのプラットフォームを含む）。

Advisement

省略可。「Google で予約」を通して順番待ちリストに登録するユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイス内の個々のテキスト フィールドの長さは 100 バイト以下にしてください。

string

Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。

string

販売者ステータスのリソース名。形式は partners/{partner_id}/merchants/{merchant_id}/status です。

string

パートナーから提供された販売者の名前。

GeoCoordinates

パートナーが提供した販売者の地域情報。

ProcessingStatus

販売者の処理ステータス。

BookingStatus

エンドツーエンドの予約統合に関連するステータス。

WaitlistStatus

順番待ちリストの統合に関連するステータス。

PlaceInfo

この販売者の一致する地域。販売者が地域と一致していない場合は空になります。

LocalServicesMatchInfo

この販売者のローカル サービス広告が一致しました。ローカル サービスの販売者でない場合、またはどのプロバイダとも一致しない場合は空になります。

DirectUrl

現在の販売者の在庫の内容を示す URL のリスト。ただし、広告枠が実際に配信されているという意味ではなく、URL が一般公開 URL と異なる場合があります。

bool

販売者に今後 30 日以内に在庫がある場合は true。販売者が実際にサービスを提供していることを保証するものではありません。

UrlType

この URL のタイプ。

string

この販売者を表示する URL。

MatchedProvider

一致したサービス プロバイダ。販売者は、複数のサービス プロバイダとマッチングされる場合があります。

int64

Google ローカル サービスの外部お客様 ID。

string

ローカル サービスのカテゴリ（カテゴリ）。例:「配管工」「carpet_cleaning」と入力します

string

場所の名前です。

string

現地の言語でフォーマットされた住所。

string

この場所の Google の場所 ID。Google マップの URL の作成、または場所の詳細情報の取得に使用できます。使用例については、https://developers.google.com/places/web-service/place-id をご覧ください。

bool

販売者が順番待ちリストサービスを利用している場合は true。販売者が実際にサービスを提供していることを保証するものではありません。

Money

最低額。

Money

限度額です。

Price

予約時にユーザーが予約しなかった場合に請求される可能性のある金額。

PriceType

空室状況から料金をどのように決定するかを定義します。

string

注文のリソース名: partners/{partner ID}/orders/{order ID}

ClientInformation

注文を行うクライアントの個人情報。

PaymentInformation

注文に関連する支払い取引に関する情報。

string

この注文に含まれるすべてのサービスが属する販売者の ID。

LineItem

この注文の広告申込情報。

FulfillmentOption

オンライン注文アクション リンクで使用可能なフルフィルメント オプション。

PrepaymentStatus

予約の前払いステータス。prepayment_status が PREPAYMENT_PROVIDED または PREPAYMENT_REFUNDED の場合、payment_transaction_id には関連する一意の取引 ID が含まれます。

string

予約に関連付けられた支払い処理の一意の識別子。該当しない場合は空になります。

string

この ID は、この支払いオプションを識別するために使用されます。

この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。

ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。

string

支払いオプションの名前。ユーザーに表示される可能性があります。

string

支払いオプションについての説明。ユーザーに表示される可能性があります。

Price

支払いオプションの価格。

TaxRate

この支払いオプションの税率。指定されている場合、このフィールドは Merchant または Service にある tax_rate フィールドをオーバーライドします。空のメッセージ（例: tax_rate { }）は、適用される税率を 0 にリセットします。

PaymentOptionType

この支払いオプションの種類。ドロップインの場合は 1 回限り、パックの場合は複数回、メンバーシップの場合は無制限。

int64

この支払いオプションを利用できるセッション数。マルチセッションまたはパックでのみ有効。値には「>」を指定する必要があります。1.

TimeRange

この期間内に支払いオプションを購入できます。

TimeRange

支払いオプションはこの期間内に利用できます（例: 2017 年 1 月の特別価格）。存在する場合は、valid_duration と activation_type をオーバーライドします。

Duration

支払いオプションの有効期間（例: 30 日間のメンバーシップ）。

ActivationType

この支払いオプションの有効期限の開始日を決定する方法を定義します。

UserPurchaseRestriction

この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定しない場合、すべてのユーザーが対象となります。

Processor

この構成が適用される決済代行業者パートナーを定義します。

string

この販売者を決済代行業者に応じて識別するために使用するキー。

Stripe については、https://stripe.com/docs/dashboard#api-keys をご覧ください。Braintree については、https://articles.braintreepayments.com/control-panel/important-gateway-credentials をご覧ください。

string

支払いリクエストとともに決済代行業者に送信される API バージョン番号。

CreditCardRestrictions

この販売者が受け付けるクレジット カードに関する制限。このフィールドが設定されていない場合は、すべてのクレジット カードが受け付けられるとみなされます。なお、CreditCardType でサポートされるカードのリストは今後増えていくことにご留意ください。つまり、このフィールドを空のままにすると、将来的な変更の対象となる可能性があります。

Price

送料は配送方法によって異なる場合があります。

Price

ユーザーのお支払い方法を処理するための料金。

Price

サービスに対して請求される追加料金。

Price

会場や施設に行く料金。

Price

チケット 1 枚あたりの税金。

string

ISO 3166-1 alpha-2 国コードを使用して指定された国。例:「US」（必須）

string

地域区分（例: 横須賀市）（必須）

string

県（例: 神奈川県）。このフィールドは、県が住所の一部である国でのみ必須です。（省略可）

string

郵便番号（例: 94043）。（必須）

string

番地（例: 大町 3-5）。（必須）

int64

価格（最小通貨単位）。最小通貨単位の端数は、最近接偶数に丸められます（例: 2.5 セントは 2 セントに、3.5 セントは 4 セントに、0.5 セントは 0 セントに、2.51 セントは 3 セントに四捨五入されます）。

string

ISO 4217 で定義された価格の通貨。

string

拡張価格に関連付けられている価格設定オプションを識別する、省略可能な不透明な文字列。

double

単一値。例: 5.6

RangeValue

自由回答形式または制限ありの値の範囲です。例: * 5.5 以上 * 5.5 以下 * 5.5 ～ 6.5

double

最小値。

double

最大値

double

平均評価値（number_of_ratings > 0 の場合は必須）。値は [1, 5] の範囲内である必要があり、number_of_ratings がゼロの場合にのみ省略できます。

uint64

価値の計算に使用された評価の数（必須）。

string

このメディアソースの URL。Google はこの URL でホストされているメディアをクロールします。

MediaType

このメディアソースのタイプ。

Text

i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。（省略可）

Attribution

メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。（省略可）

string

非推奨。localized_caption を使用することをおすすめします。

Text

i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドでは書式なしテキストのみがサポートされ、HTML コンポーネントはすべて削除されます（ハイパーリンク ベースのアトリビューションはサポートされません）。

string

非推奨。localized_text を使用することをおすすめします。

ServiceAvailability

既存のサービスの可用性を置き換えるために使用されるサービスの可用性。

string

サービスを提供するスタッフの ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。Staff_name が存在する場合、このフィールドは必須です。

string

サービスを提供するスタッフ メンバーの名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。employee_id が存在する場合、このフィールドは必須です。

string

サービスが提供される部屋の ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。Room_name が指定されている場合は、このフィールドを指定する必要があります。

string

サービスが提供される部屋の名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。（省略可。ただし、room_id が存在する場合は必須）食事では、部屋名はバーやパティオなどの座席エリアにのみ使用し、定額メニュー、スペシャル アクティビティ、その他の客室以外の値（予約やディナーなど）には使用しないでください。デフォルトの座席エリアには部屋を関連付けないことを強くおすすめします。

int32

Dining のみ: この時間枠に対応できる人数。レストランは複数の Slot に同時に関連付けることができます。たとえば、予約で 2 人、3 人、4 人が座れる場合、それぞれが異なる party_size を指定できます。

int64

予約をオンラインでキャンセルするために必要な最小事前通知期間（秒単位）。（省略可）

Price

最小事前通知期間内のキャンセル料。

Price

無断キャンセル料。

AdmissionPolicy

このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。（省略可）

CancellationPolicy

キャンセル ポリシーのスケジュール設定ルール。（おすすめスポットに必須）

int64

最後の予約が可能になってから予約枠が開始するまでの時間（秒単位）。

int64

最終予約可能時間から予約枠の終了時刻までの期間（秒単位）。 このフィールドが設定されている場合、「admission_policy」フィールドを TIME_FLEXIBLE に設定して、スロットの開始後にユーザーが購入したチケットを使用できることを示す必要があります。

string

サービス リソース名。形式は partners/{partner_id}/merchants/{merchant_id}/services/{service_id} です。

string

サービスの名前（例: 「メンズ ヘアカット」）。非推奨。代わりに localized_service_name を使用してください。

Text

サービスの名前（例: 「メンズ ヘアカット」）。複数の言語 / 地域で使用される可能性があります。

string

ユーザーに表示される、サービスの説明。非推奨。代わりに localized_description を使用してください。

Text

ユーザーに表示される、サービスの説明。

このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。

サポートされている HTML に類似する形式の書式設定タグ:

見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6>
見出しタグはタイトルとサブタイトルの表示に使用できます。たとえば、「<h1>旅行プラン</h1>」と入力すると、セクションの最も重要な見出しとしてインライン テキストが表示されます。なお、内部 HTML タグ、スタイル、属性は無視されます。たとえば、<h1 style=".."> は <h1> と同様に扱われ、書式なしテキストのみが保持されます。

段落タグ: <p>
段落タグを使用して、詳細な紹介やコンテンツを強調できます。内部タグ、スタイル、属性はすべて無視されます（例外: <br>、<strong>、<em>）。詳しくは、下記のフレーズタグのセクションをご覧ください。

リストタグ: <ul>、<ol>、<li>
<ul> タグを <li> タグとともに使用して、順序なしリストを表示できます。また、<ol> タグを <li> タグとともに使用して、順序付きリストを表示できます。チェックリスト、スケジュールなど、使用方法に合ったリストを表示するのに適しています。
例: クルーズ旅行の特長のリストを表示する場合:
<ol>
<li>素晴らしいオーシャン ビューと野生動物と遊ぶチャンス</li>
<li>慎重にデザインされた旅行プランとサービス</li>
<li>最低価格が保証されています。</li>
</ol>
なお <li><ul> 歳未満の子供または <ol>タグが変換されます。他のすべての子タグは削除されます。また、内部タグ、属性、スタイルはすべて無視されます。保持されるのは、書式なしテキスト コンテンツのみです。

分割タグ: <div>
<div> タグのサポートされているすべての内部タグは、上記のルールで解析されます。ここで、<div> タグ自体はグループ化やインデント化を意味しません。また、内部属性とスタイルはすべて無視されます。

フレーズタグ: <br>、<strong>、<em>:
上記 3 つのタグのみがサポートされています。<br> を使用すると、段落の改行ができます。また、<strong> または <em> を使用すると、重要なテキストをハイライト表示できます。その他のフレーズタグは無視されます。

サポートされていないタグ:

• <html>、<header>、<body> タグは使用できません。
• 上記以外のタグ（<table>、<td> など）はサポートされていません。
  URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。ユーザー エクスペリエンスを豊かにするために写真を使用する場合は、下の「related_media」フィールドを使用して写真の URL を送信してください。
  

注意事項:

• 上記のサポートされているタグ以外は使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスが低下する可能性があります。
  
• 3 つを超える見出しレベルやネストされたリストなど、ネスト構造をあまり深くしないでください。浅くシンプルで単純な構造にすることで、ユーザーエクスペリエンスが向上します。
  
• 現在サポートされているレイアウトではお客様の使用方法に適さない場合は、「Google で予約」チームにお問い合わせください。
  
• 推奨される最大サイズは半角 32,000 文字（全角 16,000 文字）です。

Price

サービスの料金。

PriceInterpretation

価格を解釈してユーザーに表示する方法について説明します。「食事」と「おすすめスポット」を除くあらゆる業種で、サービス価格の表示の設定に使用できます。

SchedulingRules

予約やキャンセルのルール。

PrepaymentType

前払いが必須か、任意か、サポートされていないか。

PrepaymentTerms

前払いの完了時期に関する条件。

ServiceIntakeForm

非推奨です。intake_form と per_ticket_intake_form を使用してください。

ServiceIntakeForm

このサービスの予約時にユーザーに追加情報を尋ねるフォーム。（省略可）

ServiceIntakeForm

このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。（省略可）

TaxRate

サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された tax_rate をオーバーライドします。空のメッセージ（例: tax_rate { }）は、適用される税率を 0 にリセットします。

string

このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。

Deposit

ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。（省略可）

NoShowFee

ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。（省略可）

RequireCreditCard

このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。（省略可）

ActionLink

このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service にタイプ（下記参照）を設定する必要があります。

ServiceType

このサービスの事前定義されたタイプ。（省略可）

TicketType

チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。（省略可）

RelatedMedia

このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。（省略可）

ServiceAttributeValueId

このサービスに適用される Service 属性値（省略可）。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。（省略可）

WaitlistRules

順番待ちリストに登録するためのルール。

TicketingVerticalSpecificData

イベント チケット販売業種に固有の追加情報。（省略可）

IntegrationType

このサービスでサポートされる統合の程度。（省略可）試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンドは常に無効になります。

PerOrderFee

このサービスを購入するための注文レベルの料金。（省略可）

ToursAndActivitiesContent

ツアーとアクティビティに固有のコンテンツ フィールド。

Location

このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。

Rating

このサービスに対するユーザーの評価を、すべてのレビューの集計指標として示します。

HomeServiceData

ホームサービス カテゴリに固有の追加情報。（省略可）

VirtualSession

省略可。仮想セッションに関する情報。仮想サービスを有効にするために必要です。

DirectMerchantPayment

省略可。サービスでユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: この取引には RwG は関与しません。virtual_session が定義されていて、Service が Free でない場合、または prepayment_type が REQUIRED に設定されていない場合は指定する必要があります。

ChargeTiming

購入日時を基準に請求が行われるタイミング。

int64

サービス開始時刻までの経過時間（秒）。この時刻までにユーザーに支払いが行われます。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。

string

同じ販売者のサービス属性を一意に識別する ID（例:「account-type」を選択します。

string

ユーザーに表示される属性の名前。例:[アカウントの種類] を選択します。

Value

このサービス属性に使用可能なすべての値。

string

このサービス属性のこの値を他の値と一意に識別する識別子。例:「個人用」です。

string

ユーザーに表示される値の名前。例:「個人」。

string

Merchant.service_attribute で定義された属性の ID。例:「service-type」を指定します。

string

この属性の値の ID（「haircut」など）。サービス属性定義の value_id と一致する必要があります。

string

このパラメータの申し込み先のサービスのリソース名partners/{partner_id}/merchants/{merchant_id}/services/{service_id} の形式

Timestamp

指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

duration メッセージが設定されている場合、条件はさらに制限されます。

  availability.duration == duration_restrict

resource_restrict メッセージが設定されている場合、条件はさらに制限されます。

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。

start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。

Timestamp

start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までの時間と解釈されます。

Duration

duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。

Resources

resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。

Availability

空き情報の新しいリスト。

ServiceIntakeFormField

ユーザーに表示されるフィールド。

bool

true の場合、このフォームは初めての顧客に表示されます。非推奨。この機能はインテイク フォームではサポートされていません。

bool

true の場合、このフォームはリピーターに表示されます。非推奨。この機能はインテイク フォームではサポートされていません。

string

フォーム フィールドを一意に識別するアグリゲータ パートナーからの文字列。この ID は、対応するフォーム フィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイク フォームの両方で一意である必要があります。（必須）

FieldType

このフィールドの型。

string

ユーザーに表示される、このフィールドのテキスト。非推奨。代わりに localized_label を使用してください。

Text

ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。（必須）

string

フィールドの型が LOCATION_SEARCH の場合にのみ設定します。「location_id」を使用してください対象の「location」ロケーションの値を指定します。

Text

フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定されます。可能な選択肢を列挙するために使用します。

bool

このフィールドへの回答がユーザーに要求されるかどうかを示します。

bool

事前定義された回答以外の回答でカスタム値を許可するかどうかを指定します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。（省略可）

Text

指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。例:提供された場所リストに加えて、[後でサプライヤーに連絡します] というオプションも利用できます。（省略可）

string

ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。常に該当する質問がある場合は、フィールドを空のままにします。

Text

テキスト プレースホルダとして表示される入力のヒントテキスト。このフィールドが該当するのは、フィールド タイプが SHORT_ANSWER または Colab の場合に限られます。（省略可）

int32

税率（1% を 100 万分の 1 とする単位）。実際には小数点以下 6 桁を表すことになります。たとえば、税率が 7.253% の場合は、このフィールドは 7253000 に設定します。

このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。

このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。

string

（省略可）利用規約の URL。

string

ユーザーに表示するテキスト。新しい統合には、以下の localized_text を使用します。

Text

ユーザーに表示されるローカライズされたテキスト。

string

不明な言語 / 地域の Text 値。localized_value が空の場合にのみ必須です。この値の言語 / 地域は、パートナーまたはサービス プロバイダによって異なる場合があります。特定の言語であるとは限りません。

LocalizedString

言語 / 地域ごとのテキスト値。省略可。

string

チケット ID は、同じサービスの異なるチケットタイプを区別するために使用され、サービス内でのみ一意である必要があります。

string

この TicketType の簡単な説明。

これはユーザーに表示されます（「大人」、「子供」、「退役軍人」、「J 列」など）。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localized_short_description を使用してください。

Text

i18n をサポートするこの TicketType の簡単な説明。

これはユーザーに表示されます（「大人」、「子供」、「退役軍人」、「J 列」など）。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。

Price

このタイプのチケット 1 枚の価格（税抜き）。Service の税率がチケットに適用されます。

PerTicketFee

このチケットを購入するための追加料金。（省略可）

string

このチケットタイプが表す追加オプションの説明（ある場合）。非推奨。代わりに localized_option_description を使用してください。

Text

このチケットタイプが表す追加オプションの説明（ある場合）。言語 / 地域ごとに別々の値を指定できます。

追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。

例 1: 「大人」、「子供」などの異なるタイプのある入場チケットで、言語を追加オプションとしている場合の想定される TicketType リスト: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

例 2: 追加器具としてオプションの防水バック付きのカヤック レンタル（2 時間以上）で、short_description は「3 時間」、option_description は「防水バッグ付き」または「防水バッグなし」が可能な場合: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

省略可能ですが、サービス内のいずれかのチケットタイプにこのフィールドが設定されている場合は、他のすべてのチケットタイプにもこのフィールドを設定することをおすすめします（option_description のデフォルト値が使用される可能性があります）。たとえば、[{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] は有効なリストではありません。

サポートされている 2 つの HTML 形式タグは、<em> と <br> です。
タイトルと詳細な説明でオプションを指定するために使用します（例:「プレミアム シート
このオプションでは、座りこごちの良い椅子、専用テレビ、飲食サービスを含む専用ボックスシートが提供されます。客席からは美しい景色を眺めることができます。」）

EventCategory

イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。（省略可）

string

パートナーのウェブサイトに掲載されているイベントの URL。（省略可）

Entity

イベントに関連するエンティティのリスト。（省略可）

AttendanceMode

必須。イベントの参加者のタイプ。

string

省略可。イベントを視聴できる URL。

Text

省略可。イベントをホストする主催者。

string

省略可。予定を主催する主催者の URL。

OrganizerType

省略可。主催者の種類。

string

必須。イベントの情報や説明を確認できるページの URL。

EventState

省略可。イベントの状態。

string

パートナーのデータベースにあるエンティティの一意の識別子。（省略可）

string

エンティティの名前。（必須）

string

エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページ（存在する場合）です。エンティティのその他の公開 URL の場合は、public_identification_data で relevant_url を使用します。（省略可）

EntityType

エンティティのタイプ。（省略可）

EntityRole

イベントでのエンティティの役割。（省略可）

PublicIdentificationData

エンティティの公開参照。（省略可）

string

トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります（例: https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan）。（省略可）

string

アーティストなどの音楽エンティティの 36 文字の MusicBrainz 識別子（該当する場合）。https://musicbrainz.org/doc/MusicBrainz_Identifier をご覧ください。（省略可）

Timestamp

時間帯の下限。

Timestamp

時間帯の上限。

map<string, string>

トークン化設定には通常、キーが「gateway」で値が決済代行業者の名前である 1 つの tokenization_parameter があります。

パラメータの残りは決算代行業者によって異なります。詳しくは、Google Pay のドキュメントをご覧ください。

Braintree の例: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe の例: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen の例: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Google Pay に入力したユーザーの支払い情報（FOP を含む）を、支払いトークンに含めます（上記を参照）。フィールドを空のままにした場合は、MIN を指定した場合と同じ結果になります。