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> 歳未満の子供または <ol>タグが変換されます。他のすべての子タグは削除されます。また、内部タグ、属性、スタイルはすべて無視されます。保持されるのは、書式なしテキスト コンテンツのみです。

分割タグ: <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 { })は、適用される税率を 0 にリセットします。

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)

ツアーとアクティビティに固有のコンテンツ フィールド。

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 つの値のみが選択され、もう 1 つの値は無視されるため、どちらの値が選択されるかを正確に予測することはできません。

例:

  • 開始時刻の 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 の場合にのみ設定します。「locationId」を使用してください対象の「location」ロケーションの値を指定します。

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 または Colab の場合に限られます。(省略可)

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 で提供されるメディアが写真であることを示します。

Attribution

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

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

省略可。イベントを視聴できる URL。

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 ワークショップとクラス。

Entity

イベントに関連するエンティティを表します。

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 をご覧ください。指定されている場合、Google は場所とこの場所を照合します。

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 をユーザーと共有するタイミングをこのテキストに含める必要があります。例: 「講義の 30 分前に Zoom の URL をメールでお送りします」(推奨)

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_MEET
ZOOM Zoom Video Communications.
SKYPE Skype。
YOUTUBE YouTube でのライブ配信。
OTHER 使用する動画プラットフォームがここに示されているプラットフォームと異なる場合は設定する必要があります。

DirectMerchantPayment

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

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

object (Text)

お支払いには、下記のお支払い方法のみをおすすめします。

メソッド

create

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

delete

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

patch

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