Package google.maps.booking.v1alpha

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

repeat_every

ExtendedServiceAvailability

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

例: 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 となります。（必須）

ScheduleException

ScheduleException メッセージは、上記の繰り返しの例外で、1 営業日内のすでに予約された時間帯、または利用できない時間帯を表します。タイムスロットが予約されると、例外のリストが更新されて、新たに利用できなくなった時間帯が反映されます。繰り返し自体は変更されません。

フィールド

フィールド
`time_range`	`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 から始まる予約枠は影響を受けません。

time_range

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 から始まる予約枠は影響を受けません。

SchedulingRuleOverrides

空き情報レベルのスケジュール設定ルール。

フィールド

フィールド
`last_bookable_sec`	`int64` この予約枠を予約できる最終時間（秒）。このタイムスタンプは、遵守されるべき予約枠の start_sec より前にくる必要があります（ユーザーが開始時刻を過ぎてから予約できる場合は、サービスレベルで SchedulingRules.min_booking_before_end_time を使用します）。存在する場合、対応する Service の SchedulingRules の min_booking_buffer で指定されたものがすべてオーバーライドされます。
`first_bookable_sec`	`int64` この予約枠を予約できる開始時刻（秒）。このタイムスタンプは、スロットの start_sec または指定した場合は last_bookable_sec より前にする必要があります。
`last_online_cancellable_sec`	`int64` 設定されている場合は、この予約枠を「Google で予約」でキャンセルできる最後の時間（Unix エポックからの経過秒数）。このフィールドは、サービスレベルのキャンセルルールをオーバーライドします。（省略可）

last_bookable_sec

int64

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

first_bookable_sec

int64

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

last_online_cancellable_sec

int64

設定されている場合は、この予約枠を「Google で予約」でキャンセルできる最後の時間（Unix エポックからの経過秒数）。このフィールドは、サービスレベルのキャンセルルールをオーバーライドします。（省略可）

BatchDeleteGenericRecordsRequest

指定したフィードタイプのレコードを削除するバッチリクエスト。

フィールド

フィールド
`parent`	`string` リソース名。`partners/{partner_id}/feeds/{feed_name}` の形式で指定します。
`records[]`	`GenericDeleteRecord` 削除するレコード。1 回の API 呼び出しで最大 1,000 件のレコードを使用できます。

parent

string

リソース名。partners/{partner_id}/feeds/{feed_name} の形式で指定します。

records[]

GenericDeleteRecord

削除するレコード。1 回の API 呼び出しで最大 1,000 件のレコードを使用できます。

BatchPushGenericRecordRequest

リクエスト URL で指定されたフィードタイプのレコードを挿入または更新するバッチリクエスト。

フィールド

フィールド
`parent`	`string` リソース名。`partners/{partner_id}/feeds/{feed_name}` の形式で指定します。
`records[]`	`GenericRecord` 挿入/更新するレコード。1 回の API 呼び出しで最大 1,000 件のレコードを使用できます。

parent

string

リソース名。partners/{partner_id}/feeds/{feed_name} の形式で指定します。

records[]

GenericRecord

挿入/更新するレコード。1 回の API 呼び出しで最大 1,000 件のレコードを使用できます。

BatchReplaceServiceAvailabilityRequest

複数の Service の予約枠を置き換えるバッチリクエスト。

フィールド

フィールド
`parent`	`string` `partners/{partner_id}` の形式。
`extended_service_availability[]`	`ExtendedServiceAvailability` 既存の予約枠を置き換えるために使用される、サービスの延長された空き状況。

parent

string

partners/{partner_id} の形式。

extended_service_availability[]

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

BatchReplaceServiceAvailabilityResponse

複数の Service の予約枠を置き換えるバッチレスポンス。正常に更新された予約枠のみこのメッセージに含まれます。

フィールド

フィールド
`extended_service_availability[]`	`ExtendedServiceAvailability` 既存の予約枠を置き換えるために使用される、サービスの延長された空き時間メッセージが正常に更新されました。

extended_service_availability[]

ExtendedServiceAvailability

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

Booking

予約枠の予約

フィールド
`name`	`string` 予約のリソース名: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` スロットの販売者の ID
`service_id`	`string` 販売者サービスの ID
`start_time`	`Timestamp` 予約枠の開始時刻
`duration`	`Duration` 予約枠の期間
`client_information`	`ClientInformation` 予約した顧客の個人情報
`status`	`BookingStatus` 予約のステータス
`payment_information`	`PaymentInformation` 予約に関連する支払い取引に関する情報。
`party_size`	`int64` 予約の人数

BookingFailure

予約の処理が非同期で失敗した理由を示すステータスデータ。BookingFailure は、主にビジネスロジックのエラーを取得することを目的としています。

フィールド
`cause`	`Cause` 予約が失敗した理由。（必須）
`rejected_card_type`	`CreditCardType` （原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合にのみ必須）
`description`	`string` パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。（省略可）
`payment_failure`	`PaymentFailureInformation` 支払いのエラーに関する情報。

原因

エラーの原因の列挙。

列挙型
`CAUSE_UNSPECIFIED`	デフォルト値: 使用しないでください。「不明なエラー」になります
`SLOT_UNAVAILABLE`	参照された予約枠は利用できなくなっています。
`SLOT_ALREADY_BOOKED_BY_USER`	ユーザーは参照された予約枠をすでに予約しています。
`LEASE_EXPIRED`	リース（指定されている場合）が期限切れになり、リクエストされた予約を完了するために使用できなくなりました。
`OUTSIDE_CANCELLATION_WINDOW`	リクエストされたキャンセルは、販売者のキャンセルポリシーの時間制限により、現時点では実行できません。
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	指定されたクレジットカードの種類が販売者に受け入れられなかったため、支払いの処理中にエラーが発生しました。クレジットカードの種類は、rejected_card_type で指定する必要があります。
`PAYMENT_ERROR_CARD_DECLINED`	指定されたクレジットカードが承認されなかったため、支払いの処理中にエラーが発生しました。
`PAYMENT_OPTION_NOT_VALID`	予約の支払いに使用されたパック / メンバーシップでエラーが発生しました。有効な残高がなかったか、有効期限が切れている可能性があります。
`PAYMENT_ERROR`	この予約の支払いの処理中にエラーが発生しました。上記の支払いエラーと一致しない場合にのみ、この値を使って一般的な支払い関連のエラーを示します。
`USER_CANNOT_USE_PAYMENT_OPTION`	ユーザーは指定された支払いオプションを使用できません（1 回限りの価格を 2 回目に使用しようとしているユーザーなど）。
`BOOKING_ALREADY_CANCELLED`	ユーザーがキャンセルしようとした予約はすでにキャンセルされています。
`BOOKING_NOT_CANCELLABLE`	ユーザーがキャンセルしようとした予約はキャンセルできません。
`OVERLAPPING_RESERVATION`	ユーザーがこの時間の近くにすでに予約を行っています。
`USER_OVER_BOOKING_LIMIT`	アグリゲータのユーザーあたりの予約制限を超えているため、予約が失敗しました。
`PAYMENT_REQUIRES_3DS1`	取り引きの再試行をリクエストしていますが、今回は 3DS1 のチャレンジ / レスポンスを行った後にリクエストしたため、支払いが拒否された場合に設定されます。現在のトランザクションのエラー状態はエラーのままになります。再試行は完全に別に行われます。これがエラーの理由である場合は、payment_failure.3DS1_parameters を設定する必要があります。そうでない場合は、現在の原因は PAYMENT_ERROR のように扱われます。

PaymentFailureInformation

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

フィールド

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

threeds1_parameters

ThreeDS1Parameters

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

ThreeDS1Parameters

RwG が 3DS1 チャレンジを実行するようリクエストするパラメータ。

パラメータは、3DS1 プロトコルの EMVCo の説明によって設定されます。

フィールド
`acs_url`	`string` 認証のためにユーザーに提示するフォームの読み込み元の URL。
`pa_req`	`string` PaymentAuthentication リクエスト。指定した場合は ACSUrl フォームに投稿されます。
`transaction_id`	`string` ACS プロバイダにより使用される識別子。指定した場合は ACSUrl フォームに投稿されます。
`md_merchant_data`	`string` 販売者データ。指定した場合は ACSUrl フォームに投稿されます。

BookingStatus

予約のステータス

列挙型
`BOOKING_STATUS_UNSPECIFIED`	指定されていません。
`CONFIRMED`	予約が確認されました。
`PENDING_MERCHANT_CONFIRMATION`	予約は、CONFIRMED ステータスへの移行前の販売者による確認待ちです（現在サポートされていません）。
`PENDING_CLIENT_CONFIRMATION`	予約は、CONFIRMED ステータスへの移行前の顧客による確認待ちです（現在サポートされていません）。
`CANCELED`	ユーザーに代わって予約がキャンセルされました。
`NO_SHOW`	予約が顧客により無断キャンセルされました。
`NO_SHOW_PENALIZED`	予約が顧客により無断キャンセルされ、キャンセルポリシー違反となりました。
`FAILED`	処理に失敗したため、予約を完了できませんでした。
`DECLINED_BY_MERCHANT`	予約は販売者によって非同期的に拒否されました。

CallMerchant

UnsupportedPartySizeOption で使用されるメッセージが空です。この設定により、ユーザーは予約のためにビジネスに電話するオプションを表示できます。

CancellationPolicy

サービスのキャンセルポリシー。

フィールド

フィールド
`refund_condition[]`	`RefundCondition` ポリシーに適用される 0 個以上の払い戻し条件。

refund_condition[]

RefundCondition

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

RefundCondition

単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。

フィールド

フィールド
`min_duration_before_start_time`	`Duration` 開始時刻までの期間。顧客は、この時刻まで `refund_percent` で指定されたサービス価格の一部の払い戻しを受け取ることができます。0（デフォルト）に設定すると、サービスはいつでもキャンセルできます。
`refund_percent`	`uint32` サービス開始時刻の `min_duration_before_start_time` 以前にサービス予約がキャンセルされる限り、払い戻し可能な金額の割合（[0, 100] の範囲）。0（デフォルト）に設定すると、サービスは払い戻しできません。100 に設定すると、このサービスの全額払い戻しが可能になります。

min_duration_before_start_time

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

refund_percent

uint32

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

ClientInformation

予約者の個人情報

フィールド
`given_name`	`string` お客様の名前
`family_name`	`string` クライアントの姓
`address`	`PostalAddress` お客様の住所
`telephone`	`string` クライアントの電話番号
`email`	`string` クライアントのメールアドレス

CreateMerchantRequest

Merchant を作成するためのリクエスト。

フィールド

フィールド
`parent`	`string` この販売者を所有するパートナーの親リソース名。形式は `partners/{partner_id}` です。
`merchant_id`	`string` この販売者に使用する販売者 ID。
`merchant`	`Merchant` 作成する販売者。

parent

string

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

merchant_id

string

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

merchant

Merchant

作成する販売者。

CreateServiceRequest

新しい Service を作成するためのリクエスト。

フィールド

フィールド
`parent`	`string` このサービスを所有する販売者の親リソース名。`partners/{partner_id}/merchants/{merchant_id}` の形式で指定します。
`service_id`	`string` このサービスに使用するサービス ID。
`service`	`Service` 作成するサービス。

parent

string

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

service_id

string

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

service

Service

作成するサービス。

CreditCardRestrictions

この販売者が受け付けるクレジットカードの種類の制限。

フィールド

フィールド
`credit_card_type[]`	`CreditCardType` サポートされているクレジットカードのリスト。空欄にした場合、クレジットカードはサポートされません。

credit_card_type[]

CreditCardType

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

CreditCardType

クレジットカードの種類。

列挙型
`CREDIT_CARD_TYPE_UNSPECIFIED`	未使用。
`VISA`	Visa クレジットカード。
`MASTERCARD`	Mastercard クレジットカード。
`AMERICAN_EXPRESS`	American Express クレジットカード。
`DISCOVER`	Discover クレジットカード。
`JCB`	JCB クレジットカード。

DeleteMerchantRequest

Merchant を削除するリクエスト。

フィールド

フィールド
`name`	`string` 削除する販売者のリソース名形式は Partners/{partner_id}/merchants/{merchant_id} です。

name

string

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

DeleteServiceRequest

Service を削除するリクエスト。

フィールド

フィールド
`name`	`string` 削除するサービスのリソース名`partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` の形式

name

string

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

入金の

ユーザーに請求される、またはクレジットカードに保留されている保証料。

フィールド

フィールド
`deposit`	`Price` デポジット金額。
`min_advance_cancellation_sec`	`int64` 事前予約のキャンセル期限は保証金です。
`deposit_type`	`PriceType` 在庫状況に基づくデポジットの計算方法を定義します。

deposit

デポジット金額。

min_advance_cancellation_sec

int64

事前予約のキャンセル期限は保証金です。

deposit_type

PriceType

在庫状況に基づくデポジットの計算方法を定義します。

DirectMerchantPayment

ユーザーが RwG を介してサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。

フィールド

フィールド
`payment_methods[]`	`Text` お客様には、以下に記載のお支払い方法でのみお支払いいただくようご案内してください。

payment_methods[]

Text

お客様には、以下に記載のお支払い方法でのみお支払いいただくようご案内してください。

DurationRange

有限または無制限の持続時間範囲のラッパー。min_duration または max_duration のうち少なくとも 1 つは必須です。

フィールド

フィールド
`min_duration`	`Duration` 最小期間。
`max_duration`	`Duration` 最長期間。

min_duration

最小期間。

max_duration

最長期間。

ExtendedServiceAvailability

空き情報のリストおよび申し込み対象先と申し込み対象時間

フィールド
`merchant_id`	`string` 以下の在庫状況メッセージが属する販売者を指定するための必須フィールドです。
`service_id`	`string` 以下の空き情報メッセージが属するサービスを指定するために必須のフィールドです。
`start_time_restrict`	`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 から始まる全期間とみなされます。
`end_time_restrict`	`Timestamp` start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までのすべての時間を意味すると解釈されます。
`duration_restrict`	`Duration` duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。
`resources_restrict`	`Resources` resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが正確に一致している必要があります。
`availability[]`	`Availability` 空き状況の新しいリスト。

FeedStatistics

アップロードされたフィードの処理中に取得された統計情報。

フィールド

new_items

int64

このフィードにより新しく追加された項目。フィードのタイプに応じて、販売者、サービス、または予約枠を商品アイテムとして表示できます。

existing_items

int64

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

deleted_items

int64

このフィードには存在せず、その結果削除された商品アイテム。

FeedStatus

アグリゲータのプラットフォームからアップロードされたフィードのステータス。

フィールド
`name`	`string` 以下の形式を持つフィードリソース名: `partners/{partner_id}/feeds/merchants/{file_name}` `partners/{partner_id}/feeds/services/{file_name}` `partners/{partner_id}/feeds/availability/{file_name}`
`state`	`State` このフィードの処理ステータス。
`error_details`	`string` このフィードを処理できなかった場合に詳細を示す、人が読める形式の文字列。
`statistics`	`FeedStatistics` このフィードに固有の統計情報。

状態

フィードの処理状態を示す列挙型。

列挙型
`STATE_UNSPECIFIED`	デフォルト値。未使用。
`IN_PROGRESS`	フィードが処理中です。
`SUCCESS`	フィードが正常に処理されました。
`FAILURE`	フィードの処理中にエラーが発生しました。

FoodOrderingMetadata

料理注文アクションリンクのメタデータ。

フィールド
`fee_details[]`	`FeeDetails` 商品アイテムの合計に加えてユーザーに請求される料金の詳細。サービス手数料や配送料など、さまざまな種類の料金について繰り返されます。
`advance_order_details`	`AdvanceOrderDetails` 高度な注文サポート（事前注文とも呼ばれる）の詳細で、ユーザーは現在よりも後になってから納品のために注文できます。
共用体フィールド `fulfillment_duration_options`。注文確認からの注文フルフィルメント期間。宅配注文の場合、料理が配達されるまでの時間。受け取りの注文の場合、料理を受け取る準備ができるまでにかかる時間。`fulfillment_duration_options` は次のいずれかになります。
`fulfillment_lead_time_duration`	`Duration` 固定期間。例: 30 分。
`fulfillment_lead_time_duration_range`	`DurationRange` 期間。例: * 30 分～ 45 分 * 30 分超 * 50 分未満

AdvanceOrderDetails

事前注文サポート。

フィールド

is_supported

bool

事前注文（Order Ahead）をサポートする場合は true に設定します。（必須）

FeeDetails

手数料の詳細。

フィールド

type

FeeType

料金のタイプ。（必須）

fee_amount

FeeAmount

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

FeeAmount

FeeAmount 例: * 固定料金: USD 0（手数料なし）、1.5 米ドル * 固定料金の範囲: 1.0 米ドル（最小）、3.0 米ドル（最大）、5.0 ～ 6.0 米ドル *カートサイズの割合: 15.5%、10%～ 20%、10%（最小）、15%（最大 5.5%、1.5%～ 5%、1.5% と 1.5% と 2.5% と最大 5%）、5% と 5%

フィールド
`cart_percentage`	`QuantitativeValue` カート価格に対するパーセンテージで表した料金。範囲（制限付きと制限なし）または固定の割合を使用できます。値は 0 ～ 100 の範囲で指定してください。例: * 5.5% * 少なくとも 5.5% * 最大 5.5% * 4.5% ～ 5.5%
共用体フィールド `amount_options`。金額を指定するオプション。`amount_options` は次のいずれかになります。
`amount`	`Money` 固定額。例: USD 3.5
`amount_range`	`MoneyRange` 金額の範囲。例: * 3.5 米ドル～ 5.5 米ドル * 3.5 米ドル以上 * 5.5 米ドル以下
`amount_unknown`	`bool` 不明な金額です。

FeeType

料金のタイプ。

列挙型
`FEE_TYPE_UNSPECIFIED`	料金タイプが指定されていません。
`DELIVERY`	配送料のため。
`SERVICE`	サービス手数料のため。

FulfillmentOption

オンライン注文アクションリンクのフルフィルメントオプション。

フィールド
`fulfillment_type`	`FulfillmentType` 必須。フルフィルメントタイプ。
`available_day[]`	`AvailableDay` 必須。このフルフィルメント方法を利用できる日数（できれば 2 日以上）のリストです。
`fee_details`	`FeeDetails` 必須。フルフィルメントの方法の料金の詳細。
`minimum_order`	`Price` 必須。アクションリンクに関連付けられたフルフィルメント方法の最小注文。

AvailableDay

日単位の空き情報。

フィールド

fulfillment_date

Date

必須。フルフィルメントの方法が利用可能になる日付。販売者のタイムゾーンに基づくものとみなされます。

last_ordering_time

必須。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 時までに注文する必要があります。

FeeDetails

アクションリンクに関連付けられたフルフィルメント方法の料金の詳細。

フィールド
共用体フィールド `fee_details`。フルフィルメントメソッドの料金モデル。`fee_details` は次のいずれかになります。
`no_fee`	`NoFee` フルフィルメントの方法に料金はかかりません。
`base_fee`	`MinimumFee` フルフィルメント方法に関連付けられた基本料金。
`fixed_fee`	`FixedFee` フルフィルメント方法に関連付けられた固定料金。

FixedFee

アクションリンクに関連付けられたフルフィルメント方法に必要な固定料金。

フィールド

amount

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

FulfillmentType

アクションリンクに関連付けられたフルフィルメントタイプ。

列挙型
`FULFILLMENT_TYPE_UNSPECIFIED`	フルフィルメントタイプが指定されていません。
`FULFILLMENT_TYPE_DELIVERY`	フルフィルメントタイプは配送です。
`FULFILLMENT_TYPE_PICKUP`	フルフィルメントタイプは受け取りです。

MinimumFee

アクションリンクに関連付けられたフルフィルメント方法に必要な最低費用。

フィールド

base_fee_amount

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

NoFee

アクションリンクに関連付けられたフルフィルメント方法に料金は必要ありません。

GenericDeleteRecord

URL リクエストで指定されたフィードタイプを削除するレコードです。

フィールド
`delete_time`	`Timestamp` 必須。このタイムスタンプは、インベントリに削除が適用される順序を決定するために使用されます。
共用体フィールド `record_type`。さまざまなタイプのフィードをカプセル化する（ndjson、proto ベースなど）パートナー様は、フィードまたは BatchPush API で指定するのと同様の完全なレコードを指定できます。パートナーは、レコードを一意に識別するために必要なレコードの重要なフィールドのみを含めることもできます。`record_type` は次のいずれかになります。
`data_record`	`bytes` プロトコル以外のフィードの場合。
`proto_record`	`Any` プロトコルベースのフィードの場合。

GenericRecord

URL リクエストで指定されたフィードタイプのレコード。

フィールド
`generation_timestamp`	`Timestamp` 必須。このタイムスタンプは、在庫の更新順序を正しく確認するために使用されます。
共用体フィールド `record_type`。さまざまなタイプのフィードをカプセル化する（ndjson、proto ベースなど）`record_type` は次のいずれかになります。
`data_record`	`bytes` プロトコル以外のフィードの場合。
`proto_record`	`Any` プロトコルベースのフィードの場合。

GeoCoordinates

ビジネス拠点の地理データ（緯度、経度、住所など）。

フィールド
`latitude`	`double` 緯度。（省略可）
`longitude`	`double` 経度。（省略可）
共用体フィールド `addresses`。ビジネス拠点の住所。構造化されている住所とされていない住所が可能で、`addresses` は次のいずれかになります。
`address`	`PostalAddress` ビジネス拠点の住所（推奨）。
`unstructured_address`	`string` 非構造化住所例: 「1600 amphitheatre Parkway Mountain view, ca 94043」

GetMerchantStatusRequest

MerchantStatus の取得リクエスト

フィールド

name

string

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

GetStatusRequest

アグリゲータのプラットフォームからアップロードされた特定のフィードの Status を取得するためのリクエスト。

フィールド

name

string

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

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

HomeServiceData

ホームサービスカテゴリでは追加情報を提供する必要があります。

フィールド

category_type

string

このホームサービスが属する大まかなカテゴリ。例: 配管工、電気技師など

job_type

string

特定のホームサービスが属するカテゴリの職務タイプ。たとえば、配管工の業種のジョブタイプは unclog_drain、install_faucet です。

IntegrationType

サポートされている統合の程度。

列挙型
`INTEGRATION_TYPE_UNSPECIFIED`	デフォルトは END_TO_END です。
`INTEGRATION_TYPE_END_TO_END`	Google を通じてエンドツーエンドの予約を可能にする完全な統合。
`INTEGRATION_TYPE_INVENTORY_ONLY`	予約サーバーはこのサービスをサポートする必要はありません。販売者、サービス、（省略可）空き情報データのみを送信する必要があります。

InvalidateResourceRequest

リソースを無効にするリクエスト。

フィールド

resource_id

string

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

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

LineItem

1 件の注文内の 1 つの項目。1 つの時間枠での 1 つのサービスの予約。

フィールド
`service_id`	`string` 販売者の Service の ID。
`start_sec`	`int64` 予約スロットの開始時間（Unix エポックからの UTC 時間に基づく秒単位）。
`duration_sec`	`int64` 予約枠の長さ（秒）。
`tickets[]`	`OrderedTickets` チケットタイプ別の注文数。
`price`	`Price` この広告申込情報の合計金額（税抜き）。
`status`	`BookingStatus` 広告申込情報のステータス。

OrderedTickets

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

フィールド

ticket_id

string

チケットタイプの ID。

count

int32

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

ListMerchantStatusesRequest

MerchantStatus のリストを取得するリクエスト

フィールド
`parent`	`string` 必須。この販売者ステータスのコレクションを所有する親。形式: `partners/{partner_id}/merchants`
`page_size`	`int32` 必須。返される最大アイテム数。サーバーによってページサイズが縮小される場合があります。
`page_token`	`string` （省略可）前の ListMerchantStatusResponse から返された nextPageToken 値（ある場合）。
`booking_inventory_status_restrict`	`BookingInventoryStatus` （省略可）予約広告枠のステータスで結果をフィルタするための制限（省略可）。
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` （省略可）順番待ちリストの在庫状況で結果をフィルタするための制限（省略可）。
`geo_match_restrict`	`GeoMatchingStatus` （省略可）結果を地域の一致ステータスでフィルタリングするための制限（省略可）。

BookingInventoryStatus

予約在庫のエンドツーエンドのステータス。

列挙型
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	指定されていません。
`NO_VALID_FUTURE_INVENTORY`	販売者には、今後 30 日以内に予約できる在庫がありません。
`HAS_VALID_FUTURE_INVENTORY`	販売者が今後 30 日以内に予約できる広告枠がある。

GeoMatchingStatus

販売者の地域マッチングステータス。

列挙型
`GEO_MATCHING_STATUS_UNSPECIFIED`	指定されていません。
`GEO_UNMATCHED`	販売者様が地域に一致していません。
`GEO_MATCHED`	販売者様が地域に一致しています。

WaitlistInventoryStatus

順番待ちリストのエンドツーエンドの在庫ステータス。

列挙型
`WAITLIST_INVENTORY_STATUS_UNSPECIFIED`	指定されていません。
`NO_VALID_WAITLIST_SERVICE`	販売者にサービスの順番待ちリストがありません。
`HAS_VALID_WAITLIST_SERVICE`	販売者にサービスサポートの順番待ちリストがある。

ListMerchantStatusesResponse

リスト MerchantStatus に対するレスポンス。

フィールド

merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

アグリゲータのプラットフォームからアップロードされた複数のフィードの Status を取得するためのリクエスト。

フィールド
`name`	`string` 以下の形式を持つフィードリソース名: `partners/{partner_id}/feeds/merchants` `partners/{partner_id}/feeds/services` `partners/{partner_id}/feeds/availability`
`page_size`	`int32` 返すアイテムの最大数。
`page_token`	`string` 前の List リクエストから返された next_page_token 値（存在する場合）。
`state_restrict`	`State` フィードの状態に基づいて結果をフィルタするよう制限できます（省略可）。
`time_range_restrict`	`TimeRange` 結果を上限と下限でフィルタするように制限します（省略可）。start_time が設定されていない場合は、デフォルトで Unix 時間の起点に設定されます。end_time が設定されていない場合は、デフォルトで現在に設定されます。

ListStatusResponse

アグリゲータのプラットフォームからアップロードされた複数のフィードの Status を取得するためのリクエスト。

フィールド

status[]

FeedStatus

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

next_page_token

string

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

LocalizedString

1 つの言語 / 地域の文字列のインスタンス。

フィールド

locale

string

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

value

string

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

ロケーション

ビジネス拠点に関する地理情報。

フィールド
`place_id`	`string` Google プレイスデータベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定すると、場所とこの場所が照合されます。
`name`	`string` 場所の名前、電話番号、URL、地域は、その場所を Google マップ上にすでにある場所と照合するために使用されます。このフィールドは省略可能ですが、状況によっては必須の場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、ビジネスエンティティには一致しません。（省略可）
`telephone`	`string` 国番号と市外局番を含む、ビジネス拠点の電話番号（例: +14567891234）。（省略可）
`url`	`string` ビジネス拠点の公開ウェブサイトの URL。（省略可）
`geo`	`GeoCoordinates` ビジネス拠点の地理情報（緯度、経度、住所など）。（省略可）
`location_type`	`LocationType` 場所のタイプ。この場所が Service に指定されている場合は指定する必要があります。
`location_id`	`string` サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービスフィールドでこのビジネス拠点を参照できます。たとえば、カスタム登録フォームでは、一連の場所 ID を使用して乗車場所のオプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。（省略可）

LocationType

このビジネス拠点のタイプ。

列挙型
`LOCATION_TYPE_UNSPECIFIED`	ビジネス拠点タイプが指定されていません。
`VISITED_LOCATION`	このサービスで訪れる場所。
`START_LOCATION`	このサービスが開始する場所。MEETING_LOCATION としても機能します。
`END_LOCATION`	このサービスが終了する場所。

Merchant

アグリゲータのプラットフォーム上の販売者に関する情報。

フィールド
`name`	`string` 販売者のリソース名。`partners/{partner_id}/merchants/{merchant_id}` の形式です。
`merchant_name`	`string` merchant_name、電話番号、URL、地域は、パートナーの空き情報を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。販売者の名前。
`telephone`	`string` 販売者の国コードと市外局番を含む電話番号（例: +14567891234）。
`url`	`string` 販売者の公開ウェブサイトの URL。
`geo`	`GeoCoordinates` 販売者の地理情報（緯度、経度、住所など）。
`category`	`string` アグリゲータのプラットフォームにおけるビジネスのカテゴリ。
`num_bookings_30d (deprecated)`	`int64` この項目は非推奨です。このフィールドのサポートは終了しました。
`tax_rate_basis_points (deprecated)`	`uint32` この項目のサポートは終了しました。販売者の税率（ベーシスポイント: 1% の 100 分の 1）。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。このフィールドは非推奨です。代わりに、tax_rate を使用してください。
`tax_rate`	`TaxRate` 販売者の税率。指定されている場合、このフィールドは非推奨の tax_rate_basis_points フィールドをオーバーライドします。メッセージが空の場合（tax_rate { } など）、適用税率はゼロにリセットされます。
`payment_restrictions`	`PaymentRestrictions` この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合、制限はないとみなされます。
`payment_option[]`	`PaymentOption` この販売者で利用可能な支払いオプション。この販売者のサービスは、使用できるお支払い方法を個別に制限できます。
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` この項目は非推奨です。トークン化された決済代行業者の設定（販売者がサポートしている場合）。
`tokenization_config`	`TokenizationConfig` トークン化された決済代行業者の設定（販売者がサポートしている場合）。
`terms`	`Terms` 「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。これに加えて、アグリゲータパートナーの利用規約は常にユーザーに表示されます。ここでは、アグリゲータパートナーの利用規約を提示することはできません。
`brand_id`	`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 までご連絡ください。
`matching_hints`	`MerchantMatchingHints` 販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。（省略可）
`service_attribute[]`	`ServiceAttribute` この販売者のサービスを説明するために使用されるサービス属性の定義。（省略可）
`action_link[]`	`ActionLink` （省略可）アクションの URL（言語、制限する国のリスト、種類、アクションを実行するプラットフォームを示すプラットフォーム（省略可））
`waitlist_advisement`	`Advisement` （省略可）「Google で予約」を利用して順番待ちリストに登録するユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイスの各テキストフィールドの長さは 100 バイトに制限してください。

MerchantMatchingHints

販売者が Google マップの場所とマッチングされる際に使用されるヒント。

フィールド

place_id

string

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

MerchantStatus

Google で予約のプラットフォームでの販売者のステータス。

フィールド
`name`	`string` 販売者ステータスのリソース名。`partners/{partner_id}/merchants/{merchant_id}/status` の形式で指定します。
`merchant_name`	`string` パートナーから提供された販売者の名前。
`input_geo_info`	`GeoCoordinates` パートナーから販売者の地理情報が提供されました。
`processing_status`	`ProcessingStatus` 販売者の処理ステータス。
`booking_status`	`BookingStatus` エンドツーエンドの予約統合に関連するステータスです。
`waitlist_status`	`WaitlistStatus` 順番待ちリストの統合に関連するステータスです。
`geo_match`	`PlaceInfo` この販売者の一致した地域。販売者が地域に一致していない場合は空になります。
`local_services_match`	`LocalServicesMatchInfo` この販売者のローカルサービス広告の一致。ローカルサービスの販売者でない場合や、どのプロバイダとも一致しない場合は空になります。
`direct_urls[]`	`DirectUrl` 現在の販売者の在庫のコンテンツを示す URL のリスト。なお、これは広告枠が実際に配信されているということではなく、URL が一般公開されている URL と異なる場合があります。

BookingStatus

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

フィールド

has_valid_future_inventory

bool

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

DirectUrl

販売者を表示する URL。

フィールド

type

UrlType

この URL のタイプ。

url

string

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

UrlType

表示 URL のタイプ。

列挙型
`URL_TYPE_UNSPECIFIED`	指定されていません。
`BOOKING`	エンドツーエンドの予約 URL。
`WAITLIST`	エンドツーエンドの順番待ちリストの URL。
`LOCAL_SERVICES`	Google ローカルサービスの URL。

LocalServicesMatchInfo

Google ローカルサービスの情報が一致しています（ローカルサービスの販売者に対してのみ設定されます）。

フィールド

matched_providers[]

MatchedProvider

一致したサービスプロバイダ。1 つの販売者を複数のサービスプロバイダに対応させることができます。

MatchedProvider

ローカルサービスプロバイダ。

フィールド

customer_id

int64

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

categories[]

string

ローカルサービスの業種（カテゴリ）。例: 「配管工」と「カーペットクリーニング」。

PlaceInfo

一致した場所の情報。

フィールド

name

string

場所の名前。

formatted_address

string

住所を現地の言語で書式設定しました。

place_id

string

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

ProcessingStatus

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

列挙型
`PROCESSING_STATUS_UNSPECIFIED`	ステータスの指定なし。
`IN_PROGRESS`	販売者は Madden に届いておりますが、まだ処理中です。このステータスの販売者には、他のステータスは入力されません。
`COMPLETED`	販売者の他のステータスが算出済みである。

WaitlistStatus

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

フィールド

has_valid_waitlist_service

bool

販売者がウェイティングリストサービスがある場合は true。販売者が実際にサービスを提供することを保証するものではありません。

MoneyRange

金額の範囲（有限または無制限）のラッパー。min_amount または max_amount の少なくとも 1 つが必要です。

フィールド

min_amount

Money

最低額。

max_amount

Money

上限額。

NoShowFee

ユーザーが予約したにもかかわらず無断キャンセルした場合に請求される可能性のある料金。

フィールド

fee

予約したユーザーが無断で予約したユーザーに対して請求される可能性のある金額です。

fee_type

PriceType

在庫状況から料金をどのように算出するかを定義します。

順序

販売者にサービスを予約する際の注文。

フィールド
`name`	`string` 注文のリソース名: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` 注文を行うクライアントの個人情報。
`payment_information`	`PaymentInformation` 注文に関連する支払い取引に関する情報。
`merchant_id`	`string` この注文のすべてのサービスが属する販売者の ID。
`item[]`	`LineItem` このオーダーの広告申込情報。

OrderOnlineMetadata

オンライン注文アクションリンクのメタデータ。

フィールド

fulfillment_option[]

FulfillmentOption

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

PaymentInformation

予約に関する支払いの詳細

フィールド

prepayment_status

PrepaymentStatus

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

payment_transaction_id

string

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

PaymentOption

販売者が提供するサービスの支払いに使用できる支払いオプション。支払いオプションは、複数の販売者（同じチェーンに属する販売者など）で共有できます。

フィールド
`payment_option_id`	`string` この ID は、この支払いオプションを識別するために使用されます。この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。 ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。
`name`	`string` 支払いオプションの名前。これはユーザーが表示できます。
`description`	`string` 支払いオプションについての説明。これはユーザーが表示できます。
`price`	`Price` 支払いオプションの価格。
`tax_rate`	`TaxRate` この支払いオプションの税率。指定されている場合、このフィールドは Merchant または Service にある tax_rate フィールドをオーバーライドします。メッセージが空の場合（tax_rate { } など）、適用税率はゼロにリセットされます。
`payment_option_type`	`PaymentOptionType` この支払いオプションの種類。ドロップインには 1 回限り、パックには複数回、メンバーシップには無制限にご利用いただけます。
`session_count`	`int64` この支払いオプションを利用できるセッション数。マルチセッション / パックでのみ有効で、値は 1 より大きくする必要があります。
`purchase_interval`	`TimeRange` その期間内であれば、支払いオプションを購入できます。
`valid_interval`	`TimeRange` 支払いオプションはこの期間内に利用できます（例: 2017 年 1 月の特別価格）。存在する場合、これは valid_duration と activation_type をオーバーライドします。
`valid_duration`	`Duration` 支払いオプションの有効期間（例: 30 日間のメンバーシップ）。
`activation_type`	`ActivationType` この支払いオプションの有効期限をどのように決定するかを定義します。
`user_restriction`	`UserPurchaseRestriction` この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定しなかった場合、すべてのユーザーが対象になります。

ActivationType

有効期間の開始日を決定する方法を定義します。

列挙型
`ACTIVATION_TYPE_UNSPECIFIED`	未使用。
`ACTIVATION_ON_PURCHASE`	購入時から有効期間が開始します。
`ACTIVATION_ON_FIRST_USE`	支払いオプションの初回使用時に有効期間が開始します。

PaymentOptionType

支払いオプションのタイプ。

列挙型
`PAYMENT_OPTION_TYPE_UNSPECIFIED`	未使用。
`PAYMENT_OPTION_SINGLE_USE`	支払いオプションは 1 回のみ使用可能。
`PAYMENT_OPTION_MULTI_USE`	支払いオプションは、セッション数 > 0 の場合に使用できます。
`PAYMENT_OPTION_UNLIMITED`	支払いオプションは有効期間内に利用できます。セッション数は該当しません。

PaymentProcessorConfig

決済代行業者の設定。Merchant ごとに設定します。

フィールド

processor

Processor

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

public_key

string

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

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

version

string

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

プロセッサ

特定の決済代行業者パートナーを定義します。

列挙型
`PROCESSOR_UNSPECIFIED`	未使用
`PROCESSOR_STRIPE`	Stripe を利用する支払いの設定。
`PROCESSOR_BRAINTREE`	Braintree を利用する支払いの設定。

PaymentRestrictions

この販売者が受け付ける支払い方法に関する制限。

フィールド

credit_card_restrictions

CreditCardRestrictions

この販売者が受け付けるクレジットカードに関する制限。このフィールドが設定されていない場合は、すべてのクレジットカードが受け付けられるとみなされます。CreditCardType でサポートされているカードの数は時間の経過とともに増えていきます。つまり、このフィールドを空のままにしておくと、今後設定が変更される可能性があります。

PerOrderFee

チケットの数に関係なく、注文ごとに 1 回支払う必要がある料金。

フィールド

delivery_fee

配送方法によって異なる料金。

processing_fee

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

PerTicketFee

ユーザーが購入するチケットごとに支払う必要がある料金。

フィールド

service_charge

サービスに対して課せられる追加料金。

facility_fee

会場または施設に支払う料金。

taxes

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

PostalAddress

顧客またはビジネス拠点の住所。

フィールド
`address_country`	`string` 国。ISO 3166-1 alpha-2 の国コードを使用して指定します。例: 「US」（必須）
`address_locality`	`string` 地域区分（例: 横須賀市）（必須）
`address_region`	`string` 県（例: 神奈川県）。このフィールドは、県が住所の一部である国でのみ必須です。（省略可）
`postal_code`	`string` 郵便番号（例: 94043）。（必須）
`street_address`	`string` 番地（例: 大町 3-5）。（必須）

PrepaymentStatus

予約の前払いステータス。

列挙型
`PREPAYMENT_STATUS_UNSPECIFIED`	指定されていない場合、デフォルトは PREPAYMENT_NOT_PROVIDED です。
`PREPAYMENT_PROVIDED`	予約料金は前払いされています。
`PREPAYMENT_NOT_PROVIDED`	予約料金は前払いされていません。
`PREPAYMENT_REFUNDED`	料金は以前に PREPAYMENT_PROVIDED でしたが、現在は払い戻されています。

価格

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

フィールド
`price_micros`	`int64` 価格（最小通貨単位）。最小通貨単位の端数は、最近接偶数に丸められます（例: USD 2.5 セントは 2 セント、3.5 セントは 4 セント、0.5 セントは 0 セント、2.51 セントは 3 セントに丸められます）。
`currency_code`	`string` ISO 4217 で定義されている価格の通貨。
`pricing_option_tag`	`string` 拡張価格に関連付けられている価格設定オプションを識別する不透明な文字列（省略可）。

PriceInterpretation

Price を解釈してユーザーに表示する方法について説明します。

列挙型
`PRICE_INTERPRETATION_UNSPECIFIED`	Price 解釈が指定されていません。デフォルトは EXACT_AMOUNT です。
`EXACT_AMOUNT`	価格を特定の値として解釈する必要がある場合。例: ヨガのクラスは 20 ドル。子どもの散髪は 150 ドル。
`STARTS_AT`	サービスの価格は変動する可能性があるが、すでに決まっている最小価格がユーザーに表示される場合。消費者のオプション追加により価格が上がることがあります。この PriceInterpretation を使用するサービスでは、PrepaymentType NOT_SUPPORTED を使用する必要があります。例: 犬のトリミング料金は 30 ドルですが、消費者のオプション追加により価格が上がる場合があります。
`NOT_DISPLAYED`	サービスの価格は変動する可能性があるが、ユーザーに価格情報が事前に表示されていない場合。この PriceInterpretation を使用するサービスでは、PrepaymentType NOT_SUPPORTED を使用し、Price を空にする必要があります。例: 家事のコンサルティング

PriceType

空き情報を基に合計価格を決定する方法を定義します。

列挙型

FIXED_RATE_DEFAULT

価格が固定額の場合に使用します。フィールドが設定されていない場合のデフォルト値です。

例: テーブルを予約するための 50 ドルのデポジット、ヨガクラスのキャンセル料 20 ドル

PER_PERSON

1 人あたりの価格を指定する場合に使用します。合計金額は、Resources で指定された人数を基に算出されます（price_micros × party_size）。PER_PERSON の価格は、空き情報リソースの人数に関連付ける必要があります。それ以外の場合は、人数として 1 が使用されます。

例: 美術館のチケット 1 枚 10 ドル

QuantitativeValue

範囲または固定値である数値のラッパー。QuantitativeValue の例: * 単一の値: value: 10.5 * 境界範囲: value_range {min_value: 5.5, max_value 10.5} * 下限: value_range {min_value: 5.5} * 上限: value_range {max_value: 10.5}

フィールド

共用体フィールド value_options。（必須）value_options は次のいずれかになります。

value

double

単一の値。例: 5.6

value_range

RangeValue

値の範囲。値の範囲は自由形式でも制限付きでもかまいません。例: * 5.5 以上 × 5.5 以下 × 5.5 ～ 6.5

RangeValue

min_value < max_value のような値の範囲。min_value または max_value の少なくとも 1 つが必要です。

フィールド

min_value

double

最小値。

max_value

double

最大値

評価

エンティティの評価を定義します。

フィールド

value

double

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

number_of_ratings

uint64

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

RelatedMedia

このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。（省略可）

フィールド
`url`	`string` このメディアソースの URL。Google はこの URL でホストされているメディアをクロールします。
`type`	`MediaType` このメディアソースのタイプ。
`localized_caption`	`Text` i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。（省略可）
`attribution`	`Attribution` メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。（省略可）
`caption (deprecated)`	`string` この項目は非推奨です。非推奨。localized_caption を使用することをおすすめします。

Attribution

このメディアの権利帰属情報。

フィールド

localized_text

Text

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

text
(deprecated)

string

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

MediaType

このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。

列挙型
`TYPE_UNSPECIFIED`	未使用。
`PHOTO`	URL で提供されるメディアが写真であることを示します。

ReplaceServiceAvailabilityRequest

Service の空き情報を置き換えるリクエスト。

フィールド

service_availability

ServiceAvailability

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

RequireCreditCard

予約にクレジットカードが必要かどうかを定義します。

列挙型
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	クレジットカードの要件は明示的に指定されておらず、動作は CONDITIONAL で指定されたものと同じになります。
`REQUIRE_CREDIT_CARD_CONDITIONAL`	空き情報に価格が設定されており、prepayment_type が REQUIRED の場合、no_show_fee が設定されている場合、保証料フィールドが設定されている場合のうちいずれかの条件に該当する場合は、クレジットカード情報が必要です。
`REQUIRE_CREDIT_CARD_ALWAYS`	他のフィールドの値に関係なく、この空き情報を予約するにはクレジットカードが常に必要です。

SchedulingRules

サービスのスケジュール設定ルール。

フィールド
`min_advance_online_canceling`	`int64` 予約をオンラインでキャンセルするために必要な最小事前通知期間（秒単位）。（省略可）
`late_cancellation_fee (deprecated)`	`Price` この項目は非推奨です。最小事前通知期間内のキャンセル料。
`noshow_fee (deprecated)`	`Price` この項目は非推奨です。無断キャンセル料。
`admission_policy`	`AdmissionPolicy` このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。（省略可）
`cancellation_policy`	`CancellationPolicy` キャンセルポリシーのスケジュール設定ルール。（おすすめスポットでは必須）
共用体フィールド `min_booking_buffer`。最終予約が可能な時間から予約枠の開始時刻または終了時刻までの期間（秒単位）。「min_advance_booking」が設定されている場合、最終予約可能時間は（<予約枠開始時間> - min_advance_booking）として計算されます。「min_booking_Buffer_before_end_time」が設定されている場合、最終予約可能時間は（<予約枠終了時間> - min_booking_buffer_before_end_time）として計算されます。「min_booking_buffer_before_end_time」を設定する場合は、正の値にする必要があります。どちらも設定されていない場合、時間枠は開始時間まで予約可能です。両方のフィールドが設定されている場合、一方の値は選択され、もう一方の値は無視されるため、どちらの値が選択されるかを確実に予測できません。例: 開始時刻の 1 時間前までに予約する必要がある美容院: 'scheduling_rules{ min_advance_booking: 3600 ...}` 閉館 30 分前まで最終チケットを購入できる博物館: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}' 開始時刻より前に購入する必要がある映画チケット: 'scheduling_rules{ ...}'（このフィールドを空にします）（省略可）`min_booking_buffer` は次のいずれかが可能です。
`min_advance_booking`	`int64` 最後の予約が可能になってから予約枠が開始するまでの時間（秒単位）。
`min_booking_buffer_before_end_time`	`int64` 最終予約可能時間から予約枠の終了時刻までの期間（秒単位）。このフィールドが設定されている場合、「admission_policy」フィールドを TIME_FLEXIBLE に設定して、ユーザーが予約枠の開始後に購入したチケットを使用できることを示す必要があります。

AdmissionPolicy

このサービスの入場ポリシー。

列挙型
`ADMISSION_POLICY_UNSPECIFIED`	未使用。
`TIME_STRICT`	顧客は予約枠の開始時刻にはそこにいる必要があり、サービスは予約枠の終了時間に終了するものとされています。TIME_STRICT の使用例: すべての参加者が開始時刻の午前 9 時に到着し、午後 12 時頃に戻るツアー。予約が土曜日の午後 3 時で、所要時間は約 30 分のヘアカット。* 午後 6 時から午後 8 時までのフィットネスクラス。
`TIME_FLEXIBLE`	顧客はこの予約の予約枠の開始時刻から終了時間までいつでも到着可能です。 TIME_FLEXIBLE の使用例: * 購入対象日の任意の時間に使用できる博物館のチケット。* 午後 12 時から午後 9 時まで利用できる遊園地の午後用入場券。
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	顧客は、予約枠の開始時刻に販売者の拠点に到着する必要がありますが、必要に応じていつでも退出できます。たとえば、博物館の入場の場合、午前 10 時の時間指定の入場券を提示するために、購入者は午前 10 時に博物館に到着している必要があります。このサービスの予約枠の開始時刻は、指定された入場時間を表します。ただし、終了時間は、予約の予約枠を識別するためのキーとしてのみ使用されます。

サービス

販売者が提供しているサービス（ヘアカットなど）に関する情報。

フィールド
`name`	`string` サービスリソース名。`partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` の形式です。
`service_name`	`string` サービスの名前（例: 「メンズヘアカット」）。非推奨です。代わりに localized_service_name を使用してください。
`localized_service_name`	`Text` サービスの名前（例: 「メンズヘアカット」）。複数の言語 / 地域で発生する可能性があります。
`description`	`string` ユーザーに表示される、サービスの説明。非推奨です。代わりに localized_description を使用してください。
`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> または <ul> 未満の子供のみが変換されます。他のすべての子タグは削除されます。また、内部タグ、属性、スタイルはすべて無視されます。保持されるのは、書式なしテキストコンテンツのみです。分割タグ: <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`	`Price` サービスの料金。
`price_interpretation`	`PriceInterpretation` 価格を解釈してユーザーに表示する方法について説明します。「レストラン」と「おすすめスポット」以外のすべてのカテゴリで、サービス料金の表示を設定できます。
`rules`	`SchedulingRules` 予約やキャンセルのルール。
`prepayment_type`	`PrepaymentType` 前払いが必須、任意、またはサポート対象外
`prepayment_terms`	`PrepaymentTerms` 前払いの完了に関する条件。
`form[] (deprecated)`	`ServiceIntakeForm` この項目は非推奨です。非推奨です。intake_form と per_ticket_intake_form を使用してください。
`intake_form`	`ServiceIntakeForm` このサービスの予約時にユーザーに追加情報を尋ねるフォーム。（省略可）
`per_ticket_intake_form`	`ServiceIntakeForm` このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。（省略可）
`tax_rate`	`TaxRate` サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された tax_rate をオーバーライドします。メッセージが空の場合（tax_rate { } など）、適用税率はゼロにリセットされます。
`payment_option_id[]`	`string` このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。
`deposit`	`Deposit` ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。（省略可）
`no_show_fee`	`NoShowFee` ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。（省略可）
`require_credit_card`	`RequireCreditCard` このサービスを予約するためにユーザーがクレジットカード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。（省略可）
`action_link[]`	`ActionLink` このサービスに関連するアクションリンク。アクションリンクが存在する場合は、Service でタイプ（下記を参照）を設定する必要があります。
`type`	`ServiceType` このサービスの事前定義されたタイプ。（省略可）
`ticket_type[]`	`TicketType` チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。（省略可）
`related_media[]`	`RelatedMedia` このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。（省略可）
`service_attribute_value_id[]`	`ServiceAttributeValueId` このサービスに適用される Service 属性値（省略可）。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。（省略可）
`waitlist_rules`	`WaitlistRules` 順番待ちリストに登録するためのルール
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` イベントチケット販売業種に固有の追加情報。（省略可）
`integration_type`	`IntegrationType` このサービスでサポートされる統合の程度。（省略可）試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンドでは常に無効になります。
`per_order_fee`	`PerOrderFee` このサービスを購入するための注文レベルの料金。（省略可）
`tours_and_activities_content`	`ToursAndActivitiesContent` Tours と Activities に固有のコンテンツフィールド。
`location[]`	`Location` このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。
`rating`	`Rating` このサービスに対するユーザー評価（すべてのレビューの集計指標）。
`home_service_data`	`HomeServiceData` ホームサービスの業種に固有の追加情報。（省略可）
`virtual_session`	`VirtualSession` （省略可）仮想セッションに関する情報。仮想サービスを有効にするために必要です。
`direct_merchant_payment`	`DirectMerchantPayment` （省略可）ユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: この取引に RwG は関与しません。virtual_session が定義されていて、Service が無料でない場合、または prepayment_type が REQUIRED に設定されていない場合は必須です。

PrepaymentTerms

前払いが完了したタイミングに関する具体的な情報。

フィールド

charge_timing

ChargeTiming

請求が発生するタイミング。購入日時に対して相対的な料金が発生するか。

charge_time_before_start_time_sec

int64

ユーザーに料金の請求が行われるサービス開始時刻までの秒数。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。

ChargeTiming

購入時刻を基準に請求が発生するタイミングを列挙する列挙型です。

列挙型
`CHARGE_TIMING_UNSPECIFIED`	未使用。
`CHARGE_NOW`	お客様への請求は直ちに行われます。
`CHARGE_LATER`	後ほどお客様に請求が行われます。

PrepaymentType

前払いのタイプを示す列挙型。

列挙型
`PREPAYMENT_TYPE_UNSPECIFIED`	デフォルトでは、前払いは NOT_SUPPORTED とみなされます。
`REQUIRED`	ユーザーは予約時にこのサービスの支払いを行う必要があります。
`OPTIONAL`	ユーザーは予約時または予約後にこのサービスの前払いを行うことができますが、必須ではありません。
`NOT_SUPPORTED`	このサービスでは前払いがサポートされていません。

ServiceType

事前定義されたサービスタイプ。

列挙型
`SERVICE_TYPE_UNSPECIFIED`	未使用。
`SERVICE_TYPE_DINING_RESERVATION`	レストランの予約。
`SERVICE_TYPE_FOOD_ORDERING`	料理の注文（料理のデリバリーまたはテイクアウト、またはその両方）。
`SERVICE_TYPE_FOOD_DELIVERY`	料理のデリバリー。
`SERVICE_TYPE_FOOD_TAKEOUT`	料理のテイクアウト。
`SERVICE_TYPE_EVENT_TICKET`	イベントチケット。
`SERVICE_TYPE_TRIP_TOUR`	旅行のツアー。
`SERVICE_TYPE_APPOINTMENT`	面会の予約やクラスを提供するサービス。（1）健康＆フィットネス、（2）スパ、美容サービス、（3）金融に関するコンサルティングと評価サービスに推奨されています。サポートされているサービスの種類については、https://developers.google.com/maps-booking/guides/end-to-end-integration/overview をご覧ください。
`SERVICE_TYPE_ONLINE_APPOINTMENT`	完全にバーチャルで行われるクラスやセッションをオンラインで予約するサービス。仮想サービスの予約を有効にする場合に設定する必要があります。
`SERVICE_TYPE_SHOPPING`	ユーザーが特定の販売者から商品を購入できるサービス。受け取りは、宅配または受け取りのいずれかになります。

ServiceAttribute

サービス属性は、Merchant の Services を記述するパートナー定義のカテゴリです。たとえば、銀行では「口座の種類」サービス属性を「個人」、「ビジネス」の値で定義し、ヘアーサロンでは「サービスの種類」サービス属性を「ヘアーカット」、「ヘアカラー」、「ヘアセット」の値で定義できます。

フィールド

attribute_id

string

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

attribute_name

string

この属性のユーザーに表示される名前（「アカウントの種類」など）。

value[]

Value

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

値

特定のサービス属性で可能な値を表します。

フィールド

value_id

string

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

value_name

string

ユーザーに表示される値の名前（「個人」など）。

ServiceAttributeValueId

Service に適用されるサービス属性の特定の値を識別します。

フィールド

attribute_id

string

Merchant.service_attribute で定義されている属性の ID（「service-type」など）。

value_id

string

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

ServiceAvailability

空き情報のリストおよび申し込み対象先と申し込み対象時間

フィールド
`name`	`string` このパラメータの申し込み先のサービスのリソース名`partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` の形式
`start_time_restrict`	`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 から始まる全期間とみなされます。
`end_time_restrict`	`Timestamp` start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までのすべての時間を意味すると解釈されます。
`duration_restrict`	`Duration` duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。
`resources_restrict`	`Resources` resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが正確に一致している必要があります。
`availability[]`	`Availability` 空き状況の新しいリスト。

ServiceIntakeForm

販売者が提供するサービスをカスタマイズするインテイクフォームを定義します。

フィールド

field[]

ServiceIntakeFormField

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

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

ServiceIntainForm に含まれるフィールドを定義します。

フィールド
`id`	`string` フォームフィールドを一意に識別するアグリゲータパートナーからの文字列。この ID は、対応するフォームフィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイクフォームの両方で一意である必要があります。（必須）
`type`	`FieldType` このフィールドの型。
`label`	`string` ユーザーに表示される、このフィールドのテキスト。非推奨です。代わりに `localized_label` を使用してください。
`localized_label`	`Text` ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。（必須）
`value[]`	`string` フィールドタイプが LOCATION_SEARCH の場合にのみ設定します。[location] フィールドの [location_id] を使用して場所の値を指定してください。
`choice_text[]`	`Text` フィールドタイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用します。
`is_required`	`bool` このフィールドに対する回答がユーザーに必須であるかどうかを示します。
`allow_custom_answer`	`bool` 事前定義された回答に加えて、カスタム値が許可されているかどうかを示します。これは、フィールドタイプが LOCATION_SEARCH の場合にのみ適用されます。（省略可）
`additional_option[]`	`Text` 指定された値に加えて、追加のオプションが提供されます。フィールドタイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、指定した場所のリストのほかに、「後でサプライヤーに連絡します」などのオプションを使用することもできます。（省略可）
`ticket_type_restrict[]`	`string` ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に当てはまる場合は、フィールドを空欄にしてください。
`hint`	`Text` 入力のヒントテキスト。テキストのプレースホルダとして表示されます。これは、フィールドタイプが SHORT_ANSWER または段落である場合にのみ適用されます。（省略可）

FieldType

フィールドのタイプを示す列挙型。

列挙型
`FIELD_TYPE_UNSPECIFIED`	未指定または不明なタイプのフィールドは無視されます。
`SHORT_ANSWER`	テキスト用の 1 行の入力フィールド。
`PARAGRAPH`	テキスト用の複数行の入力フィールド。
`MULTIPLE_CHOICE`	多数のオプションから 1 つを選択する必要があるラジオボタンのセット。
`CHECKBOXES`	チェックボックス付きの 1 つ以上の列挙型項目。
`DROPDOWN`	プルダウンからの選択。
`BOOLEAN`	はい / いいえボタン。
`LOCATION_SEARCH`	ユーザーの入力に基づいて、指定されたビジネス拠点のリストから一致するビジネス拠点を検索できる検索ボックス。

TaxRate

サービスの料金をユーザーに請求する際に適用される税率。販売者単位またはサービス単位で設定できます。

フィールド

micro_percent

int32

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

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

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

利用規約

「Google で予約」を介して予約を行うためにユーザーに表示される一連のルールとガイドライン。

フィールド

url

string

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

text

string

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

localized_text

Text

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

テキスト

ローカライズされた可能性のあるテキストペイロード。一部の Text フィールドには、マークアップされたコンテンツを含めることができます。

フィールド

value

string

不明な言語 / 地域の Text 値。localized_value が空の場合にのみ必須です。この値のロケールは、パートナーまたはサービスプロバイダによって異なる場合があります。特定の言語を想定しないでください。

localized_value[]

LocalizedString

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

TicketType

TicketType は、ユーザータイプ、サービス属性、オプション / アドオンが異なるため、価格や空き情報が異なるチケットを他のチケットとの間で区別するために使用されます。

チケットは、サービスの予約可能な最小単位です（ラフティングのツアースポット、博物館への入場、2 人用カヤックの 1 日レンタルなど）。

フィールド
`ticket_type_id`	`string` チケット ID は、同じサービスの異なるチケットタイプを区別するために使用され、サービス内で一意であることが想定されます。
`short_description`	`string` この TicketType の簡単な説明。これはユーザーに表示されます（「大人」、「子供」、「退役軍人」、「J 列」など）。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localized_short_description を使用してください。
`localized_short_description`	`Text` i18n をサポートするこの TicketType の簡単な説明。これはユーザーに表示されます（「大人」、「子供」、「退役軍人」、「J 列」など）。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。
`price`	`Price` このタイプのチケット 1 枚の価格（税抜き）。Service の税率はチケットに適用されます。
`per_ticket_fee`	`PerTicketFee` このチケットを購入するための追加料金。（省略可）
`option_description`	`string` このチケットタイプが表す追加オプションの説明（ある場合）。非推奨です。代わりに localized_option_description を使用してください。
`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> です。タイトルと詳細な説明でオプションを指定するために使用します（例:「プレミアムシートこのオプションでは、座りこごちの良い椅子、専用テレビ、飲食サービスを含む専用ボックスシートが提供されます。客席からは美しい景色を眺めることができます。」）

TicketingVerticalSpecificData

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

フィールド
`event_category`	`EventCategory` イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。（省略可）
`event_url`	`string` パートナーのウェブサイトに掲載されているイベントの URL。（省略可）
`entity[]`	`Entity` イベントに関連するエンティティのリスト。（省略可）
`event_attendance_mode`	`AttendanceMode` 必須。イベントへの参加のタイプ。
`event_virtual_location_url[]`	`string` （省略可）イベントを視聴できます。
`event_organizer`	`Text` （省略可）イベントを主催する主催者。
`event_organizer_url`	`string` （省略可）予定を主催する主催者の URL。
`event_organizer_type`	`OrganizerType` （省略可）主催者のタイプ。
`event_source_url[]`	`string` 必須。イベントの情報や説明を確認できるページの URL。
`event_state`	`EventState` （省略可）イベントの状態。

AttendanceMode

イベントへの参加のタイプ。

列挙型
`ATTENDANCE_MODE_UNSPECIFIED`	指定されていません。
`ONLINE`	仮想イベントの場合。
`PHYSICAL`	実地イベントの場合。
`PHYSICAL_ONLINE_MIXED`	対面と仮想の両方のイベントに対応。

エンティティ

イベントに関連するエンティティを表します。

フィールド
`id`	`string` パートナーのデータベースにあるエンティティの一意の識別子。（省略可）
`name`	`string` エンティティの名前。（必須）
`url`	`string` エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページ（存在する場合）です。エンティティのその他の公開 URL の場合は、public_identification_data で relevant_url を使用します。（省略可）
`entity_type`	`EntityType` エンティティのタイプ。（省略可）
`entity_role`	`EntityRole` イベントでのエンティティの役割。（省略可）
`public_identification_data`	`PublicIdentificationData` エンティティの公開参照。（省略可）

EntityRole

イベントでのエンティティの役割。

列挙型
`ENTITY_ROLE_UNSPECIFIED`	指定されていません。
`ENTITY_ROLE_HEADLINER`	エンティティは、イベントでの主演者または主要出演者を表します。
`ENTITY_ROLE_SUPPORTER`	エンティティは、イベントでの脇役を表します。
`ENTITY_ROLE_HOME_TEAM`	エンティティは、（スポーツ）イベントのホームチームを表します。
`ENTITY_ROLE_AWAY_TEAM`	エンティティは、（スポーツ）イベントのアウェイチームを表します。

EntityType

エンティティのタイプ。注: 汎用のオントロジーを意図したものではありません。

列挙型
`ENTITY_TYPE_UNSPECIFIED`	指定なし。使用しないでください。
`ENTITY_TYPE_PERFORMER`	エンティティは、コンサート / ショーで演奏する / 演じるアーティストやグループを表します。イベントカテゴリが CONCERT または THEATRE の場合にのみ該当します。
`ENTITY_TYPE_PLAYER`	エンティティは、イベントのスポーツチームまたは選手を表します。イベントカテゴリが SPORTS の場合にのみ該当します。
`ENTITY_TYPE_CONCERT_TOUR`	エンティティは、このイベントが属するツアーを表します。イベントカテゴリが CONCERT の場合にのみ該当します。
`ENTITY_TYPE_SPORTS_SERIES`	エンティティは、このイベントが属するスポーツトーナメントを表します。イベントカテゴリが SPORTS の場合にのみ該当します。
`ENTITY_TYPE_PLAY`	エンティティは、イベントで行われる演劇のタイプ（ミュージカル、コメディ、バレエなど）を表します。イベントカテゴリが THEATRE の場合にのみ該当します。

EventCategory

サービスエクスペリエンスをカスタマイズするイベントカテゴリのサブセット。注: イベントの汎用のオントロジーを意図したものではありません。

列挙型
`EVENT_CATEGORY_UNSPECIFIED`	指定なし。使用しないでください。
`EVENT_CATEGORY_CONCERT`	コンサート。
`EVENT_CATEGORY_SPORTS`	スポーツイベント。
`EVENT_CATEGORY_THEATRE`	劇場でのイベント。
`EVENT_CATEGORY_EXHIBITS`	展示。
`EVENT_CATEGORY_WORKSHOPS_AND_CLASSES`	ワークショップとクラス。

EventState

イベントの状態。

列挙型
`EVENT_STATE_UNSPECIFIED`	指定されていません。
`SCHEDULED`	このイベントはスケジュールされています。
`RESCHEDULED`	イベントの日時が変更されました。
`CANCELLED`	イベントはキャンセルされました。
`POSTPONED`	イベントは延期されています。

OrganizerType

主催者のタイプ。

列挙型
`ORGANIZER_TYPE_UNSPECIFIED`	指定されていません。
`PERSON`	主催者（個人の場合）。
`ORGANIZATION`	組織の主催者向け。

PublicIdentificationData

エンティティを参照する識別子、ウェブページ、その他の公開ソース。

フィールド

relevant_url[]

string

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

musicbrainz_id

string

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

TimeRange

左閉右開の時間帯（例: [start_time, end_time)）。

フィールド

start_time

時間帯の下限。

end_time