REST Resource: inventory.partners.merchants.services

リソース: Service

販売者が提供しているサービス(ヘアカットなど)に関する情報。

JSON 表現
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  }
}
フィールド
name

string

サービス リソース名。partners/{partner_id}/merchants/{merchantId}/services/{serviceId} の形式です。

serviceName

string

サービスの名前(例: 「メンズ ヘアカット」)。非推奨です。代わりに localizedServiceName を使用してください。

localizedServiceName

object (Text)

サービスの名前(例: 「メンズ ヘアカット」)。複数の言語 / 地域で発生する可能性があります。

description

string

ユーザーに表示される、サービスの説明。非推奨です。代わりに localizedDescription を使用してください。

localizedDescription

object (Text)

ユーザーに表示される、サービスの説明。

このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。

サポートされている HTML に類似する形式の書式設定タグ:

見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6>
見出しタグはタイトルとサブタイトルの表示に使用できます。たとえば、「<h1>旅行プラン</h1>」と入力すると、セクションの最も重要な見出しとしてインライン テキストが表示されます。なお、内部 HTML タグ、スタイル、属性は無視されます。たとえば、<h1 style=".."> は <h1> と同様に扱われ、書式なしテキストのみが保持されます。

段落タグ: <p>
段落タグを使用して、詳細な紹介やコンテンツを強調できます。内部タグ、スタイル、属性はすべて無視されます(例外: <br>、<strong>、<em>)。詳しくは、下記のフレーズタグのセクションをご覧ください。

リストタグ: <ul>、<ol>、<li>
<ul> タグを <li> タグとともに使用して、順序なしリストを表示できます。また、<ol> タグを <li> タグとともに使用して、順序付きリストを表示できます。チェックリスト、スケジュールなど、使用方法に合ったリストを表示するのに適しています。
例: クルーズ旅行の特徴の一覧を表示する場合:
<ol>
<li>素晴らしい海の景色と野生動物との遊び</li>
<li>入念なデザインの旅行の手配とサービス。</li>
<li>最低価格が保証されます。</li>
</ol>
<li> <ul> または <ul> 未満の子供のみが変換されます。他のすべての子タグは削除されます。また、内部タグ、属性、スタイルはすべて無視されます。保持されるのは、書式なしテキスト コンテンツのみです。

分割タグ: <div>
<div> タグのサポートされているすべての内部タグは、上記のルールで解析されます。ここで、<div> タグ自体はグループ化やインデント化を意味しません。また、内部属性とスタイルはすべて無視されます。

フレーズタグ: <br>、<strong>、<em>:
上記 3 つのタグのみがサポートされています。<br> を使用すると、段落の改行ができます。また、<strong> または <em> を使用すると、重要なテキストをハイライト表示できます。その他のフレーズタグは無視されます。

サポートされていないタグ:

  • <html>、<header>、<body> タグは使用できません。
  • 上記以外のタグ(<table>、<td> など)はサポートされません。
    URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。ユーザー エクスペリエンスを豊かにするために写真を使用する場合は、下の「relatedMedia」フィールドを使用して写真の URL を送信してください。

注意事項:

  • 上記のサポートされているタグ以外は使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスが低下する可能性があります。
  • 3 つを超える見出しレベルやネストされたリストなど、ネスト構造をあまり深くしないでください。浅くシンプルで単純な構造にすることで、ユーザーエクスペリエンスが向上します。
  • 現在サポートされているレイアウトではお客様の使用方法に適さない場合は、「Google で予約」チームにお問い合わせください。
  • 推奨される最大サイズは半角 32,000 文字(全角 16,000 文字)です。
price

object (Price)

サービスの料金。

priceInterpretation

enum (PriceInterpretation)

価格を解釈してユーザーに表示する方法について説明します。「レストラン」と「おすすめスポット」以外のすべてのカテゴリで、サービス料金の表示を設定できます。

rules

object (SchedulingRules)

予約やキャンセルのルール。

prepaymentType

enum (PrepaymentType)

前払いが必須、任意、またはサポート対象外

prepaymentTerms

object (PrepaymentTerms)

前払いの完了に関する条件。

form[]
(deprecated)

object (ServiceIntakeForm)

非推奨です。intakeForm と perTicketIntakeForm を使用してください。

intakeForm

object (ServiceIntakeForm)

このサービスの予約時にユーザーに追加情報を尋ねるフォーム。(省略可)

perTicketIntakeForm

object (ServiceIntakeForm)

このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。(省略可)

taxRate

object (TaxRate)

サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された taxRate をオーバーライドします。メッセージが空の場合(taxRate { } など)、適用される税率はゼロにリセットされます。

paymentOptionId[]

string

このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。

deposit

object (Deposit)

ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。(省略可)

noShowFee

object (NoShowFee)

ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。(省略可)

requireCreditCard

enum (RequireCreditCard)

このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。(省略可)

type

enum (ServiceType)

このサービスの事前定義されたタイプ。(省略可)

ticketType[]

object (TicketType)

チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。(省略可)

relatedMedia[]

object (RelatedMedia)

このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。(省略可)

serviceAttributeValueId[]

object (ServiceAttributeValueId)

このサービスに適用される Service 属性値(省略可)。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。(省略可)

waitlistRules

object (WaitlistRules)

順番待ちリストに登録するためのルール

ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

イベント チケット販売業種に固有の追加情報。(省略可)

integrationType

enum (IntegrationType)

このサービスでサポートされる統合の程度。(省略可)試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンドでは常に無効になります。

perOrderFee

object (PerOrderFee)

このサービスを購入するための注文レベルの料金。(省略可)

toursAndActivitiesContent

object (ToursAndActivitiesContent)

Tours と Activities に固有のコンテンツ フィールド。

location[]

object (Location)

このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、会議の場所を指定する必要があります。

rating

object (Rating)

このサービスに対するユーザー評価(すべてのレビューの集計指標)。

homeServiceData

object (HomeServiceData)

ホームサービスの業種に固有の追加情報。(省略可)

virtualSession

object (VirtualSession)

(省略可)仮想セッションに関する情報。仮想サービスを有効にするために必要です。

directMerchantPayment

object (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 (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
フィールド
minAdvanceOnlineCanceling

string (int64 format)

予約をオンラインでキャンセルするために必要な最小事前通知期間(秒単位)。(省略可)

lateCancellationFee
(deprecated)

object (Price)

最小事前通知期間内のキャンセル料。

noshowFee
(deprecated)

object (Price)

無断キャンセル料。

admissionPolicy

enum (AdmissionPolicy)

このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。(省略可)

cancellationPolicy

object (CancellationPolicy)

キャンセル ポリシーのスケジュール設定ルール。(おすすめスポットでは必須)

共用体フィールド min_booking_buffer。最終予約が可能な時間から予約枠の開始時刻または終了時刻までの期間(秒単位)。

「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 時間前までに予約する必要がある美容院: 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • 閉館 30 分前まで最終チケットを購入できる博物館: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • 開始時刻より前に購入する必要がある映画チケット: 'scheduling_rules{ ...}'(このフィールドを空にします)(省略可)min_booking_buffer は次のいずれかが可能です。

minAdvanceBooking

string (int64 format)

最後の予約が可能になってから予約枠が開始するまでの時間(秒単位)。

minBookingBufferBeforeEndTime

string (int64 format)

最終予約可能時間から予約枠の終了時刻までの期間(秒単位)。 このフィールドが設定されている場合、「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)
    }
  ]
}
フィールド
refundCondition[]

object (RefundCondition)

ポリシーに適用される 0 個以上の払い戻し条件。

RefundCondition

単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。

JSON 表現
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
フィールド
minDurationBeforeStartTime

string (Duration format)

開始時刻までの期間。顧客は、この時刻まで refundPercent で指定されたサービス価格の一部の払い戻しを受け取ることができます。0(デフォルト)に設定すると、サービスはいつでもキャンセルできます。

s」で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

refundPercent

integer (uint32 format)

サービス開始時刻の minDurationBeforeStartTime 以前にサービス予約がキャンセルされる限り、払い戻し可能な金額の割合([0, 100] の範囲)。0(デフォルト)に設定すると、サービスは払い戻しできません。100 に設定すると、このサービスの全額払い戻しが可能になります。

PrepaymentType

前払いのタイプを示す列挙型。

列挙型
PREPAYMENT_TYPE_UNSPECIFIED デフォルトでは、前払いは NOT_SUPPORTED とみなされます。
REQUIRED ユーザーは予約時にこのサービスの支払いを行う必要があります。
OPTIONAL ユーザーは予約時または予約後にこのサービスの前払いを行うことができますが、必須ではありません。
NOT_SUPPORTED このサービスでは前払いがサポートされていません。

PrepaymentTerms

前払いが完了したタイミングに関する具体的な情報。

JSON 表現
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
フィールド
chargeTiming

enum (ChargeTiming)

請求が発生するタイミング。購入日時に対して相対的な料金が発生するか。

chargeTimeBeforeStartTimeSec

string (int64 format)

ユーザーに料金の請求が行われるサービス開始時刻までの秒数。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。

ChargeTiming

購入時刻を基準に請求が発生するタイミングを列挙する列挙型です。

列挙型
CHARGE_TIMING_UNSPECIFIED 未使用。
CHARGE_NOW お客様への請求は直ちに行われます。
CHARGE_LATER 後ほどお客様に請求が行われます。

ServiceIntakeForm

販売者が提供するサービスをカスタマイズするインテイク フォームを定義します。

JSON 表現
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
フィールド
field[]

object (ServiceIntakeFormField)

ユーザーに表示されるフィールド。

firstTimeCustomers
(deprecated)

boolean

true の場合、このフォームは初めての顧客に表示されます。非推奨。この機能はインテイク フォームではサポートされていません。

returningCustomers
(deprecated)

boolean

true の場合、このフォームはリピーターに表示されます。非推奨。この機能はインテイク フォームではサポートされていません。

ServiceIntakeFormField

ServiceIntainForm に含まれるフィールドを定義します。

JSON 表現
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
フィールド
id

string

フォーム フィールドを一意に識別するアグリゲータ パートナーからの文字列。この ID は、対応するフォーム フィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイク フォームの両方で一意である必要があります。(必須)

type

enum (FieldType)

このフィールドの型。

label

string

ユーザーに表示される、このフィールドのテキスト。非推奨です。代わりに localizedLabel を使用してください。

localizedLabel

object (Text)

ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。(必須)

value[]

string

フィールド タイプが LOCATION_SEARCH の場合にのみ設定します。「location」フィールドの「locationId」を使用して場所の値を指定してください。

choiceText[]

object (Text)

フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用します。

isRequired

boolean

このフィールドに対する回答がユーザーに必須であるかどうかを示します。

allowCustomAnswer

boolean

事前定義された回答に加えて、カスタム値が許可されているかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可)

additionalOption[]

object (Text)

指定された値に加えて、追加のオプションが提供されます。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、指定した場所のリストのほかに、「後でサプライヤーに連絡します」などのオプションを使用することもできます。(省略可)

ticketTypeRestrict[]

string

ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に当てはまる場合は、フィールドを空欄にしてください。

hint

object (Text)

入力のヒントテキスト。テキストのプレースホルダとして表示されます。これは、フィールド タイプが SHORT_ANSWER または 段落である場合にのみ適用されます。(省略可)

FieldType

フィールドのタイプを示す列挙型。

列挙型
FIELD_TYPE_UNSPECIFIED 未指定または不明なタイプのフィールドは無視されます。
SHORT_ANSWER テキスト用の 1 行の入力フィールド。
PARAGRAPH テキスト用の複数行の入力フィールド。
MULTIPLE_CHOICE 多数のオプションから 1 つを選択する必要があるラジオボタンのセット。
CHECKBOXES チェックボックス付きの 1 つ以上の列挙型項目。
DROPDOWN プルダウンからの選択。
BOOLEAN はい / いいえボタン。

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 (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
フィールド
ticketTypeId

string

チケット ID は、同じサービスの異なるチケットタイプを区別するために使用され、サービス内で一意であることが想定されます。

shortDescription

string

この TicketType の簡単な説明。

これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localizedShortDescription を使用してください。

localizedShortDescription

object (Text)

i18n をサポートするこの TicketType の簡単な説明。

これはユーザーに表示されます(「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。

price

object (Price)

このタイプのチケット 1 枚の価格(税抜き)。Service の税率はチケットに適用されます。

perTicketFee

object (PerTicketFee)

このチケットを購入するための追加料金。(省略可)

optionDescription

string

このチケットタイプが表す追加オプションの説明(ある場合)。非推奨です。代わりに localizedOptionDescription を使用してください。

localizedOptionDescription

object (Text)

このチケットタイプが表す追加オプションの説明(ある場合)。言語 / 地域ごとに別々の値を指定できます。

追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。

例 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 (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
フィールド
serviceCharge

object (Price)

サービスに対して課せられる追加料金。

facilityFee

object (Price)

会場または施設に支払う料金。

taxes

object (Price)

チケット 1 件あたりの税金。

RelatedMedia

このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。(省略可)

JSON 表現
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
フィールド
url

string

このメディアソースの URL。Google はこの URL でホストされているメディアをクロールします。

type

enum (MediaType)

このメディアソースのタイプ。

localizedCaption

object (Text)

i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。(省略可)

attribution

object (Attribution)

メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。(省略可)

caption
(deprecated)

string

非推奨。localizedCaption を使用することをおすすめします。

MediaType

このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。

列挙型
TYPE_UNSPECIFIED 未使用。
PHOTO URL で提供されるメディアが写真であることを示します。

帰属

このメディアの権利帰属情報。

JSON 表現
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
フィールド
localizedText

object (Text)

i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドには書式なしテキストのみがサポートされ、HTML コンポーネントは削除されます(ハイパーリンク ベースの帰属表示はサポートされていません)。

text
(deprecated)

string

非推奨。localizedText を使用することをおすすめします。

ServiceAttributeValueId

Service に適用されるサービス属性の特定の値を識別します。

JSON 表現
{
  "attributeId": string,
  "valueId": string
}
フィールド
attributeId

string

Merchant.service_attribute で定義されている属性の ID(「service-type」など)。

valueId

string

この属性の値の ID(「haircut」など)。サービス属性定義の valueId と一致する必要があります。

WaitlistRules

順番待ちリストへの参入に関連するルール。

JSON 表現
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
フィールド
minPartySize

integer

必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者がウェイティング リスト機能を提供していない場合は、このフィールドに入力しないでください。

maxPartySize

integer

必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者がウェイティング リスト機能を提供していない場合は、このフィールドに入力しないでください。

supportsAdditionalRequest

boolean

true の場合、ユーザーはこのサービスの順番待ちリストに登録する際に、自由形式の追加テキスト リクエストを送信できます。

aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

maxPartySize よりも大きいサイズのグループに対してオプションを設定する。人数の多い参加者に対して順番待ちリストに登録するための代替オプションを提供しない場合は、空欄のままにします。

UnsupportedPartySizeOption

通信範囲外のパーティに利用できるオプション。

JSON 表現
{
  "callMerchant": {
    object (CallMerchant)
  }
}
フィールド
callMerchant

object (CallMerchant)

範囲外の人数の場合は、ビジネスに電話をかけることができます。定義済みのメッセージがユーザーに表示されます。表示されるサンプル テキスト: 「{waitlistRules.max_party_size} を超える人数の場合は、レストラン {phone} にお電話ください。」CallMerchant を設定する必要がありますが、空になります。

CallMerchant

UnsupportedPartySizeOption で使用されるメッセージが空です。この設定により、ユーザーは予約のためにビジネスに電話するオプションを表示できます。

TicketingVerticalSpecificData

イベント チケット販売業種に固有の追加情報。

JSON 表現
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState)
}
フィールド
eventCategory

enum (EventCategory)

イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。(省略可)

eventUrl

string

パートナーのウェブサイトに掲載されているイベントの URL。(省略可)

entity[]

object (Entity)

イベントに関連するエンティティのリスト。(省略可)

eventAttendanceMode

enum (AttendanceMode)

必須。イベントへの参加のタイプ。

eventVirtualLocationUrl[]

string

(省略可)イベントを視聴できます。

eventOrganizer

object (Text)

(省略可)イベントを主催する主催者。

eventOrganizerUrl

string

(省略可)予定を主催する主催者の URL。

eventOrganizerType

enum (OrganizerType)

(省略可)主催者のタイプ。

eventSourceUrl[]

string

必須。イベントの情報や説明を確認できるページの URL。

eventState

enum (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 (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
フィールド
id

string

パートナーのデータベースにあるエンティティの一意の識別子。(省略可)

name

string

エンティティの名前。(必須)

url

string

エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページです(ある場合)。エンティティのその他の公開 URL は、publicIdentificationData の relevantUrl を使用します。(省略可)

entityType

enum (EntityType)

エンティティのタイプ。(省略可)

entityRole

enum (EntityRole)

イベントでのエンティティの役割。(省略可)

publicIdentificationData

object (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[]

string

トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります(例: https://www.discogs.com/artist/1124645-Taylor-Swifthttps://www.wikidata.org/wiki/Q19320959https://twitter.com/acmilan)。(省略可)

musicbrainzId

string

アーティストなどの音楽エンティティの 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 (Price)
  },
  "processingFee": {
    object (Price)
  }
}
フィールド
deliveryFee

object (Price)

配送方法によって異なる料金。

processingFee

object (Price)

ユーザーのお支払い方法を処理するための手数料。

ToursAndActivitiesContent

Tours と Activities に固有のコンテンツ フィールド。繰り返しフィールドの各要素は、独立したレンダリング(箇条書きなど)ができるように個々に設定する必要があります。

ツアーやアクティビティの場合、ToursAndActivitiesContent への入力は強くおすすめしますが、絶対必須条件ではありません。すべてのフィールドは、基本的な書式として、書式なしテキストと HTML に類似する形式のテキストの両方をサポートしています。サポートされている HTML に類似する形式の書式設定タグ:

フレーズタグ: <br>、<strong>、<em>、<italic> の 3 つのタグのみがサポートされています。
<br> を使用すると、段落の改行ができます。また、<strong>、<em>、<italic> を使用すると、重要なテキストをハイライト表示できます。
その他のフレーズタグは無視されます。

その他すべてのタグとカスタム スタイルは使用できず、削除されます。URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。

重要な注意事項: * highlightsexclusion など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。

JSON 表現
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
フィールド
highlights[]

object (Text)

ユーザーに表示されるハイライトのリスト。

inclusions[]

object (Text)

ユーザーに表示される包含リスト。

exclusions[]

object (Text)

ユーザーに表示される除外リスト。

mustKnow[]

object (Text)

ユーザーに表示される重要なメモのリスト。年齢制限など、このサービスが不適切となる条件の詳細に使用します。

ロケーション

ビジネス拠点に関する地理情報。

JSON 表現
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
フィールド
placeId

string

Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定すると、場所とこの場所が照合されます。

name

string

場所の名前、電話番号、URL、地域は、その場所を Google マップ上にすでにある場所と照合するために使用されます。

このフィールドは省略可能ですが、状況によっては必須の場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、ビジネス エンティティには一致しません。(省略可)

telephone

string

国番号と市外局番を含む、ビジネス拠点の電話番号(例: +14567891234)。(省略可)

url

string

ビジネス拠点の公開ウェブサイトの URL。(省略可)

geo

object (GeoCoordinates)

ビジネス拠点の地理情報(緯度、経度、住所など)。(省略可)

locationType

enum (LocationType)

場所のタイプ。この場所が Service に指定されている場合は指定する必要があります。

locationId

string

サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービス フィールドでこのビジネス拠点を参照できます。たとえば、カスタム登録フォームでは、一連の場所 ID を使用して乗車場所のオプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。(省略可)

LocationType

このビジネス拠点のタイプ。

列挙型
LOCATION_TYPE_UNSPECIFIED ビジネス拠点タイプが指定されていません。
VISITED_LOCATION このサービスで訪れる場所。
START_LOCATION このサービスが開始する場所。MEETING_LOCATION としても機能します。
END_LOCATION このサービスが終了する場所。

Rating

エンティティの評価を定義します。

JSON 表現
{
  "value": number,
  "numberOfRatings": string
}
フィールド
value

number

平均評価値(numberOfRatings > 0 の場合は必須)。値は [1, 5] の範囲内で指定する必要があります。また、numberOfRatings が 0 の場合にのみ省略できます。

numberOfRatings

string

値の計算に使用される評価の数(必須)。

HomeServiceData

ホームサービス カテゴリでは追加情報を提供する必要があります。

JSON 表現
{
  "categoryType": string,
  "jobType": string
}
フィールド
categoryType

string

このホームサービスが属する大まかなカテゴリ。例: 配管工、電気技師など

jobType

string

特定のホームサービスが属するカテゴリの職務タイプ。たとえば、配管工の業種のジョブタイプは unclog_drain、install_faucet です。

VirtualSession

仮想/オンライン セッションに関する情報。例: オンラインのヨガクラス、バーチャル料理教室など

JSON 表現
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
フィールド
sessionInstructions

object (Text)

この仮想クラスを設定する方法。予約に動画の URL が含まれていない場合は、動画の URL をユーザーにいつ共有するかをこのテキストに含める必要があります。(「Zoom の URL は講義の 30 分前に郵送されます。」(推奨)

sessionRequirements

object (Text)

該当の仮想セッションの要件。例: ヨガマット、調理器具など(推奨)

virtualPlatformInfo

object (VirtualPlatformInfo)

このセッションで使用される仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要)

isSessionPrerecorded

boolean

必須。仮想セッションがライブではなく、事前に録画されている場合は、これを true に設定します。

VirtualPlatformInfo

この仮想セッションで使用するプラットフォームに関する情報。

JSON 表現
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
フィールド
platform

enum (Platform)

仮想セッションに使用されるプラットフォーム。

otherPlatformName

object (Text)

プラットフォームが OTHER に設定されている場合のプラットフォームの名前。(プラットフォームが OTHER に設定されている場合は必須)

プラットフォーム

販売者がどの仮想プラットフォームを使用するかを示す列挙型。

列挙型
PLATFORM_UNSPECIFIED 未使用。
FLEXIBLE 販売者は、使用する動画プラットフォームを柔軟に選択できます。
GOOGLE_HANGOUTS Google ハングアウト サービス。
GOOGLE_MEET
ZOOM Zoom Video Communications、
SKYPE Skype。
YOUTUBE YouTube でのライブ配信。
OTHER 使用する動画プラットフォームがここに記載されているものと異なる場合は設定する必要があります。

DirectMerchantPayment

ユーザーが RwG を介してサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。

JSON 表現
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
フィールド
paymentMethods[]

object (Text)

お客様には、以下に記載のお支払い方法でのみお支払いいただくようご案内してください。

Methods

create

指定されたアグリゲータによって管理されている販売者の新しい Service を作成して返します。

delete

指定されたアグリゲータが管理する販売者の既存の Service を削除します。

patch

指定されたアグリゲータによって管理されている販売者の既存の Service を更新して返します。