Package google.maps.booking.v1alpha

string

このアクション リンクのエントリポイント URL。

string

この URI のコンテンツを利用できる言語を識別する BCP-47 言語タグ。

string

ISO 3166-1 alpha-2 の国コード。表示を制限しない場合は空のままにします。

ActionPlatform

このアクションを実行するプラットフォーム。このフィールドが設定されていない場合は、代替として ACTION_PLATFORM_WEB_APPLICATION が使用されます。

ActionLinkType

事前定義されたアクションのタイプ。

OrderOnlineMetadata

オンライン注文リンクのメタデータ。ActionLinkType が ACTION_LINK_TYPE_SHOP_ONLINE のアクションをサポートします。

FoodOrderingMetadata

料理の注文リンクのメタデータ。サポートされているアクション タイプ: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT ACTION_LINK_TYPE_ORDER_FOOD はサポートされていません。

EventMetadata

イベント カテゴリに固有のアクション リンクに関する追加情報。

Surface

アクション リンクに関連付けられている事前定義済みのイベント サーフェス。これはイベント カテゴリでのみ使用されます。

string

ID。AdsAccountLink のリソース名。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

string

必須。Google 広告アカウントにリンクする広告枠アイテム ID のリスト。

State

出力専用。Google 広告アカウントのリンクの状態。

Text

「Google で予約」で予約する際にユーザーに表示されるカスタム メッセージ。

Timestamp

予約スロットの開始時刻。

Duration

予約枠の期間

int64

この予約枠の合計スポット数と空きスポット数。例:

• 10 個のスポットがあるヨガクラスで 3 個が予約済みの場合: availability {spots_total: 10, spots_open: 7 ...}
• チェア マッサージの 1 回の施術が完全に予約済みの場合: availability {spots_total: 1, spots_open: 0 ...}

注: 以下で定義されている空き状況の圧縮形式を使用してリクエストを送信すると、これら 2 つのフィールドが推定されます。

• Recurrence では、spots_total=1 と spots_open=1 が推定されます。
• ScheduleException では、spots_total=1 と spots_open=0 が推定されます。

int64

空きスポットの数。

string

この予約枠を識別するための不透明型文字列（省略可）。設定すると、予約の予約、更新、キャンセルのリクエストに含まれます。

Resources

異なるスタッフや部屋がサービスに含まれている場合に、個々の予約枠を区別するために使用されるリソース（省略可）。

たとえば、1 つのヨガクラスに 2 人のインストラクターがいる場合:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

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

このフィールドは、サービス メッセージで指定された payment_option_id をオーバーライドします。同様に、ここで指定された payment_option_id はサービス メッセージに存在する必要はありませんが、Merchant レベルで定義する必要があります。

Recurrence

空き状況の繰り返しに関する情報で、複数の開始時刻を表します。繰り返しには、1 営業日の予約を含める必要があります。

ScheduleException

このサービスをスケジュールできない時間。schedule_exception メッセージの数を制限するには、隣接する例外を結合することを検討してください。

Deposit

この空き情報の保証料（省略可）。サービス デポジットが指定されている場合は、オーバーライドします。

NoShowFee

この空き状況用の無断キャンセル料（省略可）。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。

Prepayment

省略可。この空き情報に関する前払い情報（省略可）。

RequireCreditCard

この予約枠を予約するために、ユーザがクレジット カードを提供する必要があるかどうかを示します。値が設定されていない場合、サービスレベルから値が継承されます（設定されている場合）。（省略可）

string

この空き状況スロットでサポートされているチケットタイプのリストを示します。設定されていない場合、親サービスのすべてのチケットタイプをこのスロットで使用できます。なお、このフィールドの値は親サービスで定義する必要があります。たとえば、次のように定義します。

• 4 つのチケットタイプがあるサービスの場合: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

平日の空き情報を表す場合: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}。休日の空き情報を表す場合: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}。

• 3 つのチケットタイプがあるサービスの場合: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

この時間枠で 3 つのチケットタイプすべてを使用できることを示すには、availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} または availability {...} を使用します（この予約枠に ticket_type_id は設定しないでください）。

（省略可）

DurationRequirement

スロットの期間や終了時間を表示するための要件。時間枠が利用できない場合、このフィールドは無視されます。おすすめスポットのカテゴリでは使用されません。（省略可）

SchedulingRuleOverrides

空き状況のスケジュール設定ルール。フィールドに値が入力されている場合は、サービスレベルの SchedulingRules 上の対応するスケジュール設定ルールをオーバーライドします。

ConfirmationMode

この空き状況の予約時に使用される確認モード。CONFIRMATION_MODE_SYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に確認または拒否されます。確認モードが CONFIRMATION_MODE_ASYNCHRONOUS の予約を作成しようとすると、すぐに拒否するか、ステータスが PENDING として作成する必要があります。

LinkoutRequiredReason

省略可。このスロットにリンクアウトが必要な理由。設定する場合は、このスロットの Merchant リソースに有効な LinkoutTemplate が必要です。（省略可）

Timestamp

空き状況が繰り返される最終時間として含める UTC タイムスタンプ。

Duration

後続の予約枠との間隔を定義します。

例: duration が 20 分、repeat_every が 30 分、start_time が午前 9:00、repeat_until が午前 11:00 の空き情報は、午前 9:00～9:20、午前 9:30～9:50、午前 10:00～10:20、午前 10:30～10:50、午前 11:00～11:20 となります。（必須）

TimeRange

例外の時間帯。繰り返しで記述された予約枠内で、例外の時間帯（左閉右開）が重複する時間帯は、利用不可と見なされます。

例: duration が 20 分、repeat_every が 30 分、start_time が午前 9:00、repeat_until が午前 11:00 で繰り返しが指定され、time_range が午前 9:45～11:00 で ScheduleException が指定されている場合、午前 9:30～9:50、午前 10:00～10:20、午前 10:30～10:50 は利用できません。

例外の時間帯は左閉右開であるため、午前 11:00 から始まる予約枠は影響を受けません。

int64

この予約枠を予約できる最終時間（秒）。このタイムスタンプは、遵守されるべき予約枠の start_sec より前にくる必要があります（ユーザーが開始時刻を過ぎてから予約できる場合は、サービスレベルで SchedulingRules.min_booking_before_end_time を使用します）。この要素が存在する場合、対応する Service の SchedulingRules の min_booking_buffer で指定された値をオーバーライドします。

int64

この予約枠を予約できる開始時刻（秒）。このタイムスタンプは、スロットの start_sec より前にする必要があります。指定する場合は last_bookable_sec より前にする必要があります。

int64

設定されている場合、この特定の予約スロットを Google で予約する際にキャンセルできる最終時間（Unix エポックからの秒数）。このフィールドは、サービスレベルのキャンセル ルールをオーバーライドします。（省略可）

string

リソース名（形式: - partners/{partner_id}/feeds/{feed_name}）。

GenericDeleteRecord

削除するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。

string

リソース名（形式: - partners/{partner_id}/feeds/{feed_name}）。

GenericRecord

挿入または更新するレコード。1 回の API 呼び出しで許可されるレコードは最大 1,000 件です。

string

partners/{partner_id} の形式。

ExtendedServiceAvailability

既存の予約枠を置き換えるために使用される、サービスの延長された可用性。

ExtendedServiceAvailability

既存の予約枠を置き換えるために使用された、延長サービスの更新済み空き情報メッセージ。

string

予約のリソース名: partners/{partner ID}/bookings/{booking ID}

string

予約枠の販売者 ID

string

販売者サービスの ID

Timestamp

予約枠の開始時刻

Duration

予約枠の期間

ClientInformation

予約を取るクライアントの個人情報

BookingStatus

予約のステータス

PaymentInformation

予約に関連する支払い取引に関する情報。

int64

予約の人数

Cause

予約が失敗した理由。（必須）

CreditCardType

（原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合のみ必須）

string

パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。（省略可）

PaymentFailureInformation

支払いのエラーに関する情報。

ThreeDS1Parameters

ユーザーとの 3DS1 認証プロトコルを開始するために、RwG アグリゲータによって使用されるパラメータ。BookingFailure.cause が PAYMENT_REQUIRES_3DS1 に設定されていない限り、無視されます。

string

認証のためにユーザーに提示するフォームの読み込み元となる URL。

string

PaymentAuthentication リクエスト。指定されている場合は ACSUrl フォームに投稿されます。

string

ACS プロバイダにより使用される識別子。ACSUrl フォームに送信されます（指定されている場合）。

string

販売者データ。ACSUrl フォームに送信されます（指定されている場合）。

RefundCondition

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

Duration

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

uint32

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

string

お客様の名

string

顧客の姓

PostalAddress

クライアントの住所

string

クライアントの電話番号

string

クライアントのメールアドレス

string

必須。この広告アカウントのリンクが作成される親リソース。パートナー センター アカウント ID と同じです。形式: partners/{partner}

string

必須。Google 広告アカウントのリンクに使用する ID。これは Google 広告のお客様 ID と同じです。詳しくは、https://support.google.com/google-ads/answer/1704344 形式 : xxx-xxx-xxxx をご覧ください。

AdsAccountLink

必須。作成する AdsAccountLink。

string

この販売者を所有するパートナーの親リソース名。partners/{partner_id} の形式で指定します。

string

この販売者に使用する販売者 ID。

Merchant

作成する販売者。

string

このサービスを所有する販売者の親リソース名。partners/{partner_id}/merchants/{merchant_id} の形式で指定します。

string

このサービスに使用するサービス ID。

Service

作成するサービス。

CreditCardType

サポートされているクレジット カードのリスト。空白の場合、クレジット カードはサポートされません。

string

必須。削除する AdsAccountLink の名前。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

string

削除する販売者のリソース名形式は Partners/{partner_id}/merchants/{merchant_id} です。

string

削除するサービスのリソース名partners/{partner_id}/merchants/{merchant_id}/services/{service_id} の形式

Price

デポジットの金額。

int64

保証料払い戻しのための最低事前キャンセル時間。

PriceType

在庫状況から保証料をどのように決定するかを定義します。

Text

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

Duration

最小期間。

Duration

最大時間。

Text

必須。経済事業者の名前、住所、電話番号、メールアドレス。製造者、正式な代表者、輸入業者、流通業者、納品サービス プロバイダ、または製品の製造、販売、サービスの提供に関連する義務を負うその他の自然人または法人。economic_operator の自由形式の文字列表現。この情報は、」および "\n".

string

これは、以下の空き情報メッセージが属する販売者を指定するための必須フィールドです。

string

以下の空き情報メッセージが属するサービスを指定するために必要なフィールドです。

Timestamp

指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

duration メッセージが設定されている場合、条件はさらに制限されます。

  availability.duration == duration_restrict

resource_restrict メッセージが設定されている場合、条件はさらに制限されます。

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。

start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。

Timestamp

start_time_restrict を設定せずに end_time_restrict を設定すると、end_time_restrict までの全期間とみなされます。

Duration

duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。

Resources

resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。

Availability

空き情報の新しいリスト。

int64

このフィードにより新しく追加された項目。フィードの種類に応じて、販売者、サービス、または予約枠になります。

int64

既存の商品アイテム。必要に応じてフィードの新しい情報から更新されます。

int64

このフィード内に存在せず、結果的に削除された項目。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

このフィードの処理ステータス。

string

このフィードを処理できなかった場合に詳細情報を提供する、人が読める形式の文字列。

FeedStatistics

このフィードに固有の統計情報。

FeeDetails

アイテムの合計額に加えてユーザーに請求された手数料の詳細。サービス料、配送料など、さまざまな種類の手数料について繰り返し使用します。

AdvanceOrderDetails

事前注文サポートの詳細（事前注文とも呼ばれます）。ユーザーは、注文した商品の配送を後日行うことができます。

Duration

固定時間。例: 30 分。

DurationRange

期間の範囲。例: * 30 分～ 45 分 * 30 分超 * 50 分未満

bool

事前注文（事前注文）がサポートされている場合は true。（必須）

FeeType

料金タイプ。（必須）

FeeAmount

単位通貨、カートの金額に対する割合、または両方の組み合わせで表現した料金。（必須）

QuantitativeValue

カートの金額の割合で表した料金。範囲（制限ありおよび制限なし）または固定の割合を指定できます。値は 0～100 の範囲で指定してください。例: * 固定 5.5% * 5.5% 以上 * 5.5% 以下 * 4.5%～5.5%

Money

固定額。例: USD 3.5

MoneyRange

金額の範囲。例: * 3.5～5.5 米ドル * 3.5 米ドル以上 * 5.5 米ドル以下

bool

金額は不明です。

FulfillmentType

必須。フルフィルメント タイプ。

AvailableDay

必須。このフルフィルメント方法で空きがある日付のリスト（できれば 2 日以上）。

FeeDetails

必須。フルフィルメント方法の料金の詳細。

Price

必須。アクション リンクに関連付けられたフルフィルメント メソッドの最低注文額。

Date

必須。納品方法を利用できる日付。販売者のタイムゾーンと見なされます。

Timestamp

必須。Unix タイムスタンプ。ユーザーが最後に注文し、fulfillment_date までに商品を受け取れた日付。つまり、last_ordering_time の後は、fulfillment_date が在庫として表示されなくなります。

たとえば、fulfillment_date が 2020-08-10 の場合: - last_ordering_time の値が 2020-08-10 18:00 であれば、2020-08-10 に注文を受け取るには、その日午後 6 時までに注文する必要があります。- last_ordering_time の値が 2020-08-08 20:00 の場合、顧客は 2020-08-10 に注文を受けるには、2 日前の午後 8 時までに注文を行う必要があります。

NoFee

フルフィルメント方法の料金は発生しません。

MinimumFee

フルフィルメント方法に関連付けられた基本料金。

FixedFee

フルフィルメント方法に関連付けられた固定料金。

Price

必須。フルフィルメント方法の固定料金の金額。

Price

必須。フルフィルメント方法の基本料金の金額。

Timestamp

必須。このタイムスタンプは、広告枠に削除を適用する順序を決定するために使用されます。

bytes

proto ベース以外のフィードの場合。

Any

proto ベースのフィード用。

Timestamp

必須。このタイムスタンプは、在庫更新の正しい順序を保証するために使用されます。

bytes

proto ベース以外のフィードの場合。

Any

proto ベースのフィード用。

double

緯度。（省略可）

double

経度。（省略可）

PostalAddress

ビジネス拠点の、郵便物の送付先となる住所（推奨）。

string

非構造化住所（例: 1600 amphitheatre parkway mountain view, ca 94043）

string

必須。取得する Google 広告アカウントのリンクの名前。形式: partners/{partner}/adsAccountLinks/{ads_account_link}

string

必須。リソース名。Partners/{partner_id}/merchants/{merchant_id}/status の形式で指定します。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

このホームサービスが属する上位カテゴリ。例:配管工、電気工など

string

指定されたホームサービスが属するカテゴリ内のジョブタイプ。たとえば、plumber カテゴリには、unclog_drain、install_faucet などのジョブタイプがあります。

string

無効にするリソースの名前。

たとえば、集荷リソースの場合、名前の形式は partners/{partner_id}/pickups/{pickup_id} にする必要があります。実装は、識別されたリソースのキャッシュ バージョンを削除しなければなりません。

string

販売者のサービス ID。

int64

予約枠の開始時間（Unix エポックからの UTC 時間）。

int64

予約枠の長さ（秒）。

OrderedTickets

チケットタイプ別に注文されたチケットの数。

Price

この広告申込情報の合計金額（税抜き）。

BookingStatus

広告申込情報のステータス。

string

チケットタイプの ID。

int32

このタイプで注文されたチケットの数。

string

必須。この販売者ステータスのコレクションを所有する親。形式: partners/{partner_id}/merchants

int32

必須。返される最大アイテム数。サーバーがページサイズを小さくする可能性があるので注意してください。

string

省略可。前の ListMerchantStatusResponse から返された nextPageToken 値（存在する場合）。

BookingInventoryStatus

省略可。予約在庫のステータスで結果をフィルタする制限（省略可）。

WaitlistInventoryStatus

省略可。保留中の在庫ステータスで結果をフィルタする制限（省略可）。

GeoMatchingStatus

省略可。位置情報の一致ステータスで結果をフィルタする制限（省略可）。

MerchantStatus

フィルタ条件を満たす販売者のステータスのリスト。

string

次の結果ページを取得するためのトークン。空の場合、リストにこれ以上結果はありません。

string

以下の形式を持つフィード リソース名:

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

返す最大アイテム数。

string

前の List リクエストから返された next_page_token 値（存在する場合）。

State

フィードの状態によって結果をフィルタするオプションの制限。

TimeRange

（省略可）上限と下限で結果をフィルタするための制限。start_time が設定されていない場合は、デフォルトで Unix 時間の起点に設定されます。end_time が設定されていない場合は、デフォルトで現在に設定されます。

FeedStatus

アップロードしたフィードのステータスを日付の新しい順に並べ替えます。返されるアイテムの最大数は、リクエストの page_size フィールドに基づきます。

string

次の結果ページを取得するためのトークン。空の場合、リストにこれ以上結果はありません。

string

IETF BCP 47 言語コード（「en」、「mas」、「zh-Hant」、「de-CH-1901」など）。詳しくは、http://www.w3.org/International/articles/language-tags/ をご覧ください。

string

上記の言語 / 地域（UTF-8）でのメッセージ。

string

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

string

ビジネス拠点の名前、電話番号、URL、地域は、そのビジネス拠点を Google マップにすでに表示されている場所とマッチングするために使用されます。

このフィールドは省略可能ですが、状況によっては必須の場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、事業体には一致しません。（省略可）

string

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

string

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

GeoCoordinates

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

LocationType

ロケーションのタイプ。この場所が Service に提供される場合は指定する必要があります。

string

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

string

販売者のリソース名。partners/{partner_id}/merchants/{merchant_id} の形式で指定します。

string

merchant_name、電話番号、URL、地域は、パートナーの空き情報を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。

販売者の名前。

string

国コードと市外局番を含む販売者の公開電話番号。例:+14567891234。

string

販売者の公開ウェブサイトの URL。

GeoCoordinates

販売者の地理情報（緯度、経度、住所など）。

string

アグリゲータのプラットフォームにおけるビジネスのカテゴリ。

int64

このフィールドのサポートは終了しました。

uint32

販売者の税率（ベーシス ポイント: 1% の 100 分の 1）。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。

このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。

このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。

このフィールドは非推奨です。代わりに、tax_rate を使用してください。

TaxRate

販売者の税率。指定されている場合、このフィールドは非推奨の tax_rate_basis_points フィールドをオーバーライドします。メッセージが空（例: tax_rate { }）の場合、適用される税率はゼロにリセットされます。

PaymentRestrictions

この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合は、制限はないものとみなされます。

PaymentOption

この販売者で利用可能な支払いオプション。この販売者のサービスは、許可する支払い方法を個別に制限できます。

PaymentProcessorConfig

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

TokenizationConfig

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

Terms

「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。これらに加えて、アグリゲータ パートナーの利用規約は常にユーザーに表示されるものであり、ここでは提供しないでください。

string

パートナーの帰属を表示する際に使用する、消費者向けのブランドを識別する不透明型の文字列。このフィールドを使用すると、複数の消費者向けブランドを所有するパートナーが、同じフィード内のすべてのブランドの販売者を指定できます。

ブランドは、名前、ロゴ、利用規約、プライバシー ポリシーなど、消費者向けのプロパティで構成されます。

消費者向けのパートナー ブランドが 1 つしかない場合は、このフィールドを設定する必要はなく、無視してかまいません。

パートナーの種類別の処理方法:

消費者向けのブランドが 1 つしかない場合は、このフィールドは無視します。

複数のブランドが設定されている場合は、次のように処理されます。

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

注意: ほとんどのパートナーは、このフィールドを設定する必要はありません。パートナーがこのフィールドを使用する場合は、各ブランド（デフォルトのブランドを含む）を個別に設定する必要がありますので、Google までご連絡ください。

MerchantMatchingHints

販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。（省略可）

ServiceAttribute

この販売者のサービスを説明するために使用されるサービス属性の定義。（省略可）

ActionLink

省略可。関連する言語を含むアクション URL、表示を制限する国のリスト、タイプ、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。

Advisement

省略可。「Google で予約」を通して順番待ちリストに登録するユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイザリー内の個々のテキスト フィールドの長さは 100 バイト以内にする必要があります。

EconomicOperator

省略可。規制遵守のために必要な、この特定の販売者に関連付けられた経済事業者の情報。（省略可）

string

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

string

販売者ステータスのリソース名。形式は partners/{partner_id}/merchants/{merchant_id}/status です。

string

パートナーから提供された販売者の名前。

GeoCoordinates

パートナーが提供した販売者の地域情報。

ProcessingStatus

販売者の処理ステータス。

BookingStatus

エンドツーエンドの予約統合に関するステータス。

WaitlistStatus

順番待ちリストの統合に関連するステータス。

PlaceInfo

この販売者の一致する地域。販売者が位置情報と一致しない場合、空になります。

LocalServicesMatchInfo

この販売者のローカル サービスでの一致。ローカル サービス販売者でない場合、またはプロバイダと一致しない場合は空白です。

DirectUrl

現在の販売者の在庫の内容を示す URL のリスト。これは、広告枠が実際に配信されていることを意味するものではなく、URL が一般公開されている URL とは異なる場合があります。

bool

販売者が今後 30 日以内に在庫を持っている場合は true。販売者が実際にサービスを提供していることを保証するものではありません。

UrlType

この URL のタイプ。

string

この販売者が表示される可能性がある URL。

MatchedProvider

一致したサービス プロバイダ。販売者は複数のサービス プロバイダに照合できます。

int64

Google ローカル サービスの外部お客様 ID。

string

ローカル サービスのカテゴリ（カテゴリ）。例: 「plumber」、「carpet_cleaning」

string

場所の名前です。

string

現地の言語でフォーマットされた住所。

string

この場所の Google の場所 ID。Google マップの URL の作成、または場所の詳細情報の取得に使用できます。使用例については、https://developers.google.com/places/web-service/place-id をご覧ください。

bool

販売者が順番待ちリストサービスを利用している場合は true。販売者が実際にサービスを提供していることを保証するものではありません。

Money

最低額。

Money

最大金額。

Price

予約時にユーザーが予約しなかった場合に請求される可能性のある金額。

PriceType

空室状況から料金をどのように決定するかを定義します。

string

注文のリソース名: partners/{partner ID}/orders/{order ID}

ClientInformation

注文を行うクライアントの個人情報。

PaymentInformation

注文に関連する支払い取引に関する情報。

string

この注文が属するすべてのサービスを提供する販売者の ID。

LineItem

この注文の項目。

FulfillmentOption

オンライン注文アクション リンクで使用可能なフルフィルメント オプション。

PrepaymentStatus

予約の前払いステータス。prepayment_status が PREPAYMENT_PROVIDED または PREPAYMENT_REFUNDED の場合、payment_transaction_id には関連付けられた一意の取引 ID が含まれます。

string

予約に関連付けられた支払い処理の一意の識別子。該当しない場合は空になります。

string

この ID は、この支払いオプションを識別するために使用されます。

この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。

ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。

string

支払いオプションの名前。これはユーザーに表示されます。

string

支払いオプションについての説明。これはユーザーに表示されます。

Price

支払いオプションの価格。

TaxRate

この支払いオプションの税率。指定されている場合、このフィールドは Merchant または Service にある tax_rate フィールドをオーバーライドします。空のメッセージ（例: tax_rate { }）は、適用される税率を 0 にリセットします。

PaymentOptionType

この支払いオプションの種類。ドロップインの場合は 1 回限り、パックの場合は複数回、メンバーシップの場合は無制限。

int64

この支払いオプションを利用できるセッション数。マルチセッションまたはパックでのみ有効。値には「>」を指定する必要があります。1.

TimeRange

この期間内に支払いオプションを購入できます。

TimeRange

支払いオプションはこの期間内に利用できます（例: 2017 年 1 月の特別価格）。存在する場合は、valid_duration と activation_type をオーバーライドします。

Duration

支払いオプションの有効期間（例: 30 日間のメンバーシップ）。

ActivationType

この支払いオプションが有効となる開始日を決定する方法を定義します。

UserPurchaseRestriction

この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定されていない場合、すべてのユーザーが対象となります。

Processor

この構成が適用される決済代行業者パートナーを定義します。

string

この販売者を決済代行業者に応じて識別するために使用するキー。

Stripe については、https://stripe.com/docs/dashboard#api-keys をご覧ください。Braintree については、https://articles.braintreepayments.com/control-panel/important-gateway-credentials をご覧ください。

string

支払いリクエストとともに決済代行業者に送信される API バージョン番号。

CreditCardRestrictions

この販売者が受け付けるクレジット カードに関する制限。このフィールドが設定されていない場合は、すべてのクレジット カードが受け付けられるとみなされます。なお、CreditCardType でサポートされるカードのリストは今後増えていくことにご留意ください。つまり、このフィールドを空のままにすると、将来的な変更の対象となる可能性があります。

Price

送料は配送方法によって異なる場合があります。

Price

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

Price

サービスに対して請求される追加料金。

Price

会場や施設に赴く際の料金。

Price

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

string

国。ISO 3166-1 alpha-2 国コードを使用して指定（「US」など）。（必須）

string

地域区分（例: 横須賀市）（必須）

string

県（例: 神奈川県）。このフィールドは、県が住所の一部である国でのみ必須です。（省略可）

string

郵便番号（例: 94043）。（必須）

string

番地（例: 大町 3-5）。（必須）

PriceInfo

料金の詳細のコンテナ。

int64

価格（最小通貨単位）。最小通貨単位の端数は、最近接偶数に丸められます（例: 2.5 セントは 2 セント、3.5 セントは 4 セント、0.5 セントは 0 セント、2.51 セントは 3 セントに丸められます）。

string

ISO 4217 で定義されている価格の通貨。

string

合計価格に関連付けられている価格設定オプションを識別する不透明型文字列（省略可）。

PriceType

料金または料金帯の適用方法（1 人あたりまたは固定）を定義します。

Price

サービスの価格または料金。

PriceRange

サービスまたは料金の上限/下限。

Price

最低額。

Price

限度額です。常に min_price より大きくする必要があります。

double

単一値。例: 5.6

RangeValue

値の範囲（上限なしまたは上限あり）。例: * 5.5 以上 * 5.5 以下 * 5.5 ～ 6.5

double

最小値。

double

最大値

double

平均評価値（number_of_ratings > 0 の場合は必須）。値は [1, 5] の範囲内である必要があり、number_of_ratings がゼロの場合にのみ省略できます。

uint64

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

string

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

MediaType

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

Text

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

Attribution

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

string

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

Text

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

string

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

ServiceAvailability

既存のサービス空き情報を置き換えるために使用されるサービス空き情報。

string

サービスを提供するスタッフの ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。staff_name が指定されている場合は、このフィールドを指定する必要があります。

string

サービスを提供するスタッフ メンバーの名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。staff_id が指定されている場合は、このフィールドを指定する必要があります。

string

サービスが提供される部屋の ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。room_name が指定されている場合は、このフィールドを指定する必要があります。

string

サービスが提供される部屋の名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。（省略可、ただし room_id が存在する場合は必須）ダイニングでは、部屋の名前はバーやパティオなどの座席エリアにのみ使用し、固定料金メニュー、特別なアクティビティ、空席以外の値（予約や夕食など）には使用しないでください。デフォルトの座席エリアには部屋を関連付けないことを強くおすすめします。

int32

Dining のみ: この時間枠に対応できる人数。レストランを複数の Slots に同時に関連付けて、たとえば 2 人、3 人、4 人が予約して座れる場合は、それぞれ異なる party_size を指定します。

Text

省略可。ローカライズされた客室の説明。設定する場合は、デフォルト値を指定する必要があります。販売者の言語 / 地域で使用される一般的な言語も指定することをおすすめします。（省略可）

int64

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

Price

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

Price

無断キャンセル料。

AdmissionPolicy

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

CancellationPolicy

キャンセル ポリシーのスケジュール設定ルール。（おすすめスポットに必須）

int64

最終予約可能時間から予約枠の開始時刻までの期間（秒単位）。

int64

最終予約可能時間から予約枠の終了時刻までの期間（秒単位）。 このフィールドが設定されている場合、予約枠の開始後にユーザーが購入済みチケットを使用できることを示すために、「admission_policy」フィールドを TIME_FLEIBLE に設定する必要があります。

string

サービス リソース名。形式は partners/{partner_id}/merchants/{merchant_id}/services/{service_id} です。

string

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

Text

サービスの名前（例: 「メンズ ヘアカット」）。複数の言語 / 地域で使用される可能性があります。

string

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

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、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。ユーザー エクスペリエンスを豊かにするために写真を使用する場合は、下の「related_media」フィールドを使用して写真の URL を送信してください。
  

注意事項:

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

Price

サービスの料金。

PriceInterpretation

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

SchedulingRules

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

PrepaymentType

前払いが必須か、選択可能か、対象外か。

PrepaymentTerms

前払いが完了するタイミングに関する条件。

ServiceIntakeForm

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

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

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

string

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

Deposit

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

NoShowFee

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

RequireCreditCard

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

ActionLink

このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service でタイプ（下記参照）を設定する必要があります。

ServiceType

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

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 はこの取引には関与しません。virtual_session が定義されていて、サービスが無料ではないか、prepayment_type が REQUIRED に設定されていない場合は必須です。

UriTemplate

省略可。外部サイトへの URL の生成方法を指定するオプションのテンプレート。

ChargeTiming

購入日時に対する請求日時。

int64

サービス開始時間の前にユーザーに請求される支払い時間（秒単位）。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。

string

同じ販売者のサービス属性を他のサービス属性から一意に識別する ID（「account-type」など）。

string

ユーザーに表示される属性の名前。例:[アカウントの種類] を選択します。

Value

このサービス属性に使用可能なすべての値。

string

このサービス属性のこの値を他の値と一意に識別する識別子。例:「個人用」です。

string

ユーザーに表示される、この値の名前（「個人」など）。

string

Merchant.service_attribute で定義された属性の ID。例:「service-type」を指定します。

string

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

string

このパラメータの申し込み先のサービスのリソース名partners/{partner_id}/merchants/{merchant_id}/services/{service_id} の形式

Timestamp

指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

duration メッセージが設定されている場合、条件はさらに制限されます。

  availability.duration == duration_restrict

resource_restrict メッセージが設定されている場合、条件はさらに制限されます。

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。

start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。

Timestamp

start_time_restrict を設定せずに end_time_restrict を設定すると、end_time_restrict までの全期間とみなされます。

Duration

duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。

Resources

resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。

Availability

空き情報の新しいリスト。

ServiceIntakeFormField

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

bool

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

bool

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

string

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

FieldType

このフィールドの型。

string

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

Text

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

string

フィールドタイプが LOCATION_SEARCH の場合にのみ設定します。「location」フィールドの「location_id」を使用してビジネス拠点の値を指定してください。

Text

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

bool

このフィールドへの回答がユーザーに要求されるかどうかを示します。

bool

事前定義された回答以外の回答でカスタム値を許可するかどうかを指定します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。（省略可）

Text

指定された値に加えて指定された追加オプション。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。例:提供された場所リストに加えて、[後でサプライヤーに連絡します] というオプションも利用できます。（省略可）

string

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

Text

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

int32

税率（1% を 100 万分の 1 とする単位）。実際には小数点以下 6 桁を表すことになります。たとえば、税率が 7.253% の場合は、このフィールドは 7253000 に設定します。

このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。

このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。

string

（省略可）利用規約の URL。

string

ユーザーに表示するテキスト。新しい統合の場合は、下記の localized_text を使用します。

Text

ユーザーに表示されるローカライズされたテキスト。

string

不明な言語 / 地域の Text 値。localized_value が空の場合にのみ必須です。この値の言語 / 地域は、パートナーまたはサービス提供業者によって異なる場合があります。特定の言語を想定することはできません。

LocalizedString

言語 / 地域ごとのテキスト値。省略可。

string

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

string

この TicketType の簡単な説明。

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

Text

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

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

Price

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

PerTicketFee

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

PriceDisplayType

省略可。このタイプのチケット 1 枚の事前定義された料金表示タイプ。

string

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

Text

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

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

例 1: 「大人」、「子供」などの異なるタイプのある入場チケットで、言語を追加オプションとしている場合の想定される TicketType リスト: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

例 2: 追加器具としてオプションの防水バック付きのカヤック レンタル（2 時間以上）で、short_description は「3 時間」、option_description は「防水バッグ付き」または「防水バッグなし」が可能な場合: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

省略可能ですが、サービス内のいずれかのチケットタイプにこのフィールドが設定されている場合は、他のすべてのチケットタイプにもこのフィールドを設定することをおすすめします（option_description のデフォルト値が使用される可能性があります）。たとえば、[{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] は有効なリストではありません。

サポートされている 2 つの HTML 形式タグは、<em> と <br> です。
タイトルと詳細な説明でオプションを指定するために使用します（例:「プレミアム シート
このオプションでは、座りこごちの良い椅子、専用テレビ、飲食サービスを含む専用ボックスシートが提供されます。客席からは美しい景色を眺めることができます。」）

InventoryType

省略可。このタイプのチケット 1 枚の事前定義された広告枠タイプ。

EventCategory

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

string

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

Entity

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

AttendanceMode

必須。イベントの参加の種類。

string

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

Text

省略可。イベントをホストする主催者。

string

省略可。イベントをホストする主催者の URL。

OrganizerType

省略可。主催者の種類。

string

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

EventState

省略可。イベントの状態。

Text

省略可。ローカライズされたブランド名。

EventCreator

省略可。イベントの作成者に関する情報。

string

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

string

エンティティの名前。（必須）

string

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

EntityType

エンティティのタイプ。（省略可）

EntityRole

イベントでのエンティティの役割。（省略可）

PublicIdentificationData

エンティティの公開参照。（省略可）

string

省略可。イベント作成者の名前。文字の制限はありません。

string

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

string

アーティストなどの音楽エンティティの 36 文字の MusicBrainz 識別子（該当する場合）。https://musicbrainz.org/doc/MusicBrainz_Identifier をご覧ください。（省略可）

Timestamp

時間帯の下限。

Timestamp

時間帯の上限。

map<string, string>

トークン化設定には通常、キーが「gateway」で値が決済代行業者の名前である 1 つの tokenization_parameter があります。

パラメータの残りは決算代行業者によって異なります。詳しくは、Google Pay のドキュメントをご覧ください。

Braintree の例: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe の例: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen の例: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Google Pay に入力したユーザーの支払い情報（FOP を含む）を、支払いトークンに含めます（上記を参照）。フィールドを空のままにした場合は、MIN を指定した場合と同じ結果になります。