- リソース サービス
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- ロケーション
- LocationType
- Rating
- HomeServiceData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VirtualSession
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VirtualPlatformInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- Platform
- DirectMerchantPayment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: Service
販売者が提供しているサービスに関する情報(例:ヘアカット。
JSON 表現 |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
フィールド | |
---|---|
name |
サービス リソース名。形式は |
serviceName |
サービスの名前(例: 「メンズ ヘアカット」)。非推奨。代わりに localizedServiceName を使用してください。 |
localizedServiceName |
サービスの名前(例: 「メンズ ヘアカット」)。複数の言語 / 地域で使用される可能性があります。 |
description |
ユーザーに表示される、サービスの説明。非推奨。代わりに localizedDescription を使用してください。 |
localizedDescription |
ユーザーに表示される、サービスの説明。 このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。 サポートされている HTML に類似する形式の書式設定タグ: 見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落タグ: <p> リストタグ: <ul>、<ol>、<li> 分割タグ: <div> フレーズタグ: <br>、<strong>、<em>: サポートされていないタグ:
注意事項:
|
price |
サービスの料金。 |
priceInterpretation |
価格を解釈してユーザーに表示する方法について説明します。「食事」と「おすすめスポット」を除くあらゆる業種で、サービス価格の表示の設定に使用できます。 |
rules |
予約やキャンセルのルール。 |
prepaymentType |
前払いが必須か、任意か、サポートされていないか。 |
prepaymentTerms |
前払いの完了時期に関する条件。 |
form[] |
非推奨です。intakeForm と perTicketIntakeForm を使用してください。 |
intakeForm |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。(省略可) |
perTicketIntakeForm |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。(省略可) |
taxRate |
サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された taxRate をオーバーライドします。空のメッセージ(例: taxRate { })を指定すると、適用される税率はゼロにリセットされます。 |
paymentOptionId[] |
このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 |
deposit |
ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。(省略可) |
noShowFee |
ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。(省略可) |
requireCreditCard |
このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。(省略可) |
actionLink[] |
このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service にタイプ(下記参照)を設定する必要があります。 |
type |
このサービスの事前定義されたタイプ。(省略可) |
ticketType[] |
チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。(省略可) |
relatedMedia[] |
このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。(省略可) |
serviceAttributeValueId[] |
このサービスに適用される Service 属性値(省略可)。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。(省略可) |
waitlistRules |
順番待ちリストに登録するためのルール。 |
ticketingVerticalSpecificData |
イベント チケット販売業種に固有の追加情報。(省略可) |
integrationType |
このサービスでサポートされる統合の程度。(省略可)試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンドは常に無効になります。 |
perOrderFee |
このサービスを購入するための注文レベルの料金。(省略可) |
toursAndActivitiesContent |
ツアーとアクティビティに固有のコンテンツ フィールド。 |
location[] |
このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。 |
rating |
このサービスに対するユーザーの評価を、すべてのレビューの集計指標として示します。 |
homeServiceData |
ホームサービス カテゴリに固有の追加情報。(省略可) |
virtualSession |
省略可。仮想セッションに関する情報。仮想サービスを有効にするために必要です。 |
directMerchantPayment |
省略可。サービスでユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: この取引には RwG は関与しません。virtualSession が定義されていてサービスが無料でない場合、または prepaymentType が REQUIRED に設定されていない場合は指定する必要があります。 |
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 を空にする必要があります。 例: 家事のコンサルティング |
SchedulingRules
サービスのスケジュール設定ルール。
JSON 表現 |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
フィールド | |
---|---|
minAdvanceOnlineCanceling |
予約をオンラインでキャンセルするために必要な最小事前通知期間(秒単位)。(省略可) |
lateCancellationFee |
最小事前通知期間内のキャンセル料。 |
noshowFee |
無断キャンセル料。 |
admissionPolicy |
このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。(省略可) |
cancellationPolicy |
キャンセル ポリシーのスケジュール設定ルール。(おすすめスポットに必須) |
共用体フィールド 「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 つの値は無視されるため、どちらの値が選択されるかを正確に予測することはできません。 例:
|
|
minAdvanceBooking |
最後の予約が可能になってから予約枠が開始するまでの時間(秒単位)。 |
minBookingBufferBeforeEndTime |
最終予約可能時間から予約枠の終了時刻までの期間(秒単位)。 このフィールドが設定されている場合、「admissionPolicy」フィールドを 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 時に博物館に到着している必要があります。このサービスの予約枠の開始時刻は、指定された入場時間を表します。ただし、終了時間は、予約の予約枠を識別するためのキーとしてのみ使用されます。 |
CancellationPolicy
サービスのキャンセル ポリシー。
JSON 表現 |
---|
{
"refundCondition": [
{
object ( |
フィールド | |
---|---|
refundCondition[] |
ポリシーに適用される 0 個以上の払い戻し条件。 |
RefundCondition
単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。
JSON 表現 |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
フィールド | |
---|---|
minDurationBeforeStartTime |
開始時刻までの期間。顧客は、この時刻まで
|
refundPercent |
サービス開始時刻の |
PrepaymentType
前払いのタイプを示す列挙型。
列挙型 | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
デフォルトでは、前払いは NOT_SUPPORTED とみなされます。 |
REQUIRED |
ユーザーは予約時にこのサービスの支払いを行う必要があります。 |
OPTIONAL |
ユーザーは予約時または予約後にこのサービスの前払いを行うことができますが、必須ではありません。 |
NOT_SUPPORTED |
このサービスでは前払いがサポートされていません。 |
PrepaymentTerms
前払いの完了時期に関する具体的な情報
JSON 表現 |
---|
{
"chargeTiming": enum ( |
フィールド | |
---|---|
chargeTiming |
購入日時を基準に請求が行われるタイミング。 |
chargeTimeBeforeStartTimeSec |
サービス開始時刻までの経過時間(秒)。この時刻までにユーザーに支払いが行われます。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。 |
ChargeTiming
購入日時を基準にして請求が発生するタイミングを指定する列挙型。
列挙型 | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
未使用。 |
CHARGE_NOW |
直ちに請求が行われます。 |
CHARGE_LATER |
お客様には後で請求が行われます。 |
ServiceIntakeForm
販売者が提供するサービスをカスタマイズするインテイク フォームを定義します。
JSON 表現 |
---|
{
"field": [
{
object ( |
フィールド | |
---|---|
field[] |
ユーザーに表示されるフィールド。 |
firstTimeCustomers |
true の場合、このフォームは初めての顧客に表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
returningCustomers |
true の場合、このフォームはリピーターに表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
ServiceIntakeFormField
ServiceIntainForm に含まれるフィールドを定義します。
JSON 表現 |
---|
{ "id": string, "type": enum ( |
フィールド | |
---|---|
id |
フォーム フィールドを一意に識別するアグリゲータ パートナーからの文字列。この ID は、対応するフォーム フィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイク フォームの両方で一意である必要があります。(必須) |
type |
このフィールドの型。 |
label |
ユーザーに表示される、このフィールドのテキスト。非推奨。代わりに |
localizedLabel |
ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。(必須) |
value[] |
フィールドの型が LOCATION_SEARCH の場合にのみ設定します。「locationId」を使用してください対象の「location」ロケーションの値を指定します。 |
choiceText[] |
フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定されます。可能な選択肢を列挙するために使用します。 |
isRequired |
このフィールドへの回答がユーザーに要求されるかどうかを示します。 |
allowCustomAnswer |
事前定義された回答以外の回答でカスタム値を許可するかどうかを指定します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additionalOption[] |
指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。例:提供された場所リストに加えて、[後でサプライヤーに連絡します] というオプションも利用できます。(省略可) |
ticketTypeRestrict[] |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。常に該当する質問がある場合は、フィールドを空のままにします。 |
hint |
テキスト プレースホルダとして表示される入力のヒントテキスト。このフィールドが該当するのは、フィールド タイプが SHORT_ANSWER または Colab の場合に限られます。(省略可) |
FieldType
フィールドのタイプを示す列挙型。
列挙型 | |
---|---|
FIELD_TYPE_UNSPECIFIED |
未指定または不明なタイプのフィールドは無視されます。 |
SHORT_ANSWER |
テキスト用の 1 行の入力フィールド。 |
PARAGRAPH |
テキスト用の複数行の入力フィールド。 |
MULTIPLE_CHOICE |
多数のオプションから 1 つを選択する必要があるラジオボタンのセット。 |
CHECKBOXES |
チェックボックス付きの 1 つ以上の列挙型項目。 |
DROPDOWN |
プルダウンからの選択。 |
BOOLEAN |
はい / いいえボタン。 |
LOCATION_SEARCH |
ユーザーの入力に基づいて、指定されたビジネス拠点のリストから一致するビジネス拠点を検索できる検索ボックス。 |
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 |
ユーザーが特定の販売者からショッピングできるようにするサービス。配達または受け取りのいずれかです。 |
TicketType
TicketType は、ユーザータイプ、サービス属性、オプション / アドオンが異なるため、価格や空き情報が異なるチケットを他のチケットとの間で区別するために使用されます。
チケットは、サービスの予約可能な最小単位です(ラフティングのツアースポット、博物館への入場、2 人用カヤックの 1 日レンタルなど)。
JSON 表現 |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
フィールド | |
---|---|
ticketTypeId |
チケット ID は、同じサービスの異なるチケットタイプを区別するために使用され、サービス内でのみ一意である必要があります。 |
shortDescription |
この TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localizedShortDescription を使用してください。 |
localizedShortDescription |
i18n をサポートするこの TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。 |
price |
このタイプのチケット 1 枚の価格(税抜き)。Service の税率がチケットに適用されます。 |
perTicketFee |
このチケットを購入するための追加料金。(省略可) |
optionDescription |
このチケットタイプが表す追加オプションの説明(ある場合)。非推奨。代わりに localizedOptionDescription を使用してください。 |
localizedOptionDescription |
このチケットタイプが表す追加オプションの説明(ある場合)。言語 / 地域ごとに別々の値を指定できます。 追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。 例 1: 「大人」、「子供」などの異なるタイプのある入場チケットで、言語を追加オプションとしている場合の想定される TicketType リスト: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } } 例 2: 防水バックをオプションの追加器具として選択できるカヤック レンタル(2 時間以上)で、shortDescription は「3 時間」、optionDescription は「防水バッグ付き」または「防水バッグなし」が可能な場合: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } } 省略可能ですが、サービス内のいずれかのチケットタイプにこのフィールドが設定されている場合は、他のすべてのチケットタイプにもこのフィールドを設定することをおすすめします(optionDescription のデフォルト値が使用される可能性があります)。たとえば、[{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] は有効なリストではありません。 サポートされている 2 つの HTML 形式タグは、<em> と <br> です。 |
PerTicketFee
ユーザーが購入するチケットごとに支払う必要がある料金。
JSON 表現 |
---|
{ "serviceCharge": { object ( |
フィールド | |
---|---|
serviceCharge |
サービスに対して請求される追加料金。 |
facilityFee |
会場や施設に行く料金。 |
taxes |
チケット 1 枚あたりの税金。 |
RelatedMedia
このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。(省略可)
JSON 表現 |
---|
{ "url": string, "type": enum ( |
フィールド | |
---|---|
url |
このメディアソースの URL。Google はこの URL でホストされているメディアをクロールします。 |
type |
このメディアソースのタイプ。 |
localizedCaption |
i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。(省略可) |
attribution |
メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。(省略可) |
caption |
非推奨。localizedCaption を使用することをおすすめします。 |
MediaType
このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。
列挙型 | |
---|---|
TYPE_UNSPECIFIED |
未使用。 |
PHOTO |
URL で提供されるメディアが写真であることを示します。 |
Attribution
このメディアの権利帰属情報。
JSON 表現 |
---|
{
"localizedText": {
object ( |
フィールド | |
---|---|
localizedText |
i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドでは書式なしテキストのみがサポートされ、HTML コンポーネントはすべて削除されます(ハイパーリンク ベースのアトリビューションはサポートされません)。 |
text |
非推奨。localizedText を使用することをおすすめします。 |
ServiceAttributeValueId
Service に適用されるサービス属性の特定の値を識別します。
JSON 表現 |
---|
{ "attributeId": string, "valueId": string } |
フィールド | |
---|---|
attributeId |
Merchant.service_attribute で定義された属性の ID。例:「service-type」を指定します。 |
valueId |
この属性の値の ID(「haircut」など)。サービス属性定義の valueId と一致する必要があります。 |
WaitlistRules
順番待ちリストへの参入に関連するルール。
JSON 表現 |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
フィールド | |
---|---|
minPartySize |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
maxPartySize |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
supportsAdditionalRequest |
true の場合、ユーザーはこのサービスの順番待ちリストに登録する際に、自由形式の追加テキスト リクエストを送信できます。 |
aboveMaxPartySizeOptions[] |
設定した maxPartySize を超えるグループのオプションを設定します。人数の多い方が順番待ちリストに登録するための代替手段を提供しない場合は、空白のままにします。 |
UnsupportedPartySizeOption
圏外の相手向けのオプション。
JSON 表現 |
---|
{
"callMerchant": {
object ( |
フィールド | |
---|---|
callMerchant |
範囲外の人数の場合は、ビジネスに電話をかけることができます。事前定義されたメッセージがユーザーに表示されます。表示するサンプル テキスト: 「{waitlistRules.max_party_size} を超える人数のレストランの場合は、{phone} のレストランにお電話ください。」CallMerchant を設定する必要がありますが、空になります。 |
CallMerchant
UnsupportedPartySizeOption で使用される空のメッセージです。これを設定すると、予約のためにビジネスに電話するオプションがユーザーに表示されます。
TicketingVerticalSpecificData
イベント チケット販売業種に固有の追加情報。
JSON 表現 |
---|
{ "eventCategory": enum ( |
フィールド | |
---|---|
eventCategory |
イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。(省略可) |
eventUrl |
パートナーのウェブサイトに掲載されているイベントの URL。(省略可) |
entity[] |
イベントに関連するエンティティのリスト。(省略可) |
eventAttendanceMode |
必須。イベントの参加者のタイプ。 |
eventVirtualLocationUrl[] |
省略可。イベントを視聴できる URL。 |
eventOrganizer |
省略可。イベントをホストする主催者。 |
eventOrganizerUrl |
省略可。予定を主催する主催者の URL。 |
eventOrganizerType |
省略可。主催者の種類。 |
eventSourceUrl[] |
必須。イベントの情報や説明を確認できるページの URL。 |
eventState |
省略可。イベントの状態。 |
EventCategory
サービス エクスペリエンスをカスタマイズするイベント カテゴリのサブセット。注: イベントの汎用のオントロジーを意図したものではありません。
列挙型 | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
指定なし。使用しないでください。 |
EVENT_CATEGORY_CONCERT |
コンサート。 |
EVENT_CATEGORY_SPORTS |
スポーツ イベント。 |
EVENT_CATEGORY_THEATRE |
劇場でのイベント。 |
EVENT_CATEGORY_EXHIBITS |
展示。 |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
ワークショップとクラス。 |
Entity
イベントに関連するエンティティを表します。
JSON 表現 |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
フィールド | |
---|---|
id |
パートナーのデータベースにあるエンティティの一意の識別子。(省略可) |
name |
エンティティの名前。(必須) |
url |
エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページです(ある場合)。エンティティのその他の公開 URL は、publicIdentificationData の relevantUrl を使用します。(省略可) |
entityType |
エンティティのタイプ。(省略可) |
entityRole |
イベントでのエンティティの役割。(省略可) |
publicIdentificationData |
エンティティの公開参照。(省略可) |
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 の場合にのみ該当します。 |
EntityRole
イベントでのエンティティの役割。
列挙型 | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
指定されていません。 |
ENTITY_ROLE_HEADLINER |
エンティティは、イベントでの主演者または主要出演者を表します。 |
ENTITY_ROLE_SUPPORTER |
エンティティは、イベントでの脇役を表します。 |
ENTITY_ROLE_HOME_TEAM |
エンティティは、(スポーツ)イベントのホームチームを表します。 |
ENTITY_ROLE_AWAY_TEAM |
エンティティは、(スポーツ)イベントのアウェイチームを表します。 |
PublicIdentificationData
エンティティを参照する識別子、ウェブページ、その他の公開ソース。
JSON 表現 |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
フィールド | |
---|---|
relevantUrl[] |
トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります(例: https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan)。(省略可) |
musicbrainzId |
アーティストなどの音楽エンティティの 36 文字の MusicBrainz 識別子(該当する場合)。https://musicbrainz.org/doc/MusicBrainz_Identifier をご覧ください。(省略可) |
AttendanceMode
イベントの参加者のタイプ。
列挙型 | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
指定されていません。 |
ONLINE |
バーチャル イベントの場合。 |
PHYSICAL |
物理的なイベント用。 |
PHYSICAL_ONLINE_MIXED |
対面と仮想の両方のイベントが対象です。 |
OrganizerType
主催者の種類。
列挙型 | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
指定されていません。 |
PERSON |
主催者が個人の場合。 |
ORGANIZATION |
組織である主催者を対象とします。 |
EventState
イベントの状態。
列挙型 | |
---|---|
EVENT_STATE_UNSPECIFIED |
指定されていません。 |
SCHEDULED |
イベントがスケジュール設定されています。 |
RESCHEDULED |
イベントの日時が変更された。 |
CANCELLED |
イベントはキャンセルされました。 |
POSTPONED |
イベントは延期されました。 |
IntegrationType
サポートされている統合の程度。
列挙型 | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
デフォルトは END_TO_END です。 |
INTEGRATION_TYPE_END_TO_END |
Google を通じてエンドツーエンドの予約を可能にする完全な統合。 |
INTEGRATION_TYPE_INVENTORY_ONLY |
予約サーバーはこのサービスをサポートする必要はありません。販売者、サービス、(省略可)空き情報データのみを送信する必要があります。 |
PerOrderFee
チケットの数に関係なく、注文ごとに 1 回支払う必要がある料金。
JSON 表現 |
---|
{ "deliveryFee": { object ( |
フィールド | |
---|---|
deliveryFee |
送料は配送方法によって異なる場合があります。 |
processingFee |
ユーザーのお支払い方法を処理するための料金。 |
ToursAndActivitiesContent
Tours と Activities に固有のコンテンツ フィールド。繰り返しフィールドの各要素は、独立したレンダリング(箇条書きなど)ができるように個々に設定する必要があります。
ツアーやアクティビティの場合、ToursAndActivitiesContent への入力は強くおすすめしますが、絶対必須条件ではありません。すべてのフィールドは、基本的な書式として、書式なしテキストと HTML に類似する形式のテキストの両方をサポートしています。サポートされている HTML に類似する形式の書式設定タグ:
フレーズタグ: <br>、<strong>、<em>、<italic> の 3 つのタグのみがサポートされています。
<br> を使用すると、段落の改行ができます。また、<strong>、<em>、<italic> を使用すると、重要なテキストをハイライト表示できます。
その他のフレーズタグは無視されます。
その他すべてのタグとカスタム スタイルは使用できず、削除されます。URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。
重要な注意事項: * highlights
、exclusion
など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。
JSON 表現 |
---|
{ "highlights": [ { object ( |
フィールド | |
---|---|
highlights[] |
ユーザーに表示されるハイライトのリスト。 |
inclusions[] |
ユーザーに表示される内容のリスト。 |
exclusions[] |
ユーザーに表示される除外リスト。 |
mustKnow[] |
ユーザーに表示される重要なメモのリスト。年齢制限やこのサービスが適さないその他の条件などの詳細で使用されます。 |
場所
ビジネス拠点に関する地理情報。
JSON 表現 |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
フィールド | |
---|---|
placeId |
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 |
ビジネス拠点の地理情報(緯度、経度、住所など)。(省略可) |
locationType |
ロケーションのタイプ。このロケーションが Service に対して指定されている場合は指定する必要があります。 |
locationId |
サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービス フィールドでこのビジネス拠点を参照できます。例:カスタム登録フォームでは、地域 ID のセットを使用して乗車場所のオプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。(省略可) |
LocationType
このビジネス拠点のタイプ。
列挙型 | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
ビジネス拠点タイプが指定されていません。 |
VISITED_LOCATION |
このサービスで訪れる場所。 |
START_LOCATION |
このサービスが開始する場所。MEETING_LOCATION としても機能します。 |
END_LOCATION |
このサービスが終了する場所。 |
Rating
エンティティの評価を定義します。
JSON 表現 |
---|
{ "value": number, "numberOfRatings": string } |
フィールド | |
---|---|
value |
平均評価値(numberOfRatings > 0 の場合は必須)。値は [1, 5] の範囲内である必要があり、numberOfRatings が 0 の場合にのみ省略できます。 |
numberOfRatings |
価値の計算に使用された評価の数(必須)。 |
HomeServiceData
ホームサービス カテゴリの場合、追加の情報を提供する必要があります。
JSON 表現 |
---|
{ "categoryType": string, "jobType": string } |
フィールド | |
---|---|
categoryType |
このホームサービスが属する上位カテゴリ。例:配管工、電気工など |
jobType |
特定のホームサービスが属するカテゴリの職種。例:unclog_drain、install_faucet は、配管工カテゴリの職種です。 |
VirtualSession
仮想/オンライン セッションに関する情報。例:オンラインのヨガクラス、バーチャル料理教室など
JSON 表現 |
---|
{ "sessionInstructions": { object ( |
フィールド | |
---|---|
sessionInstructions |
この仮想クラスを設定する方法。パートナーが予約に動画の URL を記載していない場合は、動画の URL をユーザーと共有するタイミングをこのテキストに含める必要があります。例: 「講義の 30 分前に Zoom の URL をメールでお送りします」(推奨) |
sessionRequirements |
該当の仮想セッションの要件。例:ヨガマット、調理器具など(推奨) |
virtualPlatformInfo |
このセッションで使用されている仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
isSessionPrerecorded |
必須。仮想セッションがライブではなく、事前に録画されている場合は、true に設定します。 |
VirtualPlatformInfo
このバーチャル セッションで使用されるプラットフォームに関する情報。
JSON 表現 |
---|
{ "platform": enum ( |
フィールド | |
---|---|
platform |
仮想セッションに使用するプラットフォーム。 |
otherPlatformName |
プラットフォームが OTHER に設定されている場合、プラットフォームの名前。(プラットフォームが「OTHER」に設定されている場合は必須) |
プラットフォーム
販売者が使用する仮想プラットフォームを示す列挙型。
列挙型 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、使用する動画プラットフォームを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
。 |
GOOGLE_MEET |
。 |
ZOOM |
Zoom Video Communications. |
SKYPE |
Skype。 |
YOUTUBE |
YouTube でのライブ配信。 |
OTHER |
使用する動画プラットフォームがここに示されているプラットフォームと異なる場合は設定する必要があります。 |
DirectMerchantPayment
ユーザーが RwG を介してサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。
JSON 表現 |
---|
{
"paymentMethods": [
{
object ( |
フィールド | |
---|---|
paymentMethods[] |
お支払いには、下記のお支払い方法のみをおすすめします。 |
メソッド |
|
---|---|
|
指定されたアグリゲータによって管理されている販売者の新しい Service を作成して返します。 |
|
指定されたアグリゲータによって管理されている販売者の既存の Service を削除します。 |
|
指定されたアグリゲータによって管理されている販売者の既存の Service を更新して返します。 |