索引
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 |
---|
既存の
|
フィード
外部アグリゲータ パートナーによりアップロードされたフィードの処理ステータスを取得します。
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 |
空き状況のスケジュール設定ルール。このフィールドに値が入力されると、サービスレベルの SchedulingRule の対応するスケジューリング ルールがオーバーライドされます。 |
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 |
デポジット金額。 |
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 |
事前注文(Order Ahead)をサポートする場合は true に設定します。(必須) |
FeeDetails
手数料の詳細。
フィールド | |
---|---|
type |
料金のタイプ。(必須) |
fee_amount |
料金。単位通貨、カート価格の割合、またはその両方の組み合わせで指定できます。(必須) |
FeeAmount
FeeAmount
例: * 固定料金: USD 0(手数料なし)、1.5 米ドル * 固定料金の範囲: 1.0 米ドル(最小)、3.0 米ドル(最大)、5.0 ~ 6.0 米ドル *カートサイズの割合: 15.5%、10%~ 20%、10%(最小)、15%(最大 5.5%、1.5%~ 5%、1.5% と 1.5% と 2.5% と最大 5%)、5% と 5%
フィールド | |
---|---|
cart_percentage |
カート価格に対するパーセンテージで表した料金。範囲(制限付きと制限なし)または固定の割合を使用できます。値は 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_record |
プロトコルベースのフィードの場合。 |
GenericRecord
URL リクエストで指定されたフィードタイプのレコード。
フィールド | |
---|---|
generation_timestamp |
必須。このタイムスタンプは、在庫の更新順序を正しく確認するために使用されます。 |
共用体フィールド record_type 。さまざまなタイプのフィードをカプセル化する(ndjson、proto ベースなど)record_type は次のいずれかになります。 |
|
data_record |
プロトコル以外のフィードの場合。 |
proto_record |
プロトコルベースのフィードの場合。 |
GeoCoordinates
ビジネス拠点の地理データ(緯度、経度、住所など)。
フィールド | |
---|---|
latitude |
緯度。(省略可) |
longitude |
経度。(省略可) |
共用体フィールド addresses 。ビジネス拠点の住所。構造化されている住所とされていない住所が可能で、addresses は次のいずれかになります。 |
|
address |
ビジネス拠点の住所(推奨)。 |
unstructured_address |
非構造化住所例: 「1600 amphitheatre Parkway Mountain view, ca 94043」 |
GetMerchantStatusRequest
MerchantStatus
の取得リクエスト
フィールド | |
---|---|
name |
必須。リソース名。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 |
無効にするリソースの名前。 たとえば、受け取りリソースの場合、名前は |
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 をご覧ください。指定すると、場所とこの場所が照合されます。 |
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 { } など)、適用税率はゼロにリセットされます。 |
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[] |
一致したサービス プロバイダ。1 つの販売者を複数のサービス プロバイダに対応させることができます。 |
MatchedProvider
ローカル サービス プロバイダ。
フィールド | |
---|---|
customer_id |
Google ローカル サービスの外部お客様 ID。 |
categories[] |
ローカル サービスの業種(カテゴリ)。例: 「配管工」と「カーペット クリーニング」。 |
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 { } など)、適用税率はゼロにリセットされます。 |
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_micros |
価格(最小通貨単位)。最小通貨単位の端数は、最近接偶数に丸められます(例: USD 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 が 0 の場合にのみ省略できます。 |
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 |
他のフィールドの値に関係なく、この空き情報を予約するにはクレジット カードが常に必要です。 |
関連情報
リソースは、異なるスタッフ メンバーや部屋がサービスに含まれている場合に、個々の空き状況スロットを区別するために使用されます。予約枠のサービスと時間間隔が同じでも、リソースが異なるなら、予約枠は複数存在できます。
フィールド | |
---|---|
staff_id |
サービスを提供するスタッフの ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。employee_name が存在する場合、このフィールドは必須です。 |
staff_name |
サービスを提供するスタッフ メンバーの名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。Staff_id が存在する場合、このフィールドを指定する必要があります。 |
room_id |
サービスが提供される部屋の ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。Room_name が存在する場合は、このフィールドを指定する必要があります。 |
room_name |
サービスが提供される部屋の名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。(省略可。ただし、room_id が存在する場合は必須です)客室名は、バーやパティオなどの座ってくつろげるエリアにのみ使用し、固定料金メニュー、特別なアクティビティ、その他の客室以外の価値(予約やディナーなど)には使用しないでください。デフォルトの座席エリアには部屋を関連付けることを強くおすすめします。 |
party_size |
Dining のみ: この時間枠に対応できる人数。たとえば、予約で 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」を設定する場合は、正の値にする必要があります。どちらも設定されていない場合、時間枠は開始時間まで予約可能です。両方のフィールドが設定されている場合、一方の値は選択され、もう一方の値は無視されるため、どちらの値が選択されるかを確実に予測できません。 例:
|
|
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 { } など)、適用税率はゼロにリセットされます。 |
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 |
Tours と Activities に固有のコンテンツ フィールド。 |
location[] |
このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。 |
rating |
このサービスに対するユーザー評価(すべてのレビューの集計指標)。 |
home_service_data |
ホームサービスの業種に固有の追加情報。(省略可) |
virtual_session |
(省略可)仮想セッションに関する情報。仮想サービスを有効にするために必要です。 |
direct_merchant_payment |
(省略可)ユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: この取引に RwG は関与しません。virtual_session が定義されていて、Service が無料でない場合、または 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 |
このサービス属性の中の他の値から値を一意に識別する識別子(「personal」など)。 |
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] フィールドの [location_id] を使用して場所の値を指定してください。 |
choice_text[] |
フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用します。 |
is_required |
このフィールドに対する回答がユーザーに必須であるかどうかを示します。 |
allow_custom_answer |
事前定義された回答に加えて、カスタム値が許可されているかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additional_option[] |
指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、指定した場所のリストのほかに、「後でサプライヤーに連絡します」などのオプションを使用することもできます。(省略可) |
ticket_type_restrict[] |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に当てはまる場合は、フィールドを空欄にしてください。 |
hint |
入力のヒントテキスト。テキストのプレースホルダとして表示されます。これは、フィールド タイプが SHORT_ANSWER または 段落である場合にのみ適用されます。(省略可) |
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 セントの端数など)は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。 |
利用規約
「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[] |
(省略可)イベントを視聴できます。 |
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 をユーザーにいつ共有するかをこのテキストに含める必要があります。(「Zoom の URL は講義の 30 分前に郵送されます。」(推奨) |
session_requirements |
該当の仮想セッションの要件。例: ヨガマット、調理器具など(推奨) |
virtual_platform_info |
このセッションで使用される仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
is_session_prerecorded |
必須。仮想セッションがライブではなく、事前に録画されている場合は、これを true に設定します。 |
VirtualPlatformInfo
この仮想セッションで使用するプラットフォームに関する情報。
フィールド | |
---|---|
platform |
仮想セッションに使用されるプラットフォーム。 |
other_platform_name |
プラットフォームが OTHER に設定されている場合のプラットフォームの名前。(プラットフォームが OTHER に設定されている場合は必須) |
プラットフォーム
販売者がどの仮想プラットフォームを使用するかを示す列挙型。
列挙型 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、使用する動画プラットフォームを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
Google ハングアウト サービス。 |
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 よりも大きいサイズのパーティーの場合は、オプションを設定します。人数の多い参加者に対して順番待ちリストに登録するための代替オプションを提供しない場合は、空欄のままにします。 |