Package google.maps.booking.v1alpha

string

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

string

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

string

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

ActionPlatform

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

ActionLinkType

預定動作類型。

OrderOnlineMetadata

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

FoodOrderingMetadata

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

EventMetadata

活動專屬的動作連結其他資訊。

Surface

與動作連結相關聯的預先指定事件途徑。僅適用於事件類別。

string

ID。AdsAccountLink 的資源名稱。格式：partners/{partner}/adsAccountLinks/{ads_account_link}

string

必要欄位。要與 Google Ads 帳戶連結的商品目錄商品 ID 清單。

State

僅供輸出。Google Ads 帳戶連結狀態。

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

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

Prepayment

選用設定。這個可預訂時段的選用預付款資訊。

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，就必須立即拒絕或建立預訂，且建立狀態為「待處理」。

LinkoutRequiredReason

選用設定。這個時段需要建立連結的原因。如果已設定，這個版位的商家資源必須包含有效的 LinkoutTemplate。(選填)

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 紀元時間起算，以秒為單位)。這個欄位會覆寫任何服務層級的取消規則。(選填)

string

資源名稱，格式如下：partners/{partner_id}/feeds/{feed_name}。

GenericDeleteRecord

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

string

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

GenericRecord

要插入和/或更新的記錄。一個 API 呼叫最多可傳回 1000 筆記錄。

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

必要欄位。用來建立這個 Google Ads 帳戶連結的父項資源。這與合作夥伴中心帳戶 ID 相同。格式：partners/{partner}

string

必要欄位。用於 Google Ads 帳戶連結的 ID。這與 Google Ads 客戶 ID 相同。詳情請參閱 https://support.google.com/google-ads/answer/1704344 格式：xxx-xxx-xxxx。

AdsAccountLink

必要欄位。要建立的 AdsAccountLink。

string

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

string

要用於此商家的商家 ID。

Merchant

要建立的商家。

string

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

string

要用於這項服務的服務 ID。

Service

要建立的服務。

CreditCardType

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

string

必要欄位。要刪除的 AdsAccountLink 名稱。格式：partners/{partner}/adsAccountLinks/{ads_account_link}

string

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

string

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

Price

訂金金額。

int64

提前取消最低存款金額。

PriceType

定義如何根據供應情形決定訂金金額。

Text

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

Duration

時間長度下限。

Duration

時間長度上限。

Text

必要欄位。經濟運營商的姓名、地址、電話號碼和電子郵件地址，經濟運營商是指製造商、授權代表、進口商、發布商、履行服務供應商或任何其他自然人或法人，須遵守與產品製造、提供產品或將產品投入服務相關的義務。Economic_operator 的任意字串表示法。這項資訊的格式可使用「"」和「\n」來設定。

string

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

string

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

Timestamp

如有提供，我們會將實體提供的供應情形視為於 [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，表示消費者必須在兩天前晚上 8 點前下單，才能在 2020-08-10 收到訂購商品。

NoFee

不收取任何服務費。

MinimumFee

與執行要求方法相關聯的基本費用。

FixedFee

與履行方式相關聯的固定費用。

Price

必要欄位。執行方法的固定費用金額。

Price

必要欄位。執行要求方法的基本費用金額。

Timestamp

必要欄位。這個時間戳記會用來決定刪除作業在廣告空間中執行的順序。

bytes

適用於非原型設計動態饋給。

Any

適用於以 Protobuf 為基礎的動態饋給。

Timestamp

必要欄位。這個時間戳記可確保商品目錄更新的正確順序。

bytes

適用於非原型設計動態饋給。

Any

適用於 proto 型動態饋給。

double

緯度度數。(選填)

double

經度度數。(選填)

PostalAddress

位置的郵寄地址 (建議使用)。

string

您也可以提供非結構化的地址備用。例如：「1600 amphitheatre parkway Mountain View, ca 94043, USA」

string

必要欄位。要擷取的 Google Ads 帳戶連結名稱。格式：partners/{partner}/adsAccountLinks/{ads_account_link}

string

必要欄位。資源名稱，格式為 partners/{partner_id}/merchants/{merchant_id}/status。

string

動態饋給的資源名稱，格式為

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

string

這項住家服務所屬的概略類別。例如水電工、電工等。

string

指定住家服務所屬類別下的作業類型。例如，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 個位元組。

EconomicOperator

選用設定。為確保遵循法規，請務必提供與這個特定商家相關聯的經濟操作員資訊。(選填)

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

如果商家提供等候名單服務，則為 True。並不保證商家實際送達。

Money

最低金額。

Money

最高金額。

Price

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

PriceType

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

string

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

ClientInformation

下訂單客戶的個人資訊。

PaymentInformation

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

string

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

LineItem

此訂單中的明細項目。

FulfillmentOption

線上訂購動作連結的可用執行要求選項。

PrepaymentStatus

預訂的預付狀態。如果 prepayment_status 是 PREPAYMENT_PROVIDED 或 PREPAYMENT_REFUNDED，則 payment_transaction_id 會包含相關聯的唯一交易 ID。

string

與預訂相關聯的唯一付款交易 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 號」。(必填)

PriceInfo

價格詳細資料容器。

int64

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

string

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

string

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

PriceType

定義價格或價格範圍的套用方式 (每人或固定價格)

Price

服務或費用的價格。

PriceRange

服務或費用的上限和/或下限。

Price

最低金額。

Price

最高金額。應一律設為 >min_price [最低價格]。

double

單一值。例如：5.6

RangeValue

也可能是開放式或受限的值範圍。範例：* 至少 5.5 * 最多 5.5 * 5.5 到 6.5

double

最小值。

double

最大值。

double

平均評分值 (number_of_ratings 大於 0 時必填)。這個值必須在 [1, 5] 的範圍內，只有在 number_of_ratings 為零的情況下可省略。

uint64

用於計算值的評分次數 (必填)。

string

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

MediaType

這個媒體來源的類型。

Text

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

Attribution

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

string

已淘汰，建議使用 localized_caption。

Text

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

string

已淘汰，建議使用 localized_text。

ServiceAvailability

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

string

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

string

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

string

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

string

(選用) 服務進行時所在空間的名稱。這個欄位會向預訂者顯示，且應為使用者可理解的格式，而非隱晦 ID。(選填，但如果有 room_id 就必須填寫) 在餐飲類別中，房間名稱應只用於酒吧或露台等座位區，不應用於固定價格菜單、特殊活動或任何其他非房間值 (例如預訂或晚餐)。強烈建議將預設座椅休息區設成無關聯的房間。

int32

僅適用於「餐飲業」：在此時段可接待的用餐人數。一家餐廳可同時與多個「時段」建立關聯，各自指定不同的 party_size，例如一筆預訂可以有 2 人、3 人或 4 人入座。

Text

選用設定。本地化客房說明。如果已設定，則必須提供預設值。建議您也提供商家所在區域的常用語言。(選填)

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>
請注意，只有 <li><ul> 歲以下兒童或 <ol>代碼之間會經過轉換所有其他子項都將會捨棄。此外，系統會忽略所有內部標記、屬性和樣式，只保留純文字內容。

分區標記：<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

與這項服務相關的動作連結。如有動作連結，則必須在「Service」中設定類型 (請參閱下方說明)。

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，但服務不是免費，或 prepayment_type 未設為 REQUIRED，就必須提供此參數。

UriTemplate

選用設定。選用範本，指定 Google 應如何產生外部網站的網址。

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 或 PARAGRAPH 的情況。(選填)

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

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

PriceDisplayType

選用設定。這個類型的單一票券預設價格顯示類型。

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

InventoryType

選用設定。這類型一張票券的預定廣告空間類型。

EventCategory

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

string

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

Entity

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

AttendanceMode

必要欄位。活動出席類型。

string

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

Text

選用設定。活動主辦人。

string

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

OrganizerType

選用設定。發起人類型。

string

必要欄位。可查看事件資訊或說明的網頁網址。

EventState

選用設定。事件狀態。

Text

選用設定。本地化品牌名稱。

EventCreator

選用設定。活動建立者的相關資訊。

string

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

string

實體名稱。(必填)

string

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

EntityType

實體的類型。(選填)

EntityRole

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

PublicIdentificationData

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

string

選用設定。活動建立者的名稱。沒有字元限制。

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 做為值。