インデックス
AdsAccountLinkingService(インターフェース)BookingNotification(インターフェース)Feed(インターフェース)InvalidationService(インターフェース)InventoryStatus(インターフェース)InventoryUpdate(インターフェース)ActionLink(メッセージ)ActionLink.ActionLinkType(列挙型)ActionLink.EventMetadata(メッセージ)ActionLink.EventMetadata.Surface(列挙型)ActionPlatform(列挙型)AdsAccountLink(メッセージ)AdsAccountLink.State(列挙型)Advisement(メッセージ)Availability(メッセージ)Availability.ConfirmationMode(列挙型)Availability.DurationRequirement(列挙型)Availability.LinkoutRequiredReason(列挙型)Availability.Recurrence(メッセージ)Availability.ScheduleException(メッセージ)Availability.SchedulingRuleOverrides(メッセージ)BatchDeleteGenericRecordsRequest(メッセージ)BatchPushGenericRecordRequest(メッセージ)BatchReplaceServiceAvailabilityRequest(メッセージ)BatchReplaceServiceAvailabilityResponse(メッセージ)Booking(メッセージ)BookingFailure(メッセージ)BookingFailure.Cause(列挙型)BookingFailure.PaymentFailureInformation(メッセージ)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters(メッセージ)BookingStatus(列挙型)CallMerchant(メッセージ)CancellationPolicy(メッセージ)CancellationPolicy.RefundCondition(メッセージ)ClientInformation(メッセージ)CreateAdsAccountLinkRequest(メッセージ)CreateMerchantRequest(メッセージ)CreateServiceRequest(メッセージ)CreditCardRestrictions(メッセージ)CreditCardRestrictions.CreditCardType(列挙型)DeleteAdsAccountLinkRequest(メッセージ)DeleteMerchantRequest(メッセージ)DeleteServiceRequest(メッセージ)Deposit(メッセージ)DirectMerchantPayment(メッセージ)DurationRange(メッセージ)EconomicOperator(メッセージ)ExtendedServiceAvailability(メッセージ)FeedStatistics(メッセージ)FeedStatus(メッセージ)FeedStatus.State(列挙型)FoodOrderingMetadata(メッセージ)FoodOrderingMetadata.AdvanceOrderDetails(メッセージ)FoodOrderingMetadata.FeeDetails(メッセージ)FoodOrderingMetadata.FeeDetails.FeeAmount(メッセージ)FoodOrderingMetadata.FeeDetails.FeeType(列挙型)FulfillmentOption(メッセージ)FulfillmentOption.AvailableDay(メッセージ)FulfillmentOption.FeeDetails(メッセージ)FulfillmentOption.FixedFee(メッセージ)FulfillmentOption.FulfillmentType(列挙型)FulfillmentOption.MinimumFee(メッセージ)FulfillmentOption.NoFee(メッセージ)GenericDeleteRecord(メッセージ)GenericRecord(メッセージ)GeoCoordinates(メッセージ)GetAdsAccountLinkRequest(メッセージ)GetMerchantStatusRequest(メッセージ)GetStatusRequest(メッセージ)HomeServiceData(メッセージ)IntegrationType(列挙型)InvalidateResourceRequest(メッセージ)LineItem(メッセージ)LineItem.OrderedTickets(メッセージ)LinkoutTemplate(メッセージ)ListMerchantStatusesRequest(メッセージ)ListMerchantStatusesRequest.BookingInventoryStatus(列挙型)ListMerchantStatusesRequest.GeoMatchingStatus(列挙型)ListMerchantStatusesRequest.WaitlistInventoryStatus(列挙型)ListMerchantStatusesResponse(メッセージ)ListStatusRequest(メッセージ)ListStatusResponse(メッセージ)LocalizedString(メッセージ)Location(メッセージ)LocationType(列挙型)Merchant(メッセージ)MerchantMatchingHints(メッセージ)MerchantStatus(メッセージ)MerchantStatus.BookingStatus(メッセージ)MerchantStatus.DirectUrl(メッセージ)MerchantStatus.DirectUrl.UrlType(列挙型)MerchantStatus.LocalServicesMatchInfo(メッセージ)MerchantStatus.LocalServicesMatchInfo.MatchedProvider(メッセージ)MerchantStatus.PlaceInfo(メッセージ)MerchantStatus.ProcessingStatus(列挙型)MerchantStatus.WaitlistStatus(メッセージ)MoneyRange(メッセージ)NoShowFee(メッセージ)Order(メッセージ)OrderOnlineMetadata(メッセージ)PaymentInformation(メッセージ)PaymentOption(メッセージ)PaymentOption.ActivationType(列挙型)PaymentOption.PaymentOptionType(列挙型)PaymentProcessorConfig(メッセージ)PaymentProcessorConfig.Processor(列挙型)PaymentRestrictions(メッセージ)PerOrderFee(メッセージ)PerTicketFee(メッセージ)PostalAddress(メッセージ)Prepayment(メッセージ)PrepaymentStatus(列挙型)Price(メッセージ)PriceInfo(メッセージ)PriceInterpretation(列挙型)PriceRange(メッセージ)PriceType(列挙型)QuantitativeValue(メッセージ)QuantitativeValue.RangeValue(メッセージ)Rating(メッセージ)RelatedMedia(メッセージ)RelatedMedia.Attribution(メッセージ)RelatedMedia.MediaType(列挙型)ReplaceServiceAvailabilityRequest(メッセージ)RequireCreditCard(列挙型)Resources(メッセージ)SchedulingRules(メッセージ)SchedulingRules.AdmissionPolicy(列挙型)Service(メッセージ)Service.PrepaymentTerms(メッセージ)Service.PrepaymentTerms.ChargeTiming(列挙型)Service.PrepaymentType(列挙型)Service.ServiceType(列挙型)ServiceAttribute(メッセージ)ServiceAttribute.Value(メッセージ)ServiceAttributeValueId(メッセージ)ServiceAvailability(メッセージ)ServiceIntakeForm(メッセージ)ServiceIntakeFormField(メッセージ)ServiceIntakeFormField.FieldType(列挙型)TaxRate(メッセージ)Terms(メッセージ)Text(メッセージ)TicketType(メッセージ)TicketType.InventoryType(列挙型)TicketType.PriceDisplayType(列挙型)TicketingVerticalSpecificData(メッセージ)TicketingVerticalSpecificData.AttendanceMode(列挙型)TicketingVerticalSpecificData.Entity(メッセージ)TicketingVerticalSpecificData.Entity.EntityRole(列挙型)TicketingVerticalSpecificData.Entity.EntityType(列挙型)TicketingVerticalSpecificData.EventCategory(列挙型)TicketingVerticalSpecificData.EventCreator(メッセージ)TicketingVerticalSpecificData.EventState(列挙型)TicketingVerticalSpecificData.OrganizerType(列挙型)TicketingVerticalSpecificData.PublicIdentificationData(メッセージ)TimeRange(メッセージ)TokenizationConfig(メッセージ)TokenizationConfig.BillingInformationFormat(列挙型)ToursAndActivitiesContent(メッセージ)UnsupportedPartySizeOption(メッセージ)UpdateAdsAccountLinkRequest(メッセージ)UpdateBookingRequest(メッセージ)UpdateMerchantRequest(メッセージ)UpdateOrderRequest(メッセージ)UpdateServiceRequest(メッセージ)UriTemplate(メッセージ)UserPurchaseRestriction(メッセージ)VirtualSession(メッセージ)VirtualSession.VirtualPlatformInfo(メッセージ)VirtualSession.VirtualPlatformInfo.Platform(列挙型)WaitlistRules(メッセージ)
AdsAccountLinkingService
Google 広告とパートナー センター間のアカウント リンクを管理するサービス。
| CreateAdsAccountLink |
|---|
|
Google 広告アカウントのリンクを作成します。これにより、Google 広告アカウントとパートナー センターのリンクが開始されます。リンクは、広告ポータルで承認されるまで
|
| DeleteAdsAccountLink |
|---|
|
広告アカウントのリンクを削除します。これにより、Google 広告アカウントとパートナー センター アカウントのリンクが解除されます。
|
| GetAdsAccountLink |
|---|
|
Google 広告アカウントのリンクを取得します。
|
| UpdateAdsAccountLink |
|---|
|
在庫アイテムで Google 広告アカウントのリンクを更新します。これにより、指定した商品アイテムで Google 広告アカウントのリンクが更新されます。
|
BookingNotification
外部のスケジューリング パートナーからの予約に関する通知を受け取ります。パートナーは、CreateBooking や CheckAvailability などの予約ベースのリモート プロシージャ コールを実装するか、あるいは CreateOrder や CheckOrderFulfillability などの注文ベースのリモート プロシージャ コールを実装することで、UpdateBooking または UpdateOrder を呼び出します。
| UpdateBooking |
|---|
|
既存の
|
| UpdateOrder |
|---|
|
既存の
|
Feed
外部アグリゲータ パートナーによりアップロードされたフィードの処理ステータスを取得します。
| GetStatus |
|---|
|
指定したアグリゲータによって以前にアップロードされたフィードの
|
| ListStatus |
|---|
|
指定されたアグリゲータによって、以前にアップロードされた複数の販売者フィード、サービス フィード、または空き情報フィードの
|
InvalidationService
外部パートナーからリソースの無効化リクエストを受け取ります。
| InvalidateResource |
|---|
|
既存のリソースを無効にします。 リクエストされたリソースが Google サービスに登録されていない場合、リクエストは無視されます。 サポートされているリソースタイプ: - Pickup
|
InventoryStatus
アップロードされた販売者の在庫と照合ステータスを取得します。
| GetMerchantStatus |
|---|
|
|
| ListMerchantStatuses |
|---|
|
フィルタ条件を満たすパートナーのすべての
|
InventoryUpdate
外部アグリゲータから空き情報の更新を取得します。
| BatchDeleteGenericRecords |
|---|
|
指定されたフィードタイプのレコードを削除します。基本的な検証(不正な形式のリクエストなど)のみを実行し、その後、適切なレスポンスをパートナーにすぐに返します。Google は、リクエストに対してビジネス ロジックの検証を非同期で実行します。このバッチ呼び出しでは、原子性は保証されません。
|
| BatchPushGenericRecord |
|---|
|
指定されたフィードタイプのレコードを挿入または更新します。基本的な検証(不正な形式のリクエストなど)のみを実行し、その後、適切なレスポンスをパートナーにすぐに返します。Google は、リクエストに対してビジネス ロジックの検証を非同期で実行します。このバッチ呼び出しでは、原子性は保証されません。
|
| BatchReplaceServiceAvailability |
|---|
|
既存の
|
| CreateMerchant |
|---|
|
指定されたアグリゲータによって管理されている新しい
|
| CreateService |
|---|
|
指定されたアグリゲータによって管理されている販売者の新しい
|
| DeleteMerchant |
|---|
|
指定されたアグリゲータによって管理されている既存の
|
| DeleteService |
|---|
|
指定されたアグリゲータによって管理されている販売者の既存の
|
| ReplaceServiceAvailability |
|---|
|
指定されたアグリゲータによって管理されている販売者の既存の
|
| UpdateMerchant |
|---|
|
指定されたアグリゲータによって管理されている既存の
|
| UpdateService |
|---|
|
指定されたアグリゲータによって管理されている販売者の既存の
|
ActionLink
関連する言語を含むアクション URL、表示を制限する国のリスト、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。
| フィールド | |
|---|---|
url |
このアクション リンクのエントリポイント URL。 |
language |
この URI のコンテンツを利用できる言語を識別する BCP-47 言語タグ。 |
restricted_country[] |
ISO 3166-1 alpha-2 の国コード。表示を制限しない場合は空のままにします。 |
platform |
このアクションを実行するプラットフォーム。このフィールドが設定されていない場合は、代替として ACTION_PLATFORM_WEB_APPLICATION が使用されます。 |
action_link_type |
事前定義されたアクションのタイプ。 |
order_online_metadata |
オンライン注文リンクのメタデータ。ActionLinkType が ACTION_LINK_TYPE_SHOP_ONLINE のアクションをサポートします。 |
food_ordering_metadata |
デリバリー&テイクアウトのリンクのメタデータ。サポートされているアクション タイプ: * |
event_metadata |
イベント カテゴリに固有のアクション リンクに関する追加情報。 |
ActionLinkType
アクション リンクに関連付けられている、事前定義されたアクションのタイプ。
| 列挙型 | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
アクション リンクのタイプが指定されていません。 |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
アクション リンクのタイプは予約です。 |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
アクション リンクのタイプはオンライン予約です。 |
ACTION_LINK_TYPE_ORDER_FOOD |
アクション リンクのタイプは、料理の宅配またはテイクアウトの注文、もしくはその両方の注文です。 |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
アクション リンクのタイプは料理の宅配の注文です。 |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
アクション リンクのタイプは料理のテイクアウトの注文です。 |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
アクション リンクのタイプはレストランの予約です。 |
ACTION_LINK_TYPE_SHOP_ONLINE |
アクション リンクのタイプはショッピングの注文です。配達または受け取り、もしくはその両方です。 |
EventMetadata
イベント カテゴリに固有のアクション リンクに関する追加情報。
| フィールド | |
|---|---|
surface |
アクション リンクに関連付けられた所定のイベント サーフェス。これはイベント カテゴリでのみ使用されます。 |
Surface
アクション リンクに関連付けられた所定のイベント サーフェス。これはイベント カテゴリでのみ使用されます。
| 列挙型 | |
|---|---|
SURFACE_UNSPECIFIED |
サーフェスが指定されていません。 |
SURFACE_SEARCH |
アクション リンクは、検索でのイベント チケットの予約です。 |
SURFACE_YOUTUBE |
アクション リンクは YouTube でのイベント チケットの予約です。 |
SURFACE_ADS |
アクション リンクは、イベントの広告をクリックすることです。 |
ActionPlatform
アクションが実行されるプラットフォーム。ウェブ アプリケーションが、一般的な代替プラットフォームです。ACTION_PLATFORM_WEB_APPLICATION をプラットフォームとする ActionLink を少なくとも 1 つ用意することをおすすめします。Android と iOS をプラットフォームとするリンクは、それぞれのシステムでのみ使用されます。
| 列挙型 | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
プラットフォームが指定されていません。 |
ACTION_PLATFORM_WEB_APPLICATION |
アクション プラットフォームはウェブ全般です。 |
ACTION_PLATFORM_MOBILE_WEB |
アクション プラットフォームはモバイル デバイス上のウェブです。 |
ACTION_PLATFORM_ANDROID |
アクション プラットフォームは Android OS です。 |
ACTION_PLATFORM_IOS |
アクション プラットフォームは iOS です。 |
AdsAccountLink
AdsAccountLink は、Google 広告アカウントとパートナー センター アカウントのリンクとインベントリ アイテムです。
| フィールド | |
|---|---|
name |
ID。AdsAccountLink のリソース名。形式: |
item_ids[] |
必須。Google 広告アカウントにリンクする在庫アイテム ID のリスト。 |
state |
出力専用。Google 広告アカウントのリンクの状態。 |
州
Google 広告アカウントのリンクの状態。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
不明な状態。 |
LINKED |
パートナー センターと Google 広告ポータル間でアカウントがリンクされている。 |
PENDING |
アカウントがパートナー センターまたは Google 広告ポータルで承認待ちの状態です。 |
DELETED |
アカウントのリンクが削除されました。 |
REJECTED |
アカウントのリンク リクエストがパートナー センターまたは広告ポータルで拒否された。 |
アドバイス
「Google で予約」で予約を行うときにユーザーに表示される注意事項。
| フィールド | |
|---|---|
text |
「Google で予約」で予約するときにユーザーに表示されるカスタム メッセージ。 |
対象
販売者のサービスの予約枠(時間とスポット数)。
| フィールド | |
|---|---|
start_time |
予約スロットの開始時刻。 |
duration |
予約枠の期間 |
spots_total |
この予約枠の合計スポット数と空きスポット数。例:
注: 以下で定義されている空き状況の圧縮形式を使用してリクエストを送信すると、これら 2 つのフィールドが推定されます。
|
spots_open |
空きスポット数。 |
availability_tag |
この予約枠を識別するための不透明型文字列(省略可)。設定すると、予約、予約の更新、予約のキャンセルを行うリクエストに含まれます。 |
resources |
異なるスタッフや部屋がサービスに含まれている場合に、個々の予約枠を区別するために使用されるリソース(省略可)。 たとえば、1 つのヨガクラスに 2 人のインストラクターがいる場合: |
payment_option_id[] |
このスロットの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 このフィールドは、サービス メッセージで指定された payment_option_id をオーバーライドします。同様に、ここで指定された payment_option_id はサービス メッセージに存在する必要はありませんが、Merchant レベルで定義する必要があります。 |
recurrence |
空き状況の繰り返しに関する情報で、複数の開始時刻を表します。繰り返しには 1 営業日の予約が含まれている必要があります。 |
schedule_exception[] |
このサービスをスケジュールできない時間。schedule_exception メッセージの数を制限するには、隣接する例外を結合することを検討してください。 |
deposit |
この空き情報の保証料(省略可)。サービスの保証料が指定されている場合は、それをオーバーライドします。 |
no_show_fee |
この空き状況用の無断キャンセル料(省略可)。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。 |
prepayment |
省略可。この空き状況の前払い情報(省略可)。 |
require_credit_card |
この予約枠を予約するために、ユーザがクレジット カードを提供する必要があるかどうかを示します。値が設定されていない場合、サービスレベルから値が継承されます(設定されている場合)。(省略可) |
ticket_type_id[] |
この空き状況スロットでサポートされているチケットタイプのリストを示します。設定されていない場合、親サービスのすべてのチケットタイプをこのスロットで使用できます。なお、このフィールドの値は親サービスで定義する必要があります。たとえば、次のように定義します。
平日の空き情報を表す場合:
この時間枠で 3 つのチケットタイプすべてを使用できることを示すには、 (省略可) |
duration_requirement |
時間枠の期間や終了時刻を表示する必要がある。スロットが使用できない場合、このフィールドは無視されます。「おすすめスポット」カテゴリでは使用されません。(省略可) |
scheduling_rule_overrides |
空き状況のスケジュール設定ルール。フィールドに値が入力されている場合は、サービスレベルの SchedulingRules 上の対応するスケジュール設定ルールをオーバーライドします。 |
confirmation_mode |
この空き状況の予約時に使用される確認モード。CONFIRMATION_MODE_SYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に確認または拒否されます。CONFIRMATION_MODE_ASYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に拒否されるか、保留中のステータスで作成されます。 |
linkout_required_reason |
省略可。このスロットにリンクアウトが必要な理由。設定されている場合、このスロットの Merchant リソースには有効な LinkoutTemplate が必要です。(省略可) |
ConfirmationMode
空き状況の予約時に使用される確認モード。
| 列挙型 | |
|---|---|
CONFIRMATION_MODE_UNSPECIFIED |
確認モードが指定されませんでした。同期確認が想定されます。 |
CONFIRMATION_MODE_SYNCHRONOUS |
この空き状況に対する予約は同期的に確認されます。 |
CONFIRMATION_MODE_ASYNCHRONOUS |
この空き情報に対する予約は非同期的に確認されます。 |
DurationRequirement
この列挙型は、リクエストされたスロットの期間/終了時刻をユーザーが確認または表示するための要件を示します。
| 列挙型 | |
|---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
終了時間の処理は指定されていません。これがデフォルトです。 |
DO_NOT_SHOW_DURATION |
終了時間はユーザーに表示されません。 |
MUST_SHOW_DURATION |
予約を行う前に、終了時刻をユーザーに表示する必要があります。 |
LinkoutRequiredReason
スロットにリンクアウト エクスペリエンスがある理由。
| 列挙型 | |
|---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED |
デフォルト値: 使用しないでください。不明と同等です。 |
PAYMENT_REQUIRED |
スロットを予約するには、パートナー プラットフォームで支払いを行う必要があります。 |
繰り返し
Recurrence メッセージは省略可能ですが、空き状況スロットが一貫性を持って繰り返す場合は、これを使うとより簡潔に表すことができます。通常は 1 日の営業スケジュールを表した後、ScheduleException メッセージを使って、その営業日内で予約済みの時間帯や利用できない時間帯を表します。
要件:
- 予約枠または繰り返しを拡張することで、同一の予約枠を作成することはできません。id、start_time、duration、resources が一致する場合、予約枠は同一と見なされます。
- 単一のサービスの予約枠内で、標準の空き情報形式と繰り返しを混在させないでください。繰り返しは、予約を提供する販売者やサービスに有効で、標準形式は、定期的にクラスをスケジュール設定する販売者やサービスを対象としています。
- 繰り返しは 24 時間を超えることはできません。
| フィールド | |
|---|---|
repeat_until |
空き状況が繰り返される最終時間として含める UTC タイムスタンプ。 |
repeat_every |
後続の予約枠との間隔を定義します。 例: 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 となります。(必須) |
ScheduleException
ScheduleException メッセージは、上記の繰り返しの例外で、1 営業日内のすでに予約された時間帯、または利用できない時間帯を表します。タイムスロットが予約されると、例外のリストが更新されて、新たに利用できなくなった時間帯が反映されます。繰り返し自体は変更されません。
| フィールド | |
|---|---|
time_range |
例外の時間帯。繰り返しで記述された予約枠内で、例外の時間帯(左閉右開)が重複する時間帯は、利用不可と見なされます。 例: 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 から始まる予約枠は影響を受けません。 |
SchedulingRuleOverrides
空き情報レベルのスケジュール設定ルール。
| フィールド | |
|---|---|
last_bookable_sec |
この予約枠を予約できる最終時間(秒)。このタイムスタンプは、遵守されるべき予約枠の start_sec より前にくる必要があります(ユーザーが開始時刻を過ぎてから予約できる場合は、サービスレベルで SchedulingRules.min_booking_before_end_time を使用します)。指定されている場合、対応する Service の SchedulingRules の min_booking_buffer で指定されたすべての値をオーバーライドします。 |
first_bookable_sec |
この予約枠を予約できる開始時刻(秒)。このタイムスタンプは、スロットの start_sec または last_bookable_sec(指定されている場合)の前に指定する必要があります。 |
last_online_cancellable_sec |
設定されている場合、この特定の予約枠を Google で予約からキャンセルできる最終時間(Unix エポックからの経過時間での秒単位)。このフィールドは、サービスレベルのキャンセル ルールをオーバーライドします。(省略可) |
BatchDeleteGenericRecordsRequest
指定されたフィードタイプのレコードを削除するバッチ リクエスト。
| フィールド | |
|---|---|
parent |
リソース名(形式: |
records[] |
削除するレコード。1 回の API 呼び出しで許可されるレコードの最大数は 1,000 件です。 |
BatchPushGenericRecordRequest
リクエスト URL で指定されたフィードタイプのレコードを挿入または更新するバッチ リクエスト。
| フィールド | |
|---|---|
parent |
リソース名(形式: |
records[] |
挿入または更新するレコード。1 回の API 呼び出しで許可されるレコードの最大数は 1,000 件です。 |
BatchReplaceServiceAvailabilityRequest
複数の Service の予約枠を置き換えるバッチ リクエスト。
| フィールド | |
|---|---|
parent |
|
extended_service_availability[] |
既存の予約枠を置き換えるために使用される、延長サービスの空き情報。 |
BatchReplaceServiceAvailabilityResponse
複数の Service の予約枠を置き換えるバッチ レスポンス。正常に更新された予約枠のみこのメッセージに含まれます。
| フィールド | |
|---|---|
extended_service_availability[] |
既存の予約枠を置き換えるために使用された、延長サービスの更新済み空き情報メッセージ。 |
Booking
予約枠の予約
| フィールド | |
|---|---|
name |
予約のリソース名: |
merchant_id |
予約枠の販売者 ID |
service_id |
販売者のサービス ID |
start_time |
予約枠の開始時刻 |
duration |
予約枠の期間 |
client_information |
予約を行っている顧客の個人情報 |
status |
予約のステータス |
payment_information |
予約に関連する支払い処理についての情報。 |
party_size |
予約の人数 |
BookingFailure
予約の処理が非同期で失敗した理由を示すステータス データ。BookingFailure は、主にビジネス ロジックのエラーを取得することを目的としています。
| フィールド | |
|---|---|
cause |
予約が失敗した理由。(必須) |
rejected_card_type |
(原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合のみ必須) |
description |
パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。(省略可) |
payment_failure |
支払いのエラーに関する情報。 |
原因
エラーの原因の列挙。
| 列挙型 | |
|---|---|
CAUSE_UNSPECIFIED |
デフォルト値: 使用しないでください。「不明なエラー」になります |
SLOT_UNAVAILABLE |
参照された予約枠は利用できなくなっています。 |
SLOT_ALREADY_BOOKED_BY_USER |
ユーザーは参照された予約枠をすでに予約しています。 |
LEASE_EXPIRED |
リース(指定されている場合)が期限切れになり、リクエストされた予約を完了するために使用できなくなりました。 |
OUTSIDE_CANCELLATION_WINDOW |
リクエストされたキャンセルは、販売者のキャンセル ポリシーの時間制限により、現時点では実行できません。 |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
指定されたクレジット カードの種類が販売者に受け入れられなかったため、支払いの処理中にエラーが発生しました。クレジット カードの種類は、rejected_card_type で指定する必要があります。 |
PAYMENT_ERROR_CARD_DECLINED |
指定されたクレジット カードが承認されなかったため、支払いの処理中にエラーが発生しました。 |
PAYMENT_OPTION_NOT_VALID |
予約の支払いに使用されたパック / メンバーシップでエラーが発生しました。有効な残高がなかったか、有効期限が切れている可能性があります。 |
PAYMENT_ERROR |
この予約の支払いの処理中にエラーが発生しました。上記の支払いエラーと一致しない場合にのみ、この値を使って一般的な支払い関連のエラーを示します。 |
USER_CANNOT_USE_PAYMENT_OPTION |
ユーザーは指定された支払いオプションを使用できません(1 回限りの価格を 2 回目に使用しようとしているユーザーなど)。 |
BOOKING_ALREADY_CANCELLED |
ユーザーがキャンセルしようとした予約はすでにキャンセルされています。 |
BOOKING_NOT_CANCELLABLE |
ユーザーがキャンセルしようとした予約はキャンセルできません。 |
OVERLAPPING_RESERVATION |
ユーザーがこの時間の近くにすでに予約を行っています。 |
USER_OVER_BOOKING_LIMIT |
アグリゲータのユーザーあたりの予約制限を超えているため、予約が失敗しました。 |
PAYMENT_REQUIRES_3DS1 |
取り引きの再試行をリクエストしていますが、今回は 3DS1 のチャレンジ / レスポンスを行った後にリクエストしたため、支払いが拒否された場合に設定されます。現在のトランザクションのエラー状態はエラーのままになります。再試行は完全に別に行われます。 これがエラーの理由である場合は、payment_failure.3DS1_parameters を設定する必要があります。そうでない場合は、現在の原因は PAYMENT_ERROR のように扱われます。 |
PaymentFailureInformation
支払いのエラーに関する情報。
| フィールド | |
|---|---|
threeds1_parameters |
ユーザーとの 3DS1 認証プロトコルを開始するために、RwG アグリゲータによって使用されるパラメータ。BookingFailure.cause が PAYMENT_REQUIRES_3DS1 に設定されていない限り無視されます。 |
ThreeDS1Parameters
RwG が 3DS1 チャレンジを実行するようリクエストするパラメータ。
パラメータは、3DS1 プロトコルの EMVCo の説明によって設定されます。
| フィールド | |
|---|---|
acs_url |
認証のために User に表示するフォームの読み込み元の URL。 |
pa_req |
PaymentAuthentication リクエスト。指定された場合、ACSUrl フォームに投稿されます。 |
transaction_id |
ACS プロバイダにより使用される識別子。指定された場合、ACSUrl フォームに投稿されます。 |
md_merchant_data |
販売者データ。指定された場合、ACSUrl フォームに投稿されます。 |
BookingStatus
予約のステータス
| 列挙型 | |
|---|---|
BOOKING_STATUS_UNSPECIFIED |
指定されていません。 |
CONFIRMED |
予約が確認されました。 |
PENDING_MERCHANT_CONFIRMATION |
予約は、CONFIRMED ステータスへの移行前の販売者による確認待ちです(現在サポートされていません)。 |
PENDING_CLIENT_CONFIRMATION |
予約は、CONFIRMED ステータスへの移行前の顧客による確認待ちです(現在サポートされていません)。 |
CANCELED |
ユーザーに代わって予約がキャンセルされました。 |
NO_SHOW |
予約が顧客により無断キャンセルされました。 |
NO_SHOW_PENALIZED |
予約が顧客により無断キャンセルされ、キャンセル ポリシー違反となりました。 |
FAILED |
処理に失敗したため、予約を完了できませんでした。 |
DECLINED_BY_MERCHANT |
予約は販売者によって非同期的に拒否されました。 |
CallMerchant
この型にはフィールドがありません。
UnsupportedPartySizeOption で使用される空のメッセージ。これを設定すると、ユーザーに予約のためにビジネスに電話をかけるオプションが表示されます。
CancellationPolicy
サービスのキャンセル ポリシー。
| フィールド | |
|---|---|
refund_condition[] |
ポリシーに適用される 0 個以上の払い戻し条件。 |
RefundCondition
単一の払い戻し条件を定義します。複数の払い戻し条件を組み合わせて使用すると、サービスの開始時刻までのさまざまな期間として「払い戻しステップ」を記述できます。
| フィールド | |
|---|---|
min_duration_before_start_time |
開始時刻までの期間。顧客は、この時刻まで |
refund_percent |
サービス開始時刻の |
ClientInformation
予約者の個人情報
| フィールド | |
|---|---|
given_name |
顧客の名前 |
family_name |
顧客の姓 |
address |
クライアントの住所 |
telephone |
クライアントの電話番号 |
email |
クライアントのメールアドレス |
CreateAdsAccountLinkRequest
AdsAccountLinkingService.CreateAdsAccountLink に対するリクエスト メッセージ。
| フィールド | |
|---|---|
parent |
必須。この広告アカウントのリンクが作成される親リソース。これはパートナー センターのアカウント ID と同じです。形式: partners/{partner} |
ads_account_link_id |
必須。広告アカウント リンクに使用する ID。これは Google 広告のお客様 ID と同じです。詳しくは、https://support.google.com/google-ads/answer/1704344 をご覧ください。形式 : xxx-xxx-xxxx。 |
ads_account_link |
必須。作成する AdsAccountLink。 |
CreateMerchantRequest
Merchant を作成するためのリクエスト。
| フィールド | |
|---|---|
parent |
この販売者を所有するパートナーの親リソース名(形式: |
merchant_id |
この販売者に使用する販売者 ID。 |
merchant |
作成する販売者。 |
CreateServiceRequest
新しい Service を作成するためのリクエスト。
| フィールド | |
|---|---|
parent |
このサービスを所有する販売者の親リソース名(形式: |
service_id |
このサービスに使用するサービス ID。 |
service |
作成するサービス。 |
CreditCardRestrictions
この販売者が受け付けるクレジット カードの種類の制限。
| フィールド | |
|---|---|
credit_card_type[] |
サポートされているクレジット カードのリスト。空の場合、クレジット カードはサポートされません。 |
CreditCardType
クレジット カードの種類。
| 列挙型 | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
未使用。 |
VISA |
Visa クレジット カード。 |
MASTERCARD |
Mastercard クレジット カード。 |
AMERICAN_EXPRESS |
American Express クレジット カード。 |
DISCOVER |
Discover クレジット カード。 |
JCB |
JCB クレジット カード。 |
DeleteAdsAccountLinkRequest
AdsAccountLinkingService.DeleteAdsAccountLink に対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。削除する AdsAccountLink の名前。形式: partners/{partner}/adsAccountLinks/{ads_account_link} |
DeleteMerchantRequest
Merchant を削除するリクエスト。
| フィールド | |
|---|---|
name |
削除する販売者のリソース名(形式: partners/{partner_id}/merchants/{merchant_id})。 |
DeleteServiceRequest
Service を削除するリクエスト。
| フィールド | |
|---|---|
name |
削除するサービスのリソース名(形式: |
Deposit
ユーザーに請求される、またはクレジット カードに保留されている保証料。
| フィールド | |
|---|---|
deposit |
保証料の金額。 |
min_advance_cancellation_sec |
保証料払い戻しのための最低事前キャンセル時間。 |
deposit_type |
空き情報を基に保証料を決定する方法を定義します。 |
DirectMerchantPayment
ユーザーが RwG 経由でサービス料金を前払いするのではなく、販売者に直接支払う方法に関する情報。
| フィールド | |
|---|---|
payment_methods[] |
お支払いは、以下の方法でのみ行うようお客様に伝えます。 |
DurationRange
制限付きまたは制限なしにできる期間の範囲のラッパー。min_duration と max_duration のうち少なくとも 1 つは必須です。
| フィールド | |
|---|---|
min_duration |
最小期間。 |
max_duration |
最大期間。 |
EconomicOperator
アグリゲータの経済事業者情報。
| フィールド | |
|---|---|
text |
必須。経済事業者の名前、住所、電話番号、メールアドレス。経済事業者とは、製造業者、正式な代表者、輸入業者、販売業者、フルフィルメント サービス プロバイダ、または製品の製造、提供、使用開始に関連する義務を負うその他の個人または法人として定義されます。economic_operator の自由形式の文字列表現。この情報は「 」と「\n」を使用してフォーマットできます。 |
ExtendedServiceAvailability
空き情報のリストおよび申し込み対象先と申し込み対象時間
| フィールド | |
|---|---|
merchant_id |
これは、以下の空き情報メッセージが属する販売者を指定するための必須フィールドです。 |
service_id |
これは、以下の空き情報メッセージが属するサービスを指定するための必須フィールドです。 |
start_time_restrict |
指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。 duration メッセージが設定されている場合、条件はさらに制限されます。 resource_restrict メッセージが設定されている場合、条件はさらに制限されます。 これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。 start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。 |
end_time_restrict |
start_time_restrict を設定せずに end_time_restrict を設定すると、end_time_restrict までの全期間とみなされます。 |
duration_restrict |
duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。 |
resources_restrict |
resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。 |
availability[] |
空き情報の新しいリスト。 |
FeedStatistics
アップロードされたフィードの処理中に取得された統計情報。
| フィールド | |
|---|---|
new_items |
このフィードにより新しく追加された項目。フィードの種類に応じて、販売者、サービス、または予約枠になります。 |
existing_items |
既存の項目。フィードの最新情報から必要に応じて更新されます。 |
deleted_items |
このフィード内に存在せず、結果的に削除された項目。 |
FeedStatus
アグリゲータのプラットフォームからアップロードされたフィードのステータス。
| フィールド | |
|---|---|
name |
以下の形式を持つフィード リソース名:
|
state |
このフィードの処理ステータス。 |
error_details |
このフィードの処理が失敗した場合に詳細を説明する、人が読んで理解できる文字列。 |
statistics |
このフィードに固有の統計情報。 |
州
フィードの処理状態を示す列挙型。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
デフォルト値。未使用。 |
IN_PROGRESS |
フィードが処理中です。 |
SUCCESS |
フィードが正常に処理されました。 |
FAILURE |
フィードの処理中にエラーが発生しました。 |
FoodOrderingMetadata
料理の注文アクション リンクのメタデータ。
| フィールド | |
|---|---|
fee_details[] |
アイテムの合計に加えてユーザーに請求される手数料の詳細。サービス手数料、配送料など、さまざまな種類の手数料について繰り返されます。 |
advance_order_details |
事前注文サポート(ユーザーが今すぐではなく後で注文できる)の詳細。 |
共用体フィールド fulfillment_duration_options。注文確認から注文処理までの時間。配達注文の場合、料理が配達されるまでの時間。受け取り注文の場合、料理の受け取り準備が整うまでの時間。fulfillment_duration_options は次のいずれかになります。 |
|
fulfillment_lead_time_duration |
固定期間。例: 30 分。 |
fulfillment_lead_time_duration_range |
期間の範囲。例: * 30 分~ 45 分 * 30 分以上 * 50 分未満 |
AdvanceOrderDetails
事前注文のサポート。
| フィールド | |
|---|---|
is_supported |
事前注文(Order Ahead)がサポートされている場合は true。(必須) |
FeeDetails
料金の詳細。
| フィールド | |
|---|---|
type |
料金タイプ。(必須) |
fee_amount |
料金の金額。単位通貨、カートの金額の割合、またはその両方の組み合わせで指定します。(必須) |
FeeAmount
FeeAmount の例: * 固定手数料: USD 0(手数料なし)、USD 1.5 * 固定手数料の範囲: USD 1.0(最小)、USD 3.0(最大)、USD 5.0 ~ 6.0 * カートサイズの割合: 15.5%、10%~ 20%、10%(最小)、15%(最大) * 範囲と割合の組み合わせ: 25.5% と USD 2.5(最小)、25.5% と USD 4.5(最大)、 10% と USD 1.5 ~ 2.5、10.5%~ 20% と USD 2.5 ~ 3.5
| フィールド | |
|---|---|
cart_percentage |
カートの価格に対する割合で表した手数料。範囲(上限と下限あり、上限と下限なし)または固定の割合をサポートします。値は 0 ~ 100 の範囲で指定してください。例: * 5.5% 固定 * 5.5% 以上 * 5.5% 以下 * 4.5% ~ 5.5% |
共用体フィールド amount_options。金額を指定するオプション。amount_options は次のいずれかになります。 |
|
amount |
固定額。例: USD 3.5。 |
amount_range |
金額の範囲。例: * USD 3.5 ~ USD 5.5 * USD 3.5 以上 * USD 5.5 以下 |
amount_unknown |
不明な金額。 |
FeeType
料金タイプ。
| 列挙型 | |
|---|---|
FEE_TYPE_UNSPECIFIED |
料金タイプが指定されていません。 |
DELIVERY |
配送料について。 |
SERVICE |
サービス手数料の場合。 |
FulfillmentOption
オンライン注文アクション リンクの配送オプション。
| フィールド | |
|---|---|
fulfillment_type |
必須。フルフィルメント タイプ。 |
available_day[] |
必須。このフルフィルメント方法を利用できる日のリスト(できれば 2 日以上)。 |
fee_details |
必須。フルフィルメント方法の手数料の詳細。 |
minimum_order |
必須。アクション リンクに関連付けられたフルフィルメント方法の最小注文数。 |
AvailableDay
日単位の空き状況。
| フィールド | |
|---|---|
fulfillment_date |
必須。フルフィルメント方法の利用可能な日付。販売者のタイムゾーンにあると想定されます。 |
last_ordering_time |
必須。Unix タイムスタンプ。ユーザーが たとえば、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 時までに注文する必要があります。 |
FeeDetails
アクション リンクに関連付けられたフルフィルメント方法の料金の詳細。
| フィールド | |
|---|---|
共用体フィールド fee_details。フルフィルメント方法の料金モデル。fee_details は次のいずれかになります。 |
|
no_fee |
フルフィルメント方法の料金はかかりません。 |
base_fee |
配送方法に関連付けられた基本料金。 |
fixed_fee |
フルフィルメント方法に関連付けられた固定料金。 |
FixedFee
アクション リンクに関連付けられたフルフィルメント方法に必要な固定料金。
| フィールド | |
|---|---|
amount |
必須。フルフィルメント方法の固定料金の金額。 |
FulfillmentType
アクション リンクに関連付けられているフルフィルメント タイプ。
| 列挙型 | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
フルフィルメント タイプが指定されていません。 |
FULFILLMENT_TYPE_DELIVERY |
フルフィルメント タイプは配達です。 |
FULFILLMENT_TYPE_PICKUP |
フルフィルメント タイプは受け取りです。 |
MinimumFee
アクション リンクに関連付けられたフルフィルメント方法に必要な最低料金。
| フィールド | |
|---|---|
base_fee_amount |
必須。配送方法の基本料金。 |
NoFee
この型にはフィールドがありません。
アクション リンクに関連付けられたフルフィルメント方法には料金はかかりません。
GenericDeleteRecord
URL リクエストで言及されているフィードタイプの削除対象レコード。
| フィールド | |
|---|---|
delete_time |
必須。このタイムスタンプは、広告枠に削除を適用する順序を決定するために使用されます。 |
共用体フィールド record_type。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化します。パートナーは、フィードまたは BatchPush API でレコードが提供される方法と同様に、完全なレコードを提供できます。パートナーは、レコードを一意に識別するために必要な必須フィールドのみを含めることもできます。record_type は次のいずれかになります。 |
|
data_record |
非 proto ベースのフィードの場合。 |
proto_record |
proto ベースのフィードの場合。 |
GenericRecord
URL リクエストで言及されているフィードタイプのレコード。
| フィールド | |
|---|---|
generation_timestamp |
必須。このタイムスタンプは、在庫更新の順序を正しく保つために使用されます。 |
共用体フィールド record_type。さまざまな種類のフィード(ndjson、proto ベースなど)をカプセル化します。record_type は次のいずれかになります。 |
|
data_record |
非 proto ベースのフィードの場合。 |
proto_record |
proto ベースのフィードの場合。 |
GeoCoordinates
ビジネス拠点の地理データ(緯度、経度、住所など)。
| フィールド | |
|---|---|
latitude |
緯度。(省略可) |
longitude |
経度。(省略可) |
共用体フィールド addresses。ビジネス拠点の住所。構造化されている住所とされていない住所が可能で、addresses は次のいずれかになります。 |
|
address |
ビジネス拠点の、郵便物の送付先となる住所(推奨)。 |
unstructured_address |
非構造化住所(例: 1600 amphitheatre parkway mountain view, ca 94043) |
GetAdsAccountLinkRequest
AdsAccountLinkingService.GetAdsAccountLink に対するリクエスト メッセージ。
| フィールド | |
|---|---|
name |
必須。取得する広告アカウント リンクの名前。形式: |
GetMerchantStatusRequest
MerchantStatus を取得するリクエスト
| フィールド | |
|---|---|
name |
必須。リソース名。形式は partners/{partner_id}/merchants/{merchant_id}/status。 |
GetStatusRequest
アグリゲータのプラットフォームからアップロードされた特定のフィードの Status を取得するためのリクエスト。
| フィールド | |
|---|---|
name |
以下の形式を持つフィード リソース名:
|
HomeServiceData
ホームサービス業種で提供する必要がある追加情報。
| フィールド | |
|---|---|
category_type |
このホーム サービスが属する大まかなカテゴリ。例: 配管工、電気技師など |
job_type |
指定されたホーム サービスが属するカテゴリのサービスの種類。たとえば、plumber カテゴリのジョブタイプは unclog_drain、install_faucet などです。 |
IntegrationType
サポートされている統合の程度。
| 列挙型 | |
|---|---|
INTEGRATION_TYPE_UNSPECIFIED |
デフォルトは END_TO_END です。 |
INTEGRATION_TYPE_END_TO_END |
Google を通じてエンドツーエンドの予約を可能にする完全な統合。 |
INTEGRATION_TYPE_INVENTORY_ONLY |
予約サーバーはこのサービスをサポートする必要はありません。販売者、サービス、(省略可)空き情報データのみを送信する必要があります。 |
InvalidateResourceRequest
リソースを無効にするリクエスト。
| フィールド | |
|---|---|
resource_id |
無効にするリソースの名前。 たとえば、Pickup リソースの場合、名前の形式は |
LineItem
1 件の注文内の 1 つの項目。1 つの時間枠での 1 つのサービスの予約。
| フィールド | |
|---|---|
service_id |
販売者のサービス ID。 |
start_sec |
予約枠の開始時刻(Unix エポックからの経過時間での秒単位)。 |
duration_sec |
予約枠の長さ(秒単位)。 |
tickets[] |
チケットタイプ別の注文済みチケット数。 |
price |
この項目の合計金額(税抜き)。 |
status |
広告申込情報のステータス。 |
OrderedTickets
チケットタイプ別の注文済みチケット数。
| フィールド | |
|---|---|
ticket_id |
チケットタイプの ID。 |
count |
このタイプの注文済みチケット数。 |
LinkoutTemplate
パートナーのサイトへの URL を Google が生成する方法を指定するテンプレート。
| フィールド | |
|---|---|
uri_template |
URI テンプレートは RFC 6570 に準拠している必要があります。https://datatracker.ietf.org/doc/html/rfc6570 をご覧ください。レベル 1 テンプレートとすべてのレベル 4 複合テンプレートをサポートします。例: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc |
ListMerchantStatusesRequest
MerchantStatus のリストを取得するリクエスト
| フィールド | |
|---|---|
parent |
必須。この販売者ステータスのコレクションを所有する親。形式: |
page_size |
必須。返される最大アイテム数。サーバーによってページサイズが縮小されることがあります。 |
page_token |
省略可。前の ListMerchantStatusResponse から返された nextPageToken 値(存在する場合)。 |
booking_inventory_status_restrict |
省略可。予約在庫のステータスで結果をフィルタする省略可能な制限。 |
waitlist_inventory_status_restrict |
省略可。ウェイティング リストの在庫ステータスで結果をフィルタする省略可能な制限。 |
geo_match_restrict |
省略可。地域一致ステータスで結果をフィルタする省略可能な制限。 |
BookingInventoryStatus
エンドツーエンドの予約の在庫ステータス。
| 列挙型 | |
|---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
指定されていません。 |
NO_VALID_FUTURE_INVENTORY |
販売者が今後 30 日間の予約在庫を保有していない。 |
HAS_VALID_FUTURE_INVENTORY |
販売者は今後 30 日間の予約在庫を持っています。 |
GeoMatchingStatus
販売者の地域一致ステータス。
| 列挙型 | |
|---|---|
GEO_MATCHING_STATUS_UNSPECIFIED |
指定されていません。 |
GEO_UNMATCHED |
販売者が地域と一致していません。 |
GEO_MATCHED |
販売者が地域で一致している。 |
WaitlistInventoryStatus
エンドツーエンドのウェイティング リストの在庫ステータス。
| 列挙型 | |
|---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
指定されていません。 |
NO_VALID_WAITLIST_SERVICE |
販売者に順番待ちリストをサポートするサービスがない。 |
HAS_VALID_WAITLIST_SERVICE |
販売者は順番待ちリストをサポートするサービスを利用している。 |
ListMerchantStatusesResponse
MerchantStatus のリストに対するレスポンス。
| フィールド | |
|---|---|
merchant_statuses[] |
フィルタ条件を満たす販売者のステータスのリスト。 |
next_page_token |
次の結果ページを取得するためのトークン。空の場合、リストにこれ以上結果はありません。 |
ListStatusRequest
アグリゲータのプラットフォームからアップロードされた複数のフィードの Status を取得するためのリクエスト。
| フィールド | |
|---|---|
name |
以下の形式を持つフィード リソース名:
|
page_size |
返す最大アイテム数。 |
page_token |
前の List リクエストから返された next_page_token 値(存在する場合)。 |
state_restrict |
(省略可)フィードの状態で結果をフィルタする制限。 |
time_range_restrict |
(省略可)結果を上限と下限でフィルタする制限。start_time が設定されていない場合は、デフォルトで Unix 時間の起点に設定されます。end_time が設定されていない場合は、デフォルトで現在の時間に設定されます。 |
ListStatusResponse
アグリゲータのプラットフォームからアップロードされた複数のフィードの Status を取得するためのリクエスト。
| フィールド | |
|---|---|
status[] |
アップロードしたフィードのステータスを日付の新しい順に並べ替えます。返されるアイテムの最大数は、リクエストの page_size フィールドに基づきます。 |
next_page_token |
次の結果ページを取得するためのトークン。空の場合、リストにこれ以上結果はありません。 |
LocalizedString
1 つの言語 / 地域の文字列のインスタンス。
| フィールド | |
|---|---|
locale |
IETF BCP 47 言語コード(「en」、「mas」、「zh-Hant」、「de-CH-1901」など)。詳しくは、http://www.w3.org/International/articles/language-tags/ をご覧ください。 |
value |
上記の言語 / 地域(UTF-8)でのメッセージ。 |
場所
ビジネス拠点に関する地理情報。
| フィールド | |
|---|---|
place_id |
Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。指定すると、ビジネス拠点がこの場所とマッチングされます。 |
name |
ビジネス拠点の名前、電話番号、URL、地域は、そのビジネス拠点を Google マップにすでに表示されている場所とマッチングするために使用されます。 このフィールドは省略可能ですが、コンテキストによっては必須になる場合があります。たとえば、名前のない Service.location は、同じ住所に所在していても、事業体と照合されません。(省略可) |
telephone |
国番号と市外局番を含む、ビジネス拠点の電話番号(例: +14567891234)。(省略可) |
url |
ビジネス拠点の公開ウェブサイトの URL。(省略可) |
geo |
ビジネス拠点の地理情報(緯度、経度、住所など)。(省略可) |
location_type |
ビジネス拠点のタイプ。このビジネス拠点が Service に指定されている場合は指定する必要があります。 |
location_id |
サービス内のビジネス拠点の一意の参照。この ID を使用して、他のサービス フィールドでこのビジネス拠点を参照できます。たとえば、カスタム インテイク フォームで、一連のビジネス拠点 ID を使用して、迎車場所オプションを指定できます。設定されている場合、この ID は同じサービス内で一意でなければなりません。(省略可) |
LocationType
このビジネス拠点のタイプ。
| 列挙型 | |
|---|---|
LOCATION_TYPE_UNSPECIFIED |
ビジネス拠点タイプが指定されていません。 |
VISITED_LOCATION |
このサービスで訪れる場所。 |
START_LOCATION |
このサービスが開始する場所。MEETING_LOCATION としても機能します。 |
END_LOCATION |
このサービスが終了する場所。 |
Merchant
アグリゲータのプラットフォーム上の販売者に関する情報。
| フィールド | |
|---|---|
name |
販売者リソース名(形式: |
merchant_name |
merchant_name、電話番号、URL、地域は、パートナーの空き情報を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。 販売者の名前。 |
telephone |
販売者の国番号と市外局番を含む公開電話番号(例: +14567891234)。 |
url |
販売者の公開ウェブサイトの URL。 |
geo |
販売者の地理情報(緯度、経度、住所など)。 |
category |
アグリゲータのプラットフォームにおけるビジネスのカテゴリ。 |
num_bookings_30d |
このフィールドのサポートは終了しました。 |
tax_rate_basis_points |
販売者の税率(ベーシス ポイント: 1% の 100 分の 1)。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。 このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。 このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金(ここで指定された税率を基に算出)が含まれます。最小通貨単位の端数(1 セントの端数など)は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。 このフィールドは非推奨です。代わりに、tax_rate を使用してください。 |
tax_rate |
販売者の税率。指定されている場合、このフィールドは非推奨の tax_rate_basis_points フィールドをオーバーライドします。メッセージが空の場合(tax_rate { } など)、適用される税率はゼロにリセットされます。E2E 支払いのサポートが終了したため、非推奨になりました。 |
payment_restrictions |
この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合、制限は存在しないとみなされます。E2E 支払いのサポートが終了したため、非推奨になりました。 |
payment_option[] |
この販売者で利用可能な支払いオプション。この販売者のサービスでは、利用可能な支払いオプションを個別に制限できます。E2E 支払いのサポートが終了したため、非推奨になりました。 |
payment_processor_config |
トークン化された決済代行業者の設定(販売者がサポートしている場合)。 |
tokenization_config |
トークン化された決済代行業者の設定(販売者がサポートしている場合)。E2E 支払いのサポートが終了したため、非推奨になりました。 |
terms |
「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。アグリゲータ パートナーの利用規約は常にユーザーに表示されるため、これに加えてアグリゲータ パートナーの利用規約はここでは提供しないでください。 |
brand_id |
パートナーの帰属を表示する際に使用する、消費者向けのブランドを識別する不透明型の文字列。このフィールドを使用すると、複数の消費者向けブランドを所有するパートナーが、同じフィード内のすべてのブランドの販売者を指定できます。 ブランドは、名前、ロゴ、利用規約、プライバシー ポリシーなど、消費者向けのプロパティで構成されます。 消費者向けのパートナー ブランドが 1 つしかない場合は、このフィールドを設定する必要はなく、無視してかまいません。 パートナーの種類別の処理方法: 消費者向けのブランドが 1 つしかない場合は、このフィールドは無視します。 複数のブランドが設定されている場合は、次のように処理されます。 注意: ほとんどのパートナーは、このフィールドを設定する必要はありません。パートナーがこのフィールドを使用する場合は、各ブランド(デフォルトのブランドを含む)を個別に設定する必要がありますので、Google までご連絡ください。 |
matching_hints |
販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。(省略可) |
service_attribute[] |
この販売者のサービスを説明するために使用されるサービス属性の定義。(省略可) |
action_link[] |
省略可。関連する言語を含むアクション URL、表示を制限する国のリスト、タイプ、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。 |
reservation_linkout_template[] |
省略可。パートナーのプラットフォームでテーブルを予約するための URL を Google が生成する方法を指定するリンクアウト テンプレート。 現在、複数の値が指定されている場合は、最初の値のみが使用されます。 URI テンプレートは、ユーザーの予約選択に基づいて入力されるフィールドをサポートしています。予約の URL を正常に作成するには、すべての必須フィールドが必要です。* (必須)party_size、整数: ユーザーが予約をリクエストしているグループの人数。*(必須)selected_date_time、ISO 8601 日時(https://en.wikipedia.org/wiki/ISO_8601): ユーザーが予約をリクエストしている時間。* (省略可)merchant_id、文字列: ユーザーが予約をリクエストしている販売者の ID。テンプレートに販売者 ID がすでに含まれている場合は不要です。*(省略可)room_id、文字列: ユーザーが予約をリクエストしている部屋の ID。 |
waitlist_advisement |
省略可。「Google で予約」を通じて順番待ちリストに登録したユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイス内の個々のテキスト フィールドの長さは 100 バイトに制限されます。 |
economic_operator |
省略可。規制遵守に必要な、この特定の販売者に関連付けられた経済事業者の情報。(省略可) |
MerchantMatchingHints
販売者が Google マップの場所とマッチングされる際に使用されるヒント。
| フィールド | |
|---|---|
place_id |
Google プレイス データベースと Google マップ上の場所の Place ID。プレイス ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。 |
MerchantStatus
Google で予約プラットフォームでの販売者のステータス。
| フィールド | |
|---|---|
name |
販売者のステータス リソース名(形式: |
merchant_name |
パートナーから提供された販売者の名前。 |
input_geo_info |
パートナーが販売者の地理情報を提供しました。 |
processing_status |
販売者の処理ステータス。 |
booking_status |
エンドツーエンドの予約統合に関連するステータス。 |
waitlist_status |
順番待ちリストの統合に関連するステータス。 |
geo_match |
この販売者の Geo プレイスが一致しました。販売者が地域で一致していない場合は空になります。 |
local_services_match |
この販売者のローカル サービスのマッチング。ローカル サービス販売者でない場合、またはプロバイダと一致しない場合は空になります。 |
direct_urls[] |
現在の販売者の在庫の内容を示す URL のリスト。広告枠が実際に配信されていることを意味するわけではなく、URL は一般公開されているものとは異なる場合があります。 |
BookingStatus
エンドツーエンドの予約統合に関連するステータス。
| フィールド | |
|---|---|
has_valid_future_inventory |
販売者が今後 30 日以内に在庫を確保している場合は true。販売者に実際に広告が表示されることを保証するものではありません。 |
DirectUrl
販売者を表示する URL。
| フィールド | |
|---|---|
type |
この URL のタイプ。 |
url |
この販売者が表示される可能性のある URL。 |
UrlType
表示される URL のタイプ。
| 列挙型 | |
|---|---|
URL_TYPE_UNSPECIFIED |
指定されていません。 |
BOOKING |
エンドツーエンドの予約 URL。 |
WAITLIST |
エンドツーエンドのウェイティング リストの URL。 |
LOCAL_SERVICES |
Google ローカル サービスの URL。 |
LocalServicesMatchInfo
Google ローカル サービス マッチングの情報(ローカル サービス販売者のみに設定)。
| フィールド | |
|---|---|
matched_providers[] |
一致したサービス プロバイダ。1 つの販売者が複数のサービス プロバイダと照合されることがあります。 |
MatchedProvider
ローカル サービス プロバイダ。
| フィールド | |
|---|---|
customer_id |
Google ローカル サービスの外部お客様 ID。 |
categories[] |
ローカル サービスのカテゴリ(業種)。例: 「plumber」、「carpet_cleaning」。 |
PlaceInfo
一致した場所の情報。
| フィールド | |
|---|---|
name |
場所の名前。 |
formatted_address |
現地語でフォーマットされた住所。 |
place_id |
この場所の Google プレイス ID。Google マップの URL を作成したり、場所の詳細情報を取得したりするために使用できます。使用例については、https://developers.google.com/places/web-service/place-id をご覧ください。 |
ProcessingStatus
販売者の処理ステータス。
| 列挙型 | |
|---|---|
PROCESSING_STATUS_UNSPECIFIED |
ステータスの指定なし。 |
IN_PROGRESS |
販売者は Madden に登録されていますが、まだ処理中です。このステータスの販売者には、他のステータスは設定されません。 |
COMPLETED |
販売者の他のステータスが計算されました。 |
WaitlistStatus
順番待ちリストの統合に関連するステータス。
| フィールド | |
|---|---|
has_valid_waitlist_service |
販売者が順番待ちリスト サービスを利用している場合は true。販売者に実際に広告が表示されることを保証するものではありません。 |
MoneyRange
制限付きまたは制限なしの金額の範囲のラッパー。min_amount と max_amount のうち少なくとも 1 つは必須です。
| フィールド | |
|---|---|
min_amount |
最小額。 |
max_amount |
最大額。 |
NoShowFee
ユーザーが予約したにもかかわらず無断キャンセルした場合に請求される可能性のある料金。
| フィールド | |
|---|---|
fee |
ユーザーが予約したにもかかわらず無断キャンセルした場合に請求される可能性のある金額。 |
fee_type |
空き情報を基に料金を決定する方法を定義します。 |
注文
販売者にサービスを予約する際の注文。
| フィールド | |
|---|---|
name |
注文のリソース名: |
client_information |
注文を行っている顧客の個人情報。 |
payment_information |
注文に関連する支払い取引に関する情報。 |
merchant_id |
この注文が属するすべてのサービスを提供する販売者の ID。 |
item[] |
この注文の項目。 |
OrderOnlineMetadata
オンライン注文アクション リンクのメタデータ。
| フィールド | |
|---|---|
fulfillment_option[] |
オンライン注文アクション リンクで利用可能なフルフィルメント オプション。 |
PaymentInformation
予約に関する支払いの詳細
| フィールド | |
|---|---|
prepayment_status |
予約の前払いステータス。prepayment_status が PREPAYMENT_PROVIDED または PREPAYMENT_REFUNDED の場合、payment_transaction_id には関連付けられた一意の取引 ID が含まれます。 |
payment_transaction_id |
予約に関連付けられた支払い処理の一意の識別子。該当しない場合は空になります。 |
PaymentOption
販売者が提供するサービスの支払いに使用できる支払いオプション。支払いオプションは、複数の販売者(同じチェーンに属する販売者など)で共有できます。
| フィールド | |
|---|---|
payment_option_id |
この ID は、この支払いオプションを識別するために使用されます。 この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。 ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。 |
name |
支払いオプションの名前。これはユーザーに表示されます。 |
description |
支払いオプションについての説明。これはユーザーに表示されます。 |
price |
支払いオプションの価格。 |
tax_rate |
この支払いオプションの税率。指定されている場合、このフィールドは Merchant または Service にある tax_rate フィールドをオーバーライドします。メッセージが空(例: tax_rate { })の場合、適用される税率はゼロにリセットされます。 |
payment_option_type |
この支払いオプションの種類。ドロップインには 1 回限り、パックには複数回、メンバーシップには無制限の使用が可能。 |
session_count |
この支払いオプションを利用できるセッション数。値が 1 以上となるマルチセッションやパックの場合にのみ有効。 |
purchase_interval |
支払いオプションを購入できる期間。 |
valid_interval |
支払いオプションはこの期間内に利用できます(例: 2017 年 1 月の特別価格)。設定されている場合は、valid_duration、activation_type をオーバーライドします。 |
valid_duration |
支払いオプションの有効期間(例: 30 日間のメンバーシップ)。 |
activation_type |
この支払いオプションが有効となる開始日を決定する方法を定義します。 |
user_restriction |
この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定されていない場合、すべてのユーザーが対象となります。 |
ActivationType
有効期間の開始日を決定する方法を定義します。
| 列挙型 | |
|---|---|
ACTIVATION_TYPE_UNSPECIFIED |
未使用。 |
ACTIVATION_ON_PURCHASE |
購入時から有効期間が開始します。 |
ACTIVATION_ON_FIRST_USE |
支払いオプションの初回使用時に有効期間が開始します。 |
PaymentOptionType
支払いオプションのタイプ。
| 列挙型 | |
|---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
未使用。 |
PAYMENT_OPTION_SINGLE_USE |
支払いオプションは 1 回のみ使用可能。 |
PAYMENT_OPTION_MULTI_USE |
支払いオプションは、セッション数 > 0 の場合に使用できます。 |
PAYMENT_OPTION_UNLIMITED |
支払いオプションは有効期間内に利用できます。セッション数は該当しません。 |
PaymentProcessorConfig
決済代行業者の設定。Merchant ごとに設定します。
| フィールド | |
|---|---|
processor |
この設定が適用される決済代行業者を定義します。 |
public_key |
この販売者を決済代行業者に応じて識別するために使用するキー。 Stripe については、https://stripe.com/docs/dashboard#api-keys をご覧ください。Braintree については、https://articles.braintreepayments.com/control-panel/important-gateway-credentials をご覧ください。 |
version |
支払いリクエストとともに決済代行業者に送信される API バージョン番号。 |
プロセッサ
特定の決済代行業者パートナーを定義します。
| 列挙型 | |
|---|---|
PROCESSOR_UNSPECIFIED |
未使用 |
PROCESSOR_STRIPE |
Stripe を利用する支払いの設定。 |
PROCESSOR_BRAINTREE |
Braintree を利用する支払いの設定。 |
PaymentRestrictions
この販売者が受け付ける支払い方法に関する制限。
| フィールド | |
|---|---|
credit_card_restrictions |
この販売者が受け付けるクレジット カードに関する制限。このフィールドが設定されていない場合は、すべてのクレジット カードが受け付けられるとみなされます。なお、CreditCardType でサポートされるカードの数は今後増える予定ですので、このフィールドを空にすると今後、設定が変更される可能性があります。 |
PerOrderFee
チケットの数に関係なく、注文ごとに 1 回支払う必要がある料金。
| フィールド | |
|---|---|
delivery_fee |
配達方法によって異なる料金。 |
processing_fee |
ユーザーの支払い方法を処理するための料金。 |
PerTicketFee
ユーザーが購入するチケットごとに支払う必要がある料金。
| フィールド | |
|---|---|
service_charge |
サービスごとに課される追加料金。 |
facility_fee |
会場や施設に赴く際の料金。 |
taxes |
チケットごとの税金。 |
PostalAddress
顧客またはビジネス拠点の住所。
| フィールド | |
|---|---|
address_country |
国。ISO 3166-1 alpha-2 国コードを使用して指定(「US」など)。(必須) |
address_locality |
地域区分(例: 横須賀市)(必須) |
address_region |
県(例: 神奈川県)。このフィールドは、県が住所の一部である国でのみ必須です。(省略可) |
postal_code |
郵便番号(例: 94043)。(必須) |
street_address |
番地(例: 大町 3-5)。(必須) |
一括前払い
予約の一環としてユーザーに請求される可能性のある支払い。
| フィールド | |
|---|---|
price_info |
価格の詳細のコンテナ。 |
PrepaymentStatus
予約の前払いステータス。
| 列挙型 | |
|---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
指定されていない場合、デフォルトは PREPAYMENT_NOT_PROVIDED です。 |
PREPAYMENT_PROVIDED |
予約料金は前払いされています。 |
PREPAYMENT_NOT_PROVIDED |
予約料金は前払いされていません。 |
PREPAYMENT_REFUNDED |
料金は以前に PREPAYMENT_PROVIDED でしたが、現在は払い戻されています。 |
Price
サービスの価格または料金。
| フィールド | |
|---|---|
price_micros |
価格(最小通貨単位)。最小通貨単位の端数は、最近接偶数に丸められます(例: 2.5 セントは 2 セント、3.5 セントは 4 セント、0.5 セントは 0 セント、2.51 セントは 3 セントに丸められます)。 |
currency_code |
ISO 4217 で定義されている価格の通貨。 |
pricing_option_tag |
合計価格に関連付けられている価格設定オプションを識別する不透明型文字列(省略可)。 |
PriceInfo
価格の詳細のコンテナ。
| フィールド | |
|---|---|
price_type |
料金または価格帯の適用方法(1 人あたりまたは固定)を定義します |
共用体フィールド price_options。価格オプションでは、正確な価格または価格帯を指定します。price_options は次のいずれかになります。 |
|
price |
サービスの価格または料金。 |
price_range |
サービスまたは料金の上限または下限。 |
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 を空にする必要があります。 例: 家事のコンサルティング |
PriceRange
両方の値が設定されていない限り、上限なしとして扱われる金額の範囲のラッパー。min_amount と max_amount のうち少なくとも 1 つは必須です。
| フィールド | |
|---|---|
min_price |
最小額。 |
max_price |
最大額。常に min_price より大きくする必要があります。 |
PriceType
空き情報を基に合計価格を決定する方法を定義します。
| 列挙型 | |
|---|---|
FIXED_RATE_DEFAULT |
価格が固定額の場合に使用します。フィールドが設定されていない場合のデフォルト値です。 例: テーブルを予約するための 50 ドルのデポジット、ヨガクラスのキャンセル料 20 ドル |
PER_PERSON |
1 人あたりの価格を指定する場合に使用します。合計金額は、Resources で指定された人数を基に算出されます(price_micros × party_size)。PER_PERSON の価格は、空き情報リソースの人数に関連付ける必要があります。それ以外の場合は、人数として 1 が使用されます。 例: 美術館のチケット 1 枚 10 ドル |
QuantitativeValue
範囲または固定値のいずれかになる可能性のある数値のラッパー。QuantitativeValue の例: * 単一値: value: 10.5 * 境界範囲: value_range {min_value: 5.5, max_value 10.5} * 下限: value_range {min_value: 5.5} * 上限: value_range {max_value: 10.5}
| フィールド | |
|---|---|
共用体フィールド value_options。(必須)value_options は次のいずれかになります。 |
|
value |
単一の値。例: 5.6 |
value_range |
値の範囲。上限または下限を設定することもできます。例: * 5.5 以上 * 5.5 以下 * 5.5 ~ 6.5 |
RangeValue
min_value < max_value となる値の範囲。min_value と max_value の少なくとも 1 つが必要です。
| フィールド | |
|---|---|
min_value |
最小値。 |
max_value |
最大値 |
評価
エンティティの評価を定義します。
| フィールド | |
|---|---|
value |
平均評価値(number_of_ratings > 0 の場合は必須)。値は [1, 5] の範囲内で指定する必要があり、number_of_ratings がゼロの場合にのみ省略できます。 |
number_of_ratings |
値の計算に使用される評価の数(必須)。 |
RelatedMedia
このサービスに関連する写真。エンドユーザーに正しく表示されるよう、Google によりこれらのメディアがクロールされます。(省略可)
| フィールド | |
|---|---|
url |
このメディアソースの URL。この URL でホストされているメディアが、Google によりクロールされます。 |
type |
このメディアソースのタイプ。 |
localized_caption |
i18n をサポートするメディアのキャプション。書式なしテキストのみがサポートされています。HTML コンポーネントはすべて削除されます。(省略可) |
attribution |
メディアのソースに関する権利帰属情報。撮影者または代理店にクレジットを付与するために、メディアとともに権利帰属情報を表示する必要がある場合は、このフィールドを設定する必要があります。(省略可) |
caption |
非推奨。localized_caption を使用することをおすすめします。 |
Attribution
このメディアの権利帰属情報。
| フィールド | |
|---|---|
localized_text |
i18n をサポートする撮影者または代理店にクレジットを付与するテキスト。このテキストはソースメディアとともに表示されます。このフィールドでは書式なしテキストのみがサポートされ、HTML コンポーネントは削除されます(ハイパーリンク ベースの権利帰属は対象外です)。 |
text |
非推奨。localized_text を使用することをおすすめします。 |
MediaType
このメディアソースのタイプを示す列挙型。サポートされるのは写真のみです。写真以外のメディアのサポートが必要な場合は、「Google で予約」チームにお問い合わせください。
| 列挙型 | |
|---|---|
TYPE_UNSPECIFIED |
未使用。 |
PHOTO |
URL で提供されるメディアが写真であることを示します。 |
ReplaceServiceAvailabilityRequest
Service の空き情報を置き換えるリクエスト。
| フィールド | |
|---|---|
service_availability |
既存のサービス空き情報を置き換えるために使用されるサービス空き情報。 |
RequireCreditCard
予約にクレジット カードが必要かどうかを定義します。
| 列挙型 | |
|---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
クレジット カードの要件は明示的に指定されておらず、動作は CONDITIONAL で指定されたものと同じになります。 |
REQUIRE_CREDIT_CARD_CONDITIONAL |
空き情報に価格が設定されており、prepayment_type が REQUIRED の場合、no_show_fee が設定されている場合、保証料フィールドが設定されている場合のうちいずれかの条件に該当する場合は、クレジット カード情報が必要です。 |
REQUIRE_CREDIT_CARD_ALWAYS |
他のフィールドの値に関係なく、この空き情報を予約するにはクレジット カードが常に必要です。 |
Resources
リソースは、異なるスタッフ メンバーや部屋がサービスに含まれている場合に、個々の空き状況スロットを区別するために使用されます。予約枠のサービスと時間間隔が同じでも、リソースが異なるなら、予約枠は複数存在できます。
| フィールド | |
|---|---|
staff_id |
サービスを提供するスタッフの ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。staff_name が指定されている場合は、このフィールドを指定する必要があります。 |
staff_name |
サービスを提供するスタッフ メンバーの名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。staff_id が指定されている場合は、このフィールドを指定する必要があります。 |
room_id |
サービスが提供される部屋の ID(省略可)。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。room_name が指定されている場合は、このフィールドを指定する必要があります。 |
room_name |
サービスが提供される部屋の名前(省略可)。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。(省略可。room_id がある場合は必須)ダイニング ルームの名前は、バーやパティオなどの座席エリアにのみ使用し、固定価格メニュー、特別なアクティビティ、空席以外の値(予約や夕食など)には使用しないでください。デフォルトの座席エリアには部屋を関連付けないことを強くおすすめします。 |
party_size |
Dining のみ: この時間枠に対応できる人数。1 つのレストランに同じ時間の複数の Slot を関連付けることができます。たとえば、1 つの予約に対して 2 人、3 人、4 人のグループが予約できる場合は、それぞれ異なる party_size を指定できます。 |
room_description |
省略可。ローカライズされたチャットルームの説明。設定する場合は、デフォルト値を指定する必要があります。販売者の地域でよく使用される言語も指定することをおすすめします。(省略可) |
SchedulingRules
サービスのスケジュール設定ルール。
| フィールド | |
|---|---|
min_advance_online_canceling |
予約をオンラインでキャンセルするために必要な最小事前通知期間(秒単位)。(省略可) |
late_cancellation_fee |
最小事前通知期間内のキャンセル料。 |
noshow_fee |
無断キャンセル料。 |
admission_policy |
このサービスに適用される入場ポリシー。設定しない場合、デフォルトは TIME_STRICT です。(省略可) |
cancellation_policy |
キャンセル ポリシーのスケジュール設定ルール。(「おすすめスポット」で必須) |
共用体フィールド 「min_advance_booking」が設定されている場合、最終予約可能時間は(<予約枠開始時間> - min_advance_booking)として計算されます。「min_booking_Buffer_before_end_time」が設定されている場合、最終予約可能時間は(<予約枠終了時間> - min_booking_buffer_before_end_time)として計算されます。「min_booking_buffer_before_end_time」を設定する場合は、正の値にする必要があります。両方とも設定されていない場合、時間枠の開始時間まで予約可能となります。両方のフィールドが設定されている場合、一方の値のみが選択され、もう一方の値は無視されます。どちらの値が選択されるかは予測できません。 例:
|
|
min_advance_booking |
最終予約可能時間から予約枠の開始時刻までの期間(秒単位)。 |
min_booking_buffer_before_end_time |
最終予約可能時間から予約枠の終了時刻までの期間(秒単位)。 このフィールドが設定されている場合、予約枠の開始後にユーザーが購入済みチケットを使用できることを示すために、「admission_policy」フィールドを TIME_FLEIBLE に設定する必要があります。 |
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 時に博物館に到着している必要があります。このサービスの予約枠の開始時刻は、指定された入場時間を表します。ただし、終了時間は、予約の予約枠を識別するためのキーとしてのみ使用されます。 |
サービス
販売者が提供するサービスに関する情報(例: ヘアカット)。
| フィールド | |
|---|---|
name |
サービス リソース名(形式: |
service_name |
サービスの名前(例: 「メンズ ヘアカット」)。非推奨。代わりに、localized_service_name を使用してください。 |
localized_service_name |
サービスの名前(例: 「メンズ ヘアカット」)。いくつかの言語 / 地域で使用されている可能性があります。 |
description |
ユーザーに表示される、サービスの説明。非推奨。代わりに、localized_description を使用してください。 |
localized_description |
ユーザーに表示される、サービスの説明。 このフィールドは、書式なしテキストと HTML に類似する形式の両方に対応しています。書式なしテキストのセクションとは異なり、見出し、段落、リスト、一部のフレーズタグを使用して、レイアウトをカスタマイズできます。最適なユーザー エクスペリエンスを提供するため、次の手順と注意事項をよくお読みください。 サポートされている HTML に類似する形式の書式設定タグ: 見出しタグ: <h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落タグ: <p> リストタグ: <ul>、<ol>、<li> 分割タグ: <div> フレーズタグ: <br>、<strong>、<em>: サポートされていないタグ:
注意事項:
|
price |
サービスの価格。 |
price_interpretation |
価格を解釈してユーザーに表示する方法について説明します。サービスの価格の表示を設定するために、「レストラン」と「おすすめスポット」以外のカテゴリで使用できます。 |
rules |
予約/キャンセルのルール。 |
prepayment_type |
前払いが必須か、選択可能か、対象外か。 |
prepayment_terms |
前払いが完了する時期に関する条件。 |
form[] |
非推奨です。intake_form と per_ticket_intake_form を使用してください。 |
intake_form |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。(省略可) |
per_ticket_intake_form |
このサービスの予約時にユーザーに追加情報を尋ねるフォーム。このフォームは、ユーザーが予約するチケットごとに 1 回入力する必要があります。(省略可) |
tax_rate |
サービスの税率。指定されている場合、このフィールドは販売者レベルで設定された tax_rate をオーバーライドします。メッセージが空(例: tax_rate { })の場合、適用される税率はゼロにリセットされます。 |
payment_option_id[] |
このサービスの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。 |
deposit |
ユーザーへの保証料の請求方法を定義します。サービスの保証料が指定されている場合は、それをオーバーライドします。これを空の Deposit メッセージに設定すると、サービスレベルの保証料がすべて削除されます。(省略可) |
no_show_fee |
ユーザーに請求される可能性のある無断キャンセル料を定義します。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。これを空の NoShowFee メッセージに設定すると、サービスレベルの無断キャンセル料がすべて削除されます。(省略可) |
require_credit_card |
このサービスを予約するためにユーザーがクレジット カード情報を提供する必要があるかどうかを示します。このフィールドは、空き情報レベルでオーバーライドされる可能性があります。(省略可) |
action_link[] |
このサービスに関連するアクション リンク。アクション リンクが存在する場合は、Service でタイプ(下記参照)を設定する必要があります。 |
type |
このサービスの事前定義されたタイプ。(省略可) |
ticket_type[] |
チケットがサポートされている場合、このサービスで予約 / 購入できるチケットのタイプ。(省略可) |
related_media[] |
このサービスに関連する写真。このメディアは、エンドユーザーに最も効率的な方法でされるよう、Google によりクロールおよび保存されます。(省略可) |
service_attribute_value_id[] |
このサービスに適用される Service 属性値(省略可)。各 Service には、対応する Merchant で定義された各サービス属性の値が 0 個以上含まれている場合があります。(省略可) |
waitlist_rules |
順番待ちリストに加わるためのルール。 |
ticketing_vertical_specific_data |
イベント チケット販売業種に固有の追加情報。(省略可) |
integration_type |
このサービスでサポートされる統合の程度。(省略可)試用版統合を使用するパートナーには関係ありません。これらのパートナーでは、エンドツーエンド統合は常に無効になります。 |
per_order_fee |
このサービスを購入するための注文レベルの料金。(省略可) |
tours_and_activities_content |
Tours と Activities に固有のコンテンツ フィールド。 |
location[] |
このサービスに関連するビジネス拠点。重要: このサービスに関連する複数の訪問先がある場合、または START_LOCATION が VISITED_LOCATION と異なる場合は、START_LOCATION を指定する必要があります。例: - 3 か所を巡るガイド付き自転車ツアーの場合、出発地を指定する必要があります。- ホテルのロビーで集合してから訪問先に向かうバスツアーの場合、集合場所を指定する必要があります。 |
rating |
このサービスに対するユーザーの評価(すべてのクチコミの集計指標で表します)。 |
home_service_data |
ホームサービス業種に固有の追加情報。(省略可) |
virtual_session |
省略可。バーチャル セッションに関する情報。仮想サービスを有効にするために必要です。 |
direct_merchant_payment |
省略可。サービスでユーザーが販売者に直接支払う必要がある場合に追加する必要がある追加情報。重要な注意事項: RwG はこの取引に関与しません。virtual_session が定義されていて、サービスが無料でないか、prepayment_type が REQUIRED に設定されていない場合は必須です。 |
uri_template |
省略可。Google が外部サイトへの URL を生成する方法を指定する省略可能なテンプレート。 |
PrepaymentTerms
前払いが完了した日時に関する具体的な情報。
| フィールド | |
|---|---|
charge_timing |
購入時からの請求のタイミング。 |
charge_time_before_start_time_sec |
ユーザーが支払いを請求されるサービス開始時刻までの時間(秒)。このフィールドは、ChargeTiming が CHARGE_LATER の場合にのみ設定する必要があります。 |
ChargeTiming
購入時間に対する請求のタイミングを指定する列挙型。
| 列挙型 | |
|---|---|
CHARGE_TIMING_UNSPECIFIED |
未使用。 |
CHARGE_NOW |
お客様に直ちに請求されます。 |
CHARGE_LATER |
お客様には後日請求いたします。 |
PrepaymentType
前払いのタイプを示す列挙型。
| 列挙型 | |
|---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
デフォルトでは、前払いは NOT_SUPPORTED とみなされます。 |
REQUIRED |
ユーザーは予約時にこのサービスの支払いを行う必要があります。 |
OPTIONAL |
ユーザーは予約時または予約後にこのサービスの前払いを行うことができますが、必須ではありません。 |
NOT_SUPPORTED |
このサービスでは前払いがサポートされていません。 |
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 |
ユーザーが指定された販売者から購入できるサービス。配送または受け取りのいずれかになります。 |
ServiceAttribute
サービス属性は、Merchant の Services を記述するパートナー定義のカテゴリです。たとえば、銀行では「口座の種類」サービス属性を「個人」、「ビジネス」の値で定義し、ヘアーサロンでは「サービスの種類」サービス属性を「ヘアーカット」、「ヘアカラー」、「ヘアセット」の値で定義できます。
| フィールド | |
|---|---|
attribute_id |
同じ販売者のサービス属性を他のサービス属性から一意に識別する ID(「account-type」など)。 |
attribute_name |
ユーザーに表示される、この属性の名前(「口座種別」など)。 |
value[] |
このサービス属性で可能なすべての値。 |
値
特定のサービス属性で可能な値を表します。
| フィールド | |
|---|---|
value_id |
このサービス属性の値を他の値から一意に識別する ID(「personal」など)。 |
value_name |
ユーザーに表示される、この値の名前(「個人」など)。 |
ServiceAttributeValueId
Service に適用されるサービス属性の特定の値を識別します。
| フィールド | |
|---|---|
attribute_id |
Merchant.service_attribute で定義されている属性の ID(「service-type」など)。 |
value_id |
この属性の値の ID(「haircut」など)。サービス属性定義の value_id と一致する必要があります。 |
ServiceAvailability
空き情報のリストおよび申し込み対象先と申し込み対象時間
| フィールド | |
|---|---|
name |
このパラメータの申し込み先のサービスのリソース名(形式: |
start_time_restrict |
指定した場合、指定された Availability エンティティは [start_time_restrict, end_time_restrict] からの完全なスナップショットと見なされます。つまり、次の条件が当てはまる場合、既存の空き情報はすべて削除されます。 duration メッセージが設定されている場合、条件はさらに制限されます。 resource_restrict メッセージが設定されている場合、条件はさらに制限されます。 これらのフィールドは通常、特定の期間の空き情報を完全に更新するために使用されます。 start_time_restrict を設定せずに start_time_restrict を設定すると、start_time_restrict から始まる全期間とみなされます。 |
end_time_restrict |
start_time_restrict を設定せずに end_time_restrict を設定すると、end_time_restrict までの全期間とみなされます。 |
duration_restrict |
duration を設定すると、一致する期間の空き情報のみに更新の範囲が限定されます。 |
resources_restrict |
resources_restrict を設定すると、リソースのこのセットのみに更新の範囲が限定されます。リソースのすべての ID フィールドが完全に一致する必要があります。 |
availability[] |
空き情報の新しいリスト。 |
ServiceIntakeForm
販売者が提供するサービスをカスタマイズするインテイク フォームを定義します。
| フィールド | |
|---|---|
field[] |
ユーザーに表示されるフィールド。 |
first_time_customers |
true の場合、このフォームは初めての顧客に表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
returning_customers |
true の場合、このフォームはリピーターに表示されます。非推奨。この機能はインテイク フォームではサポートされていません。 |
ServiceIntakeFormField
ServiceIntainForm に含まれるフィールドを定義します。
| フィールド | |
|---|---|
id |
フォーム フィールドを一意に識別するアグリゲータ パートナーからの文字列。この ID は、対応するフォーム フィールドの回答の ID と同じで、サービスレベルとチケットごとのインテイク フォームの両方で一意である必要があります。(必須) |
type |
このフィールドのタイプ。 |
label |
ユーザーに表示される、このフィールドのテキスト。非推奨。代わりに |
localized_label |
ユーザーに表示される、このフィールドのテキスト。このフィールドは複数の言語 / 地域で指定できます。(必須) |
value[] |
フィールドのタイプが LOCATION_SEARCH の場合にのみ設定します。「location」フィールドの「location_id」を使用してビジネス拠点の値を指定してください。 |
choice_text[] |
フィールド タイプが MULTIPLE_CHOICE、CHECKBOXES、または DROPDOWN の場合にのみ設定します。可能な選択肢を列挙するために使用されます。 |
is_required |
このフィールドへの回答がユーザーに必須かどうかを示します。 |
allow_custom_answer |
定義済みの回答に加えてカスタム値を許可するかどうかを示します。これは、フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。(省略可) |
additional_option[] |
提供された値に加えて提供される追加オプション。フィールド タイプが LOCATION_SEARCH の場合にのみ適用されます。たとえば、提供された場所のリストに加えて、「後でサプライヤーに連絡する」というオプションも利用できます。(省略可) |
ticket_type_restrict[] |
ユーザーが特定のチケットタイプを予約するときにのみこの質問を表示する場合は、このフィールドを該当するチケットタイプ ID のセットとして設定します。質問が常に該当する場合は、この欄を空欄のままにします。 |
hint |
入力のヒント テキスト。テキスト プレースホルダとして表示されます。これは、フィールド タイプが SHORT_ANSWER または PARAGRAPH の場合にのみ適用されます。(省略可) |
FieldType
フィールドのタイプを示す列挙型。
| 列挙型 | |
|---|---|
FIELD_TYPE_UNSPECIFIED |
未指定または不明なタイプのフィールドは無視されます。 |
SHORT_ANSWER |
テキスト用の 1 行の入力フィールド。 |
PARAGRAPH |
テキスト用の複数行の入力フィールド。 |
MULTIPLE_CHOICE |
多数のオプションから 1 つを選択する必要があるラジオボタンのセット。 |
CHECKBOXES |
チェックボックス付きの 1 つ以上の列挙型項目。 |
DROPDOWN |
プルダウンからの選択。 |
BOOLEAN |
はい / いいえボタン。 |
LOCATION_SEARCH |
ユーザーの入力に基づいて、指定されたビジネス拠点のリストから一致するビジネス拠点を検索できる検索ボックス。 |
TaxRate
サービスの料金をユーザーに請求する際に適用される税率。販売者単位またはサービス単位で設定できます。
| フィールド | |
|---|---|
micro_percent |
税率(1% を 100 万分の 1 とする単位)。実際には小数点以下 6 桁を表すことになります。たとえば、税率が 7.253% の場合は、このフィールドは 7253000 に設定します。 このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。 このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金(ここで指定された税率を基に算出)が含まれます。最小通貨単位の端数(1 セントの端数など)は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。 |
Terms
「Google で予約」を介して予約を行うためにユーザーに表示される一連のルールとガイドライン。
| フィールド | |
|---|---|
url |
(省略可)利用規約の URL。 |
text |
ユーザーに表示するテキスト。新しい統合の場合は、下記の localized_text を使用します。 |
localized_text |
ユーザーに表示するローカライズされたテキスト。 |
テキスト
ローカライズされた可能性のあるテキスト ペイロード。一部の Text フィールドには、マークアップされたコンテンツを含めることができます。
| フィールド | |
|---|---|
value |
不明な言語 / 地域の Text 値。 |
localized_value[] |
言語 / 地域ごとのテキスト値。省略可。 |
TicketType
TicketType は、ユーザータイプ、サービス属性、オプション / アドオンが異なるため、価格や空き情報が異なるチケットを他のチケットとの間で区別するために使用されます。
チケットは、サービスの予約可能な最小単位です(ラフティングのツアースポット、博物館への入場、2 人用カヤックの 1 日レンタルなど)。
| フィールド | |
|---|---|
ticket_type_id |
チケット ID は、同じサービスの異なるチケットタイプの間で区別するために使用され、サービス内で一意である必要があります。 |
short_description |
この TicketType の簡単な説明。 (「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。非推奨。代わりに、localized_short_description を使用してください。 |
localized_short_description |
i18n をサポートするこの TicketType の簡単な説明。 (「大人」、「子供」、「退役軍人」、「J 列」など)。必須。チケットタイプごとに、ユーザーに表示する説明が必要です。言語 / 地域ごとに別々の値を指定できます。 |
price |
このタイプのチケット 1 枚の価格(税抜き)。Service の税率がチケットに適用されます。 |
per_ticket_fee |
このチケットを購入するための追加料金。(省略可) |
price_display_type |
省略可。このタイプのチケット 1 枚の事前設定されたディスプレイのタイプ。 |
option_description |
このチケットタイプが表す追加オプションの説明(ある場合)。非推奨。代わりに、localized_option_description を使用してください。 |
localized_option_description |
このチケットタイプが表す追加オプションの説明(ある場合)。言語 / 地域ごとに別々の値を指定できます。 追加のオプションは、チケットタイプが複数の側面を表す場合に便利です。 例 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> です。 |
inventory_type |
省略可。このタイプのチケット 1 枚の事前設定されたインベントリ タイプ。 |
InventoryType
このタイプのチケット 1 枚の事前設定されたインベントリ タイプ。
| 列挙型 | |
|---|---|
INVENTORY_TYPE_UNSPECIFIED |
インベントリ タイプが指定されていません。 |
INVENTORY_TYPE_PRIMARY |
プライマリ インベントリ。 |
INVENTORY_TYPE_VERIFIED_RESALE |
再販在庫が確認済みであること。 |
INVENTORY_TYPE_RESALE |
再販在庫。 |
INVENTORY_TYPE_AGGREGATOR |
アグリゲーターの広告枠。アグリゲータ(www.bandsintown.com など)とは、パートナーがイベントとチケットの情報を提供することを意味します。ただし、チケットはパートナーが直接販売するものではありません。実際のチケット販売者は、一次販売者、確認済みの再販業者、再販業者のいずれかになります。現在、最上位のパートナーのインベントリ タイプのみを区別し、アグリゲータ内の実際のチケット販売者のインベントリ タイプは無視しています。 |
PriceDisplayType
ランディング ページに表示される価格の形式を示します。
このフィールドは、リンクアウト以外の広告枠では無視されます。
このフィールドを使用すると、Google サーフェスで、ランディング ページで使用されているのと同じ価格形式を表示できます。価格形式を統一すると、コンバージョン率が向上し、混乱を減らすことができます。
| 列挙型 | |
|---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED |
価格のディスプレイのタイプが指定されていません。表示する形式は Google が決定します。 |
PRICE_DISPLAY_TYPE_BASE |
ランディング ページに表示される価格は基本価格です。 |
PRICE_DISPLAY_TYPE_ALL_IN |
ランディング ページに表示されている価格には、すべての手数料と税金が含まれています。 |
TicketingVerticalSpecificData
イベント チケット販売業種に固有の追加情報。
| フィールド | |
|---|---|
event_category |
イベントのカテゴリ。事前定義されたカテゴリのいずれかにイベントが該当する場合にのみ設定します。(省略可) |
event_url |
パートナーのウェブサイトに掲載されているイベントの URL。(省略可) |
entity[] |
イベントに関連するエンティティのリスト。(省略可) |
event_attendance_mode |
必須。イベント参加のタイプ。 |
event_virtual_location_url[] |
省略可。イベントを視聴できる URL。 |
event_organizer |
省略可。イベントを主催する主催者。 |
event_organizer_url |
省略可。イベントを主催する主催者の URL。 |
event_organizer_type |
省略可。主催者のタイプ。 |
event_source_url[] |
必須。イベント情報や説明が記載されているページの URL。 |
event_state |
省略可。イベントの状態。 |
brand_name |
省略可。ローカライズされたブランド名。 |
event_creator |
省略可。イベントの作成者に関する情報。 |
AttendanceMode
イベント参加のタイプ。
| 列挙型 | |
|---|---|
ATTENDANCE_MODE_UNSPECIFIED |
指定されていません。 |
ONLINE |
バーチャル イベントの場合。 |
PHYSICAL |
実地イベントの場合。 |
PHYSICAL_ONLINE_MIXED |
物理的なイベントとバーチャル イベントの両方の場合。 |
エンティティ
イベントに関連するエンティティを表します。
| フィールド | |
|---|---|
id |
パートナーのデータベースにあるエンティティの一意の識別子。(省略可) |
name |
エンティティの名前。(必須) |
url |
エンティティを明確に説明しているウェブページの URL。これは、パートナーのウェブサイトにあるエンティティのウェブページ(存在する場合)です。エンティティのその他の公開 URL の場合は、public_identification_data で relevant_url を使用します。(省略可) |
entity_type |
エンティティのタイプ。(省略可) |
entity_role |
イベントでのエンティティの役割。(省略可) |
public_identification_data |
エンティティの公開参照。(省略可) |
EntityRole
イベントでのエンティティの役割。
| 列挙型 | |
|---|---|
ENTITY_ROLE_UNSPECIFIED |
指定されていません。 |
ENTITY_ROLE_HEADLINER |
エンティティは、イベントでの主演者または主要出演者を表します。 |
ENTITY_ROLE_SUPPORTER |
エンティティは、イベントでの脇役を表します。 |
ENTITY_ROLE_HOME_TEAM |
エンティティは、(スポーツ)イベントのホームチームを表します。 |
ENTITY_ROLE_AWAY_TEAM |
エンティティは、(スポーツ)イベントのアウェイチームを表します。 |
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 の場合にのみ該当します。 |
EventCategory
サービス エクスペリエンスをカスタマイズするイベント カテゴリのサブセット。注: イベントの汎用のオントロジーを意図したものではありません。
| 列挙型 | |
|---|---|
EVENT_CATEGORY_UNSPECIFIED |
指定なし。使用しないでください。 |
EVENT_CATEGORY_CONCERT |
コンサート。 |
EVENT_CATEGORY_SPORTS |
スポーツ イベント。 |
EVENT_CATEGORY_THEATRE |
劇場でのイベント。 |
EVENT_CATEGORY_EXHIBITS |
展示。 |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
ワークショップとクラス。 |
EventCreator
イベントの作成者に関する情報。ユーザー作成コンテンツ イベントを含むプラットフォームにのみ関連します。
| フィールド | |
|---|---|
name |
省略可。イベント作成者の名前。文字制限はありません。 |
EventState
イベントの状態。
| 列挙型 | |
|---|---|
EVENT_STATE_UNSPECIFIED |
指定されていません。 |
SCHEDULED |
イベントがスケジュールされています。 |
RESCHEDULED |
イベントの日程が変更されます。 |
CANCELLED |
イベントはキャンセルされました。 |
POSTPONED |
イベントは延期されています。 |
OrganizerType
主催者のタイプ。
| 列挙型 | |
|---|---|
ORGANIZER_TYPE_UNSPECIFIED |
指定されていません。 |
PERSON |
主催者が個人の場合。 |
ORGANIZATION |
主催者が組織の場合。 |
PublicIdentificationData
エンティティを参照する識別子、ウェブページ、その他の公開ソース。
| フィールド | |
|---|---|
relevant_url[] |
トピック専用のウェブページの公開 URL。これには、公式ウェブサイト、ディスコグラフィ、ソーシャル メディア プラットフォーム、ウィキペディア、IMDB ページなどがあります(例: https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan)。(省略可) |
musicbrainz_id |
アーティストなどの音楽エンティティの 36 文字の MusicBrainz 識別子(該当する場合)。https://musicbrainz.org/doc/MusicBrainz_Identifier をご覧ください。(省略可) |
TimeRange
左閉右開の時間帯(例: [start_time, end_time))。
| フィールド | |
|---|---|
start_time |
時間帯の下限。 |
end_time |
時間帯の上限。 |
TokenizationConfig
決済代行業者のトークン化の設定。Merchant ごとに設定します。
| フィールド | |
|---|---|
tokenization_parameter |
トークン化設定には通常、キーが「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" } |
billing_information_format |
Google Pay に入力したユーザーの支払い情報(FOP を含む)を、支払いトークンに含めます(上記を参照)。フィールドを空のままにすると、MIN を指定した場合と同じ処理を行います。 |
BillingInformationFormat
トークンに含める請求先住所の記載事項(ユーザーが入力)。列挙値は Google Pay API のパラメータに対応します(https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters を参照)。
| 列挙型 | |
|---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
指定なし。デフォルトは MIN です。 |
MIN |
名前、国コード、郵便番号(Google Pay のデフォルト設定)。 |
FULL |
名前、番地、地域区分、県、国コード、郵便番号。 |
ToursAndActivitiesContent
Tours と Activities に固有のコンテンツ フィールド。繰り返しフィールドの各要素は、独立したレンダリング(箇条書きなど)ができるように個々に設定する必要があります。
ツアーやアクティビティの場合、ToursAndActivitiesContent への入力は強くおすすめしますが、絶対必須条件ではありません。すべてのフィールドは、基本的な書式として、書式なしテキストと HTML に類似する形式のテキストの両方をサポートしています。サポートされている HTML に類似する形式の書式設定タグ:
フレーズタグ: <br>、<strong>、<em>、<italic> の 3 つのタグのみがサポートされています。
<br> を使用すると、段落の改行ができます。また、<strong>、<em>、<italic> を使用すると、重要なテキストをハイライト表示できます。
その他のフレーズタグは無視されます。
その他すべてのタグとカスタム スタイルは使用できず、削除されます。URL、アンカー、リンクはすべて削除され、エンドユーザーには表示されません。
重要な注意事項: * highlights、exclusion など(具体的には、サービスの説明のフィールド)にすでに指定したデータを複製しないでください。* 上記以外のタグは使用しないでください。サポートされていないタグ内のコンテンツは削除されるため、ユーザー エクスペリエンスの低下につながります。
| フィールド | |
|---|---|
highlights[] |
ユーザーに表示される、ハイライトのリスト。 |
inclusions[] |
ユーザーに表示される内容物のリスト。 |
exclusions[] |
ユーザーに表示される除外物のリスト。 |
must_know[] |
ユーザーに表示される重要なメモのリスト。年齢制限など、このサービスが対象外となる条件の詳細情報に使用します。 |
UnsupportedPartySizeOption
範囲外の参加者のオプション。
| フィールド | |
|---|---|
共用体フィールド kind。範囲外の参加者が利用できるオプション。kind は次のいずれかになります。 |
|
call_merchant |
範囲外の人数で予約する場合は、店舗に電話してください。ユーザーに事前定義されたメッセージが表示されます。表示されるテキストの例: 「{waitlist_rules.max_party_size} 人を超える場合は、レストラン(電話: {phone})までお問い合わせください。」CallMerchant を設定する必要がありますが、空になります。 |
UpdateAdsAccountLinkRequest
AdsAccountLinkingService.UpdateAdsAccountLink に対するリクエスト メッセージです。
| フィールド | |
|---|---|
ads_account_link |
必須。更新する Google 広告アカウントのリンク。 AdsAccountLink の |
update_mask |
省略可。更新するフィールドのリスト。 |
UpdateBookingRequest
google.maps.booking.v1alpha.Booking を更新するリクエスト
| フィールド | |
|---|---|
update_mask |
更新するすべての予約フィールドのフィールド マスク。 |
booking |
更新する予約 |
booking_failure |
非同期で確認された予約リクエストの処理が失敗し、予約のステータスが FAILED に更新されている場合、このフィールドはビジネス ロジック エラー(たとえば、「ユーザーがこの時間の近くにすでに予約を行っている」)を反映します。このフィールドは、予約ステータスを FAILED に更新する場合にのみ設定され、それ以外の場合は無視されます。 |
UpdateMerchantRequest
Merchant を更新するリクエスト。
| フィールド | |
|---|---|
merchant |
新しい販売者データ。 |
update_mask |
販売者向けに更新される特定のフィールド。 |
UpdateOrderRequest
google.maps.booking.v1alpha.Order を更新するリクエスト
| フィールド | |
|---|---|
update_mask |
更新するすべての注文フィールドのフィールド マスク。 |
order |
更新される注文 |
UpdateServiceRequest
Service を更新するリクエスト。
| フィールド | |
|---|---|
service |
新しいサービスデータ。 |
update_mask |
更新する、サービスの特定のフィールド。 |
UriTemplate
Google が外部サイトへの URL を生成する方法を指定するテンプレート。
| フィールド | |
|---|---|
uri_template |
省略可。URI テンプレートは RFC6570 に準拠している必要があります。https://datatracker.ietf.org/doc/html/rfc6570 をご覧ください。レベル 2 のテンプレートをサポートします。これらのパラメータは、それぞれのエンティティで指定された値に解決されます。 レストラン予約リンクアウトで使用可能なパラメータ: 1)(必須){availability_slot_start_seconds} :: アベイラビリティ フィードの start_sec フィールドから入力されます 2)(必須){resources_party_size} :: アベイラビリティ フィードの party_size フィールドから入力されます 3)(省略可){availability_slot_duration_seconds} :: アベイラビリティ フィードの duration_sec フィールドから入力されます 4)(省略可){availability_slot_availability_tag} :: アベイラビリティ フィードの availability_tag フィールドから入力されます 使用例: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} 次の場合: * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
UserPurchaseRestriction
支払いオプションを購入できるユーザーを制限します。
| フィールド | |
|---|---|
new_to_merchant |
以前に同じ販売者から購入したことがないユーザーのみが購入できる支払いオプション。 |
new_to_payment_option |
以前に同じ支払いオプションを購入したことがないユーザーのみが購入できる支払いオプション。 |
VirtualSession
バーチャル/オンライン セッションに関する情報。例: オンライン ヨガ教室、バーチャル料理教室など。
| フィールド | |
|---|---|
session_instructions |
このバーチャル クラスの設定方法の手順。パートナーが予約に動画の URL を含めない場合は、このテキストに動画の URL をユーザーと共有するタイミングを含める必要があります。例: 「Zoom の URL はクラスの 30 分前にメールでお送りします」(推奨)。 |
session_requirements |
指定されたバーチャル セッションの要件。例: ヨガマット、調理器具など(推奨) |
virtual_platform_info |
このセッションで使用された仮想プラットフォームに関する情報。(仮想サービスを有効にするために必要) |
is_session_prerecorded |
必須。バーチャル セッションがライブではなく事前録画の場合は、これを true に設定します。 |
VirtualPlatformInfo
このバーチャル セッションで使用されるプラットフォームに関する情報。
| フィールド | |
|---|---|
platform |
バーチャル セッションで使用されるプラットフォーム。 |
other_platform_name |
プラットフォームが OTHER に設定されている場合、プラットフォームの名前。(プラットフォームが「その他」に設定されている場合は必須) |
プラットフォーム
販売者が使用する仮想プラットフォームを示す列挙型。
| 列挙型 | |
|---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
販売者は、どの動画プラットフォームを使用するかを柔軟に選択できます。 |
GOOGLE_HANGOUTS |
Google ハングアウトのプロダクト。 |
GOOGLE_MEET |
Google Meet サービス。 |
ZOOM |
Zoom Video Communications。 |
SKYPE |
Skype。 |
YOUTUBE |
YouTube でのライブ配信。 |
OTHER |
使用する動画プラットフォームがここで説明するものと異なる場合は、設定する必要があります。 |
WaitlistRules
順番待ちリストへの参入に関連するルール。
| フィールド | |
|---|---|
min_party_size |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
max_party_size |
必須。順番待ちリスト機能を提供するサービスでは正の整数を指定する必要があります。サービスまたは販売者が順番待ちリスト機能を提供していない場合は、入力しないでください。 |
supports_additional_request |
true の場合、ユーザーはこのサービスの順番待ちリストに加わるときに、自由形式の追加テキスト リクエストを送信できます。 |
above_max_party_size_options[] |
設定された max_party_size より大きいパーティのオプションを設定します。大人数のグループにウェイトリストへの登録の代替オプションを提供しない場合は、空のままにします。 |