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 はサポートされていません。

EventMetadata

イベント カテゴリに固有のアクション リンクに関する追加情報。

Surface

アクション リンクに関連付けられた所定のイベント サーフェス。これはイベント カテゴリでのみ使用されます。

string

ID。AdsAccountLink のリソース名。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

string

必須。Google 広告アカウントにリンクする在庫アイテム ID のリスト。

State

出力専用。Google 広告アカウントのリンクの状態。

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

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

Prepayment

省略可。この空き状況の前払い情報（省略可）。

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 の確認モードで空き状況の予約を作成しようとした場合、即座に拒否されるか、保留中のステータスで作成されます。

LinkoutRequiredReason

省略可。このスロットにリンクアウトが必要な理由。設定されている場合、このスロットの Merchant リソースには有効な LinkoutTemplate が必要です。（省略可）

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

認証のために User に表示するフォームの読み込み元の 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

必須。この広告アカウントのリンクが作成される親リソース。これはパートナー センターのアカウント ID と同じです。形式: partners/{partner}

string

必須。広告アカウント リンクに使用する ID。これは Google 広告のお客様 ID と同じです。詳しくは、https://support.google.com/google-ads/answer/1704344 をご覧ください。形式 : xxx-xxx-xxxx。

AdsAccountLink

必須。作成する AdsAccountLink。

string

この販売者を所有するパートナーの親リソース名（形式: partners/{partner_id}）。

string

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

Merchant

作成する販売者。

string

このサービスを所有する販売者の親リソース名（形式: partners/{partner_id}/merchants/{merchant_id}）。

string

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

Service

作成するサービス。

CreditCardType

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

string

必須。削除する AdsAccountLink の名前。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

string

削除する販売者のリソース名（形式: partners/{partner_id}/merchants/{merchant_id}）。

string

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

Price

保証料の金額。

int64

保証料払い戻しのための最低事前キャンセル時間。

PriceType

空き情報を基に保証料を決定する方法を定義します。

Text

お支払いは、以下の方法でのみ行うようお客様に伝えます。

Duration

最小期間。

Duration

最大期間。

Text

必須。経済事業者の名前、住所、電話番号、メールアドレス。経済事業者とは、製造業者、正式な代表者、輸入業者、販売業者、フルフィルメント サービス プロバイダ、または製品の製造、提供、使用開始に関連する義務を負うその他の個人または法人として定義されます。economic_operator の自由形式の文字列表現。この情報は「 」と「\n」を使用してフォーマットできます。

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

事前注文（Order Ahead）がサポートされている場合は true。（必須）

FeeType

料金タイプ。（必須）

FeeAmount

料金の金額。単位通貨、カートの金額の割合、またはその両方の組み合わせで指定します。（必須）

QuantitativeValue

カートの価格に対する割合で表した手数料。範囲（上限と下限あり、上限と下限なし）または固定の割合をサポートします。値は 0 ～ 100 の範囲で指定してください。例: * 5.5% 固定 * 5.5% 以上 * 5.5% 以下 * 4.5% ～ 5.5%

Money

固定額。例: USD 3.5。

MoneyRange

金額の範囲。例: * USD 3.5 ～ USD 5.5 * USD 3.5 以上 * USD 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

非構造化住所（例: 1600 amphitheatre parkway mountain view, ca 94043）

string

必須。取得する広告アカウント リンクの名前。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

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

指定されたホーム サービスが属するカテゴリのサービスの種類。たとえば、plumber カテゴリのジョブタイプは unclog_drain、install_faucet などです。

string

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

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

string

販売者のサービス ID。

int64

予約枠の開始時刻（Unix エポックからの経過時間での秒単位）。

int64

予約枠の長さ（秒単位）。

OrderedTickets

チケットタイプ別の注文済みチケット数。

Price

この項目の合計金額（税抜き）。

BookingStatus

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

string

チケットタイプの ID。

int32

このタイプの注文済みチケット数。

string

URI テンプレートは RFC 6570 に準拠している必要があります。https://datatracker.ietf.org/doc/html/rfc6570 をご覧ください。レベル 1 テンプレートとすべてのレベル 4 複合テンプレートをサポートします。例: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

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 をご覧ください。指定すると、ビジネス拠点がこの場所とマッチングされます。

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 { } など）、適用される税率はゼロにリセットされます。E2E 支払いのサポートが終了したため、非推奨になりました。

PaymentRestrictions

この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合、制限は存在しないとみなされます。E2E 支払いのサポートが終了したため、非推奨になりました。

PaymentOption

この販売者で利用可能な支払いオプション。この販売者のサービスでは、利用可能な支払いオプションを個別に制限できます。E2E 支払いのサポートが終了したため、非推奨になりました。

PaymentProcessorConfig

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

TokenizationConfig

トークン化された決済代行業者の設定（販売者がサポートしている場合）。E2E 支払いのサポートが終了したため、非推奨になりました。

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、表示を制限する国のリスト、タイプ、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。

LinkoutTemplate

省略可。パートナーのプラットフォームでテーブルを予約するための URL を Google が生成する方法を指定するリンクアウト テンプレート。

現在、複数の値が指定されている場合は、最初の値のみが使用されます。

URI テンプレートは、ユーザーの予約選択に基づいて入力されるフィールドをサポートしています。予約の URL を正常に作成するには、すべての必須フィールドが必要です。* （必須）party_size、整数: ユーザーが予約をリクエストしているグループの人数。*（必須）selected_date_time、ISO 8601 日時（https://en.wikipedia.org/wiki/ISO_8601): ユーザーが予約をリクエストしている時間。* （省略可）merchant_id、文字列: ユーザーが予約をリクエストしている販売者の ID。テンプレートに販売者 ID がすでに含まれている場合は不要です。*（省略可）room_id、文字列: ユーザーが予約をリクエストしている部屋の ID。

Advisement

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

EconomicOperator

省略可。規制遵守に必要な、この特定の販売者に関連付けられた経済事業者の情報。（省略可）

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

この販売者の Geo プレイスが一致しました。販売者が地域で一致していない場合は空になります。

LocalServicesMatchInfo

この販売者のローカル サービスのマッチング。ローカル サービス販売者でない場合、またはプロバイダと一致しない場合は空になります。

DirectUrl

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

bool

販売者が今後 30 日以内に在庫を確保している場合は true。販売者に実際に広告が表示されることを保証するものではありません。

UrlType

この URL のタイプ。

string

この販売者が表示される可能性のある URL。

MatchedProvider

一致したサービス プロバイダ。1 つの販売者が複数のサービス プロバイダと照合されることがあります。

int64

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

string

ローカル サービスのカテゴリ（業種）。例: 「plumber」、「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 { }）の場合、適用される税率はゼロにリセットされます。

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

チケットごとの税金。

string

国。ISO 3166-1 alpha-2 国コードを使用して指定（「US」など）。（必須）

string

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

string

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

string

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

string

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

PriceInfo

価格の詳細のコンテナ。

int64

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

string

ISO 4217 で定義されている価格の通貨。

string

合計価格に関連付けられている価格設定オプションを識別する不透明型文字列（省略可）。

PriceType

料金または価格帯の適用方法（1 人あたりまたは固定）を定義します

Price

サービスの価格または料金。

PriceRange

サービスまたは料金の上限または下限。

Price

最小額。

Price

最大額。常に min_price より大きくする必要があります。

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。この URL でホストされているメディアが、Google によりクロールされます。

MediaType

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

Text

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

Attribution

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

string

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

Text

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

string

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

ServiceAvailability

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

string

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

string

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

string

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

string

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

int32

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

Text

省略可。ローカライズされたチャットルームの説明。設定する場合は、デフォルト値を指定する必要があります。販売者の地域でよく使用される言語も指定することをおすすめします。（省略可）

int64

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

Price

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

Price

無断キャンセル料。

AdmissionPolicy

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

CancellationPolicy

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

int64

最終予約可能時間から予約枠の開始時刻までの期間（秒単位）。

int64

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

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 { }）の場合、適用される税率はゼロにリセットされます。

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

Tours と Activities に固有のコンテンツ フィールド。

Location

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

Rating

このサービスに対するユーザーの評価（すべてのクチコミの集計指標で表します）。

HomeServiceData

ホームサービス業種に固有の追加情報。（省略可）

VirtualSession

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

DirectMerchantPayment

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

UriTemplate

省略可。Google が外部サイトへの URL を生成する方法を指定する省略可能なテンプレート。

ChargeTiming

購入時からの請求のタイミング。

int64

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

string

同じ販売者のサービス属性を他のサービス属性から一意に識別する ID（「account-type」など）。

string

ユーザーに表示される、この属性の名前（「口座種別」など）。

Value

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

string

このサービス属性の値を他の値から一意に識別する ID（「personal」など）。

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」フィールドの「location_id」を使用してビジネス拠点の値を指定してください。

Text

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

bool

このフィールドへの回答がユーザーに必須かどうかを示します。

bool

定義済みの回答に加えてカスタム値を許可するかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。（省略可）

Text

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

string

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

Text

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

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

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

PriceDisplayType

省略可。このタイプのチケット 1 枚の事前設定されたディスプレイのタイプ。

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

InventoryType

省略可。このタイプのチケット 1 枚の事前設定されたインベントリ タイプ。

EventCategory

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

string

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

Entity

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

AttendanceMode

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

string

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

Text

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

string

省略可。イベントを主催する主催者の URL。

OrganizerType

省略可。主催者のタイプ。

string

必須。イベント情報や説明が記載されているページの URL。

EventState

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

Text

省略可。ローカライズされたブランド名。

EventCreator

省略可。イベントの作成者に関する情報。

string

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

string

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

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

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

string

省略可。イベント作成者の名前。文字制限はありません。

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 を指定した場合と同じ処理を行います。