Package google.maps.booking.v1alpha

string

這個動作連結的進入點網址。

string

BCP-47 語言標記；指示來自這個 URI 的內容可採用的語言。

string

ISO 3166-1 alpha-2 國家/地區代碼。留空代表瀏覽權限不設限。

ActionPlatform

執行這個動作時所在的平台。如未設定此欄位，ACTION_PLATFORM_WEB_APPLICATION 將做為備用。

ActionLinkType

預定動作類型。

OrderOnlineMetadata

訂購線上連結中繼資料。支援使用 ACTION_LINK_TYPE_SHOP_ONLINE 的 ActionLinkType 動作。

FoodOrderingMetadata

訂餐連結的中繼資料。支援動作類型：* ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT 不支援 ACTION_LINK_TYPE_ORDER_FOOD。

Text

在使用者透過「透過 Google 預訂」進行預訂時，向使用者顯示的自訂訊息。

Timestamp

預約時段的開始時間。

Duration

預約時段的時間長度。

int64

這個可預訂時段的總名額和開放名額數量。示例：

• 瑜珈教室有 10 個名額，其中 3 個名額已有人預定：availability {spots_total: 10, spots_open: 7 ...}
• 已預訂額滿的坐式按摩時段：availability {spots_total: 1, spots_open: 0 ...}

注意事項：如果使用下方定義的預訂情形壓縮格式來傳送要求，系統會推測這兩個欄位的值。

• Recurrence 表示 spots_total=1 且 spots_open=1。
• ScheduleException 意指 spots_total=1 和 spots_open=0。

int64

開放名額數量。

string

(選用) 用於辨識這個供應時段的隱晦字串。如果設定了這個項目，系統會在預約/更新/取消預約的要求中納入這項資訊。

Resources

此為選用資源；如果可預訂時段的服務中含括不同的員工或房間，可用「資源」來做明確的區隔。

例如同一間瑜珈教室有兩名講師共用：

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 清單。實際付款方式需在商家層級定義，而且可由多個商家共用。

這個欄位會覆寫服務訊息中指定的任何 payment_option_ids。同樣地，在這裡指定的 payment_option_ids「不必」顯示在服務訊息中，但必須在商家層級定義。

Recurrence

供應時段的週期資訊，代表有多個開始時間。週期應包含一個工作天的預約。

ScheduleException

無法安排這項服務的時間。為限制 schedule_exception 訊息的數量，建議加入相鄰的例外狀況。

Deposit

選用欄位，表示這個可預訂時段是否需要收取訂金。指定此欄位將會覆寫該服務的訂金。

NoShowFee

選用欄位，表示這個可預訂時段是否會收取逾時未到費用。指定此欄位將會覆寫該服務的逾時未到費用。

RequireCreditCard

指出消費者是否需要提供信用卡資訊才能預訂這個時段。如果沒有設定這個值，系統會沿用服務層級設定的值 (如果已在服務層級設定)。(選用)

string

列出此供應時段支援的票券類型。如果未設定，表示父項服務中所有的票券類型皆可供這個時段使用。請注意，這個欄位的值必須在父項服務中定義，範例：

• 提供四種票券類型的服務：TicketType {ticket_type_id: "adult_1" short_description: "全票平日"} TicketType {ticket_type_id: "adult_2" short_description: "全票週末"} TicketType {ticket_type_id: "youth_1" short_description: "學生票平日"} TicketType {ticket_type_id: "youth_2" short_description: "學生票週末"}

如要表示平日的庫存清單：availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}。如要表示假日的庫存清單：availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}。

• 提供三種票券類型的服務：TicketType {ticket_type_id: "adult" short_description: "全票"} TicketType {ticket_type_id: "youth" short_description: "學生票"} TicketType {ticket_type_id: "senior" short_description: "敬老票"}

如要表示這個時段提供全部三種票券類型，請使用 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，您就必須立即拒絕或建立預訂，並將狀態設為「待處理」。

Timestamp

設定期限來指明要重複提供可預訂時段到何時，用世界標準時間格式的最晚時間戳記表示 (最晚時間包含在內)。

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

例外狀況的時間範圍。凡是與這個「從休息中到開門營業」的時間範圍重疊的週期指定時段，都視為無法預訂。

範例：假設週期指定的期間為 20 分鐘，repeat_every 為 30 分鐘，start_time 為上午 9:00，repeat_until 為上午 11:00，而 ScheduleException 的 time_range 為上午 9:45-11:00，則上午 9:30-9:50、上午 10-10:20，以及上午 10:30-10:50 的時段皆無法預訂。

請注意，由於這是「從休息中到開門營業」的時間範圍，因此從上午 11:00 開始的時段不會受到影響。

int64

這個時段可供預訂的最晚時間 (以秒為單位)。這個時間戳記必須設在該時段的 start_sec 之前才能生效 (如要讓使用者在開始時間之後繼續預訂，請使用服務層級的 SchedulingRules.min_booking_before_end_time)。如果存在，則會覆寫對應服務的 SchedulingRules 中 min_booking_buffer 指定的任何值。

int64

這個時段可供預訂的最早時間 (以秒為單位)。這個時間戳記必須早於時段的 start_sec 或 last_bookable_sec (如有指定)。

int64

如果設定這個值，表示您可以透過「透過 Google 預訂」取消這個特定預約時段的結束時間 (從 Unix Epoch 紀元時間起算，以秒為單位)。這個欄位會覆寫所有服務層級取消規則。(選用)

string

資源名稱，格式為 - partners/{partner_id}/feeds/{feed_name}。

GenericDeleteRecord

要刪除的記錄。一個 API 呼叫中最多只能包含 1,000 筆記錄。

string

資源名稱，格式為 - partners/{partner_id}/feeds/{feed_name}。

GenericRecord

要插入及/或更新的記錄。一個 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

「透過 Google 預訂」集結網站使用的參數，用來為使用者初始化 3DS1 驗證通訊協定。BookingFailure.cause 必須設為 PAYMENT_REQUIRES_3DS1，否則系統會忽略此設定。

string

用於載入表單供使用者進行驗證的網址。

string

PaymentAuthentication 要求。請發布到 ACSUrl 表單 (如有提供)。

string

ACS 供應商使用的 ID。請發布到 ACSUrl 表單 (如有提供)。

string

業務資料。請發布到 ACSUrl 表單 (如有提供)。

RefundCondition

適用於政策的零或多項退款條件。

Duration

在開始時間之前的期間，直到客戶可收到服務費用的部分退款 (比例依 refund_percent 中指定的值) 為止。如果設為 0 (預設值)，代表可隨時取消服務。

uint32

可退款的百分比 (但最晚要在服務開始時間的前 min_duration_before_start_time 取消服務預訂)，範圍在 [0, 100] 之間。如果設為 0 (預設值)，代表服務無法退款；如果設為 100，這項服務可全額退款。

string

客戶的名字

string

客戶的姓氏

PostalAddress

客戶的地址

string

客戶的電話號碼

string

客戶的電子郵件地址

string

擁有此商家的合作夥伴父項資源名稱，格式為 partners/{partner_id}。

string

要用於此商家的商家 ID。

Merchant

要建立的商家。

string

擁有這項服務的商家父項資源名稱，格式為 partners/{partner_id}/merchants/{merchant_id}。

string

要用於此服務的服務 ID。

Service

要建立的服務。

CreditCardType

受支援信用卡的清單。如果留空，則不支援任何信用卡。

string

要刪除的商家的資源名稱。格式為：partners/{partner_id}/merchants/{merchant_id}

string

要刪除的服務的資源名稱。格式：partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

存款金額。

int64

至少提前取消訂金。

PriceType

定義如何根據供應情形決定存款。

Text

建議使用者只透過下列付款方式付款。

Duration

時間長度下限。

Duration

時間長度上限。

string

這是必填欄位，用於指定下列供應情形訊息所屬的商家。

string

這是必填欄位，用於指定下列供應情形訊息所屬的服務。

Timestamp

如有提供，我們會將實體提供的供應情形視為於 [start_time_restrict, end_time_restrict] 擷取的完整快照。也就是說，如果以下條件皆成立，則所有現有的供應情形資料都將會刪除：

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

如果設定了 duration 訊息，則條件會進一步受到限制：

  availability.duration == duration_restrict

如果設定了 resources_restrict 訊息，則條件會進一步受到限制：

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

這些欄位通常用來提供指定時間範圍內的供應情形完整更新。

如果設定 start_time_restrict 而不設定 end_time_restrict，系統會解讀為一律從 start_time_restrict 開始。

Timestamp

如果設定 end_time_restrict 而不設定 start_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

固定金額。例如 $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 年 8 月 10 日下午 6 點前下單。- last_ordering_time 值為 2020-08-08 20:00，代表客戶必須在 2020 年 8 月 10 日下午 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

必要欄位。資源名稱，格式為「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

指定居家服務所屬類別下的工作類型。例如，unclog_drain、install_faucet 是「水電工」類別下的工作類型。

string

要失效的資源名稱，

舉例來說，「取貨」資源的名稱格式應為 partners/{partner_id}/pickups/{pickup_id}。實作作業必須移除已識別資源的快取版本。

string

商家服務的 ID。

int64

預約時段的開始時間 (採用世界標準時間，自 Unix Epoch 紀元時間起算，以秒為單位)。

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 地圖上特定地點的地點 ID。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解地點 ID。如果提供這項資訊，Google 就會將該位置與這個地點進行比對。

string

系統會利用位置名稱、電話、網址和地理區域來支援地點與 Google 地圖上現有的地點進行比對。

這是選填欄位，但在某些情況下可能需要。舉例來說，如果 Service.location 缺少名稱，即使商家實體位於相同地址，系統也不會比對出這個企業實體。(選用)

string

位置的公開電話號碼 (包含其所在國家/地區代碼)，例如 +14567891234。(選用)

string

位置的公開網站網址。(選用)

GeoCoordinates

位置的地理資訊，包括經緯度和地址。(選用)

LocationType

位置類型；如果已針對「服務」提供位置，就必須提供該位置。

string

服務中該位置的專屬參照。此 ID 可用來在其他服務欄位中參照這個位置。例如在自訂登記表單中，您可以使用一組地區 ID 來指定上車地點選項。如果設定這個項目，同一服務中不得出現重複的 ID。(選用)

string

商家資源名稱，格式為 partners/{partner_id}/merchants/{merchant_id}。

string

系統會利用 merchant_name、電話、網址和地理區域來合作夥伴庫存清單與 Google 地圖上現有的商家進行比對。這項資訊不會顯示。

此為商家名稱。

string

商家的公開電話號碼 (包含所在國家/地區代碼，例如 +14567891234)。

string

商家公開網站的網址。

GeoCoordinates

商家的地理資訊，包括經緯度和地址。

string

集結網站平台中的商家類別。

int64

這個欄位現已淘汰。

uint32

商家的稅率，以基準點 (一個百分點的百分之一) 表示。舉例來說，如果稅率是 7.5%，這個欄位應設為 750。

如果這個欄位未設定或設為 0，則此商家就其提供的任何服務向使用者收取的總價格就是 Service.price 指定的實際價格。系統會假設服務價格為免稅或已包含適用稅金。系統不會在獨立的明細項目中向使用者顯示稅金。

如果將這個欄位設定為任何非零值，則此商家就其提供的任何服務向使用者收取的總價格，將包含服務價格加上以此處提供的稅率計算的稅金。最小貨幣單位的小數 (例如 1 美分後面的小數) 會採用銀行家捨入法。系統會在獨立的明細項目中向使用者顯示稅金。

這個欄位已淘汰，請改用 tax_rate。

TaxRate

商家的稅率。如有這個欄位，其內容會覆寫已淘汰的 tax_rate_basis_points 欄位。空白訊息 (即 Tax_rate { }) 會將套用的稅率重設為零。

PaymentRestrictions

針對這個商家接受的付款方式的相關限制。如未設定這個欄位，系統會假設沒有任何限制。

PaymentOption

此為這個商家提供的付款方式；這個商家提供的服務將可個別限制他們允許的付款方式。

PaymentProcessorConfig

提供代碼化技術的付款處理方的設定 (如果商家能夠支援的話)。

TokenizationConfig

提供代碼化技術的付款處理方的設定 (如果商家能夠支援的話)。

Terms

如果使用者是「透過 Google 預訂」功能來預訂服務，則系統會向其顯示這項相關商家的《條款及細則》。除上述內容外，系統一律會向使用者顯示集結網站合作夥伴的條款及細則，請勿在這裡提供。

string

此為用來識別消費性品牌的隱晦字串，在顯示合作夥伴屬性時使用。這個欄位可讓擁有多個消費性品牌的合作夥伴，在同一份動態饋給內為所有品牌提供商家。

品牌是由多個向消費者顯示的元素 (例如名稱、標誌、服務條款和隱私權政策) 組成。

如果只有一個消費性合作夥伴品牌，就不需要設定這個欄位，可予以忽略。

請根據合作夥伴的情況決定：

合作夥伴沒有多個消費性品牌。--> 忽略此欄位

合作夥伴已設定多個品牌。

  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

注意事項：大多數合作夥伴都不需要設定這個欄位。如果合作夥伴想要使用這個欄位，請務必先聯絡我們設定個別品牌 (包括預設品牌)。

MerchantMatchingHints

協助 Google 比對商家與地圖上現有地點的提示。注意：大多數合作夥伴都不需要設定這個欄位，因為 Google 會使用上述欄位中提供的資訊來比對商家和 Google 地圖上的地點。(選用)

ServiceAttribute

任何服務屬性的定義，用於描述此商家提供的服務。(選用)

ActionLink

選用設定。動作網址 (含有相關聯的語言、僅限國家/地區清單、類型，以及選用平台，指出應執行這個動作的平台)。

Advisement

選用設定。特定商家的一般建議：使用者透過「透過 Google 預訂」加入等候名單的使用者。建議中的個別文字欄位長度上限為 100 個位元組。

string

Google 地方資訊資料庫和 Google 地圖上特定地點的地點 ID。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解地點 ID。

string

商家狀態資源名稱，格式為 partners/{partner_id}/merchants/{merchant_id}/status

string

合作夥伴提供的商家名稱。

GeoCoordinates

合作夥伴提供商家的地理位置資訊。

ProcessingStatus

商家處理狀態。

BookingStatus

與端對端預訂整合相關的狀態。

WaitlistStatus

與等候名單整合相關的狀態。

PlaceInfo

此商家的相符地理位置。如果商家與地理區域比對不相符，則為空白。

LocalServicesMatchInfo

此商家的在地生活服務廣告比對相符。如果該商家不是當地服務商家，或無法與任何供應商配對，則為空白。

DirectUrl

網址清單，用於顯示目前商家商品目錄的內容。請注意，這並不代表廣告空間確實會放送，而且網址可能會與公開顯示的網址不同。

bool

如果商家在未來 30 天內有商品目錄，則為「是」。並不保證商家一定能看到廣告。

UrlType

這個網址的類型。

string

可顯示此商家的網址。

MatchedProvider

相符的服務供應商。一個商家可以與多家服務供應商配對。

int64

Google 在地生活服務外部客戶 ID。

string

在地生活服務類別 (產業)。例如「水電工」和「carpet_cleaning」。

string

地點的名稱。

string

格式化地址 (以當地語言表示)。

string

這個地點的 Google 地點 ID。可用來建立 Google 地圖網址，或擷取地點的更多詳細資料。如需使用範例，請參閱 https://developers.google.com/places/web-service/place-id。

bool

如果商家提供等候名單服務，則為「是」。並不保證商家一定能看到廣告。

Money

最低金額。

Money

金額上限。

Price

使用者未到場使用預訂服務的話，可能需要支付的金額。

PriceType

定義如何根據供應情形決定費用。

string

訂單的資源名稱：partners/{partner ID}/orders/{order ID}

ClientInformation

下訂單客戶的個人資訊。

PaymentInformation

與訂單相關的付款交易資訊。

string

此訂單中所有服務所屬商家的 ID。

LineItem

此訂單中的委刊項。

FulfillmentOption

訂單線上動作連結可用的出貨選項。

PrepaymentStatus

預訂的預付狀態。如果 prepayment_status 是 PREPAYMENT_PROVIDED 或 PREPAYMENT_REFUNDED，則 payments_transaction_id 包含相關聯的專屬交易 ID。

string

與預訂相關聯的唯一付款交易 ID。如果不適用，則為空白。

string

此 ID 用來識別這個付款方式。

在整個集結網站中通用。您可以針對多個商家重複使用同一個 ID 值，讓消費者以相同的付款方式向這些商家付費。

如果針對多個商家重複使用同一個 ID，則只要為其中一個商家更新付款方式的任何值，其他商家中所有使用相同 ID 的付款方式就會一併更新。因此，最佳做法是讓所有付款方式共用相同的 ID，並一律更新為相同的值，以避免發生任何非決定性的行為。

string

此為付款方式名稱，使用者可以看見這項內容。

string

此為付款方式相關說明，使用者可以看見這項內容。

Price

付款方式的價格。

TaxRate

此為這個付款方式的稅率。如果使用這個欄位，其內容會覆寫「商家」或「服務」中的 tax_rate 欄位。空白訊息 (即 Tax_rate { }) 會將套用的稅率重設為零。

PaymentOptionType

此為這個付款方式的類型。單次使用即用

int64

用來指定這個付款方式可用於幾個工作階段。僅適用於多工作階段 / 包，值應大於 1。

TimeRange

可在這個期間內購買付款方式。

TimeRange

付款方式可在這個期間內 (例如 2017 年 1 月份限定優惠價) 使用。如果有的話，這會覆寫 valid_duration 和 activate_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

每張票券稅金。

string

國家/地區，使用 ISO 3166-1 alpha-2 國家/地區代碼指定，例如「US」(必填)

string

縣市，例如「台北市」。(必填)

string

區域，例如「CA」。只有在地址通常包含區域名稱的國家/地區，才需要使用這個欄位。(選用)

string

郵遞區號，例如「94043」。(必填)

string

街道地址，例如「八德路二段 1 號」。(必填)

int64

價格以微貨幣單位表示。最小貨幣單位的小數部分將採用銀行家捨入法 (例如將 $2.5 美分四捨五入為 2 美分，3.5 美分會四捨五入為 4 美分，0.5 美分會四捨五入為 0 美分，2.51 美分會四捨五入為 3 美分)。

string

按照 ISO 4217 定義的價格幣別。

string

這是選用且不透明的字串，用於識別與延伸價格相關聯的定價選項。

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

這個媒體來源的網址。Google 會檢索透過這個網址代管的媒體。

MediaType

這個媒體來源的類型。

Text

支援 i18n 的媒體說明文字，僅支援純文字格式。系統會移除所有 HTML 元件。(選用)

Attribution

媒體來源的作者資訊。請注意，如果必須提供出處，註明拍攝該媒體的攝影師或拍攝機構，就必須設定這個欄位。(選用)

string

已淘汰，建議使用 localized_caption。

Text

註明媒體出處 (例如攝影師或拍攝機構名稱) 的文字，支援 i18n。這段文字會與來源媒體一起顯示。請注意，這個欄位僅支援純文字，系統會移除所有 HTML 元件 (不支援以超連結為基礎的作者資訊)。

string

已淘汰，建議使用 localized_text。

ServiceAvailability

用於取代現有服務供應情形的服務供應情形。

string

選用欄位，可指明提供服務員工的 ID。這個欄位用來識別所有商家、服務和預訂情形記錄中所有的員工，此外，這項資訊必須保持穩定一段時間，才能與過往的預訂建立關聯。如果已提供 Cor_name，則此欄位為必要項目。

string

選用欄位，用來指明提供服務員工的名字。這個欄位會向預訂者顯示，且應為使用者可理解的格式，而非隱晦 ID。如果已提供 Cor_id，則此欄位為必要項目。

string

(選用) 服務進行時所在的空間的 ID。這個欄位可用於在所有商家、服務和供應情形記錄中識別空間。此外，這項資訊必須保持穩定一段時間，才能與過往的預訂建立關聯。如果已提供 room_name，則此欄位為必要項目。

string

(選用) 服務進行時所在空間的名稱。這個欄位會向預訂者顯示，且應為使用者可理解的格式，而非隱晦 ID。(如有 room_id，則為選填)強烈建議預設座位沒有相關的房間。

int32

僅適用於「餐飲業」：在此時段可接待的用餐人數。一間餐廳可以同時與多個時段建立關聯，每個時段都可指定不同的 party_size，例如 2 人、3 或 4 人可住在訂位。

int64

線上取消預約的最晚提前告知時間 (以秒為單位)。(選用)

Price

在最晚提前告知期限內取消服務的費用。

Price

在未取消的情況下逾時未到的費用。

AdmissionPolicy

適用於這項服務的入場政策。如未設定，預設值為 TIME_STRICT。(選用)

CancellationPolicy

排程規則取消政策。(觀光景點為必填)

int64

從最後可預訂時間算起，到供應時段開始為止的期間 (以秒為單位)。

int64

從最晚可預訂時間算起，到供應時段結束為止的期間 (以秒為單位)。如果設定了這個欄位，「admission_policy」欄位必須設為 TIME_FLEXIBLE，表示使用者可以在該時段開始後才使用購買的票券。

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>
請注意，只有<ul> 以下的孩童可以換算價格。<li>所有其他子項都將會捨棄。此外，系統會忽略所有內部標記、屬性和樣式，只保留純文字內容。

分區標記：<div>
針對 <div> 標記中所有支援的內部標記，系統都會根據上述規則進行剖析，這表示 <div> 標記本身不代表任何分組或縮排。此外，系統也會忽略所有內部屬性和樣式。

詞組標記：<br>、<strong>、<em>：
僅支援上述三種標記。<br> 可以用於在段落中斷行，而 <strong>/<em> 則可用來標明重要文字。系統會忽略其他所有詞組標記。

不支援的標記：

• 禁止使用 <html>、<header> 和 <body> 標記。
• 上文中未提及的標記將不予支援 (例如 <table>、<td>...)。
  所有網址、錨定標記和連結都將移除，且一律不會向使用者顯示。如果您想利用相片打造豐富的使用者體驗，請使用下方的「related_media」欄位傳送相片網址。
  

重要注意事項：

• 除了上述支援的標記以外，請盡量不要使用其他標記，因為系統會將不支援的標記中的內容移除，而這可能會影響使用者體驗。
  
• 盡量避免使用深度巢狀結構，例如超過 3 個不同的標題層級或巢狀清單。建議使用扁平、簡潔且直觀的結構，有助改善使用者體驗。
  
• 如果目前支援的版面配置無法滿足您的用途，請與「透過 Google 預訂」團隊聯絡。
  
• 建議大小上限為 32,000 個字元。

Price

服務價格。

PriceInterpretation

說明如何向使用者呈現及顯示價格。除「餐飲業」和「觀光景點」以外，所有產業都可以用來設定服務價格的顯示方式。

SchedulingRules

預約/取消預約的規則。

PrepaymentType

是否需要預付、選用或不支援。

PrepaymentTerms

預付款完成後的相關條款。

ServiceIntakeForm

已淘汰，請使用 intake_form 和 per_ticket_intake_form。

ServiceIntakeForm

此表單用於在使用者預訂這項服務時，要求使用者提供額外的資訊。(選用)

ServiceIntakeForm

此表單用於在使用者預訂這項服務時，要求使用者提供額外的資訊。針對每張預訂的票券，使用者都必須填寫一次。(選用)

TaxRate

服務的稅率。如果使用此欄位，其內容會覆寫商家層級的所有 tax_rate 設定。空白訊息 (即 Tax_rate { }) 會將套用的稅率重設為零。

string

針對可用於支付此服務費用的付款方式，列出其參照 ID。實際付款方式需在商家層級定義，而且可由多個商家共用。

Deposit

定義向使用者收取訂金的方式。指定此欄位將會覆寫該服務的訂金。如將此項設為空白的 Deposit 訊息，則系統會移除所有服務層級的訂金。(選用)

NoShowFee

定義可能會向使用者收取的逾時未到費用。指定此欄位將會覆寫該服務的逾時未到費用。如將此項設為空白的 NoShowFee 訊息，則系統會移除所有服務層級的逾時未到費用。(選用)

RequireCreditCard

指出使用者是否必須提供信用卡才能預訂這項服務。您可以在供應情形層級覆寫這個欄位。(選用)

ActionLink

與這項服務相關的動作連結。若動作連結存在，則必須在「服務」中設定類型 (詳見下文)。

ServiceType

這項服務的預先定義類型。(選用)

TicketType

這項服務可預訂/購買的票券類型 (如果支援票券的話)。(選用)

RelatedMedia

與這項服務相關的相片。Google 會檢索並儲存媒體，確保以最有效率的方式向使用者顯示相關內容。(選用)

ServiceAttributeValueId

適用於這項服務的服務屬性值 (選用)。每項「Service」對於在對應「Merchant」中定義的每個服務屬性都可設定零或多個值。(選用)

WaitlistRules

加入等候名單的規則。

TicketingVerticalSpecificData

活動售票業專用的額外資訊。(選用)

IntegrationType

我們針對這項服務支援的整合深度。(選用) 不適用於採用新手整合的合作夥伴。這些合作夥伴的端對端功能將一律停用。

PerOrderFee

購買這項服務的訂單層級費用。(選用)

ToursAndActivitiesContent

「導覽行程」和「活動」專用的內容欄位。

Location

與這項服務相關的位置。重要注意事項：如有多個造訪地點與這項服務有關，或是 START_LOCATION 與 VISITED_LOCATION 不同，則必須指定 START_LOCATION。範例：- 單車導覽行程，中間將停留三個景點，則必須指定起點。- 巴士導覽行程，在飯店大廳集合，然後前往參觀地點。必須指定會議地點。

Rating

這項服務的使用者評分，做為所有評論的匯總指標。

HomeServiceData

居家服務產業專用的額外資訊。(選用)

VirtualSession

選用設定。虛擬工作階段的相關資訊。啟用虛擬服務是需要的。

DirectMerchantPayment

選用設定。如果服務要求使用者直接付款給商家，必須新增其他資訊。重要事項：RwG 不會參與這筆交易。如果已定義 virtual_session，且服務並非 Free 或 prepayment_type 設為 REQUIRED，則為必要欄位。

ChargeTiming

費用的計算時間 (以購買時間為準)。

int64

服務開始時間 (秒) 才會向使用者收費。只有在 ChargeTiming 為 CHARGE_LATER 時，才需要設定此欄位。

string

專屬 ID，可用來識別相同商家的其他服務屬性，例如「account-type」。

string

使用者看到這項屬性的名稱，例如「帳戶類型」。

Value

這個服務屬性的所有可能值。

string

這個 ID 可用來識別這個服務屬性在眾多項目中的不重複值，例如「personal」。

string

使用者看到的值名稱，例如「個人」。

string

Merchant.service_attribute 中定義的屬性 ID，例如「service-type」。

string

這項屬性值的 ID，例如「haircut」。必須與服務屬性定義中的 value_id 相符。

string

要套用這個項目的服務的資源名稱。格式：partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

如有提供，我們會將實體提供的供應情形視為於 [start_time_restrict, end_time_restrict] 擷取的完整快照。也就是說，如果以下條件皆成立，則所有現有的供應情形資料都將會刪除：

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

如果設定了 duration 訊息，則條件會進一步受到限制：

  availability.duration == duration_restrict

如果設定了 resources_restrict 訊息，則條件會進一步受到限制：

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

這些欄位通常用來提供指定時間範圍內的供應情形完整更新。

如果設定 start_time_restrict 而不設定 end_time_restrict，系統會解讀為一律從 start_time_restrict 開始。

Timestamp

如果設定 end_time_restrict 而不設定 start_time_restrict，系統會解讀為一律到 end_time_restrict 為止。

Duration

設定 duration 會進一步將更新範圍限制在相符期間內的供應情形。

Resources

設定 resources_restrict 會進一步將更新範圍限制在這組資源。資源的所有 ID 欄位都必須完全相符。

Availability

新的供應情形清單。

ServiceIntakeFormField

向使用者顯示的欄位。

bool

如果為「是」，系統會向初次光顧的客戶顯示這份表單。已淘汰。登記表單不支援這項功能。

bool

如果為「是」，系統會向回流客戶顯示這份表單。已淘汰。登記表單不支援這項功能。

string

來自集結網站合作夥伴的字串，用來識別個別表單欄位。這個 ID 應與對應表單欄位答案中的 ID 相同，且在服務層級和所有票券登記表單中均不得重複。(必填)

FieldType

這個欄位的類型。

string

這個欄位向使用者顯示的文字。已淘汰，請改用 localized_label。

Text

這個欄位向使用者顯示的文字。此欄位支援多種語言代碼 (能以多種語言填入內容)。(必填)

string

只有在欄位類型為 LOCATION_SEARCH 時才需要設定。請使用「位置」欄位中的「location_id」來指定位置值。

Text

只有在欄位類型為 MULTIPLE_CHOICE、CHECKBOXES 或 DROPDOWN 時，才需要設定。用於列舉可能的選擇。

bool

指出使用者是否必須回答這個欄位。

bool

表示預先定義答案之外是否允許使用自訂值。只有在欄位類型為「LOCATION_SEARCH」時，才適用這個選項。(選用)

Text

除了提供的值之外，系統還會提供其他選項。只有在欄位類型為「LOCATION_SEARCH」時才能設定。舉例來說，除了提供的營業地點清單外，還有另一個可用選項設為「我稍後會聯絡供應商」。(選用)

string

如果這個問題只應在使用者預訂特定票券類型時顯示，則此欄位應設為一組適用的票券類型 ID。如果問題一律適用，請將欄位留空。

Text

輸入的提示文字，以文字預留位置的形式顯示。這僅適用於欄位類型為 SHORT_ANSWER 或 Graph 的情況。(選用)

int32

稅率以一個百分比的百萬為單位，有效位數可達 6 位的精確度。舉例來說，如果稅率是 7.253%，這個欄位就應設定為 7253000。

如果這個欄位未設定或設為 0，則此商家就其提供的任何服務向使用者收取的總價格就是 Service.price 指定的實際價格。系統會假設服務價格為免稅或已包含適用稅金。系統不會在獨立的明細項目中向使用者顯示稅金。

如果將這個欄位設定為任何非零值，則此商家就其提供的任何服務向使用者收取的總價格，將包含服務價格加上以此處提供的稅率計算的稅金。最小貨幣單位的小數 (例如 1 美分後面的小數) 會採用銀行家捨入法。系統會在獨立的明細項目中向使用者顯示稅金。

string

(選用) 條款及細則的網址。

string

此為要向消費者顯示的文字內容。新的整合請使用下方的 localized_text。

Text

要向使用者顯示的本地化文字。

string

語言代碼不明的文字值。只有在 localized_value 空白時才需要提供。這個值的語言代碼可能因合作夥伴或服務供應商而異，不應假設為任何特定語言。

LocalizedString

依據語言代碼本地化的文字值。選用。

string

支援單 ID 可用來區分同一服務中的不同票券類型，且單一服務中不應重複。

string

這個 TicketType 的簡短說明。

這項內容可向使用者顯示，例如「成人」、「兒童」、「退伍軍人」、「J 排」等。這是必要項目，每種票券類型都應向使用者顯示說明。已淘汰，請改用 localized_short_description。

Text

這個 TicketType 的簡短說明，支援 i18n。

這項內容可向使用者顯示，例如「成人」、「兒童」、「退伍軍人」、「J 排」等。這是必要項目，每種票券類型都應向使用者顯示說明。您可以針對各個語言代碼提供不同的值。

Price

這個類型一張票券的價格，不含任何稅金。票券會套用「服務」的稅率。

PerTicketFee

購買此票券需要的額外費用。(選用)

string

這個票券類型代表的任何其他選項的說明 (如適用)。已淘汰，請改用 localized_option_description。

Text

這個票券類型代表的任何其他選項的說明 (如適用)。您可以針對各個語言代碼提供不同的值。

如果票券類型代表多個維度，額外選項就能派上用場。

範例 1：入場券有不同的類型 (「成人」、「兒童」) 和語言額外選項，TicketType 清單應如下所示：- { ticket_type_id: "ticket_type_1" localized_short_description { value: "成人" } localized_option_description { value: "英文" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "成人" } localized_option_description { value: "西班牙文" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "兒童" } localized_option_description { value: "英文" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "兒童" } localized_option_description { value: "西班牙文" } }

範例 2：皮艇出租 (按小時計)，可加選防水袋，short_description 可以是「3 小時」，而 option_description 可以是「含防水袋」或「不含防水袋」：- { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 小時" } localized_option_description { value: "英文" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 小時" } localized_option_description { value: "西班牙文" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 小時" } localized_option_description { value: "英文" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 小時" } localized_option_description { value: "西班牙文" } }

(選用) 不過如果服務中有任何票券類型設定了這個欄位，我們會預期所有其他票券類型也都設定了這個欄位 (可使用預設的 option_description)。舉例來說，[{ticket_type_1, 成人, 英文}, {ticket_type_1, 成人, ''}] 就不是有效清單。

僅支援兩種 HTML 格式標記： 和
。這兩者是用來指定含有標題和詳細說明的選項，例如：「高級座位
這個選項提供私人包廂座位，附全軟墊座椅、私人電視、座位餐飲服務。這些座位能將如畫的美景盡收眼底。」

EventCategory

活動的類別。只有在活動屬於其中一個預先定義的類別時，才設定此項目。(選用)

string

合作夥伴網站上的活動網址。(選用)

Entity

與活動相關的實體清單。(選用)

AttendanceMode

必要欄位。活動出席狀況的類型。

string

選用設定。觀看活動的網址。

Text

選用設定。舉辦活動的主辦單位。

string

選用設定。活動主辦人的網址。

OrganizerType

選用設定。發起人的類型。

string

必要欄位。活動資訊或說明的網頁網址。

EventState

選用設定。事件狀態。

string

合作夥伴資料庫中實體的專屬 ID。(選用)

string

實體名稱。(必填)

string

明確描述實體的網頁網址。這是合作夥伴網站上針對該實體 (如果有的話) 的網頁；至於該實體的其他公開網址，請使用 public_identification_data 中的 relevant_url。(選用)

EntityType

實體的類型。(選用)

EntityRole

活動中實體扮演的角色。(選用)

PublicIdentificationData

實體的公開參照。(選用)

string

主題專用的任何網頁的公開網址。這類內容可能包括官方網站、discogs、社交媒體平台、維基百科或 imdb 頁面，例如 https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan。(選用)

string

演出者或其他音樂實體的 36 個字元 musicbrainz ID (如有)。請參閱 https://musicbrainz.org/doc/MusicBrainz_Identifier。(選用)

Timestamp

時間範圍的下限。

Timestamp

時間範圍的上限。

map<string, string>

代碼化技術的設定通常會有一個 tokenization_parameter，其金鑰為「gateway」，其值則是處理方的名稱。

其餘參數則視處理方而定。請參閱 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 中為付款方式提供的帳單資訊 (請見上方說明)。將這個欄位留白等同於指定 MIN。