インデックス
BookingNotification
(インターフェース)Feed
(インターフェース)InvalidationService
(インターフェース)InventoryStatus
(インターフェース)InventoryUpdate
(インターフェース)ActionLink
(メッセージ)ActionLink.ActionLinkType
(列挙型)ActionPlatform
(列挙型)Advisement
(メッセージ)Availability
(メッセージ)Availability.ConfirmationMode
(列挙型)Availability.DurationRequirement
(列挙型)Availability.Recurrence
(メッセージ)Availability.ScheduleException
(メッセージ)Availability.SchedulingRuleOverrides
(メッセージ)BatchDeleteGenericRecordsRequest
(メッセージ)BatchPushGenericRecordRequest
(メッセージ)BatchReplaceServiceAvailabilityRequest
(メッセージ)BatchReplaceServiceAvailabilityResponse
(メッセージ)Booking
(メッセージ)BookingFailure
(メッセージ)BookingFailure.Cause
(列挙型)BookingFailure.PaymentFailureInformation
(メッセージ)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(メッセージ)BookingStatus
(列挙型)CallMerchant
(メッセージ)CancellationPolicy
(メッセージ)CancellationPolicy.RefundCondition
(メッセージ)ClientInformation
(メッセージ)CreateMerchantRequest
(メッセージ)CreateServiceRequest
(メッセージ)CreditCardRestrictions
(メッセージ)CreditCardRestrictions.CreditCardType
(列挙型)DeleteMerchantRequest
(メッセージ)DeleteServiceRequest
(メッセージ)Deposit
(メッセージ)DirectMerchantPayment
(メッセージ)DurationRange
(メッセージ)ExtendedServiceAvailability
(メッセージ)FeedStatistics
(メッセージ)FeedStatus
(メッセージ)FeedStatus.State
(列挙型)FoodOrderingMetadata
(メッセージ)FoodOrderingMetadata.AdvanceOrderDetails
(メッセージ)FoodOrderingMetadata.FeeDetails
(メッセージ)FoodOrderingMetadata.FeeDetails.FeeAmount
(メッセージ)FoodOrderingMetadata.FeeDetails.FeeType
(列挙型)FulfillmentOption
(メッセージ)FulfillmentOption.AvailableDay
(メッセージ)FulfillmentOption.FeeDetails
(メッセージ)FulfillmentOption.FixedFee
(メッセージ)FulfillmentOption.FulfillmentType
(列挙型)FulfillmentOption.MinimumFee
(メッセージ)FulfillmentOption.NoFee
(メッセージ)GenericDeleteRecord
(メッセージ)GenericRecord
(メッセージ)GeoCoordinates
(メッセージ)GetMerchantStatusRequest
(メッセージ)GetStatusRequest
(メッセージ)HomeServiceData
(メッセージ)IntegrationType
(列挙型)InvalidateResourceRequest
(メッセージ)LineItem
(メッセージ)LineItem.OrderedTickets
(メッセージ)ListMerchantStatusesRequest
(メッセージ)ListMerchantStatusesRequest.BookingInventoryStatus
(列挙型)ListMerchantStatusesRequest.GeoMatchingStatus
(列挙型)ListMerchantStatusesRequest.WaitlistInventoryStatus
(列挙型)ListMerchantStatusesResponse
(メッセージ)ListStatusRequest
(メッセージ)ListStatusResponse
(メッセージ)LocalizedString
(メッセージ)Location
(メッセージ)LocationType
(列挙型)Merchant
(メッセージ)MerchantMatchingHints
(メッセージ)MerchantStatus
(メッセージ)MerchantStatus.BookingStatus
(メッセージ)MerchantStatus.DirectUrl
(メッセージ)MerchantStatus.DirectUrl.UrlType
(列挙型)MerchantStatus.LocalServicesMatchInfo
(メッセージ)MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(メッセージ)MerchantStatus.PlaceInfo
(メッセージ)MerchantStatus.ProcessingStatus
(列挙型)MerchantStatus.WaitlistStatus
(メッセージ)MoneyRange
(メッセージ)NoShowFee
(メッセージ)Order
(メッセージ)OrderOnlineMetadata
(メッセージ)PaymentInformation
(メッセージ)PaymentOption
(メッセージ)PaymentOption.ActivationType
(列挙型)PaymentOption.PaymentOptionType
(列挙型)PaymentProcessorConfig
(メッセージ)PaymentProcessorConfig.Processor
(列挙型)PaymentRestrictions
(メッセージ)PerOrderFee
(メッセージ)PerTicketFee
(メッセージ)PostalAddress
(メッセージ)PrepaymentStatus
(列挙型)Price
(メッセージ)PriceInterpretation
(列挙型)PriceType
(列挙型)QuantitativeValue
(メッセージ)QuantitativeValue.RangeValue
(メッセージ)Rating
(メッセージ)RelatedMedia
(メッセージ)RelatedMedia.Attribution
(メッセージ)RelatedMedia.MediaType
(列挙型)ReplaceServiceAvailabilityRequest
(メッセージ)RequireCreditCard
(列挙型)Resources
(メッセージ)SchedulingRules
(メッセージ)SchedulingRules.AdmissionPolicy
(列挙型)Service
(メッセージ)Service.PrepaymentTerms
(メッセージ)Service.PrepaymentTerms.ChargeTiming
(列挙型)Service.PrepaymentType
(列挙型)Service.ServiceType
(列挙型)ServiceAttribute
(メッセージ)ServiceAttribute.Value
(メッセージ)ServiceAttributeValueId
(メッセージ)ServiceAvailability
(メッセージ)ServiceIntakeForm
(メッセージ)ServiceIntakeFormField
(メッセージ)ServiceIntakeFormField.FieldType
(列挙型)TaxRate
(メッセージ)Terms
(メッセージ)Text
(メッセージ)TicketType
(メッセージ)TicketingVerticalSpecificData
(メッセージ)TicketingVerticalSpecificData.AttendanceMode
(列挙型)TicketingVerticalSpecificData.Entity
(メッセージ)TicketingVerticalSpecificData.Entity.EntityRole
(列挙型)TicketingVerticalSpecificData.Entity.EntityType
(列挙型)TicketingVerticalSpecificData.EventCategory
(列挙型)TicketingVerticalSpecificData.EventState
(列挙型)TicketingVerticalSpecificData.OrganizerType
(列挙型)TicketingVerticalSpecificData.PublicIdentificationData
(メッセージ)TimeRange
(メッセージ)TokenizationConfig
(メッセージ)TokenizationConfig.BillingInformationFormat
(列挙型)ToursAndActivitiesContent
(メッセージ)UnsupportedPartySizeOption
(メッセージ)UpdateBookingRequest
(メッセージ)UpdateMerchantRequest
(メッセージ)UpdateOrderRequest
(メッセージ)UpdateServiceRequest
(メッセージ)UserPurchaseRestriction
(メッセージ)VirtualSession
(メッセージ)VirtualSession.VirtualPlatformInfo
(メッセージ)VirtualSession.VirtualPlatformInfo.Platform
(列挙型)WaitlistRules
(メッセージ)
BookingNotification
外部のスケジューリング パートナーからの予約に関する通知を受け取ります。パートナーは、CreateBooking や CheckAvailability などの予約ベースのリモート プロシージャ コールを実装するか、あるいは CreateOrder や CheckOrderFulfillability などの注文ベースのリモート プロシージャ コールを実装することで、UpdateBooking または UpdateOrder を呼び出します。
UpdateBooking |
---|
既存の
|
UpdateOrder |
---|
既存の
|
Feed
外部アグリゲータ パートナーによりアップロードされたフィードの処理ステータスを取得します。
GetStatus |
---|
指定したアグリゲータによって以前にアップロードされたフィードの
|
ListStatus |
---|
指定されたアグリゲータによって、以前にアップロードされた複数の販売者フィード、サービス フィード、または空き情報フィードの
|
InvalidationService
外部パートナーからリソース無効化リクエストを受け取ります。
InvalidateResource |
---|
既存のリソースを無効にします。 リクエストされたリソースが Google サービスに登録されていない場合、リクエストは無視されます。 サポートされるリソースタイプ: - 店舗受け取り
|
InventoryStatus
アップロードされた販売者の在庫と一致ステータスを取得します。
GetMerchantStatus |
---|
|
ListMerchantStatuses |
---|
フィルタ条件を満たすパートナーの
|
InventoryUpdate
外部アグリゲータから空き情報の更新を取得します。
BatchDeleteGenericRecords |
---|
指定したフィードタイプのレコードを削除します。基本的な検証(不正な形式のリクエストなど)のみを行い、その後すぐに適切なレスポンスがパートナーに返されます。Google は、リクエストのビジネス ロジック検証を非同期で実行します。このバッチ呼び出しではアトミック性は保証されません。
|
BatchPushGenericRecord |
---|
指定したフィードタイプのレコードを挿入または更新します。基本的な検証(不正な形式のリクエストなど)のみを行い、その後すぐに適切なレスポンスがパートナーに返されます。Google は、リクエストのビジネス ロジック検証を非同期で実行します。このバッチ呼び出しではアトミック性は保証されません。
|
BatchReplaceServiceAvailability |
---|
既存の
|
CreateMerchant |
---|
指定されたアグリゲータによって管理されている新しい
|
CreateService |
---|
指定されたアグリゲータによって管理されている販売者の新しい
|
DeleteMerchant |
---|
指定されたアグリゲータによって管理されている既存の
|
DeleteService |
---|
指定されたアグリゲータによって管理されている販売者の既存の
|
ReplaceServiceAvailability |
---|
指定されたアグリゲータによって管理されている販売者の既存の
|
UpdateMerchant |
---|
指定されたアグリゲータによって管理されている既存の
|
UpdateService |
---|
指定されたアグリゲータによって管理されている販売者の既存の
|
ActionLink
関連する言語を含むアクション URL、表示を制限する国のリスト、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。
フィールド | |
---|---|
url |
このアクション リンクのエントリポイント URL。 |
language |
この URI のコンテンツを利用できる言語を識別する BCP-47 言語タグ。 |
restricted_country[] |
ISO 3166-1 alpha-2 の国コード。表示を制限しない場合は空のままにします。 |
platform |
このアクションを実行するプラットフォーム。このフィールドが設定されていない場合は、代替として ACTION_PLATFORM_WEB_APPLICATION が使用されます。 |
action_link_type |
事前定義されたアクションのタイプ。 |
order_online_metadata |
注文オンライン リンクのメタデータ。ActionLinkType が ACTION_LINK_TYPE_SHOP_Online のアクションをサポートします。 |
food_ordering_metadata |
料理の注文リンクのメタデータ。サポートされるアクション タイプ: * |
ActionLinkType
アクション リンクに関連付けられている、事前定義されたアクションのタイプ。
列挙型 | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
アクション リンクのタイプが指定されていません。 |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
アクション リンクのタイプは予約です。 |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
アクション リンクのタイプはオンライン予約です。 |
ACTION_LINK_TYPE_ORDER_FOOD |
アクション リンクのタイプは、料理の宅配またはテイクアウトの注文、もしくはその両方の注文です。 |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
アクション リンクのタイプは料理の宅配の注文です。 |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
アクション リンクのタイプは料理のテイクアウトの注文です。 |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
アクション リンクのタイプはレストランの予約です。 |
ACTION_LINK_TYPE_SHOP_ONLINE |
アクション リンクのタイプはショッピングの注文で、配達または受け取り、またはその両方である。 |
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 |
「Google で予約」で予約する際にユーザーに表示されるカスタム メッセージ。 |
対象
販売者のサービスの予約枠(時間とスポット数)。
フィールド | |
---|---|
start_time |
予約スロットの開始時刻。 |
duration |
予約枠の期間 |
spots_total |
この予約枠の合計スポット数と空きスポット数。例:
注: 以下で定義されている空き状況の圧縮形式を使用してリクエストを送信すると、これら 2 つのフィールドが推定されます。
|
spots_open |
空きスポットの数。 |
availability_tag |
この予約枠を識別するための不透明型文字列(省略可)。設定すると、予約の予約、更新、キャンセルのリクエストに含まれます。 |
resources |
異なるスタッフや部屋がサービスに含まれている場合に、個々の予約枠を区別するために使用されるリソース(省略可)。 たとえば、1 つのヨガクラスに 2 人のインストラクターがいる場合:
|
payment_option_id[] |
このスロットの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 このフィールドは、サービス メッセージで指定された payment_option_id をオーバーライドします。同様に、ここで指定された payment_option_id はサービス メッセージに存在する必要はありませんが、Merchant レベルで定義する必要があります。 |
recurrence |
空き状況の繰り返しに関する情報で、複数の開始時刻を表します。繰り返しには、1 営業日の予約を含める必要があります。 |
schedule_exception[] |
このサービスをスケジュールできない時間。schedule_exception メッセージの数を制限するには、隣接する例外を結合することを検討してください。 |
deposit |
この空き情報の保証料(省略可)。サービス デポジットが指定されている場合は、オーバーライドします。 |
no_show_fee |
この空き状況用の無断キャンセル料(省略可)。サービスの無断欠席料金が指定されている場合は、オーバーライドします。 |
require_credit_card |
この予約枠を予約するために、ユーザがクレジット カードを提供する必要があるかどうかを示します。値が設定されていない場合、サービスレベルから値が継承されます(設定されている場合)。(省略可) |
ticket_type_id[] |
この空き状況スロットでサポートされているチケットタイプのリストを示します。設定されていない場合、親サービスのすべてのチケットタイプをこのスロットで使用できます。なお、このフィールドの値は親サービスで定義する必要があります。たとえば、次のように定義します。
平日の空き情報を表す場合:
この時間枠で 3 つのチケットタイプすべてを使用できることを示すには、 (省略可) |
duration_requirement |
スロットの期間や終了時間を表示するための要件。時間枠が利用できない場合、このフィールドは無視されます。おすすめスポットのカテゴリでは使用されません。(省略可) |
scheduling_rule_overrides |
空き状況のスケジュール設定ルール。フィールドに値が入力されている場合は、サービスレベルの SchedulingRules の対応するスケジューリング ルールがすべてオーバーライドされます。 |
confirmation_mode |
この空き状況の予約時に使用される確認モード。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 メッセージを使って、その営業日内で予約済みの時間帯や利用できない時間帯を表します。
要件:
- 予約枠または繰り返しを拡張することで、同一の予約枠を作成することはできません。id、start_time、duration、resources が一致する場合、予約枠は同一と見なされます。
- 単一のサービスの予約枠内で、標準の空き情報形式と繰り返しを混在させないでください。繰り返しは、予約を提供する販売者やサービスに有効で、標準形式は、定期的にクラスをスケジュール設定する販売者やサービスを対象としています。
- 繰り返しは 24 時間を超えることはできません。
フィールド | |
---|---|
repeat_until |
空き状況が繰り返される最終時間として含める UTC タイムスタンプ。 |
repeat_every |
後続の予約枠との間隔を定義します。 例: 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 |
例外の時間帯。繰り返しで記述された予約枠内で、例外の時間帯(左閉右開)が重複する時間帯は、利用不可と見なされます。 例: 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 |
この予約枠を予約できる最終時間(秒)。このタイムスタンプは、遵守されるべき予約枠の start_sec より前にくる必要があります(ユーザーが開始時刻を過ぎてから予約できる場合は、サービスレベルで SchedulingRules.min_booking_before_end_time を使用します)。この要素が存在する場合、対応する Service の SchedulingRules の min_booking_buffer で指定された値をオーバーライドします。 |
first_bookable_sec |
この予約枠を予約できる開始時刻(秒)。このタイムスタンプは、スロットの start_sec より前にする必要があります。指定する場合は last_bookable_sec より前にする必要があります。 |
last_online_cancellable_sec |
設定した場合、この予約枠を Google で予約でキャンセルできる最後の時間(Unix エポックからの経過秒数)。この項目は、サービスレベルのキャンセル ルールよりも優先されます。(省略可) |
BatchDeleteGenericRecordsRequest
指定したフィードタイプのレコードを削除するバッチ リクエスト。
フィールド | |
---|---|
parent |
リソース名( |
records[] |
削除するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。 |
BatchPushGenericRecordRequest
リクエスト URL で指定されたフィードタイプのレコードを挿入または更新するバッチ リクエスト。
フィールド | |
---|---|
parent |
リソース名( |
records[] |
挿入または更新するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。 |
BatchReplaceServiceAvailabilityRequest
複数の Service
の予約枠を置き換えるバッチ リクエスト。
フィールド | |
---|---|
parent |
|
extended_service_availability[] |
既存の予約枠を置き換えるために使用される、サービスの延長された可用性。 |
BatchReplaceServiceAvailabilityResponse
複数の Service
の予約枠を置き換えるバッチ レスポンス。正常に更新された予約枠のみこのメッセージに含まれます。
フィールド | |
---|---|
extended_service_availability[] |
既存の予約枠を置き換えるために使用された拡張サービスの空き時間メッセージが正常に更新されました。 |
Booking
予約枠の予約
フィールド | |
---|---|
name |
予約のリソース名: |
merchant_id |
スロットの販売者の ID |
service_id |
販売者サービスの ID |
start_time |
予約枠の開始時刻 |
duration |
予約枠の期間 |
client_information |
予約を取るクライアントの個人情報 |
status |
予約のステータス |
payment_information |
予約に関連する支払い取引に関する情報。 |
party_size |
予約の人数 |
BookingFailure
予約の処理が非同期で失敗した理由を示すステータス データ。BookingFailure は、主にビジネス ロジックのエラーを取得することを目的としています。
フィールド | |
---|---|
cause |
予約が失敗した理由。(必須) |
rejected_card_type |
(原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合のみ必須) |
description |
パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。(省略可) |
payment_failure |
支払いのエラーに関する情報。 |
原因
エラーの原因の列挙。
列挙型 | |
---|---|
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 |
ユーザーとの 3DS1 認証プロトコルを開始するために、RwG アグリゲータによって使用されるパラメータ。BookingFailure.cause が PAYMENT_REQUIRES_3DS1 に設定されていない限り、無視されます。 |
ThreeDS1Parameters
RwG が 3DS1 チャレンジを実行するようリクエストするパラメータ。
パラメータは、3DS1 プロトコルの EMVCo の説明によって設定されます。
フィールド | |
---|---|
acs_url |
認証のためにユーザーに提示するフォームの読み込み元となる URL。 |
pa_req |
PaymentAuthentication リクエスト。ACSUrl フォームに送信されます(指定されている場合)。 |
transaction_id |
ACS プロバイダにより使用される識別子。ACSUrl フォームに送信されます(指定されている場合)。 |
md_merchant_data |
販売者データ。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[] |
ポリシーに適用される 0 個以上の払い戻し条件。 |
RefundCondition
単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。
フィールド | |
---|---|
min_duration_before_start_time |
開始時刻までの期間。顧客は、この時刻まで |
refund_percent |
サービス開始時刻の |
ClientInformation
予約者の個人情報
フィールド | |
---|---|
given_name |
お客様の名 |
family_name |
クライアントの姓 |
address |
クライアントの住所 |
telephone |
クライアントの電話番号 |
email |
クライアントのメールアドレス |
CreateMerchantRequest
Merchant
を作成するためのリクエスト。
フィールド | |
---|---|
parent |
この販売者を所有するパートナーの親リソース名。 |
merchant_id |
この販売者に使用する販売者 ID。 |
merchant |
作成する販売者。 |
CreateServiceRequest
新しい Service
を作成するためのリクエスト。
フィールド | |
---|---|
parent |
このサービスを所有する販売者の親リソース名。 |
service_id |
このサービスに使用するサービス ID。 |
service |
作成するサービス。 |
CreditCardRestrictions
この販売者が受け付けるクレジット カードの種類の制限。
フィールド | |
---|---|
credit_card_type[] |
サポートされているクレジット カードのリスト。空白の場合、クレジット カードはサポートされません。 |
CreditCardType
クレジット カードの種類。
列挙型 | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
未使用。 |
VISA |
Visa クレジット カード。 |
MASTERCARD |
Mastercard クレジット カード。 |
AMERICAN_EXPRESS |
American Express クレジット カード。 |
DISCOVER |
Discover クレジット カード。 |
JCB |
JCB クレジット カード。 |
DeleteMerchantRequest
Merchant
を削除するリクエスト。
フィールド | |
---|---|
name |
削除する販売者のリソース名形式は Partners/{partner_id}/merchants/{merchant_id} です。 |
DeleteServiceRequest
Service
を削除するリクエスト。
フィールド | |
---|---|
name |
削除するサービスのリソース名 |
Deposit
ユーザーに請求される、またはクレジット カードに保留されている保証料。
フィールド | |
---|---|
deposit |
デポジットの金額。 |
min_advance_cancellation_sec |
デポジット事前キャンセルの最低額。 |
deposit_type |
在庫状況から保証料を決定する方法を定義します。 |
DirectMerchantPayment
ユーザーが RwG を介してサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。
フィールド | |
---|---|
payment_methods[] |
お支払いには、下記のお支払い方法のみをおすすめします。 |
DurationRange
制限ありまたは制限なしにできる期間の範囲のラッパー。min_duration と max_duration の期間の少なくとも 1 つを指定する必要があります。
フィールド | |
---|---|
min_duration |
最小期間。 |
max_duration |
最大期間。 |
ExtendedServiceAvailability
空き情報のリストおよび申し込み対象先と申し込み対象時間
フィールド | |
---|---|
merchant_id |
以下の空き情報メッセージが属する販売者を指定するために必要なフィールドです。 |
service_id |
以下の空き情報メッセージが属するサービスを指定するために必要なフィールドです。 |
start_time_restrict |
指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。
duration メッセージが設定されている場合、条件はさらに制限されます。
resource_restrict メッセージが設定されている場合、条件はさらに制限されます。
これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。 start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。 |
end_time_restrict |
start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までの時間と解釈されます。 |
duration_restrict |
duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。 |
resources_restrict |
resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。 |
availability[] |
空き情報の新しいリスト。 |
FeedStatistics
アップロードされたフィードの処理中に取得された統計情報。
フィールド | |
---|---|
new_items |
このフィードにより新しく追加された項目。フィードの種類に応じて、販売者、サービス、予約枠のいずれかがアイテムになります。 |
existing_items |
既存の商品アイテム。必要に応じてフィードの新しい情報から更新されます。 |
deleted_items |
このフィードに存在しなくなったため、結果として削除された商品アイテム。 |
FeedStatus
アグリゲータのプラットフォームからアップロードされたフィードのステータス。
フィールド | |
---|---|
name |
以下の形式を持つフィード リソース名:
|
state |
このフィードの処理ステータス。 |
error_details |
このフィードを処理できなかった場合に詳細情報を提供する、人が読める形式の文字列。 |
statistics |
このフィードに固有の統計情報。 |
州
フィードの処理状態を示す列挙型。
列挙型 | |
---|---|
STATE_UNSPECIFIED |
デフォルト値。未使用。 |
IN_PROGRESS |
フィードが処理中です。 |
SUCCESS |
フィードが正常に処理されました。 |
FAILURE |
フィードの処理中にエラーが発生しました。 |
FoodOrderingMetadata
料理の注文アクション リンクのメタデータ。
フィールド | |
---|---|
fee_details[] |
アイテムの合計額に加えて、ユーザーに請求された手数料の詳細。サービス手数料や配送料など、さまざまな料金について繰り返します。 |
advance_order_details |
事前注文とも呼ばれ、ユーザーが今よりも後でフルフィルメントを注文できる、事前注文サポートの詳細。 |
共用体フィールド fulfillment_duration_options 。注文確認から注文フルフィルメントの所要時間。デリバリーの注文の場合、料理が配達されるまでの時間。テイクアウトの注文の場合は、料理の準備ができるまでの時間。fulfillment_duration_options は次のいずれかになります。 |
|
fulfillment_lead_time_duration |
固定期間。例: 30 分。 |
fulfillment_lead_time_duration_range |
期間の範囲。例: × 30 分~ 45 分 * 30 分超 * 50 分未満 |
AdvanceOrderDetails
事前注文サポート。
フィールド | |
---|---|
is_supported |
事前注文(事前注文とも呼ばれます)がサポートされている場合は true。(必須) |
FeeDetails
料金の詳細。
フィールド | |
---|---|
type |
料金タイプ。(必須) |
fee_amount |
単位通貨、カートの金額に対する割合、または両方の組み合わせで表現した料金。(必須) |
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 |
カートの金額の割合で表した料金。範囲(制限ありおよび制限なし)または固定の割合を指定できます。値は 0 ~ 100 の範囲で指定してください。例: * 固定 5.5% * 少なくとも 5.5% * 最大 5.5% * 4.5% ~ 5.5% |
共用体フィールド amount_options 。金額を指定するオプション。amount_options は次のいずれかになります。 |
|
amount |
固定額。例: USD 3.5 |
amount_range |
金額の範囲。例: * 3.5 米ドル~ 5.5 米ドル * 3.5 米ドル以上 * 5.5 米ドル以下 |
amount_unknown |
金額は不明です。 |
FeeType
料金タイプ。
列挙型 | |
---|---|
FEE_TYPE_UNSPECIFIED |
料金タイプが指定されていません。 |
DELIVERY |
配送料。 |
SERVICE |
サービス手数料。 |
FulfillmentOption
オンライン注文アクション リンクのフルフィルメント オプション。
フィールド | |
---|---|
fulfillment_type |
必須。フルフィルメント タイプ。 |
available_day[] |
必須。この納品方法を利用できる日数のリスト(できれば 2 日以上)。 |
fee_details |
必須。フルフィルメント方法の手数料の詳細。 |
minimum_order |
必須。アクション リンクに関連付けられたフルフィルメント メソッドの最低注文額。 |
AvailableDay
曜日ごとの空き時間。
フィールド | |
---|---|
fulfillment_date |
必須。納品方法を利用できる日付。販売者のタイムゾーンに基づきます。 |
last_ordering_time |
必須。Unix タイムスタンプ。ユーザーが最後に注文し、商品を受け取れた日時( たとえば、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 |
フルフィルメントの方法に手数料はかかりません。 |
base_fee |
フルフィルメント方法に関連付けられた基本料金。 |
fixed_fee |
フルフィルメント方法に関連付けられた固定料金。 |
FixedFee
アクション リンクに関連付けられたフルフィルメント メソッドに必要な固定料金。
フィールド | |
---|---|
amount |
必須。フルフィルメント方法の固定料金の金額。 |
FulfillmentType
アクション リンクに関連付けられたフルフィルメント タイプ。
列挙型 | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
フルフィルメント タイプが指定されていません。 |
FULFILLMENT_TYPE_DELIVERY |
フルフィルメント タイプは配送です。 |
FULFILLMENT_TYPE_PICKUP |
フルフィルメントの種類は受け取りです。 |
MinimumFee
アクション リンクに関連付けられたフルフィルメント方法に必要な最低料金。
フィールド | |
---|---|
base_fee_amount |
必須。フルフィルメントの方法の基本料金。 |
NoFee
アクション リンクに関連付けられたフルフィルメントの方法に手数料は必要ありません。
GenericDeleteRecord
URL リクエストで指定されたフィードタイプを削除するレコード。
フィールド | |
---|---|
delete_time |
必須。このタイムスタンプは、在庫に削除が適用される順序を決定するために使用されます。 |
共用体フィールド record_type 。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化するパートナーは、フィードまたは BatchPush API でレコードを指定する方法と同様に、完全なレコードを提供できます。パートナー様は、レコードを一意に識別するために不可欠なフィールドのみを含めることもできます。record_type は次のいずれかになります。 |
|
data_record |
proto 以外のフィードの場合。 |
proto_record |
proto ベースのフィード用。 |
GenericRecord
URL リクエストで言及されたフィードタイプのレコード。
フィールド | |
---|---|
generation_timestamp |
必須。このタイムスタンプは、在庫更新の正しい順序を保証するために使用されます。 |
共用体フィールド record_type 。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化するrecord_type は次のいずれかになります。 |
|
data_record |
proto 以外のフィードの場合。 |
proto_record |
proto ベースのフィード用。 |
GeoCoordinates
ビジネス拠点の地理データ(緯度、経度、住所など)。
フィールド | |
---|---|
latitude |
緯度。(省略可) |
longitude |
経度。(省略可) |
共用体フィールド addresses 。ビジネス拠点の住所。構造化されている住所とされていない住所が可能で、addresses は次のいずれかになります。 |
|
address |
場所の住所(推奨)。 |
unstructured_address |
非構造化住所例:「東京都千代田区神田錦町 3-22 テラススクエア 8 階 | 03-4577-4401」 |
GetMerchantStatusRequest
MerchantStatus
を取得するリクエスト
フィールド | |
---|---|
name |
必須。リソース名。Partners/{partner_id}/merchants/{merchant_id}/status の形式で指定します。 |
GetStatusRequest
アグリゲータのプラットフォームからアップロードされた特定のフィードの Status
を取得するためのリクエスト。
フィールド | |
---|---|
name |
以下の形式を持つフィード リソース名:
|
HomeServiceData
ホームサービス カテゴリの場合、追加の情報を提供する必要があります。
フィールド | |
---|---|
category_type |
このホームサービスが属する上位カテゴリ。例:配管工、電気工など |
job_type |
特定のホームサービスが属するカテゴリの職種。例:unclog_drain、install_faucet は、配管工カテゴリの職種です。 |
IntegrationType
サポートされている統合の程度。
列挙型 | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
デフォルトは END_TO_END です。 |
INTEGRATION_TYPE_END_TO_END |
Google を通じてエンドツーエンドの予約を可能にする完全な統合。 |
INTEGRATION_TYPE_INVENTORY_ONLY |
予約サーバーはこのサービスをサポートする必要はありません。販売者、サービス、(省略可)空き情報データのみを送信する必要があります。 |
InvalidateResourceRequest
リソースを無効にするリクエスト。
フィールド | |
---|---|
resource_id |
無効化するリソースの名前。 たとえば、Pickup リソースの場合、名前は |
LineItem
1 件の注文内の 1 つの項目。1 つの時間枠での 1 つのサービスの予約。
フィールド | |
---|---|
service_id |
販売者の Service の ID。 |
start_sec |
予約枠の開始時間(Unix エポックからの UTC 時間)。 |
duration_sec |
予約枠の長さ(秒)。 |
tickets[] |
チケットタイプ別に注文されたチケットの数。 |
price |
この広告申込情報の合計金額(税抜き)。 |
status |
広告申込情報のステータス。 |
OrderedTickets
チケットタイプ別の注文済みチケット数。
フィールド | |
---|---|
ticket_id |
チケットタイプの ID。 |
count |
このタイプで注文されたチケットの数。 |
ListMerchantStatusesRequest
MerchantStatus
のリストを取得するリクエスト
フィールド | |
---|---|
parent |
必須。この販売者ステータスのコレクションを所有する親。形式: |
page_size |
必須。返される最大アイテム数。サーバーがページサイズを小さくする可能性があるので注意してください。 |
page_token |
省略可。前の ListMerchantStatusResponse から返された nextPageToken 値(存在する場合)。 |
booking_inventory_status_restrict |
省略可。予約広告枠のステータスで結果をフィルタするオプションの制限。 |
waitlist_inventory_status_restrict |
省略可。順番待ちリストの在庫ステータスで結果をフィルタするオプションの制限。 |
geo_match_restrict |
省略可。地域の一致ステータスで結果をフィルタするオプションの制限。 |
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[] |
フィルタ条件を満たす販売者のステータスのリスト。 |
next_page_token |
次の結果ページを取得するためのトークン。空の場合、リストにそれ以上の結果はありません。 |
ListStatusRequest
アグリゲータのプラットフォームからアップロードされた複数のフィードの Status
を取得するためのリクエスト。
フィールド | |
---|---|
name |
以下の形式を持つフィード リソース名:
|
page_size |
返す最大アイテム数。 |
page_token |
前の List リクエストから返された next_page_token 値(存在する場合)。 |
state_restrict |
フィードの状態によって結果をフィルタするオプションの制限。 |
time_range_restrict |
(省略可)結果を上限と下限でフィルタするための制限。start_time が設定されていない場合は、デフォルトで Unix 時間の起点に設定されます。end_time が設定されていない場合は、デフォルトで現在に設定されます。 |
ListStatusResponse
アグリゲータのプラットフォームからアップロードされた複数のフィードの Status
を取得するためのリクエスト。
フィールド | |
---|---|
status[] |
アップロードしたフィードのステータスを日付の新しい順に並べ替えます。返されるアイテムの最大数はリクエストの page_size フィールドに基づきます。 |
next_page_token |
次の結果ページを取得するためのトークン。空の場合、リストにそれ以上の結果はありません。 |
LocalizedString
1 つの言語 / 地域の文字列のインスタンス。
フィールド | |
---|---|
locale |
IETF BCP 47 言語コード(「en」、「mas」、「zh-Hant」、「de-CH-1901」など)。詳しくは http://www.w3.org/International/articles/language-tags/ をご覧ください。 |
value |
上記のロケール(UTF-8)のメッセージ。 |
場所
ビジネス拠点に関する地理情報。
フィールド | |
---|---|
place_id |
Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定されている場合、Google は場所とこの場所を照合します。 |
name |
場所の名前、電話番号、URL、地域は、その場所を Google マップにすでに表示されている場所とマッチングするために使用されます。 このフィールドは省略可能ですが、状況によっては必須の場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、事業体には一致しません。(省略可) |
telephone |
国番号と市外局番を含む、ビジネス拠点の電話番号(例: +14567891234)。(省略可) |
url |
ビジネス拠点の公開ウェブサイトの URL。(省略可) |
geo |
ビジネス拠点の地理情報(緯度、経度、住所など)。(省略可) |
location_type |
ロケーションのタイプ。このロケーションが Service に対して指定されている場合は指定する必要があります。 |
location_id |
サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービス フィールドでこのビジネス拠点を参照できます。例:カスタム登録フォームでは、地域 ID のセットを使用して乗車場所のオプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。(省略可) |
LocationType
このビジネス拠点のタイプ。
列挙型 | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
ビジネス拠点タイプが指定されていません。 |
VISITED_LOCATION |
このサービスで訪れる場所。 |
START_LOCATION |
このサービスが開始する場所。MEETING_LOCATION としても機能します。 |
END_LOCATION |
このサービスが終了する場所。 |
Merchant
アグリゲータのプラットフォーム上の販売者に関する情報。
フィールド | |
---|---|
name |
販売者のリソース名。 |
merchant_name |
merchant_name、電話番号、URL、地域は、パートナーの空き情報を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。 販売者の名前。 |
telephone |
国コードと市外局番を含む販売者の公開電話番号。例:+14567891234。 |
url |
販売者の公開ウェブサイトの URL。 |
geo |
販売者の地理情報(緯度、経度、住所など)。 |
category |
アグリゲータのプラットフォームにおけるビジネスのカテゴリ。 |
num_bookings_30d |
このフィールドのサポートは終了しました。 |
tax_rate_basis_points |
販売者の税率(ベーシス ポイント: 1% の 100 分の 1)。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。 このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。 このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金(ここで指定された税率を基に算出)が含まれます。最小通貨単位の端数(1 セントの端数など)は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。 このフィールドは非推奨です。代わりに、tax_rate を使用してください。 |
tax_rate |
販売者の税率。指定されている場合、このフィールドは非推奨の tax_rate_basis_points フィールドをオーバーライドします。空のメッセージ(例: tax_rate { })は、適用される税率を 0 にリセットします。 |
payment_restrictions |
この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合は、制限はないものとみなされます。 |
payment_option[] |
この販売者で利用可能な支払いオプション。この販売者のサービスは、許可する支払い方法を個別に制限できます。 |
payment_processor_config |
トークン化された決済代行業者の設定(販売者がサポートしている場合)。 |
tokenization_config |
トークン化された決済代行業者の設定(販売者がサポートしている場合)。 |
terms |
「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。これらに加えて、アグリゲータ パートナーの利用規約は常にユーザーに表示されるものであり、ここでは提供しないでください。 |
brand_id |
パートナーの帰属を表示する際に使用する、消費者向けのブランドを識別する不透明型の文字列。このフィールドを使用すると、複数の消費者向けブランドを所有するパートナーが、同じフィード内のすべてのブランドの販売者を指定できます。 ブランドは、名前、ロゴ、利用規約、プライバシー ポリシーなど、消費者向けのプロパティで構成されます。 消費者向けのパートナー ブランドが 1 つしかない場合は、このフィールドを設定する必要はなく、無視してかまいません。 パートナーの種類別の処理方法: 消費者向けのブランドが 1 つしかない場合は、このフィールドは無視します。 複数のブランドが設定されている場合は、次のように処理されます。
注意: ほとんどのパートナーは、このフィールドを設定する必要はありません。パートナーがこのフィールドを使用する場合は、各ブランド(デフォルトのブランドを含む)を個別に設定する必要がありますので、Google までご連絡ください。 |
matching_hints |
販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。(省略可) |
service_attribute[] |
この販売者のサービスを説明するために使用されるサービス属性の定義。(省略可) |
action_link[] |
省略可。アクションの URL(関連する言語、制限されている国のリスト、タイプ、このアクションを実行するプラットフォームを示すオプションのプラットフォームを含む)。 |
waitlist_advisement |
省略可。「Google で予約」を通して順番待ちリストに登録するユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイス内の個々のテキスト フィールドの長さは 100 バイト以下にしてください。 |
MerchantMatchingHints
販売者が Google マップの場所とマッチングされる際に使用されるヒント。
フィールド | |
---|---|
place_id |
Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。 |
MerchantStatus
「Google で予約」プラットフォームの販売者のステータス。
フィールド | |
---|---|
name |
販売者ステータスのリソース名。形式は |
merchant_name |
パートナーから提供された販売者の名前。 |
input_geo_info |
パートナーが提供した販売者の地域情報。 |
processing_status |
販売者の処理ステータス。 |
booking_status |
エンドツーエンドの予約統合に関連するステータス。 |
waitlist_status |
順番待ちリストの統合に関連するステータス。 |
geo_match |
この販売者の一致する地域。販売者が地域と一致していない場合は空になります。 |
local_services_match |
この販売者のローカル サービス広告が一致しました。ローカル サービスの販売者でない場合、またはどのプロバイダとも一致しない場合は空になります。 |
direct_urls[] |
現在の販売者の在庫の内容を示す URL のリスト。ただし、広告枠が実際に配信されているという意味ではなく、URL が一般公開 URL と異なる場合があります。 |
BookingStatus
エンドツーエンドの予約統合に関連するステータス。
フィールド | |
---|---|
has_valid_future_inventory |
販売者に今後 30 日以内に在庫がある場合は true。販売者が実際にサービスを提供していることを保証するものではありません。 |
DirectUrl
販売者を表示する URL。
フィールド | |
---|---|
type |
この URL のタイプ。 |
url |
この販売者を表示する URL。 |
UrlType
表示 URL のタイプ。
列挙型 | |
---|---|
URL_TYPE_UNSPECIFIED |
指定されていません。 |
BOOKING |
エンドツーエンドの予約 URL。 |
WAITLIST |
順番待ちリストのエンドツーエンド URL。 |
LOCAL_SERVICES |
Google ローカル サービスの URL。 |
LocalServicesMatchInfo
Google ローカル サービスの情報が一致します(ローカル サービスの販売者に対してのみ設定されます)。
フィールド | |
---|---|
matched_providers[] |
一致したサービス プロバイダ。販売者は、複数のサービス プロバイダとマッチングされる場合があります。 |
MatchedProvider
ローカル サービス プロバイダ。
フィールド | |
---|---|
customer_id |
Google ローカル サービスの外部お客様 ID。 |
categories[] |
ローカル サービスのカテゴリ(カテゴリ)。例:「配管工」「carpet_cleaning」と入力します |
PlaceInfo
一致した場所の情報。
フィールド | |
---|---|
name |
場所の名前です。 |
formatted_address |
現地の言語でフォーマットされた住所。 |
place_id |
この場所の 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 |
販売者が順番待ちリストサービスを利用している場合は true。販売者が実際にサービスを提供していることを保証するものではありません。 |
MoneyRange
制限ありまたは制限なしのある範囲の金額のラッパー。min_amount と max_amount の少なくとも 1 つを指定する必要があります。
フィールド | |
---|---|
min_amount |
最低額。 |
max_amount |
限度額です。 |
NoShowFee
ユーザーが予約したにもかかわらず無断キャンセルした場合に請求される可能性のある料金。
フィールド | |
---|---|
fee |
予約時にユーザーが予約しなかった場合に請求される可能性のある金額。 |
fee_type |
空室状況から料金をどのように決定するかを定義します。 |
注文
販売者にサービスを予約する際の注文。
フィールド | |
---|---|
name |
注文のリソース名: |
client_information |
注文を行うクライアントの個人情報。 |
payment_information |
注文に関連する支払い取引に関する情報。 |
merchant_id |
この注文に含まれるすべてのサービスが属する販売者の ID。 |
item[] |
この注文の広告申込情報。 |
OrderOnlineMetadata
オンライン注文アクション リンクのメタデータ。
フィールド | |
---|---|
fulfillment_option[] |
オンライン注文アクション リンクで使用可能なフルフィルメント オプション。 |
PaymentInformation
予約に関する支払いの詳細
フィールド | |
---|---|
prepayment_status |
予約の前払いステータス。prepayment_status が PREPAYMENT_PROVIDED または PREPAYMENT_REFUNDED の場合、payment_transaction_id には関連する一意の取引 ID が含まれます。 |
payment_transaction_id |
予約に関連付けられた支払い処理の一意の識別子。該当しない場合は空になります。 |
PaymentOption
販売者が提供するサービスの支払いに使用できる支払いオプション。支払いオプションは、複数の販売者(同じチェーンに属する販売者など)で共有できます。
フィールド | |
---|---|
payment_option_id |
この ID は、この支払いオプションを識別するために使用されます。 この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。 ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。 |
name |
支払いオプションの名前。ユーザーに表示される可能性があります。 |
description |
支払いオプションについての説明。ユーザーに表示される可能性があります。 |
price |
支払いオプションの価格。 |
tax_rate |
この支払いオプションの税率。指定されている場合、このフィールドは Merchant または Service にある tax_rate フィールドをオーバーライドします。空のメッセージ(例: tax_rate { })は、適用される税率を 0 にリセットします。 |
payment_option_type |
この支払いオプションの種類。ドロップインの場合は 1 回限り、パックの場合は複数回、メンバーシップの場合は無制限。 |
session_count |
この支払いオプションを利用できるセッション数。マルチセッションまたはパックでのみ有効。値には「>」を指定する必要があります。1. |
purchase_interval |
この期間内に支払いオプションを購入できます。 |
valid_interval |
支払いオプションはこの期間内に利用できます(例: 2017 年 1 月の特別価格)。存在する場合は、valid_duration と activation_type をオーバーライドします。 |
valid_duration |
支払いオプションの有効期間(例: 30 日間のメンバーシップ)。 |
activation_type |
この支払いオプションの有効期限の開始日を決定する方法を定義します。 |
user_restriction |
この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定しない場合、すべてのユーザーが対象となります。 |
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 |
この構成が適用される決済代行業者パートナーを定義します。 |
public_key |
この販売者を決済代行業者に応じて識別するために使用するキー。 Stripe については、https://stripe.com/docs/dashboard#api-keys をご覧ください。Braintree については、https://articles.braintreepayments.com/control-panel/important-gateway-credentials をご覧ください。 |
version |
支払いリクエストとともに決済代行業者に送信される API バージョン番号。 |
プロセッサ
特定の決済代行業者パートナーを定義します。
列挙型 | |
---|---|
PROCESSOR_UNSPECIFIED |
未使用 |
PROCESSOR_STRIPE |
Stripe を利用する支払いの設定。 |
PROCESSOR_BRAINTREE |
Braintree を利用する支払いの設定。 |
PaymentRestrictions
この販売者が受け付ける支払い方法に関する制限。
フィールド | |
---|---|
credit_card_restrictions |
この販売者が受け付けるクレジット カードに関する制限。このフィールドが設定されていない場合は、すべてのクレジット カードが受け付けられるとみなされます。なお、CreditCardType でサポートされるカードのリストは今後増えていくことにご留意ください。つまり、このフィールドを空のままにすると、将来的な変更の対象となる可能性があります。 |
PerOrderFee
チケットの数に関係なく、注文ごとに 1 回支払う必要がある料金。
フィールド | |
---|---|
delivery_fee |
送料は配送方法によって異なる場合があります。 |
processing_fee |
ユーザーのお支払い方法を処理するための料金。 |
PerTicketFee
ユーザーが購入するチケットごとに支払う必要がある料金。
フィールド | |
---|---|
service_charge |
サービスに対して請求される追加料金。 |
facility_fee |
会場や施設に行く料金。 |
taxes |
チケット 1 枚あたりの税金。 |
PostalAddress
顧客またはビジネス拠点の住所。
フィールド | |
---|---|
address_country |
ISO 3166-1 alpha-2 国コードを使用して指定された国。例:「US」(必須) |
address_locality |
地域区分(例: 横須賀市)(必須) |
address_region |
県(例: 神奈川県)。このフィールドは、県が住所の一部である国でのみ必須です。(省略可) |
postal_code |
郵便番号(例: 94043)。(必須) |
street_address |
番地(例: 大町 3-5)。(必須) |
PrepaymentStatus
予約の前払いステータス。
列挙型 | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
指定されていない場合、デフォルトは PREPAYMENT_NOT_PROVIDED です。 |
PREPAYMENT_PROVIDED |
予約料金は前払いされています。 |
PREPAYMENT_NOT_PROVIDED |
予約料金は前払いされていません。 |
PREPAYMENT_REFUNDED |
料金は以前に PREPAYMENT_PROVIDED でしたが、現在は払い戻されています。 |
Price
サービスの価格または料金。
フィールド | |
---|---|
price_micros |
価格(最小通貨単位)。最小通貨単位の端数は、最近接偶数に丸められます(例: 2.5 セントは 2 セントに、3.5 セントは 4 セントに、0.5 セントは 0 セントに、2.51 セントは 3 セントに四捨五入されます)。 |
currency_code |
ISO 4217 で定義された価格の通貨。 |
pricing_option_tag |
拡張価格に関連付けられている価格設定オプションを識別する、省略可能な不透明な文字列。 |
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 |
単一値。例: 5.6 |
value_range |
自由回答形式または制限ありの値の範囲です。例: * 5.5 以上 * 5.5 以下 * 5.5 ~ 6.5 |
RangeValue
min_value
< となる値の範囲max_value
。min_value
と max_value
の少なくとも 1 つが必要です。
フィールド | |
---|---|
min_value |
最小値。 |
max_value |
最大値 |
評価
エンティティの評価を定義します。
フィールド | |
---|---|
value |
平均評価値(number_of_ratings > 0 の場合は必須)。値は [1, 5] の範囲内である必要があり、number_of_ratings がゼロの場合にのみ省略できます。 |
number_of_ratings |
価値の計算に使用された評価の数(必須)。 |
RelatedMedia
このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。(省略可)
フィールド | |
---|---|
url |
このメディアソースの URL。Google はこの URL でホストされているメディアをクロールします。 |
type |
このメディアソースのタイプ。 |
localized_caption |
i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。(省略可) |
attribution |
メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。(省略可) |
caption |
非推奨。localized_caption を使用することをおすすめします。 |
Attribution
このメディアの権利帰属情報。
フィールド | |
---|---|
localized_text |
i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドでは書式なしテキストのみがサポートされ、HTML コンポーネントはすべて削除されます(ハイパーリンク ベースのアトリビューションはサポートされません)。 |
text |
非推奨。localized_text を使用することをおすすめします。 |
MediaType
このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。
列挙型 | |
---|---|
TYPE_UNSPECIFIED |
未使用。 |
PHOTO |
URL で提供されるメディアが写真であることを示します。 |
ReplaceServiceAvailabilityRequest
Service
の空き情報を置き換えるリクエスト。
フィールド | |
---|---|
service_availability |
既存のサービスの可用性を置き換えるために使用されるサービスの可用性。 |
RequireCreditCard
予約にクレジット カードが必要かどうかを定義します。
列挙型 | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
クレジット カードの要件は明示的に指定されておらず、動作は CONDITIONAL で指定されたものと同じになります。 |
REQUIRE_CREDIT_CARD_CONDITIONAL |
空き情報に価格が設定されており、prepayment_type が REQUIRED の場合、no_show_fee が設定されている場合、保証料フィールドが設定されている場合のうちいずれかの条件に該当する場合は、クレジット カード情報が必要です。 |
REQUIRE_CREDIT_CARD_ALWAYS |
他のフィールドの値に関係なく、この空き情報を予約するにはクレジット カードが常に必要です。 |
Resources
リソースは、異なるスタッフ メンバーや部屋がサービスに含まれている場合に、個々の空き状況スロットを区別するために使用されます。予約枠のサービスと時間間隔が同じでも、リソースが異なるなら、予約枠は複数存在できます。
フィールド | |
---|---|
staff_id |
サービスを提供するスタッフの ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。Staff_name が存在する場合、このフィールドは必須です。 |
staff_name |
サービスを提供するスタッフ メンバーの名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。employee_id が存在する場合、このフィールドは必須です。 |
room_id |
サービスが提供される部屋の ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。Room_name が指定されている場合は、このフィールドを指定する必要があります。 |
room_name |
サービスが提供される部屋の名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。(省略可。ただし、room_id が存在する場合は必須)食事では、部屋名はバーやパティオなどの座席エリアにのみ使用し、定額メニュー、スペシャル アクティビティ、その他の客室以外の値(予約やディナーなど)には使用しないでください。デフォルトの座席エリアには部屋を関連付けないことを強くおすすめします。 |
party_size |
Dining のみ: この時間枠に対応できる人数。レストランは複数の Slot に同時に関連付けることができます。たとえば、予約で 2 人、3 人、4 人が座れる場合、それぞれが異なる party_size を指定できます。 |
SchedulingRules
サービスのスケジュール設定ルール。
フィールド | |
---|---|
min_advance_online_canceling |
予約をオンラインでキャンセルするために必要な最小事前通知期間(秒単位)。(省略可) |
late_cancellation_fee |
最小事前通知期間内のキャンセル料。 |
noshow_fee |
無断キャンセル料。 |
admission_policy |
このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。(省略可) |
cancellation_policy |
キャンセル ポリシーのスケジュール設定ルール。(おすすめスポットに必須) |
共用体フィールド 「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 つの値は無視されるため、どちらの値が選択されるかを正確に予測することはできません。 例:
|
|
min_advance_booking |
最後の予約が可能になってから予約枠が開始するまでの時間(秒単位)。 |
min_booking_buffer_before_end_time |
最終予約可能時間から予約枠の終了時刻までの期間(秒単位)。 このフィールドが設定されている場合、「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 |
サービス リソース名。形式は |
service_name |
サービスの名前(例: 「メンズ ヘアカット」)。非推奨。代わりに localized_service_name を使用してください。 |
localized_service_name |
サービスの名前(例: 「メンズ ヘアカット」)。複数の言語 / 地域で使用される可能性があります。 |
description |
ユーザーに表示される、サービスの説明。非推奨。代わりに localized_description を使用してください。 |
localized_description |
ユーザーに表示される、サービスの説明。 このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。 サポートされている HTML に類似する形式の書式設定タグ: 見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落タグ: <p> リストタグ: <ul>、<ol>、<li> 分割タグ: <div> フレーズタグ: <br>、<strong>、<em>: サポートされていないタグ:
注意事項:
|
price |
サービスの料金。 |
price_interpretation |
価格を解釈してユーザーに表示する方法について説明します。「食事」と「おすすめスポット」を除くあらゆる業種で、サービス価格の表示の設定に使用できます。 |
rules |
予約やキャンセルのルール。 |
prepayment_type |
前払いが必須か、任意か、サポートされていないか。 |
prepayment_terms |
前払いの完了時期に関する条件。 |
form[] |
非推奨です。intake_form と per_ticket_intake_form を使用してください。 |
intake_form |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。(省略可) |
per_ticket_intake_form |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。(省略可) |
tax_rate |
サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された tax_rate をオーバーライドします。空のメッセージ(例: tax_rate { })は、適用される税率を 0 にリセットします。 |
payment_option_id[] |
このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 |
deposit |
ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。(省略可) |
no_show_fee |
ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。(省略可) |
require_credit_card |
このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。(省略可) |
action_link[] |
このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service にタイプ(下記参照)を設定する必要があります。 |
type |
このサービスの事前定義されたタイプ。(省略可) |
ticket_type[] |
チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。(省略可) |
related_media[] |
このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。(省略可) |
service_attribute_value_id[] |
このサービスに適用される Service 属性値(省略可)。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。(省略可) |
waitlist_rules |
順番待ちリストに登録するためのルール。 |
ticketing_vertical_specific_data |
イベント チケット販売業種に固有の追加情報。(省略可) |
integration_type |
このサービスでサポートされる統合の程度。(省略可)試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンドは常に無効になります。 |
per_order_fee |
このサービスを購入するための注文レベルの料金。(省略可) |
tours_and_activities_content |
ツアーとアクティビティに固有のコンテンツ フィールド。 |
location[] |
このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。 |
rating |
このサービスに対するユーザーの評価を、すべてのレビューの集計指標として示します。 |
home_service_data |
ホームサービス カテゴリに固有の追加情報。(省略可) |
virtual_session |
省略可。仮想セッションに関する情報。仮想サービスを有効にするために必要です。 |
direct_merchant_payment |
省略可。サービスでユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: この取引には RwG は関与しません。virtual_session が定義されていて、Service が Free でない場合、または prepayment_type が REQUIRED に設定されていない場合は指定する必要があります。 |
PrepaymentTerms
前払いの完了時期に関する具体的な情報
フィールド | |
---|---|
charge_timing |
購入日時を基準に請求が行われるタイミング。 |
charge_time_before_start_time_sec |
サービス開始時刻までの経過時間(秒)。この時刻までにユーザーに支払いが行われます。このフィールドは、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 |
同じ販売者のサービス属性を一意に識別する ID(例:「account-type」を選択します。 |
attribute_name |
ユーザーに表示される属性の名前。例:[アカウントの種類] を選択します。 |
value[] |
このサービス属性に使用可能なすべての値。 |
値
特定のサービス属性で可能な値を表します。
フィールド | |
---|---|
value_id |
このサービス属性のこの値を他の値と一意に識別する識別子。例:「個人用」です。 |
value_name |
ユーザーに表示される値の名前。例:「個人」。 |
ServiceAttributeValueId
Service に適用されるサービス属性の特定の値を識別します。
フィールド | |
---|---|
attribute_id |
Merchant.service_attribute で定義された属性の ID。例:「service-type」を指定します。 |
value_id |
この属性の値の ID(「haircut」など)。サービス属性定義の value_id と一致する必要があります。 |
ServiceAvailability
空き情報のリストおよび申し込み対象先と申し込み対象時間
フィールド | |
---|---|
name |
このパラメータの申し込み先のサービスのリソース名 |
start_time_restrict |
指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。
duration メッセージが設定されている場合、条件はさらに制限されます。
resource_restrict メッセージが設定されている場合、条件はさらに制限されます。
これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。 start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。 |
end_time_restrict |
start_time_restrict を未設定のままにして end_time_restrict を設定すると、end_time_restrict までの時間と解釈されます。 |
duration_restrict |
duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。 |
resources_restrict |
resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。 |
availability[] |
空き情報の新しいリスト。 |
ServiceIntakeForm
販売者が提供するサービスをカスタマイズするインテイク フォームを定義します。
フィールド | |
---|---|
field[] |
ユーザーに表示されるフィールド。 |
first_time_customers |
true の場合、このフォームは初めての顧客に表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
returning_customers |
true の場合、このフォームはリピーターに表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
ServiceIntakeFormField
ServiceIntainForm に含まれるフィールドを定義します。
フィールド | |
---|---|
id |
フォーム フィールドを一意に識別するアグリゲータ パートナーからの文字列。この ID は、対応するフォーム フィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイク フォームの両方で一意である必要があります。(必須) |
type |
このフィールドの型。 |
label |
ユーザーに表示される、このフィールドのテキスト。非推奨。代わりに |
localized_label |
ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。(必須) |
value[] |
フィールドの型が LOCATION_SEARCH の場合にのみ設定します。「location_id」を使用してください対象の「location」ロケーションの値を指定します。 |
choice_text[] |
フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定されます。可能な選択肢を列挙するために使用します。 |
is_required |
このフィールドへの回答がユーザーに要求されるかどうかを示します。 |
allow_custom_answer |
事前定義された回答以外の回答でカスタム値を許可するかどうかを指定します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additional_option[] |
指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。例:提供された場所リストに加えて、[後でサプライヤーに連絡します] というオプションも利用できます。(省略可) |
ticket_type_restrict[] |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。常に該当する質問がある場合は、フィールドを空のままにします。 |
hint |
テキスト プレースホルダとして表示される入力のヒントテキスト。このフィールドが該当するのは、フィールド タイプが SHORT_ANSWER または Colab の場合に限られます。(省略可) |
FieldType
フィールドのタイプを示す列挙型。
列挙型 | |
---|---|
FIELD_TYPE_UNSPECIFIED |
未指定または不明なタイプのフィールドは無視されます。 |
SHORT_ANSWER |
テキスト用の 1 行の入力フィールド。 |
PARAGRAPH |
テキスト用の複数行の入力フィールド。 |
MULTIPLE_CHOICE |
多数のオプションから 1 つを選択する必要があるラジオボタンのセット。 |
CHECKBOXES |
チェックボックス付きの 1 つ以上の列挙型項目。 |
DROPDOWN |
プルダウンからの選択。 |
BOOLEAN |
はい / いいえボタン。 |
LOCATION_SEARCH |
ユーザーの入力に基づいて、指定されたビジネス拠点のリストから一致するビジネス拠点を検索できる検索ボックス。 |
TaxRate
サービスの料金をユーザーに請求する際に適用される税率。販売者単位またはサービス単位で設定できます。
フィールド | |
---|---|
micro_percent |
税率(1% を 100 万分の 1 とする単位)。実際には小数点以下 6 桁を表すことになります。たとえば、税率が 7.253% の場合は、このフィールドは 7253000 に設定します。 このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。 このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金(ここで指定された税率を基に算出)が含まれます。最小通貨単位の端数(1 セントの端数など)は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。 |
Terms
「Google で予約」を介して予約を行うためにユーザーに表示される一連のルールとガイドライン。
フィールド | |
---|---|
url |
(省略可)利用規約の URL。 |
text |
ユーザーに表示するテキスト。新しい統合には、以下の localized_text を使用します。 |
localized_text |
ユーザーに表示されるローカライズされたテキスト。 |
テキスト
ローカライズされた可能性のあるテキスト ペイロード。一部の Text フィールドには、マークアップされたコンテンツを含めることができます。
フィールド | |
---|---|
value |
不明な言語 / 地域の Text 値。 |
localized_value[] |
言語 / 地域ごとのテキスト値。省略可。 |
TicketType
TicketType は、ユーザータイプ、サービス属性、オプション / アドオンが異なるため、価格や空き情報が異なるチケットを他のチケットとの間で区別するために使用されます。
チケットは、サービスの予約可能な最小単位です(ラフティングのツアースポット、博物館への入場、2 人用カヤックの 1 日レンタルなど)。
フィールド | |
---|---|
ticket_type_id |
チケット ID は、同じサービスの異なるチケットタイプを区別するために使用され、サービス内でのみ一意である必要があります。 |
short_description |
この TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localized_short_description を使用してください。 |
localized_short_description |
i18n をサポートするこの TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。 |
price |
このタイプのチケット 1 枚の価格(税抜き)。Service の税率がチケットに適用されます。 |
per_ticket_fee |
このチケットを購入するための追加料金。(省略可) |
option_description |
このチケットタイプが表す追加オプションの説明(ある場合)。非推奨。代わりに localized_option_description を使用してください。 |
localized_option_description |
このチケットタイプが表す追加オプションの説明(ある場合)。言語 / 地域ごとに別々の値を指定できます。 追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。 例 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 |
イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。(省略可) |
event_url |
パートナーのウェブサイトに掲載されているイベントの URL。(省略可) |
entity[] |
イベントに関連するエンティティのリスト。(省略可) |
event_attendance_mode |
必須。イベントの参加者のタイプ。 |
event_virtual_location_url[] |
省略可。イベントを視聴できる URL。 |
event_organizer |
省略可。イベントをホストする主催者。 |
event_organizer_url |
省略可。予定を主催する主催者の URL。 |
event_organizer_type |
省略可。主催者の種類。 |
event_source_url[] |
必須。イベントの情報や説明を確認できるページの URL。 |
event_state |
省略可。イベントの状態。 |
AttendanceMode
イベントの参加者のタイプ。
列挙型 | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
指定されていません。 |
ONLINE |
バーチャル イベントの場合。 |
PHYSICAL |
物理的なイベント用。 |
PHYSICAL_ONLINE_MIXED |
対面と仮想の両方のイベントが対象です。 |
エンティティ
イベントに関連するエンティティを表します。
フィールド | |
---|---|
id |
パートナーのデータベースにあるエンティティの一意の識別子。(省略可) |
name |
エンティティの名前。(必須) |
url |
エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページ(存在する場合)です。エンティティのその他の公開 URL の場合は、public_identification_data で relevant_url を使用します。(省略可) |
entity_type |
エンティティのタイプ。(省略可) |
entity_role |
イベントでのエンティティの役割。(省略可) |
public_identification_data |
エンティティの公開参照。(省略可) |
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[] |
トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります(例: https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan)。(省略可) |
musicbrainz_id |
アーティストなどの音楽エンティティの 36 文字の MusicBrainz 識別子(該当する場合)。https://musicbrainz.org/doc/MusicBrainz_Identifier をご覧ください。(省略可) |
TimeRange
左閉右開の時間帯(例: [start_time, end_time))。
フィールド | |
---|---|
start_time |
時間帯の下限。 |
end_time |
時間帯の上限。 |
TokenizationConfig
決済代行業者のトークン化の設定。Merchant ごとに設定します。
フィールド | |
---|---|
tokenization_parameter |
トークン化設定には通常、キーが「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 |
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、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。
重要な注意事項: * highlights
、exclusion
など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。
フィールド | |
---|---|
highlights[] |
ユーザーに表示されるハイライトのリスト。 |
inclusions[] |
ユーザーに表示される内容のリスト。 |
exclusions[] |
ユーザーに表示される除外リスト。 |
must_know[] |
ユーザーに表示される重要なメモのリスト。年齢制限やこのサービスが適さないその他の条件などの詳細で使用されます。 |
UnsupportedPartySizeOption
圏外の相手向けのオプション。
フィールド | |
---|---|
call_merchant |
範囲外の人数の場合は、ビジネスに電話をかけることができます。事前定義されたメッセージがユーザーに表示されます。表示するサンプル テキスト: 「{waitlist_rules.max_party_size} 人を超える場合は、{phone} のレストランにお電話ください。」CallMerchant を設定する必要がありますが、空になります。 |
UpdateBookingRequest
google.maps.booking.v1alpha.Booking
を更新するリクエスト
フィールド | |
---|---|
update_mask |
更新するすべての予約フィールドのフィールド マスク。 |
booking |
更新対象の予約 |
booking_failure |
非同期で確認された予約リクエストの処理が失敗し、予約のステータスが FAILED に更新されている場合、このフィールドはビジネス ロジック エラー(たとえば、「ユーザーがこの時間の近くにすでに予約を行っている」)を反映します。このフィールドは、予約ステータスを FAILED に更新する場合にのみ設定してください。それ以外の場合は無視されます。 |
UpdateMerchantRequest
Merchant
を更新するリクエスト。
フィールド | |
---|---|
merchant |
新しい販売者データ。 |
update_mask |
販売者向けに更新される特定のフィールド。 |
UpdateOrderRequest
google.maps.booking.v1alpha.Order
を更新するリクエスト
フィールド | |
---|---|
update_mask |
更新するすべての注文フィールドのフィールド マスク。 |
order |
更新する注文 |
UpdateServiceRequest
Service
を更新するリクエスト。
フィールド | |
---|---|
service |
新しいサービスデータ。 |
update_mask |
更新する、サービスの特定のフィールド。 |
UserPurchaseRestriction
支払いオプションを購入できるユーザーを制限します。
フィールド | |
---|---|
new_to_merchant |
以前に同じ販売者から購入したことがないユーザーのみが購入できる支払いオプション。 |
new_to_payment_option |
以前に同じ支払いオプションを購入したことがないユーザーのみが購入できる支払いオプション。 |
VirtualSession
仮想/オンライン セッションに関する情報。例:オンラインのヨガクラス、バーチャル料理教室など
フィールド | |
---|---|
session_instructions |
この仮想クラスを設定する方法。パートナーが予約に動画の URL を記載していない場合は、動画の URL をユーザーと共有するタイミングをこのテキストに含める必要があります。例: 「講義の 30 分前に Zoom の URL をメールでお送りします」(推奨) |
session_requirements |
該当の仮想セッションの要件。例:ヨガマット、調理器具など(推奨) |
virtual_platform_info |
このセッションで使用されている仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
is_session_prerecorded |
必須。仮想セッションがライブではなく、事前に録画されている場合は、true に設定します。 |
VirtualPlatformInfo
このバーチャル セッションで使用されるプラットフォームに関する情報。
フィールド | |
---|---|
platform |
仮想セッションに使用するプラットフォーム。 |
other_platform_name |
プラットフォームが OTHER に設定されている場合、プラットフォームの名前。(プラットフォームが「OTHER」に設定されている場合は必須) |
プラットフォーム
販売者が使用する仮想プラットフォームを示す列挙型。
列挙型 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、使用する動画プラットフォームを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
。 |
GOOGLE_MEET |
。 |
ZOOM |
Zoom Video Communications. |
SKYPE |
Skype。 |
YOUTUBE |
YouTube でのライブ配信。 |
OTHER |
使用する動画プラットフォームがここに示されているプラットフォームと異なる場合は設定する必要があります。 |
WaitlistRules
順番待ちリストへの参入に関連するルール。
フィールド | |
---|---|
min_party_size |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
max_party_size |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
supports_additional_request |
true の場合、ユーザーはこのサービスの順番待ちリストに登録する際に、自由形式の追加テキスト リクエストを送信できます。 |
above_max_party_size_options[] |
設定した max_party_size より大きいサイズのパーティにオプションを設定します。人数の多い方が順番待ちリストに登録するための代替手段を提供しない場合は、空白のままにします。 |