- リソース サービス
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- PriceDisplayType
- InventoryType
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- EventCreator
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- ロケーション
- LocationType
- Rating
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- Platform
- DirectMerchantPayment
- UriTemplate
- メソッド
リソース: Service
販売者が提供するサービスに関する情報(例: ヘアカット)。
JSON 表現 |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
フィールド | |
---|---|
name |
サービス リソース名(形式: |
service |
サービスの名前(例: 「メンズ ヘアカット」)。非推奨。代わりに、localizedServiceName を使用してください。 |
localized |
サービスの名前(例: 「メンズ ヘアカット」)。いくつかの言語 / 地域で使用されている可能性があります。 |
description |
ユーザーに表示される、サービスの説明。非推奨。代わりに、localizedDescription を使用してください。 |
localized |
ユーザーに表示される、サービスの説明。 このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。 サポートされている HTML に類似する形式の書式設定タグ: 見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落タグ: <p> リストタグ: <ul>、<ol>、<li> 分割タグ: <div> フレーズタグ: <br>、<strong>、<em>: サポートされていないタグ:
注意事項:
|
price |
サービスの価格。 |
price |
価格を解釈してユーザーに表示する方法について説明します。サービスの価格の表示を設定するために、「レストラン」と「おすすめスポット」以外のカテゴリで使用できます。 |
rules |
予約/キャンセルのルール。 |
prepayment |
前払いが必須か、選択可能か、対象外か。 |
prepayment |
前払いが完了するタイミングに関する条件。 |
form[] |
非推奨です。intakeForm と perTicketIntakeForm を使用してください。 |
intake |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。(省略可) |
per |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。(省略可) |
tax |
サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された taxRate をオーバーライドします。メッセージが空の場合(taxRate { } など)、適用される税率はゼロにリセットされます。 |
payment |
このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 |
deposit |
ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。(省略可) |
no |
ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。(省略可) |
require |
このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。(省略可) |
action |
このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service でタイプ(下記参照)を設定する必要があります。 |
type |
このサービスの事前定義されたタイプ。(省略可) |
ticket |
チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。(省略可) |
related |
このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。(省略可) |
service |
このサービスに適用される Service 属性値(省略可)。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。(省略可) |
waitlist |
順番待ちリストに加わるためのルール。 |
ticketing |
イベント チケット販売業種に固有の追加情報。(省略可) |
integration |
このサービスでサポートされる統合の程度。(省略可)試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンド統合は常に無効になります。 |
per |
このサービスを購入するための注文レベルの料金。(省略可) |
tours |
Tours と Activities に固有のコンテンツ フィールド。 |
location[] |
このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、集合場所を指定する必要があります。 |
rating |
このサービスに対するユーザー評価(すべてのクチコミの集計指標で表します)。 |
home |
ホームサービス業種に固有の追加情報。(省略可) |
virtual |
省略可。仮想セッションに関する情報。仮想サービスを有効にするには必要です。 |
direct |
省略可。ユーザーが販売者に直接支払う必要があるサービスの場合は、追加情報を追加する必要があります。重要な注意事項: RwG はこの取引には関与しません。virtualSession が定義されていて、サービスが無料ではないか、prepaymentType が REQUIRED に設定されていない場合は必須です。 |
uri |
省略可。外部サイトへの URL の生成方法を指定するオプションのテンプレート。 |
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 ( |
フィールド | |
---|---|
min |
予約をオンラインでキャンセルするために必要な最小事前通知期間(秒単位)。(省略可) |
lateCancellationFee |
最小事前通知期間内のキャンセル料。 |
noshowFee |
無断キャンセル料。 |
admission |
このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。(省略可) |
cancellation |
キャンセル ポリシーのスケジュール設定ルール。(「おすすめスポット」で必須) |
共用体フィールド 「min_advance_booking」が設定されている場合、最終予約可能時間は(<予約枠開始時間> - min_advance_booking)として計算されます。「min_booking_Buffer_before_end_time」が設定されている場合、最終予約可能時間は(<予約枠終了時間> - min_booking_buffer_before_end_time)として計算されます。「min_booking_buffer_before_end_time」を設定する場合は、正の値にする必要があります。両方とも設定されていない場合、予約枠の開始時間まで予約可能となります。両方のフィールドが設定されている場合、選択されるのは 1 つの値のみで、もう 1 つの値は無視されます。どちらの値が選択されるかは確実に予測できません。 例:
|
|
min |
最終予約可能時間から予約枠の開始時刻までの期間(秒単位)。 |
min |
最終予約可能時間から予約枠の終了時刻までの期間(秒単位)。 このフィールドが設定されている場合、時間枠開始後にユーザーが購入したチケットを使用できることを示すため、「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 ( |
フィールド | |
---|---|
refund |
ポリシーに適用される 0 個以上の払い戻し条件。 |
RefundCondition
単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。
JSON 表現 |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
フィールド | |
---|---|
min |
開始時刻までの期間。顧客は、この時刻まで
|
refund |
サービス開始時刻の |
PrepaymentType
前払いのタイプを示す列挙型。
列挙型 | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
デフォルトでは、前払いは NOT_SUPPORTED とみなされます。 |
REQUIRED |
ユーザーは予約時にこのサービスの支払いを行う必要があります。 |
OPTIONAL |
ユーザーは予約時または予約後にこのサービスの前払いを行うことができますが、必須ではありません。 |
NOT_SUPPORTED |
このサービスでは前払いがサポートされていません。 |
PrepaymentTerms
前払いが完了する日時に関する具体的な情報。
JSON 表現 |
---|
{
"chargeTiming": enum ( |
フィールド | |
---|---|
charge |
購入日時に対する請求日時。 |
charge |
サービス開始時間の前にユーザーに請求される支払い時間(秒単位)。このフィールドは、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 |
ユーザーに表示される、このフィールドのテキスト。非推奨。代わりに |
localized |
ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。(必須) |
value[] |
フィールドのタイプが LOCATION_SEARCH の場合にのみ設定します。「location」フィールドの「locationId」を使用してビジネス拠点の値を指定してください。 |
choice |
フィールドのタイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用されます。 |
is |
このフィールドへの回答がユーザーに必須かどうかを示します。 |
allow |
定義済みの回答に加えてカスタム値が許可されるかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additional |
指定された値に加えて指定された追加オプション。フィールドタイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、指定された場所のリストに加えて、[後でサプライヤーに連絡します] などのオプションも選択できます。(省略可) |
ticket |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に該当する場合は、この欄を空欄のままにします。 |
hint |
入力のヒント テキスト。テキスト プレースホルダとして表示されます。これは、フィールドのタイプが SHORT_ANSWER または PARAGRAPH の場合にのみ適用されます。(省略可) |
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 ( |
フィールド | |
---|---|
ticket |
チケット ID は、同じサービスの異なるチケットタイプの間で区別するために使用され、サービス内で一意である必要があります。 |
short |
この TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localizedShortDescription を使用してください。 |
localized |
i18n をサポートするこの TicketType の簡単な説明。 これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。 |
price |
このタイプのチケット 1 枚の価格(税抜き)。Service の税率がチケットに適用されます。 |
per |
このチケットを購入するための追加料金。(省略可) |
price |
省略可。このタイプのチケット 1 枚の事前定義された料金表示タイプ。 |
option |
このチケットタイプが表す追加オプションの説明(ある場合)。非推奨。代わりに、localizedOptionDescription を使用してください。 |
localized |
このチケットタイプが表す追加オプションの説明(ある場合)。言語 / 地域ごとに別々の値を指定できます。 追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。 例 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> です。 |
inventory |
省略可。このタイプのチケット 1 枚の事前定義された広告枠タイプ。 |
PerTicketFee
ユーザーが購入するチケットごとに支払う必要がある料金。
JSON 表現 |
---|
{ "serviceCharge": { object ( |
フィールド | |
---|---|
service |
サービスごとに課される追加料金。 |
facility |
会場や施設に赴く際の料金。 |
taxes |
チケットごとの税金。 |
PriceDisplayType
ランディング ページに表示される価格の形式を指定します。
リンク先外広告枠の場合、このフィールドは無視されます。
このフィールドを使用すると、Google サーフェスに、ランディング ページで使用されているものと同じ価格形式を表示できます。価格の形式を統一すると、コンバージョン率が向上し、混乱を軽減できます。
列挙型 | |
---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED |
価格表示タイプが指定されていません。表示するフォーマットは Google が決定します。 |
PRICE_DISPLAY_TYPE_BASE |
ランディング ページに表示されている価格が基本価格です。 |
PRICE_DISPLAY_TYPE_ALL_IN |
ランディング ページに表示される価格には、すべての手数料と税金が含まれています。 |
InventoryType
このタイプのチケット 1 枚の事前定義された広告枠タイプ。
列挙型 | |
---|---|
INVENTORY_TYPE_UNSPECIFIED |
広告枠のタイプが指定されていません。 |
INVENTORY_TYPE_PRIMARY |
メインの広告枠。 |
INVENTORY_TYPE_VERIFIED_RESALE |
再販在庫の確認。 |
INVENTORY_TYPE_RESALE |
再販広告枠。 |
INVENTORY_TYPE_AGGREGATOR |
アグリゲータの広告枠。 |
RelatedMedia
このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。(省略可)
JSON 表現 |
---|
{ "url": string, "type": enum ( |
フィールド | |
---|---|
url |
このメディアソースの URL。この URL でホストされているメディアが、Google によりクロールされます。 |
type |
このメディアソースのタイプ。 |
localized |
i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。(省略可) |
attribution |
メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。(省略可) |
caption |
非推奨。localizedCaption を使用することをおすすめします。 |
MediaType
このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。
列挙型 | |
---|---|
TYPE_UNSPECIFIED |
未使用。 |
PHOTO |
URL で提供されるメディアが写真であることを示します。 |
Attribution
このメディアの権利帰属情報。
JSON 表現 |
---|
{
"localizedText": {
object ( |
フィールド | |
---|---|
localized |
i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドでは書式なしテキストのみがサポートされ、HTML コンポーネントは削除されます(ハイパーリンク ベースの権利帰属はサポートされません)。 |
text |
非推奨。localizedText を使用することをおすすめします。 |
ServiceAttributeValueId
Service に適用されるサービス属性の特定の値を識別します。
JSON 表現 |
---|
{ "attributeId": string, "valueId": string } |
フィールド | |
---|---|
attribute |
Merchant.service_attribute で定義されている属性の ID(「service-type」など)。 |
value |
この属性の値の ID(「haircut」など)。サービス属性定義の valueId と一致する必要があります。 |
WaitlistRules
順番待ちリストへの参入に関連するルール。
JSON 表現 |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
フィールド | |
---|---|
min |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
max |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
supports |
true の場合、ユーザーはこのサービスの順番待ちリストに加わるときに、自由形式の追加テキスト リクエストを送信できます。 |
above |
設定された maxPartySize を超えるパーティのオプションを設定します。大人数の場合はウェイトリストに登録する代替オプションを提供しない場合は、空白のままにします。 |
UnsupportedPartySizeOption
範囲外の参加者向けのオプション。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド kind 。範囲外の当事者に対して利用できるオプション。kind は次のいずれかになります。 |
|
call |
人数が範囲外の場合は、ビジネスに電話をかけることができます。事前定義されたメッセージがユーザーに表示されます。表示されるテキストの例: 「{waitlistRules.max_party_size} 人を超える場合は、レストラン(電話: {phone})までお問い合わせください。」CallMerchant は設定する必要がありますが、空になります。 |
CallMerchant
この型にはフィールドがありません。
UnsupportedPartySizeOption で使用される空のメッセージ。この値を設定すると、ユーザーに予約のためにビジネスに電話するオプションが表示されます。
TicketingVerticalSpecificData
イベント チケット販売業種に固有の追加情報。
JSON 表現 |
---|
{ "eventCategory": enum ( |
フィールド | |
---|---|
event |
イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。(省略可) |
event |
パートナーのウェブサイトに掲載されているイベントの URL。(省略可) |
entity[] |
イベントに関連するエンティティのリスト。(省略可) |
event |
必須。イベントの参加の種類。 |
event |
省略可。イベントを視聴できる URL。 |
event |
省略可。イベントをホストする主催者。 |
event |
省略可。イベントをホストする主催者の URL。 |
event |
省略可。主催者のタイプ。 |
event |
必須。イベント情報や説明を確認できるページの URL。 |
event |
省略可。イベントの状態。 |
brand |
省略可。ローカライズされたブランド名。 |
event |
省略可。イベントの作成者に関する情報。 |
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 を使用します。(省略可) |
entity |
エンティティのタイプ。(省略可) |
entity |
イベントでのエンティティの役割。(省略可) |
public |
エンティティの公開参照。(省略可) |
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 } |
フィールド | |
---|---|
relevant |
トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります(例: https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan)。(省略可) |
musicbrainz |
アーティストなどの音楽エンティティの 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 |
イベントは延期されています。 |
EventCreator
イベントの作成者に関する情報。ユーザー作成コンテンツ イベントを含むプラットフォームにのみ関連します。
JSON 表現 |
---|
{ "name": string } |
フィールド | |
---|---|
name |
省略可。イベント作成者の名前。文字の制限はありません。 |
IntegrationType
サポートされている統合の程度。
列挙型 | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
デフォルトは END_TO_END です。 |
INTEGRATION_TYPE_END_TO_END |
Google を通じてエンドツーエンドの予約を可能にする完全な統合。 |
INTEGRATION_TYPE_INVENTORY_ONLY |
予約サーバーはこのサービスをサポートする必要はありません。販売者、サービス、(省略可)空き情報データのみを送信する必要があります。 |
PerOrderFee
チケットの数に関係なく、注文ごとに 1 回支払う必要がある料金。
JSON 表現 |
---|
{ "deliveryFee": { object ( |
フィールド | |
---|---|
delivery |
配達方法によって異なる料金。 |
processing |
お客様のお支払い方法を処理するための料金。 |
ToursAndActivitiesContent
Tours と Activities に固有のコンテンツ フィールド。繰り返しフィールドの各要素は、独立したレンダリング(箇条書きなど)ができるように個々に設定する必要があります。
ツアーやアクティビティの場合、ToursAndActivitiesContent への入力は強くおすすめしますが、絶対必須条件ではありません。すべてのフィールドは、基本的な書式として、書式なしテキストと HTML に類似する形式のテキストの両方をサポートしています。サポートされている HTML に類似する形式の書式設定タグ:
フレーズタグ: <br>、<strong>、<em>、<italic> の 3 つのタグのみがサポートされています。
<br> を使用すると、段落の改行ができます。また、<strong>、<em>、<italic> を使用すると、重要なテキストをハイライト表示できます。
その他のフレーズタグは無視されます。
その他すべてのタグとカスタム スタイルは使用できず、削除されます。URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。
重要な注意事項: * highlights
、exclusion
など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。
JSON 表現 |
---|
{ "highlights": [ { object ( |
フィールド | |
---|---|
highlights[] |
ユーザーに表示される、強調したい点のリスト。 |
inclusions[] |
ユーザーに表示される内容物のリスト。 |
exclusions[] |
ユーザーに表示される除外物のリスト。 |
must |
ユーザーに表示される重要なメモのリスト。年齢制限など、このサービスが対象外となる条件の詳細情報に使用します。 |
場所
ビジネス拠点に関する地理情報。
JSON 表現 |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
フィールド | |
---|---|
place |
Google プレイス データベースと Google マップ上の場所の Place ID。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定すると、ビジネス拠点がこの場所とマッチングされます。 |
name |
ビジネス拠点の名前、電話番号、URL、地域は、そのビジネス拠点を Google マップにすでに表示されている場所とマッチングするために使用されます。 このフィールドは省略可能ですが、コンテキストによっては必須になる場合があります。たとえば、名前のない Service.location は、同じ住所にある場合でも、ビジネス エンティティには一致しません。(省略可) |
telephone |
国番号と市外局番を含む、ビジネス拠点の電話番号(例: +14567891234)。(省略可) |
url |
ビジネス拠点の公開ウェブサイトの URL。(省略可) |
geo |
ビジネス拠点の地理情報(緯度、経度、住所など)。(省略可) |
location |
ビジネス拠点のタイプ。このビジネス拠点が Service に指定されている場合は指定する必要があります。 |
location |
サービス内のビジネス拠点の一意の参照。この 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 がゼロの場合にのみ省略できます。 |
number |
値の計算に使用される評価の数(必須)。 |
HomeServiceData
ホームサービス業種で提供が求められる追加情報。
JSON 表現 |
---|
{ "categoryType": string, "jobType": string } |
フィールド | |
---|---|
category |
このホームサービスが属する大まかなカテゴリ。例: 配管工、電気工など |
job |
指定されたホームサービスが属するカテゴリ内のジョブタイプ。たとえば、plumber カテゴリには、unclog_drain や install_faucet などのジョブタイプがあります。 |
VirtualSession
バーチャル/オンライン セッションに関する情報。例: オンライン ヨガ教室、バーチャル料理教室など
JSON 表現 |
---|
{ "sessionInstructions": { object ( |
フィールド | |
---|---|
session |
このバーチャル クラスを設定する手順。パートナーが予約に動画の URL を含めない場合は、動画の URL がユーザーと共有されるタイミングをこのテキストに含める必要があります。例: 「Zoom の URL はクラスの 30 分前にメールでお送りします」 |
session |
特定の仮想セッションの要件。例: ヨガマット、調理器具など(推奨) |
virtual |
このセッションで使用される仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
is |
必須。バーチャル セッションがライブではなく事前録画されている場合は、true に設定します。 |
VirtualPlatformInfo
このバーチャル セッションで使用するプラットフォームに関する情報。
JSON 表現 |
---|
{ "platform": enum ( |
フィールド | |
---|---|
platform |
仮想セッションに使用されるプラットフォーム。 |
other |
プラットフォームが [OTHER] に設定されている場合のプラットフォームの名前。(プラットフォームが [OTHER] に設定されている場合必須) |
プラットフォーム
販売者が使用する仮想プラットフォームを示す列挙型。
列挙型 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、使用する動画プラットフォームを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
Google ハングアウト サービス。 |
GOOGLE_MEET |
Google Meet サービス。 |
ZOOM |
Zoom Video Communications。 |
SKYPE |
Skype。 |
YOUTUBE |
YouTube でのライブ配信。 |
OTHER |
使用している動画プラットフォームがここで説明されているものと異なる場合は、設定する必要があります。 |
DirectMerchantPayment
ユーザーが RwG でサービスの前払いを行うのではなく、販売者に直接支払う方法に関する情報。
JSON 表現 |
---|
{
"paymentMethods": [
{
object ( |
フィールド | |
---|---|
payment |
お客様には、以下のお支払い方法のみを使用して支払うことをおすすめします。 |
UriTemplate
外部サイトへの URL の生成方法を指定するテンプレート。
JSON 表現 |
---|
{ "uriTemplate": string } |
フィールド | |
---|---|
uri |
省略可。URI テンプレートは RFC6570 に準拠している必要があります。https://datatracker.ietf.org/doc/html/rfc6570 をご覧ください。レベル 2 テンプレートをサポートしています。これらのパラメータは、それぞれのエンティティで指定された値に解決されます。 レストラン予約のリンクアウトで使用できるパラメータは 5 つあります。1)(必須){availability_slot_start_seconds} :: 空き状況フィード内の startSec フィールドから入力されます 2)(必須){availability_slot_duration_seconds} :: 空き状況フィード内の durationSec フィールドから入力されます 3)(省略可){resources_party_size} :: 空き状況フィード内の partySize フィールドから入力されます 4)(省略可){availability_availability_tag} :: 空き状況フィード内の availabilityTag フィールドから入力されます 5)(省略可){resources_room_id} :: 空き状況フィード内の roomId フィールドから入力されます 使用例: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
メソッド |
|
---|---|
|
指定されたアグリゲータによって管理されている販売者の新しい Service を作成して返します。 |
|
指定されたアグリゲータによって管理されている販売者の既存の Service を削除します。 |
|
指定されたアグリゲータによって管理されている販売者の既存の Service を更新して返します。 |