Package google.maps.booking.v1alpha

インデックス

BookingNotification

外部のスケジューリング パートナーからの予約に関する通知を受け取ります。パートナーは、CreateBooking や CheckAvailability などの予約ベースのリモート プロシージャ コールを実装するか、あるいは CreateOrder や CheckOrderFulfillability などの注文ベースのリモート プロシージャ コールを実装することで、UpdateBooking または UpdateOrder を呼び出します。

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

既存の Booking を更新します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

既存の Order を更新します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking

Feed

外部アグリゲータ パートナーによりアップロードされたフィードの処理ステータスを取得します。

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

指定したアグリゲータによって以前にアップロードされたフィードの Status を取得して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

指定されたアグリゲータによって、以前にアップロードされた複数の販売者フィード、サービス フィード、または空き情報フィードの Status を取得して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking

InvalidationService

外部パートナーからリソース無効化リクエストを受け取ります。

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

既存のリソースを無効にします。

リクエストされたリソースが Google サービスに登録されていない場合、リクエストは無視されます。

サポートされるリソースタイプ: - 店舗受け取り

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

アップロードされた販売者の在庫と一致ステータスを取得します。

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

MerchantMerchantStatus を取得します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

フィルタ条件を満たすパートナーの MerchantStatus をすべてリストします。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

外部アグリゲータから空き情報の更新を取得します。

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

指定したフィードタイプのレコードを削除します。基本的な検証(不正な形式のリクエストなど)のみを行い、その後すぐに適切なレスポンスがパートナーに返されます。Google は、リクエストのビジネス ロジック検証を非同期で実行します。このバッチ呼び出しではアトミック性は保証されません。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

指定したフィードタイプのレコードを挿入または更新します。基本的な検証(不正な形式のリクエストなど)のみを行い、その後すぐに適切なレスポンスがパートナーに返されます。Google は、リクエストのビジネス ロジック検証を非同期で実行します。このバッチ呼び出しではアトミック性は保証されません。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

既存の ServicesAvailability を置き換えます。このバッチ呼び出しでは、原子性は保証されません。正常に更新された予約枠のみが返されます。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

指定されたアグリゲータによって管理されている新しい Merchant を作成して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService(CreateServiceRequest) returns (Service)

指定されたアグリゲータによって管理されている販売者の新しい Service を作成して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

指定されたアグリゲータによって管理されている既存の Merchant を削除します。販売者のすべてのサービスと空き状況も無効になります。後で販売者を再度追加すると、サービスと予約枠の同じセットも有効になります。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Empty)

指定されたアグリゲータによって管理されている販売者の既存の Service を削除します。サービスの空き情報もすべて削除されます。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

指定されたアグリゲータによって管理されている販売者の既存の ServiceAvailability を置き換えて返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

指定されたアグリゲータによって管理されている既存の Merchant を更新して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Service)

指定されたアグリゲータによって管理されている販売者の既存の Service を更新して返します。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

アクション リンクに関連付けられている、事前定義されたアクションのタイプ。

列挙型

ActionPlatform

アクションが実行されるプラットフォーム。ウェブ アプリケーションが、一般的な代替プラットフォームです。ACTION_PLATFORM_WEB_APPLICATION をプラットフォームとする ActionLink を少なくとも 1 つ用意することをおすすめします。Android と iOS をプラットフォームとするリンクは、それぞれのシステムでのみ使用されます。

列挙型
ACTION_PLATFORM_UNSPECIFIED プラットフォームが指定されていません。
ACTION_PLATFORM_WEB_APPLICATION アクション プラットフォームはウェブ全般です。
ACTION_PLATFORM_MOBILE_WEB アクション プラットフォームはモバイル デバイス上のウェブです。
ACTION_PLATFORM_ANDROID アクション プラットフォームは Android OS です。
ACTION_PLATFORM_IOS アクション プラットフォームは iOS です。

アドバイス

「Google で予約」で予約する際にユーザーに表示されるアドバイス。

フィールド
text

Text

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

対象

販売者のサービスの予約枠(時間とスポット数)。

フィールド
start_time

Timestamp

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

duration

Duration

予約枠の期間

spots_total

int64

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

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

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

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

int64

空きスポットの数。

availability_tag

string

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

resources

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 }
payment_option_id[]

string

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

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

recurrence

Recurrence

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

schedule_exception[]

ScheduleException

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

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

ticket_type_id[]

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 は設定しないでください)。

(省略可)

duration_requirement

DurationRequirement

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

scheduling_rule_overrides

SchedulingRuleOverrides

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

confirmation_mode

ConfirmationMode

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

ConfirmationMode

空き状況の予約時に使用される確認モード。

列挙型
CONFIRMATION_MODE_UNSPECIFIED 確認モードが指定されませんでした。同期確認が想定されます。
CONFIRMATION_MODE_SYNCHRONOUS この空き状況に対する予約は同期的に確認されます。
CONFIRMATION_MODE_ASYNCHRONOUS この空き情報に対する予約は非同期的に確認されます。

DurationRequirement

この列挙型は、リクエストされたスロットの期間/終了時間をユーザーが確認または表示するための要件を示します。

列挙型
DURATION_REQUIREMENT_UNSPECIFIED 終了時間の処理が指定されていません。これがデフォルトです。
DO_NOT_SHOW_DURATION 終了時間はユーザーに表示されません。
MUST_SHOW_DURATION 予約を取れる前に、終了時間をユーザーに提示する必要があります。

繰り返し

Recurrence メッセージは省略可能ですが、空き状況スロットが一貫性を持って繰り返す場合は、これを使うとより簡潔に表すことができます。通常は 1 日の営業スケジュールを表した後、ScheduleException メッセージを使って、その営業日内で予約済みの時間帯や利用できない時間帯を表します。

要件:

  1. 予約枠または繰り返しを拡張することで、同一の予約枠を作成することはできません。id、start_time、duration、resources が一致する場合、予約枠は同一と見なされます。
  2. 単一のサービスの予約枠内で、標準の空き情報形式と繰り返しを混在させないでください。繰り返しは、予約を提供する販売者やサービスに有効で、標準形式は、定期的にクラスをスケジュール設定する販売者やサービスを対象としています。
  3. 繰り返しは 24 時間を超えることはできません。
フィールド
repeat_until

Timestamp

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

repeat_every

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 となります。(必須)

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

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 エポックからの経過秒数)。この項目は、サービスレベルのキャンセル ルールよりも優先されます。(省略可)

BatchDeleteGenericRecordsRequest

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

フィールド
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 件です。

BatchReplaceServiceAvailabilityRequest

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

フィールド
parent

string

partners/{partner_id} の形式。

extended_service_availability[]

ExtendedServiceAvailability

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

BatchReplaceServiceAvailabilityResponse

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

フィールド
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 に設定されていない限り、無視されます。

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 個以上の払い戻し条件。

RefundCondition

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

フィールド
min_duration_before_start_time

Duration

開始時刻までの期間。顧客は、この時刻まで 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

作成する販売者。

CreateServiceRequest

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

フィールド
parent

string

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

service_id

string

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

service

Service

作成するサービス。

CreditCardRestrictions

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

フィールド
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} です。

DeleteServiceRequest

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

フィールド
name

string

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

Deposit

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

フィールド
deposit

Price

デポジットの金額。

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

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

DirectMerchantPayment

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

フィールド
payment_methods[]

Text

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

DurationRange

制限ありまたは制限なしにできる期間の範囲のラッパー。min_duration と max_duration の期間の少なくとも 1 つを指定する必要があります。

フィールド
min_duration

Duration

最小期間。

max_duration

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

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

FeeDetails

料金の詳細。

フィールド
type

FeeType

料金タイプ。(必須)

fee_amount

FeeAmount

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

FeeAmount

FeeAmount の例: * 固定料金: 0 米ドル(手数料なし)、1.5 米ドル * 固定料金の範囲: 1.0 米ドル(最小)、3.0 米ドル(最大)、5.0 ~ 6.0 米ドル * カートサイズの割合: 15.5%、10%~ 20%、10%(最小)、15%(最大)* 範囲と割合の複合:2.5 米ドル(最小)、25.5%、4.5 米ドル(最大)、10%、USD 1.5 ~ 2.5、10.5%~ 20%、USD 2.5 ~ 3.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

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

FeeDetails

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

フィールド
共用体フィールド fee_details。フルフィルメント方法の料金モデル。fee_details は次のいずれかになります。
no_fee

NoFee

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

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

FixedFee

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

フィールド
amount

Price

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

FulfillmentType

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

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

MinimumFee

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

フィールド
base_fee_amount

Price

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

NoFee

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

GenericDeleteRecord

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

フィールド
delete_time

Timestamp

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

共用体フィールド record_type。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化するパートナーは、フィードまたは BatchPush API でレコードを指定する方法と同様に、完全なレコードを提供できます。パートナー様は、レコードを一意に識別するために不可欠なフィールドのみを含めることもできます。record_type は次のいずれかになります。
data_record

bytes

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

proto_record

Any

proto ベースのフィード用。

GenericRecord

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

フィールド
generation_timestamp

Timestamp

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

共用体フィールド record_type。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化するrecord_type は次のいずれかになります。
data_record

bytes

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

proto_record

Any

proto ベースのフィード用。

GeoCoordinates

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

フィールド
latitude

double

緯度。(省略可)

longitude

double

経度。(省略可)

共用体フィールド addresses。ビジネス拠点の住所。構造化されている住所とされていない住所が可能で、addresses は次のいずれかになります。
address

PostalAddress

場所の住所(推奨)。

unstructured_address

string

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

GetMerchantStatusRequest

MerchantStatus を取得するリクエスト

フィールド
name

string

必須。リソース名。Partners/{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

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

たとえば、Pickup リソースの場合、名前は 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 をご覧ください。指定されている場合、Google は場所とこの場所を照合します。

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 { })は、適用される税率を 0 にリセットします。

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

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

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

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

MatchedProvider

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

フィールド
customer_id

int64

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

categories[]

string

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

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

Price

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

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 { })は、適用される税率を 0 にリセットします。

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

Price

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

processing_fee

Price

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

PerTicketFee

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

フィールド
service_charge

Price

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

facility_fee

Price

会場や施設に行く料金。

taxes

Price

チケット 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

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

フィールド
price_micros

int64

価格(最小通貨単位)。最小通貨単位の端数は、最近接偶数に丸められます(例: 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_valuemin_valuemax_value の少なくとも 1 つが必要です。

フィールド
min_value

double

最小値。

max_value

double

最大値

評価

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

フィールド
value

double

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

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 他のフィールドの値に関係なく、この空き情報を予約するにはクレジット カードが常に必要です。

Resources

リソースは、異なるスタッフ メンバーや部屋がサービスに含まれている場合に、個々の空き状況スロットを区別するために使用されます。予約枠のサービスと時間間隔が同じでも、リソースが異なるなら、予約枠は複数存在できます。

フィールド
staff_id

string

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

staff_name

string

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

room_id

string

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

room_name

string

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

party_size

int32

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

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 つの値のみが選択され、もう 1 つの値は無視されるため、どちらの値が選択されるかを正確に予測することはできません。

例:

  • 開始時刻の 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> 歳未満の子供または <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

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 { })は、適用される税率を 0 にリセットします。

payment_option_id[]

string

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

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

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

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

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 が Free でない場合、または 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

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

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_id」を使用してください対象の「location」ロケーションの値を指定します。

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 または Colab の場合に限られます。(省略可)

FieldType

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

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

TaxRate

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

フィールド
micro_percent

int32

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

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

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

Terms

「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

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

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-Swifthttps://www.wikidata.org/wiki/Q19320959https://twitter.com/acmilan)。(省略可)

musicbrainz_id

string

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

TimeRange

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

フィールド
start_time

Timestamp

時間帯の下限。

end_time

Timestamp

時間帯の上限。

TokenizationConfig

決済代行業者のトークン化の設定。Merchant ごとに設定します。

フィールド
tokenization_parameter

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" }

billing_information_format

BillingInformationFormat

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

BillingInformationFormat

トークンに含める請求先住所の記載事項(ユーザーが入力)。列挙値は Google Pay API のパラメータに対応します(https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters を参照)。

列挙型
BILLING_INFORMATION_FORMAT_UNSPECIFIED 指定なし。デフォルトは MIN です。
MIN 名前、国コード、郵便番号(Google Pay のデフォルト設定)。
FULL 名前、番地、地域区分、県、国コード、郵便番号。

ToursAndActivitiesContent

Tours と Activities に固有のコンテンツ フィールド。繰り返しフィールドの各要素は、独立したレンダリング(箇条書きなど)ができるように個々に設定する必要があります。

ツアーやアクティビティの場合、ToursAndActivitiesContent への入力は強くおすすめしますが、絶対必須条件ではありません。すべてのフィールドは、基本的な書式として、書式なしテキストと HTML に類似する形式のテキストの両方をサポートしています。サポートされている HTML に類似する形式の書式設定タグ:

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

その他すべてのタグとカスタム スタイルは使用できず、削除されます。URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。

重要な注意事項: * highlightsexclusion など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。

フィールド
highlights[]

Text

ユーザーに表示されるハイライトのリスト。

inclusions[]

Text

ユーザーに表示される内容のリスト。

exclusions[]

Text

ユーザーに表示される除外リスト。

must_know[]

Text

ユーザーに表示される重要なメモのリスト。年齢制限やこのサービスが適さないその他の条件などの詳細で使用されます。

UnsupportedPartySizeOption

圏外の相手向けのオプション。

フィールド
call_merchant

CallMerchant

範囲外の人数の場合は、ビジネスに電話をかけることができます。事前定義されたメッセージがユーザーに表示されます。表示するサンプル テキスト: 「{waitlist_rules.max_party_size} 人を超える場合は、{phone} のレストランにお電話ください。」CallMerchant を設定する必要がありますが、空になります。

UpdateBookingRequest

google.maps.booking.v1alpha.Booking を更新するリクエスト

フィールド
update_mask

FieldMask

更新するすべての予約フィールドのフィールド マスク。

booking

Booking

更新対象の予約

booking_failure

BookingFailure

非同期で確認された予約リクエストの処理が失敗し、予約のステータスが FAILED に更新されている場合、このフィールドはビジネス ロジック エラー(たとえば、「ユーザーがこの時間の近くにすでに予約を行っている」)を反映します。このフィールドは、予約ステータスを FAILED に更新する場合にのみ設定してください。それ以外の場合は無視されます。

UpdateMerchantRequest

Merchant を更新するリクエスト。

フィールド
merchant

Merchant

新しい販売者データ。

update_mask

FieldMask

販売者向けに更新される特定のフィールド。

UpdateOrderRequest

google.maps.booking.v1alpha.Order を更新するリクエスト

フィールド
update_mask

FieldMask

更新するすべての注文フィールドのフィールド マスク。

order

Order

更新する注文

UpdateServiceRequest

Service を更新するリクエスト。

フィールド
service

Service

新しいサービスデータ。

update_mask

FieldMask

更新する、サービスの特定のフィールド。

UserPurchaseRestriction

支払いオプションを購入できるユーザーを制限します。

フィールド
new_to_merchant

bool

以前に同じ販売者から購入したことがないユーザーのみが購入できる支払いオプション。

new_to_payment_option

bool

以前に同じ支払いオプションを購入したことがないユーザーのみが購入できる支払いオプション。

VirtualSession

仮想/オンライン セッションに関する情報。例:オンラインのヨガクラス、バーチャル料理教室など

フィールド
session_instructions

Text

この仮想クラスを設定する方法。パートナーが予約に動画の URL を記載していない場合は、動画の URL をユーザーと共有するタイミングをこのテキストに含める必要があります。例: 「講義の 30 分前に Zoom の URL をメールでお送りします」(推奨)

session_requirements

Text

該当の仮想セッションの要件。例:ヨガマット、調理器具など(推奨)

virtual_platform_info

VirtualPlatformInfo

このセッションで使用されている仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要)

is_session_prerecorded

bool

必須。仮想セッションがライブではなく、事前に録画されている場合は、true に設定します。

VirtualPlatformInfo

このバーチャル セッションで使用されるプラットフォームに関する情報。

フィールド
platform

Platform

仮想セッションに使用するプラットフォーム。

other_platform_name

Text

プラットフォームが OTHER に設定されている場合、プラットフォームの名前。(プラットフォームが「OTHER」に設定されている場合は必須)

プラットフォーム

販売者が使用する仮想プラットフォームを示す列挙型。

列挙型
PLATFORM_UNSPECIFIED 未使用。
FLEXIBLE 販売者は、使用する動画プラットフォームを柔軟に選択できます。
GOOGLE_HANGOUTS
GOOGLE_MEET
ZOOM Zoom Video Communications.
SKYPE Skype。
YOUTUBE YouTube でのライブ配信。
OTHER 使用する動画プラットフォームがここに示されているプラットフォームと異なる場合は設定する必要があります。

WaitlistRules

順番待ちリストへの参入に関連するルール。

フィールド
min_party_size

int32

必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。

max_party_size

int32

必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。

supports_additional_request

bool

true の場合、ユーザーはこのサービスの順番待ちリストに登録する際に、自由形式の追加テキスト リクエストを送信できます。

above_max_party_size_options[]

UnsupportedPartySizeOption

設定した max_party_size より大きいサイズのパーティにオプションを設定します。人数の多い方が順番待ちリストに登録するための代替手段を提供しない場合は、空白のままにします。