- Resource: Service
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- Attribution
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entity
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- Location
- LocationType
- Rating
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- 平台
- DirectMerchantPayment
- 方法
Resource: Service
商家所提供服務的相關資訊,例如剪髮
JSON 表示法 |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
欄位 | |
---|---|
name |
服務資源名稱,格式為 |
serviceName |
服務的名稱,例如「男性剪髮」。已淘汰,請改用 localizedServiceName。 |
localizedServiceName |
服務的名稱,例如「男性剪髮」。可能使用多個語言代碼。 |
description |
向使用者顯示的服務說明。已淘汰,請改用 localizedDescription。 |
localizedDescription |
向使用者顯示的服務說明。 這個欄位支援純文字和類 HTML 兩種格式。與純文字部分不同的是,您可以使用標題、段落、清單和一些詞組標記來建立自訂版面配置。請仔細閱讀下列操作說明和注意事項,確保為使用者提供最佳使用體驗。 支援的類 HTML 格式標記: 標題標記:<h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落標記:<p> 清單標記:<ul>、<ol>、<li> 分區標記:<div> 詞組標記:<br>、<strong>、<em>: 不支援的標記:
重要注意事項:
|
price |
服務價格。 |
priceInterpretation |
說明如何向使用者呈現及顯示價格。除了「餐飲」和「觀光景點」以外,其他任何產業皆可用來設定服務價格的顯示方式。 |
rules |
預約/取消預約的規則。 |
prepaymentType |
說明是否需要預付、選用或不支援。 |
prepaymentTerms |
預付完成後的相關條款。 |
form[] |
已淘汰,請使用 intakeForm 和 perTicketIntakeForm。 |
intakeForm |
此表單用於在使用者預訂這項服務時,要求使用者提供額外的資訊。(選填) |
perTicketIntakeForm |
此表單用於在使用者預訂這項服務時,要求使用者提供額外的資訊。針對每張預訂的票券,使用者都必須填寫一次。(選填) |
taxRate |
服務的稅率。如有此欄位,其將覆寫商家層級設定的任何 taxRate。空白訊息 (即 taxRate { }) 會將套用的稅率重設為零。 |
paymentOptionId[] |
針對可用於支付此服務費用的付款方式,列出其參照 ID。實際付款方式需在商家層級定義,而且可由多個商家共用。 |
deposit |
定義向使用者收取訂金的方式。指定此欄位將會覆寫該服務的訂金。如將此項設為空白的 Deposit 訊息,則系統會移除所有服務層級的訂金。(選填) |
noShowFee |
定義可能會向使用者收取的逾時未到費用。指定此欄位將會覆寫該服務的逾時未到費用。如將此項設為空白的 NoShowFee 訊息,則系統會移除所有服務層級的逾時未到費用。(選填) |
requireCreditCard |
指出使用者是否必須提供信用卡才能預訂這項服務。您可以在供應情形層級覆寫這個欄位。(選填) |
actionLink[] |
與這項服務相關的動作連結。如有動作連結,則必須在「Service」中設定類型 (請見下文)。 |
type |
這項服務的預先定義類型。(選填) |
ticketType[] |
這項服務可預訂/購買的票券類型 (如果支援票券的話)。(選填) |
relatedMedia[] |
與這項服務相關的相片。Google 會檢索並儲存媒體,確保以最有效率的方式向使用者顯示相關內容。(選填) |
serviceAttributeValueId[] |
適用於這項服務的服務屬性值 (選用)。每項「Service」對於在對應「Merchant」中定義的每個服務屬性都可設定零或多個值。(選填) |
waitlistRules |
加入等候名單的規則。 |
ticketingVerticalSpecificData |
活動售票業專用的額外資訊。(選填) |
integrationType |
我們針對這項服務支援的整合深度。(選用) 不適用於採用新手整合的合作夥伴。這類合作夥伴的端對端功能將一律停用。 |
perOrderFee |
購買這項服務的訂單層級費用。(選填) |
toursAndActivitiesContent |
「導覽行程」和「活動」專用的內容欄位。 |
location[] |
與這項服務相關的位置。重要注意事項:如有多個造訪地點與這項服務有關,或是 START_LOCATION 與 VISITED_LOCATION 不同,則必須指定 START_LOCATION。範例:- 單車導覽行程,中間將停留三個景點,則必須指定起點。- 巴士導覽行程,在飯店大廳集合,然後前往參觀地點。必須指定會議地點。 |
rating |
這項服務的使用者評分,視為所有評論的匯總指標。 |
homeServiceData |
適用於居家服務產業的額外資訊。(選填) |
virtualSession |
選用設定。虛擬工作階段的相關資訊。如要啟用虛擬服務,此為必要條件。 |
directMerchantPayment |
選用設定。如果服務要求使用者直接付款給商家,則必須加入額外資訊。重要注意事項:RwG 不會參與這筆交易。如果已定義 virtualSession,但服務並非免費,或 prepaymentType 設為「REQUIRED」,則必須提供這個參數。 |
PriceInterpretation
說明如何向使用者呈現及顯示價格。
列舉 | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
未指定價格呈現細項,預設為 EXACT_AMOUNT。 |
EXACT_AMOUNT |
適用於必須以特定值顯示價格的情況。 範例:瑜珈課程每堂 $20 美元、兒童剪髮每次 $15 美元 |
STARTS_AT |
適用於服務價格會變動,但可向消費者顯示已知最低價格的情況。消費者選擇的服務項目可能會高於顯示的價格。 請注意,凡是使用這個 PriceInterpretation 的服務都必須使用 PrepaymentType NOT_SUPPORTED。 範例:愛犬美容服務 $30 美元,但消費者可能會加購其他項目,因此總價會增加 |
NOT_DISPLAYED |
適用於服務價格會變動,但系統不會預先向消費者顯示價格資訊的情況。 請注意,凡是使用這個 PriceInterpretation 的服務都必須使用 PrepaymentType NOT_SUPPORTED,而且「Price」部分必須空白。 範例:居家服務諮詢 |
SchedulingRules
服務的排程規則。
JSON 表示法 |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
欄位 | |
---|---|
minAdvanceOnlineCanceling |
線上取消預約的最晚提前告知時間 (以秒為單位)。(選填) |
lateCancellationFee |
在最晚提前告知期限內取消服務的費用。 |
noshowFee |
在未取消的情況下逾時未到的費用。 |
admissionPolicy |
適用於這項服務的入場政策。如未設定,預設值為 TIME_STRICT。(選填) |
cancellationPolicy |
排程規則取消政策。(「觀光景點」的必要條件) |
聯集欄位 如果設定了「min_advance_booking」,則最晚可預訂時間的計算方式為 (<時段開始時間> -「min_advance_booking」)。如果設定了「min_booking_buffer_before_end_time」,則最晚可預定時間的計算方式為 (<時段結束時間> -「min_booking_buffer_before_end_time」)。請注意,如要設定「min_booking_buffer_before_end_time」,該值必須為正數。如果兩者都未設定,則在該時段開始時間之前,該時段都可供預訂。如果同時設定這兩個欄位,系統只會挑選一個值,並忽略另一個值,因此我們無法確實預測選取的值。 範例:
|
|
minAdvanceBooking |
從最晚可預訂時間算起,到供應時段開始為止的期間 (以秒為單位)。 |
minBookingBufferBeforeEndTime |
從最晚可預訂時間算起,到供應時段結束為止的期間 (以秒為單位)。如果設定這個欄位,「admissionPolicy」欄位必須設為 TIME_FLEXIBLE,表示使用者可以在該時段開始後使用購買的票券。 |
AdmissionPolicy
此服務的入場政策。
列舉 | |
---|---|
ADMISSION_POLICY_UNSPECIFIED |
未使用。 |
TIME_STRICT |
客戶必須在供應時段的開始時間到場,且服務預計會在該時段的結束時間結束。TIME_STRICT 用途範例:* 上午 9 點開始的導覽行程,要求所有參加者在開始時間抵達,預計於中午 12 點返回。* 預約週六下午 3 點剪髮,需時大約 30 分鐘。* 晚上 6 點到 8 點的健身課程。 |
TIME_FLEXIBLE |
客戶只要在供應時段的開始與結束時間之間的任何時間點抵達,就能使用本次預訂的服務。 TIME_FLEXIBLE 用途範例:* 在購買日期的任何時段都能使用的博物館票券。* 遊樂園午後入場券,可用時段為中午 12 點到晚上 9 點。 |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
客戶必須在供應時段的開始時間抵達商家,但隨時可以離開。 以博物館入場門票為例,如果使用者持有的是上午 10 點入場的限時門票,就必須在早上 10 點抵達博物館。這項服務供應時段的開始時間代表指定的入場時間。結束時間則僅用來當做識別可供預訂的供應時段的索引鍵。 |
CancellationPolicy
服務的取消政策。
JSON 表示法 |
---|
{
"refundCondition": [
{
object ( |
欄位 | |
---|---|
refundCondition[] |
適用於該政策的零或多項退款條件。 |
RefundCondition
定義單一退款條件。您可以同時採用多項退款條件,按照服務開始時間前的不同階段來說明「退款步驟」。
JSON 表示法 |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
欄位 | |
---|---|
minDurationBeforeStartTime |
在開始時間之前的期間,直到客戶可收到服務費用的部分退款 (比例依 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
refundPercent |
可退款的百分比 (但最晚要在服務開始時間的前 |
PrepaymentType
以列舉方式表示預付類型。
列舉 | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
根據預設,我們會假設預付功能為 NOT_SUPPORTED。 |
REQUIRED |
使用者必須在預訂時支付這項服務的費用。 |
OPTIONAL |
使用者可以選擇在預訂時或稍後預付服務費用,但預訂此服務不一定要先預付費用。 |
NOT_SUPPORTED |
這項服務不支援預付。 |
PrepaymentTerms
預付完成後的特定資訊。
JSON 表示法 |
---|
{
"chargeTiming": enum ( |
欄位 | |
---|---|
chargeTiming |
收費時間是相對於購買時間。 |
chargeTimeBeforeStartTimeSec |
向使用者收取費用的時間 (以秒為單位)。只有在 ChargeTiming 為 CHARGE_LATER 時才需要設定這個欄位。 |
ChargeTiming
以預估時間相對於購買時間的收費。
列舉 | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
未使用。 |
CHARGE_NOW |
系統會立即向「客戶」收費。 |
CHARGE_LATER |
系統稍後會向客戶收費。 |
ServiceIntakeForm
定義用來自訂商家所提供服務的登記表單。
JSON 表示法 |
---|
{
"field": [
{
object ( |
欄位 | |
---|---|
field[] |
要向使用者顯示的欄位。 |
firstTimeCustomers |
如果為「是」,系統會向初次光顧的客戶顯示這份表單。已淘汰。登記表單不支援這項功能。 |
returningCustomers |
如果為「是」,系統會向回流客戶顯示這份表單。已淘汰。登記表單不支援這項功能。 |
ServiceIntakeFormField
定義包含在 ServiceIntakeForm 中的欄位。
JSON 表示法 |
---|
{ "id": string, "type": enum ( |
欄位 | |
---|---|
id |
來自集結網站合作夥伴的字串,用來識別個別表單欄位。這個 ID 應與對應表單欄位答案中的 ID 相同,且在服務層級和所有票券登記表單中均不得重複。(必填) |
type |
這個欄位的類型。 |
label |
這個欄位向使用者顯示的文字。已淘汰,請改用 |
localizedLabel |
這個欄位向使用者顯示的文字。此欄位支援多種語言代碼 (能以多種語言填入內容)。(必填) |
value[] |
只在欄位類型為 LOCATION_SEARCH 時設定。請使用「locationId」位於「位置」欄位,指定位置值。 |
choiceText[] |
只在欄位類型為 MULTIPLE_CHOICE、CHECKBOXES 或 DROPDOWN 時設定。用來列舉可能的選項。 |
isRequired |
指出使用者是否需要回答此欄位。 |
allowCustomAnswer |
指出除了預先定義的答案外,是否允許自訂值。只有在欄位類型為 LOCATION_SEARCH 時才能使用此屬性。(選填) |
additionalOption[] |
除了提供的值以外,我們還提供其他選項。只有在欄位類型為 LOCATION_SEARCH 時適用。例如:除了提供的地點清單外,您還可以選取「我稍後與供應商聯絡」選項。(選填) |
ticketTypeRestrict[] |
如果這個問題只應在使用者預訂特定票券類型時顯示,則此欄位應設為一組適用的票券類型 ID。如果問題一律適用,請將這個欄位留空。 |
hint |
輸入內容的提示文字,以文字預留位置的形式顯示。這僅適用於欄位類型為 SHORT_ANSWER 或 PARAGRAPH 的情況。(選填) |
FieldType
以列舉方式表示欄位類型。
列舉 | |
---|---|
FIELD_TYPE_UNSPECIFIED |
系統會忽略未指定或不明類型的欄位。 |
SHORT_ANSWER |
單行文字輸入欄位。 |
PARAGRAPH |
多行文字輸入欄位。 |
MULTIPLE_CHOICE |
一組圓形按鈕,使用者必須從多個選項中選擇一個。 |
CHECKBOXES |
一或多個搭配核取方塊顯示的列舉項目。 |
DROPDOWN |
下拉式選單中的選項。 |
BOOLEAN |
「是/否」按鈕。 |
LOCATION_SEARCH |
搜尋框;可讓使用者透過系統提供的位置清單輸入內容,以尋找相符的位置。 |
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) SPA 與美容,以及 (3) 財務諮詢與評估服務。請參閱支援的服務類型:https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT |
提供線上預約課程或課程的線上預約服務,這類服務都以虛擬方式進行。如果啟用虛擬服務預訂功能,就必須設定。 |
SERVICE_TYPE_SHOPPING |
允許使用者向特定商家購物的服務。可以是外送或自取。 |
TicketType
TicketType 用來區分價格和/或供應情形各不相同的票券;價格和/或供應情形取決於使用者類型、服務屬性或選購項目/附加服務。
一張票券是指特定服務的最小可預訂單位,例如泛舟名額、博物館入場券、雙人皮艇一日租用券。
JSON 表示法 |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
欄位 | |
---|---|
ticketTypeId |
票券 ID 可用來區分同一服務的不同票券類型,且每項服務中均不得重複。 |
shortDescription |
這個 TicketType 的簡短說明。 這項內容可向使用者顯示,例如「成人」、「兒童」、「退伍軍人」、「J 排」等。這是必要項目,每種票券類型都應向使用者顯示說明。已淘汰,請改用 localizedShortDescription。 |
localizedShortDescription |
這個 TicketType 的簡短說明,支援 i18n。 這項內容可向使用者顯示,例如「成人」、「兒童」、「退伍軍人」、「J 排」等。這是必要項目,每種票券類型都應向使用者顯示說明。您可以針對各個語言代碼提供不同的值。 |
price |
這個類型一張票券的價格,不含任何稅金。票券會套用「服務」稅率。 |
perTicketFee |
購買此票券需要的額外費用。(選填) |
optionDescription |
這個票券類型代表的任何其他選項的說明 (如適用)。已淘汰,請改用 localizedOptionDescription。 |
localizedOptionDescription |
這個票券類型代表的任何其他選項的說明 (如適用)。您可以針對各個語言代碼提供不同的值。 如果票券類型代表多個維度,額外選項就能派上用場。 範例 1:入場券有不同的類型 (「成人」、「兒童」) 和語言額外選項,TicketType 清單應如下所示:- { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "成人" } localizedOptionDescription { value: "英文" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "成人" } localizedOptionDescription { value: "西班牙文" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "兒童" } localizedOptionDescription { value: "英文" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "兒童" } localizedOptionDescription { value: "西班牙文" } } 範例 2:皮艇出租 (按小時計),可加選防水袋,shortDescription 可以是「3 小時」,而 optionDescription 可以是「含防水袋」或「不含防水袋」:- { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 小時" } localizedOptionDescription { value: "英文" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 小時" } localizedOptionDescription { value: "西班牙文" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 小時" } localizedOptionDescription { value: "英文" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 小時" } localizedOptionDescription { value: "西班牙文" } } (選用) 不過如果服務中有任何票券類型設定了這個欄位,我們會預期所有其他票券類型也都設定了這個欄位 (可使用預設的 optionDescription)。舉例來說,[{ticket_type_1, 成人, 英文}, {ticket_type_1, 成人, ''}] 就不是有效清單。 僅支援兩種 HTML 格式標記: 和 |
PerTicketFee
使用者購買每張票需要支付的費用。
JSON 表示法 |
---|
{ "serviceCharge": { object ( |
欄位 | |
---|---|
serviceCharge |
服務收取的額外費用。 |
facilityFee |
場地/設施的費用。 |
taxes |
每張票券稅金。 |
RelatedMedia
與這項服務相關的相片。Google 會檢索這些媒體,確保其正確向使用者顯示。(選用)
JSON 表示法 |
---|
{ "url": string, "type": enum ( |
欄位 | |
---|---|
url |
這個媒體來源的網址。Google 會檢索透過這個網址代管的媒體。 |
type |
這個媒體來源的類型。 |
localizedCaption |
支援 i18n 的媒體說明文字,僅支援純文字格式。系統會移除所有 HTML 元件。(選填) |
attribution |
媒體來源的作者資訊。請注意,如果必須提供出處,註明拍攝該媒體的攝影師或拍攝機構,就必須設定這個欄位。(選填) |
caption |
已淘汰,建議使用 localizedCaption。 |
MediaType
以列舉方式指出這個媒體來源的類型。僅支援相片。如果需要支援相片以外的媒體,請與「透過 Google 預訂」團隊聯絡。
列舉 | |
---|---|
TYPE_UNSPECIFIED |
未使用。 |
PHOTO |
指出該網址提供的媒體是一張相片。 |
Attribution
這個媒體的作者資訊。
JSON 表示法 |
---|
{
"localizedText": {
object ( |
欄位 | |
---|---|
localizedText |
註明媒體出處 (例如攝影師或拍攝機構名稱) 的文字,支援 i18n。這段文字會與來源媒體一起顯示。請注意,這個欄位只支援純文字,所有 HTML 元件都會被移除 (不支援以超連結為基礎的作者資訊)。 |
text |
已淘汰,建議使用 localizedText。 |
ServiceAttributeValueId
識別要套用到某項「服務」的特定服務屬性值。
JSON 表示法 |
---|
{ "attributeId": string, "valueId": string } |
欄位 | |
---|---|
attributeId |
Merchant.service_attribute 中定義的屬性 ID,例如「service-type」。 |
valueId |
這項屬性值的 ID,例如「haircut」。必須與服務屬性定義中的 valueId 相符。 |
WaitlistRules
加入等候名單的相關規則。
JSON 表示法 |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
欄位 | |
---|---|
minPartySize |
必要。適用於提供等候名單功能的服務,必須填入正整數。如果服務或商家未提供等候名單功能,就不能填入這個欄位。 |
maxPartySize |
必要欄位。適用於提供等候名單功能的服務,必須填入正整數。如果服務或商家未提供等候名單功能,就不能填入這個欄位。 |
supportsAdditionalRequest |
如果設為「true」,使用者加入這項服務的等候名單時,將可以傳送任意形式的額外文字要求。 |
aboveMaxPartySizeOptions[] |
為大於 set maxPartySize 的參與者設定選項。如果大型方不應提供加入等候名單的替代選項,請將這個欄位留空。 |
UnsupportedPartySizeOption
超出範圍的派對選項。
JSON 表示法 |
---|
{
"callMerchant": {
object ( |
欄位 | |
---|---|
callMerchant |
如果用餐人數超出範圍,可以打電話給商家。使用者會看到預先定義的訊息。要顯示的文字範例:「如果參與者人數超過 {waitlistRules.max_party_size},請致電 {phone} 上的餐廳。」CallMerchant 必須設定,但將會空白。 |
CallMerchant
請在 UnsupportedPartySizeOption 中使用空白訊息。如果設定這個選項,系統就會顯示選項,讓使用者致電商家預訂。
TicketingVerticalSpecificData
活動售票業專用的額外資訊。
JSON 表示法 |
---|
{ "eventCategory": enum ( |
欄位 | |
---|---|
eventCategory |
活動的類別。只有在活動屬於其中一個預先定義的類別時,才設定此項目。(選填) |
eventUrl |
合作夥伴網站上的活動網址。(選填) |
entity[] |
與活動相關的實體清單。(選填) |
eventAttendanceMode |
必要欄位。活動出席狀況的類型。 |
eventVirtualLocationUrl[] |
選用設定。可查看事件的網址。 |
eventOrganizer |
選用設定。活動主辦人。 |
eventOrganizerUrl |
選用設定。活動主辦人的網址。 |
eventOrganizerType |
選用設定。發起人類型。 |
eventSourceUrl[] |
必要欄位。含有活動資訊或說明的網頁網址。 |
eventState |
選用設定。事件狀態。 |
EventCategory
一部分的活動類別,可供我們自訂產品體驗。注意:這不會用來當做活動的通用本體。
列舉 | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
未指定。請勿使用。 |
EVENT_CATEGORY_CONCERT |
音樂會/演唱會。 |
EVENT_CATEGORY_SPORTS |
運動賽事。 |
EVENT_CATEGORY_THEATRE |
戲劇活動。 |
EVENT_CATEGORY_EXHIBITS |
展覽。 |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
研討會和課程。 |
Entity
代表與活動相關的實體。
JSON 表示法 |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
欄位 | |
---|---|
id |
合作夥伴資料庫中實體的專屬 ID。(選填) |
name |
實體名稱。(必填) |
url |
明確描述實體的網頁網址。這是指合作夥伴網站上有關該實體的網頁 (如有);至於實體的其他公開網址,請使用 publicIdentificationData 中的 relevantUrl。(選填) |
entityType |
實體的類型。(選填) |
entityRole |
活動中實體扮演的角色。(選填) |
publicIdentificationData |
實體的公開參照。(選填) |
EntityType
實體的類型。注意:這不會用來當做通用本體。
列舉 | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
未指定。請勿使用。 |
ENTITY_TYPE_PERFORMER |
實體代表在演唱會/音樂會或節目中演出的演出者或團體。只有在活動類別是 CONCERT 或 THEATRE 的時候才適用。 |
ENTITY_TYPE_PLAYER |
實體代表活動中的隊伍或選手。只有在活動類別是 SPORTS 的時候才適用。 |
ENTITY_TYPE_CONCERT_TOUR |
實體代表這個活動所屬的導覽行程。只有在活動類別是 CONCERT 的時候才適用。 |
ENTITY_TYPE_SPORTS_SERIES |
實體代表此活動所屬的體育錦標賽。只有在活動類別是 SPORTS 的時候才適用。 |
ENTITY_TYPE_PLAY |
實體代表活動中演出的節目類型 (例如音樂劇、喜劇、芭蕾等)。只有在活動類別是 THEATRE 的時候才適用。 |
EntityRole
活動中實體扮演的角色。
列舉 | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
未指定。 |
ENTITY_ROLE_HEADLINER |
實體代表活動的主角或首席演出者。 |
ENTITY_ROLE_SUPPORTER |
實體代表活動的配角。 |
ENTITY_ROLE_HOME_TEAM |
實體代表 (體育) 賽事活動中的主隊。 |
ENTITY_ROLE_AWAY_TEAM |
實體代表 (體育) 賽事活動中的客隊。 |
PublicIdentificationData
ID、網頁,或任何其他參照實體的公開來源。
JSON 表示法 |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
欄位 | |
---|---|
relevantUrl[] |
主題專用的任何網頁的公開網址。這類內容可能包括官方網站、discogs、社交媒體平台、維基百科或 imdb 頁面,例如 https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan。(選填) |
musicbrainzId |
演出者或其他音樂實體的 36 個字元 musicbrainz ID (如有)。請參閱 https://musicbrainz.org/doc/MusicBrainz_Identifier。(選填) |
AttendanceMode
活動出席狀況的類型。
列舉 | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
不指定。 |
ONLINE |
用於虛擬活動。 |
PHYSICAL |
用於實體活動。 |
PHYSICAL_ONLINE_MIXED |
適用於同時屬於實體和虛擬活動。 |
OrganizerType
發起人類型。
列舉 | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
不指定。 |
PERSON |
適用對象為個人或發起人。 |
ORGANIZATION |
適用於機構的發起人。 |
EventState
事件狀態。
列舉 | |
---|---|
EVENT_STATE_UNSPECIFIED |
不指定。 |
SCHEDULED |
活動已排定。 |
RESCHEDULED |
已重新安排活動。 |
CANCELLED |
活動已取消。 |
POSTPONED |
活動已延期。 |
IntegrationType
支援的整合深度。
列舉 | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
預設為 END_TO_END。 |
INTEGRATION_TYPE_END_TO_END |
完全整合,允許透過 Google 進行端對端預訂。 |
INTEGRATION_TYPE_INVENTORY_ONLY |
預訂伺服器不需要支援這項服務。只需要傳送商家、服務和 (選用的) 供應情形資料。 |
PerOrderFee
每筆訂單必須支付一次的費用,不限票券張數。
JSON 表示法 |
---|
{ "deliveryFee": { object ( |
欄位 | |
---|---|
deliveryFee |
費用可能因運送方式而異。 |
processingFee |
處理使用者付款方式的費用。 |
ToursAndActivitiesContent
「導覽行程」和「活動」專用的內容欄位。在重複欄位中的每個元素都應該是獨立的,以便分開顯示 (例如以項目符號條列)。
強烈建議您為「導覽行程」和「活動」填入 ToursAndActivitiesContent (但不強制)。所有欄位都支援純文字和類 HTML 文字這兩種基本格式。支援的類 HTML 格式標記:
詞組標記:
、、、:僅支援上述三種標記。
可以用於在段落中斷行,而 // 則可用來標明重要文字。系統會忽略其他所有詞組標記。
系統不允許其他所有標記和自訂樣式,而且會將其移除。所有網址、錨定標記和連結都將移除,一律不會向使用者顯示。
重要注意事項:*在 highlights
、exclusion
和服務說明中其他更詳盡的欄位已提供的資料,請勿再重複提供。* 除了上述支援的標記以外,請避免使用其他標記,因為系統會將不支援的標記中的內容移除,而這可能會影響使用者體驗。
JSON 表示法 |
---|
{ "highlights": [ { object ( |
欄位 | |
---|---|
highlights[] |
向使用者顯示的重點清單。 |
inclusions[] |
向使用者顯示的包含項目清單。 |
exclusions[] |
向使用者顯示的排除項目清單。 |
mustKnow[] |
向使用者顯示的重要記事清單,用於提供詳細資料,例如年齡限製或其他不適合使用這項服務的條件。 |
位置
特定位置的地理資訊。
JSON 表示法 |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
欄位 | |
---|---|
placeId |
Google 地方資訊資料庫和 Google 地圖上特定地點的地點 ID。請參閱 https://developers.google.com/places/web-service/place-id,進一步瞭解地點 ID。如果提供這項資訊,Google 就會將該位置與這個地點進行比對。 |
name |
我們會使用位置名稱、電話、網址和地理區域來支援特定位置與 Google 地圖上現有的地點。 這是選填欄位,但在某些情況下可能需要填寫。舉例來說,沒有名稱的 Service.location 將不會與企業實體進行比對,即使這些企業實體位於相同的地址也一樣。(選填) |
telephone |
位置的公開電話號碼 (包含其所在國家/地區代碼),例如 +14567891234。(選填) |
url |
位置的公開網站網址。(選填) |
geo |
位置的地理資訊,包括經緯度和地址。(選填) |
locationType |
位置的類型;如果已針對「服務」提供位置,就必須提供該位置。 |
locationId |
服務中該位置的專屬參照。此 ID 可用來在其他服務欄位中參照這個位置。例如:在自訂登記表單中,您可以使用一組位置 ID 來指定取貨地點選項。如果設定這個項目,同一服務中不得出現重複的 ID。(選填) |
LocationType
這個位置的類型。
列舉 | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
未指定位置類型。 |
VISITED_LOCATION |
這項服務造訪的地點。 |
START_LOCATION |
這項服務開始進行的地點,也可做為 MEETING_LOCATION。 |
END_LOCATION |
這項服務結束時的所在地點。 |
Rating
為某實體定義「評分」標準。
JSON 表示法 |
---|
{ "value": number, "numberOfRatings": string } |
欄位 | |
---|---|
value |
平均評分值 (numberOfRatings 大於 0 時必須提供)。這個值必須在 [1, 5] 的範圍內,只有在 numberOfRatings 為零的情況下可省略。 |
numberOfRatings |
用於計算值的評分次數 (必填)。 |
HomeServiceData
必須為居家服務產業提供額外資訊。
JSON 表示法 |
---|
{ "categoryType": string, "jobType": string } |
欄位 | |
---|---|
categoryType |
這項住家服務所屬的概略類別。例如:水電工、電工等 |
jobType |
指定居家服務所屬類別下的工作類型。例如:unclog_drain、install_faucet 是「水電工」類別下的工作類型。 |
VirtualSession
線上/線上工作階段相關資訊。例如:線上瑜珈課程、虛擬烹飪課程等
JSON 表示法 |
---|
{ "sessionInstructions": { object ( |
欄位 | |
---|---|
sessionInstructions |
設定這個虛擬課程的操作說明。如果合作夥伴預訂時沒有提供影片網址,則這段文字必須包含影片網址,以便向使用者分享。例如:「縮放網址將在課程開始前 30 分鐘收到。」(建議選項) |
sessionRequirements |
特定虛擬工作階段的需求。例如:瑜珈墊、烹飪用具等 (建議) |
virtualPlatformInfo |
此工作階段中使用的虛擬平台相關資訊。(啟用虛擬服務時必須啟用) |
isSessionPrerecorded |
必要欄位。如果虛擬工作階段未直播且已預先錄製,請設為 true。 |
VirtualPlatformInfo
將用於這個虛擬工作階段的平台相關資訊。
JSON 表示法 |
---|
{ "platform": enum ( |
欄位 | |
---|---|
platform |
用於虛擬工作階段的平台。 |
otherPlatformName |
平台名稱 (如果平台設為 OTHER)。(如果平台設為 OTHER,則為必要欄位) |
平台
以列舉方式表示商家要使用的虛擬平台。
列舉 | |
---|---|
PLATFORM_UNSPECIFIED |
未使用。 |
FLEXIBLE |
商家可以靈活運用影片平台, |
GOOGLE_HANGOUTS |
Google Hangouts 產品。 |
GOOGLE_MEET |
Google Meet 產品。 |
ZOOM |
Zoom 視訊通訊。 |
SKYPE |
Skype。 |
YOUTUBE |
在 YouTube 中直播。 |
OTHER |
如果使用的影片平台與本文未提及的平台不同,則應設定。 |
DirectMerchantPayment
說明使用者如何直接向商家付款,而非透過 RwG 預付服務。
JSON 表示法 |
---|
{
"paymentMethods": [
{
object ( |
欄位 | |
---|---|
paymentMethods[] |
建議使用者只透過下列付款方式付款。 |
方法 |
|
---|---|
|
建立並傳回由指定集結網站管理的商家的新 Service 。 |
|
刪除由指定集結網站管理的商家的現有 Service 。 |
|
更新並傳回由指定集結網站管理的商家的現有 Service 。 |