- リソース サービス
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- ロケーション
- LocationType
- Rating
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- Platform
- DirectMerchantPayment
- メソッド
リソース: 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 |
Tours と Activities に固有のコンテンツ フィールド。 |
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」を設定する場合は、正の値にする必要があります。どちらも設定されていない場合、時間枠は開始時間まで予約可能です。両方のフィールドが設定されている場合、一方の値は選択され、もう一方の値は無視されるため、どちらの値が選択されるかを確実に予測できません。 例:
|
|
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 の場合にのみ設定します。「location」フィールドの「locationId」を使用して場所の値を指定してください。 |
choiceText[] |
フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用します。 |
isRequired |
このフィールドに対する回答がユーザーに必須であるかどうかを示します。 |
allowCustomAnswer |
事前定義された回答に加えて、カスタム値が許可されているかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additionalOption[] |
指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、指定した場所のリストのほかに、「後でサプライヤーに連絡します」などのオプションを使用することもできます。(省略可) |
ticketTypeRestrict[] |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に当てはまる場合は、フィールドを空欄にしてください。 |
hint |
入力のヒントテキスト。テキストのプレースホルダとして表示されます。これは、フィールド タイプが SHORT_ANSWER または 段落である場合にのみ適用されます。(省略可) |
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 で提供されるメディアが写真であることを示します。 |
帰属
このメディアの権利帰属情報。
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[] |
(省略可)イベントを視聴できます。 |
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 |
ワークショップとクラス。 |
エンティティ
イベントに関連するエンティティを表します。
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 をご覧ください。指定すると、場所とこの場所が照合されます。 |
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 をユーザーにいつ共有するかをこのテキストに含める必要があります。(「Zoom の URL は講義の 30 分前に郵送されます。」(推奨) |
sessionRequirements |
該当の仮想セッションの要件。例: ヨガマット、調理器具など(推奨) |
virtualPlatformInfo |
このセッションで使用される仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
isSessionPrerecorded |
必須。仮想セッションがライブではなく、事前に録画されている場合は、これを true に設定します。 |
VirtualPlatformInfo
この仮想セッションで使用するプラットフォームに関する情報。
JSON 表現 |
---|
{ "platform": enum ( |
フィールド | |
---|---|
platform |
仮想セッションに使用されるプラットフォーム。 |
otherPlatformName |
プラットフォームが OTHER に設定されている場合のプラットフォームの名前。(プラットフォームが OTHER に設定されている場合は必須) |
プラットフォーム
販売者がどの仮想プラットフォームを使用するかを示す列挙型。
列挙型 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、使用する動画プラットフォームを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
Google ハングアウト サービス。 |
GOOGLE_MEET |
。 |
ZOOM |
Zoom Video Communications、 |
SKYPE |
Skype。 |
YOUTUBE |
YouTube でのライブ配信。 |
OTHER |
使用する動画プラットフォームがここに記載されているものと異なる場合は設定する必要があります。 |
DirectMerchantPayment
ユーザーが RwG を介してサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。
JSON 表現 |
---|
{
"paymentMethods": [
{
object ( |
フィールド | |
---|---|
paymentMethods[] |
お客様には、以下に記載のお支払い方法でのみお支払いいただくようご案内してください。 |
Methods |
|
---|---|
|
指定されたアグリゲータによって管理されている販売者の新しい Service を作成して返します。 |
|
指定されたアグリゲータが管理する販売者の既存の Service を削除します。 |
|
指定されたアグリゲータによって管理されている販売者の既存の Service を更新して返します。 |