- Tài nguyên: Dịch vụ
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy (Chính sách huỷ)
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- Phân bổ
- ServiceAttributeValueId
- WaitlistRules (Quy tắc danh sách chờ)
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Thực thể
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee (Phí mỗi đơn hàng)
- ToursAndActivitiesContent
- Vị trí
- LocationType
- Điểm xếp hạng
- HomeServiceData
- VirtualSession (Phiên bản ảo)
- VirtualPlatformInfo (Thông tin nền tảng ảo)
- Nền tảng
- DirectMerchantPayment
- Phương thức
Tài nguyên: Dịch vụ
Thông tin về một dịch vụ do người bán cung cấp, ví dụ như cắt tóc.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
Các trường | |
---|---|
name |
Tên tài nguyên dịch vụ có định dạng |
serviceName |
Tên của dịch vụ, ví dụ: "Cắt tóc nam". Không dùng nữa, hãy sử dụng localServiceName. |
localizedServiceName |
Tên của dịch vụ, ví dụ: "Cắt tóc nam". Có thể ở một số khu vực. |
description |
Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Ngừng sử dụng, chuyển sang sử dụng localeDescription. |
localizedDescription |
Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Trường này hỗ trợ cả định dạng văn bản thuần tuý và định dạng giống HTML. Không giống như các mục văn bản thuần tuý, bạn có thể tạo bố cục tuỳ chỉnh tại đây bằng cách sử dụng tiêu đề, đoạn văn, danh sách và một số thẻ cụm từ. Vui lòng đọc kỹ hướng dẫn và ghi chú sau để đảm bảo bạn tạo ra trải nghiệm người dùng tốt nhất. Các thẻ định dạng giống HTML được hỗ trợ: Thẻ tiêu đề: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Thẻ đoạn: <p> Thẻ danh sách: <ul>, <ol>, <li> Thẻ chia: <div> Thẻ cụm từ: <br>, <strong>, <em>: Thẻ không được hỗ trợ:
Lưu ý quan trọng:
|
price |
Giá của dịch vụ. |
priceInterpretation |
Mô tả cách giá được diễn giải và hiển thị cho người dùng. Có thể được sử dụng trong mọi ngành dọc, ngoại trừ Hoạt động ăn uống và Điểm tham quan để thiết lập cách trình bày giá dịch vụ. |
rules |
Quy tắc đặt trước/huỷ cuộc hẹn. |
prepaymentType |
Liệu thanh toán trước là bắt buộc, tuỳ chọn hay không được hỗ trợ. |
prepaymentTerms |
Các điều khoản xung quanh thời điểm hoàn tất thanh toán trước. |
form[] |
Không dùng nữa. Vui lòng sử dụng intakeForm và perticketIntakeForm. |
intakeForm |
Biểu mẫu yêu cầu người dùng cung cấp thêm thông tin khi họ đặt trước dịch vụ này. (không bắt buộc) |
perTicketIntakeForm |
Biểu mẫu yêu cầu người dùng cung cấp thêm thông tin khi họ đặt trước dịch vụ này. Người dùng phải điền vào biểu mẫu này một lần cho mỗi vé mà họ đặt. (không bắt buộc) |
taxRate |
Thuế suất của dịch vụ. Nếu có trường này, thì trường này sẽ thay thế mọi thuế suất được đặt ở cấp người bán. Nếu bạn nhận được thông báo trống (tức là taxRate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
paymentOptionId[] |
Danh sách mã nhận dạng tham chiếu các cách thanh toán có thể dùng để thanh toán cho dịch vụ này. Các tuỳ chọn thanh toán thực tế được xác định ở cấp Người bán và cũng có thể được dùng chung giữa nhiều Người bán. |
deposit |
Xác định cách tính một khoản tiền đặt cọc cho người dùng. Ghi đè khoản phí dịch vụ nếu bạn đã chỉ định khoản phí này. Nếu bạn đặt tùy chọn này thành thông báo Khoản tiền gửi trống, thì mọi khoản tiền gửi cấp dịch vụ sẽ bị xóa. (không bắt buộc) |
noShowFee |
Loại này xác định phí vắng mặt có thể được tính cho người dùng. Ghi đè phí dịch vụ không xuất hiện nếu bạn đã chỉ định phí xuất hiện. Nếu bạn đặt thông báo này thành thông báo NoShowFee trống, thì mọi khoản phí không tham gia ở cấp dịch vụ sẽ bị xoá. (không bắt buộc) |
requireCreditCard |
Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt dịch vụ này hay không. Bạn có thể ghi đè trường này ở cấp độ khả dụng. (không bắt buộc) |
actionLink[] |
Một đường liên kết hành động liên quan đến dịch vụ này. Nếu có đường liên kết hành động, thì bạn phải đặt loại (xem bên dưới) trong Dịch vụ. |
type |
Loại được xác định trước của dịch vụ này. (không bắt buộc) |
ticketType[] |
Các loại vé có thể đặt/mua cho dịch vụ này, nếu vé được hỗ trợ. (không bắt buộc) |
relatedMedia[] |
Ảnh liên quan đến dịch vụ này. Google sẽ thu thập dữ liệu và lưu trữ nội dung nghe nhìn để đảm bảo người dùng cuối thấy những nội dung đó theo cách hiệu quả nhất. (không bắt buộc) |
serviceAttributeValueId[] |
Các giá trị thuộc tính dịch vụ áp dụng cho dịch vụ này (không bắt buộc). Mỗi Dịch vụ có thể không có hoặc có nhiều giá trị cho mỗi thuộc tính dịch vụ được xác định trong Người bán tương ứng. (không bắt buộc) |
waitlistRules |
Quy tắc tham gia danh sách chờ. |
ticketingVerticalSpecificData |
Thông tin bổ sung dành riêng cho ngành dọc bán vé sự kiện. (không bắt buộc) |
integrationType |
Chiều sâu tích hợp mà chúng tôi hỗ trợ cho dịch vụ này. (không bắt buộc) Không liên quan đến những đối tác sử dụng chức năng tích hợp ban đầu. Tính năng này sẽ luôn tắt từ đầu đến cuối đối với những đối tác này. |
perOrderFee |
Phí ở cấp đơn đặt hàng để mua dịch vụ này. (không bắt buộc) |
toursAndActivitiesContent |
Các trường nội dung dành riêng cho Chuyến tham quan và Hoạt động. |
location[] |
Các vị trí liên quan đến dịch vụ này. LƯU Ý QUAN TRỌNG: Nếu có nhiều vị trí được ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION, thì bạn phải chỉ địnhSTART_LOCATION. Ví dụ: – Một chuyến tham quan bằng xe đạp có hướng dẫn viên đến thăm ba địa điểm, bạn cần chỉ định địa điểm bắt đầu. – Một chuyến tham quan bằng xe buýt tại sảnh của khách sạn, sau đó đi đến địa điểm khách tham quan. Bạn cần chỉ định địa điểm họp. |
rating |
Điểm xếp hạng của người dùng đối với dịch vụ này dưới dạng một chỉ số tổng hợp trên tất cả các bài đánh giá. |
homeServiceData |
Thông tin bổ sung dành riêng cho ngành dọc dịch vụ gia đình. (không bắt buộc) |
virtualSession |
Không bắt buộc. Thông tin về phiên ảo. Cần có để bật các dịch vụ ảo. |
directMerchantPayment |
Không bắt buộc. Thông tin bổ sung cần được bổ sung nếu dịch vụ yêu cầu người dùng thanh toán trực tiếp cho người bán. LƯU Ý QUAN TRỌNG: RwG sẽ không tham gia vào giao dịch này. Đây là yêu cầu bắt buộc nếu VirtualSession được xác định và dịch vụ không miễn phí hoặcforegroundType KHÔNG được đặt thành REQUIRED. |
PriceInterpretation
Mô tả cách diễn giải và hiển thị Giá cho người dùng.
Enum | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
Chưa xác định phần diễn giải giá, mặc định là EXACT_AMOUNT. |
EXACT_AMOUNT |
Khi giá cả được hiểu là một giá trị cụ thể. Ví dụ: $20 cho một lớp học yoga; $15 cho một kiểu cắt tóc trẻ em |
STARTS_AT |
Khi giá của một dịch vụ có thể thay đổi nhưng giá tối thiểu được xác định và hiển thị cho người tiêu dùng. Người tiêu dùng có thể đưa ra lựa chọn làm tăng giá sản phẩm. Xin lưu ý rằng mọi dịch vụ sử dụng Thông tin diễn giải giá này đều phải sử dụng tính năng PrepaymentType NOT_ trùng. Ví dụ: 30 USD cho dịch vụ chải lông cho chó nhưng các lựa chọn khác của người tiêu dùng có thể tăng giá |
NOT_DISPLAYED |
Khi giá của một dịch vụ thay đổi và không có thông tin nào về giá được hiển thị trước cho người tiêu dùng. Xin lưu ý rằng bất kỳ dịch vụ nào sử dụng Thông tin diễn giải giá này đều phải sử dụng loại thanh toán trước NOT_PLURAL và Giá phải để trống. Ví dụ: Tư vấn về dịch vụ gia đình |
SchedulingRules
Quy tắc lên lịch cho một dịch vụ.
Biểu diễn dưới dạng JSON |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
Các trường | |
---|---|
minAdvanceOnlineCanceling |
Thời gian thông báo trước tối thiểu tính bằng giây phải có để huỷ cuộc hẹn đã đặt trước qua mạng. (không bắt buộc) |
lateCancellationFee |
Phí huỷ trong khoảng thời gian thông báo trước tối thiểu. |
noshowFee |
Phí không đến mà không huỷ. |
admissionPolicy |
Chính sách vào cửa áp dụng cho dịch vụ này. Nếu bạn không đặt chính sách này, thì chế độ mặc định sẽ là TIME_STRICT. (không bắt buộc) |
cancellationPolicy |
Chính sách huỷ quy tắc lập lịch. (bắt buộc đối với Điểm tham quan) |
Trường nhóm Nếu bạn đặt "min_advance_booking", thì thời gian có thể đặt trước gần đây nhất sẽ được tính là (<slot start time> – "min_advance_booking"). Nếu bạn đặt "min_booking_buffer_before_end_time", thì thời gian có thể đặt trước gần đây nhất sẽ được tính là (<slot end time> – "min_booking_buffer_before_end_time"). Xin lưu ý rằng nếu đặt giá trị này thì giá trị "min_booking_buffer_before_end_time" phải là số dương. Nếu bạn không đặt cả hai khung giờ, thì khung giờ có thể được đặt trước cho đến thời điểm bắt đầu khung giờ. Nếu bạn đặt cả hai trường, thì chỉ một giá trị được chọn trong khi giá trị còn lại bị bỏ qua – chúng tôi không thể dự đoán một cách chính xác giá trị nào được chọn. Ví dụ:
|
|
minAdvanceBooking |
Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất cho đến khi khung giờ còn phòng trống bắt đầu. |
minBookingBufferBeforeEndTime |
Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất đến khi thời gian còn phòng kết thúc. Nếu đặt trường này, thì bạn phải đặt trường "admissionPolicy" thành TIME_FLEXIBLE để cho biết rằng người dùng có thể sử dụng vé đã mua sau khi khung giờ bắt đầu. |
AdmissionPolicy
Chính sách nhập học của dịch vụ này.
Enum | |
---|---|
ADMISSION_POLICY_UNSPECIFIED |
Không sử dụng. |
TIME_STRICT |
Khách hàng phải có mặt vào thời điểm bắt đầu của khung thời gian phát sóng và dịch vụ dự kiến sẽ kết thúc vào thời gian kết thúc của khung giờ này. Ví dụ về các trường hợp sử dụng TIME_STRICT: * Chuyến tham quan bắt đầu lúc 9 giờ sáng yêu cầu tất cả người tham dự đều đến thời điểm bắt đầu và quay trở lại vào khoảng 12 giờ đêm. * Lịch cắt tóc lúc 3 giờ chiều thứ Bảy sẽ mất khoảng 30 phút. * Lớp thể dục từ 6 giờ tối đến 8 giờ tối. |
TIME_FLEXIBLE |
Khách hàng có thể đến bất cứ lúc nào trong khoảng thời gian từ thời điểm bắt đầu đến kết thúc của khung thời gian còn phòng để sử dụng yêu cầu đặt chỗ này. Ví dụ về các trường hợp sử dụng có thể sử dụng với hàm TIME_FLEXIBLE: * Có thể sử dụng vé tham quan bảo tàng bất cứ lúc nào vào ngày mua. * Vé vào cửa công viên giải trí buổi chiều, có thể sử dụng từ 12:00 đến 21:00. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
Khách hàng cần phải đến người bán vào thời điểm bắt đầu khung tình trạng còn hàng nhưng có thể rời khỏi danh sách bất cứ lúc nào họ muốn. Ví dụ: trong tình huống vé vào cửa bảo tàng, vé vào cổng có giới hạn thời gian là 10 giờ sáng yêu cầu người dùng phải có mặt tại bảo tàng từ 10 giờ sáng. Thời gian bắt đầu của khung giờ phát sóng cho dịch vụ này là thời gian bắt đầu được chỉ định. Tuy nhiên, thời gian kết thúc chỉ được dùng làm chìa khoá để xác định khung giờ còn trống để đặt trước. |
CancellationPolicy
Chính sách huỷ một dịch vụ.
Biểu diễn dưới dạng JSON |
---|
{
"refundCondition": [
{
object ( |
Các trường | |
---|---|
refundCondition[] |
Không có hoặc có nhiều điều kiện hoàn tiền áp dụng cho chính sách này. |
RefundCondition
Xác định một điều kiện hoàn tiền duy nhất. Nhiều điều kiện hoàn tiền có thể được sử dụng cùng nhau để mô tả "các bước hoàn tiền" dưới dạng các khoảng thời gian khác nhau trước thời gian bắt đầu dịch vụ.
Biểu diễn dưới dạng JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
Các trường | |
---|---|
minDurationBeforeStartTime |
Khoảng thời gian trước thời gian bắt đầu cho đến thời điểm khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí của dịch vụ được chỉ định trong Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
refundPercent |
Tỷ lệ phần trăm có thể được hoàn tiền, miễn là yêu cầu đặt dịch vụ bị huỷ ít nhất |
PrepaymentType
Enum để cho biết loại hình trả trước.
Enum | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Theo mặc định, chúng tôi sẽ giả định rằng khoản thanh toán trước là NOT_IMAP. |
REQUIRED |
Người dùng phải thanh toán cho dịch vụ này tại thời điểm đặt trước. |
OPTIONAL |
Người dùng có thể chọn trả trước dịch vụ này tại thời điểm đặt trước hoặc sau, nhưng không bắt buộc để đặt trước. |
NOT_SUPPORTED |
Việc thanh toán trước không được hỗ trợ cho dịch vụ này. |
PrepaymentTerms
Thông tin cụ thể về thời điểm hoàn tất khoản trả trước.
Biểu diễn dưới dạng JSON |
---|
{
"chargeTiming": enum ( |
Các trường | |
---|---|
chargeTiming |
Thời điểm tính phí tương ứng với thời gian mua hàng. |
chargeTimeBeforeStartTimeSec |
Thời gian tính bằng giây trước khi bắt đầu dịch vụ mà người dùng bị tính phí thanh toán. Bạn chỉ nên đặt trường này khi Thời gian sạc là CHARGE_LATER. |
ChargeTiming
Enum để chỉ định thời điểm sẽ tính phí so với thời gian mua.
Enum | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
Không sử dụng. |
CHARGE_NOW |
Khách hàng sẽ bị tính phí ngay lập tức. |
CHARGE_LATER |
Khách hàng sẽ bị tính phí sau. |
ServiceIntakeForm
Xác định biểu mẫu nhập thông tin tuỳ chỉnh dịch vụ do người bán cung cấp.
Biểu diễn dưới dạng JSON |
---|
{
"field": [
{
object ( |
Các trường | |
---|---|
field[] |
Các trường mà người dùng sẽ thấy. |
firstTimeCustomers |
Nếu đúng, biểu mẫu này sẽ hiển thị cho những khách hàng lần đầu tiên. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu nhập thông tin. |
returningCustomers |
Nếu đúng, biểu mẫu này sẽ hiển thị cho những khách hàng mua nhiều lần. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu nhập thông tin. |
ServiceIntakeFormField
Xác định một trường có trong ServiceIntakeForm.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "type": enum ( |
Các trường | |
---|---|
id |
Một chuỗi từ đối tác tổng hợp xác định duy nhất một trường trên biểu mẫu. Mã này phải giống với mã trong câu trả lời của trường biểu mẫu tương ứng và phải là duy nhất trên cả cấp dịch vụ lẫn biểu mẫu nhập phiếu yêu cầu hỗ trợ. (bắt buộc) |
type |
Loại trường này. |
label |
Văn bản mà người dùng nhìn thấy trong trường này. Không dùng nữa, vui lòng sử dụng |
localizedLabel |
Văn bản mà người dùng nhìn thấy trong trường này. Trường có thể được cung cấp bằng nhiều ngôn ngữ. (bắt buộc) |
value[] |
Chỉ đặt khi loại trường là LOCATION_SEARCH. Vui lòng sử dụng "locationId" trong trường "location" để chỉ định giá trị vị trí. |
choiceText[] |
Chỉ thiết lập khi loại trường là MULTIPLE_CHOICE, bắnBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể có. |
isRequired |
Cho biết liệu người dùng có bắt buộc phải trả lời trường này hay không. |
allowCustomAnswer |
Cho biết liệu giá trị tuỳ chỉnh có được cho phép trong các câu trả lời bổ sung được xác định trước hay không. Điều này chỉ áp dụng khi loại trường là LOCATION_SEARCH. (không bắt buộc) |
additionalOption[] |
Các tuỳ chọn khác được cung cấp ngoài các giá trị đã cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: Ngoài danh sách vị trí được cung cấp, bạn có thể sử dụng một lựa chọn khác là "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc) |
ticketTypeRestrict[] |
Nếu câu hỏi này chỉ hiển thị khi người dùng đặt một số loại vé nhất định, thì bạn phải đặt trường này làm tập hợp các mã loại vé thích hợp. Hãy để trống trường này nếu câu hỏi này luôn phù hợp. |
hint |
Văn bản gợi ý để nhập, xuất hiện dưới dạng một phần giữ chỗ văn bản. Điều này chỉ áp dụng khi loại trường là SHORT_ANSWER hoặc PARAGRAPH. (không bắt buộc) |
FieldType
Enum để cho biết loại trường.
Enum | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Các trường không xác định hoặc không xác định sẽ bị bỏ qua. |
SHORT_ANSWER |
Trường nhập một dòng cho văn bản. |
PARAGRAPH |
Trường nhập nhiều dòng cho văn bản. |
MULTIPLE_CHOICE |
Một tập hợp các nút chọn yêu cầu một lựa chọn từ nhiều tuỳ chọn. |
CHECKBOXES |
Một hoặc nhiều mục được liệt kê có hộp đánh dấu. |
DROPDOWN |
Một lựa chọn trong trình đơn thả xuống. |
BOOLEAN |
Nút có/không. |
LOCATION_SEARCH |
Hộp tìm kiếm hỗ trợ tìm vị trí phù hợp do người dùng nhập từ danh sách vị trí được cung cấp. |
ServiceType
Loại dịch vụ được xác định trước.
Enum | |
---|---|
SERVICE_TYPE_UNSPECIFIED |
Không sử dụng. |
SERVICE_TYPE_DINING_RESERVATION |
Đã đặt chỗ ăn uống. |
SERVICE_TYPE_FOOD_ORDERING |
Đặt đồ ăn có thể là giao đồ ăn hoặc đồ ăn mang đi hoặc cả hai. |
SERVICE_TYPE_FOOD_DELIVERY |
Giao đồ ăn. |
SERVICE_TYPE_FOOD_TAKEOUT |
Đồ ăn mang đi. |
SERVICE_TYPE_EVENT_TICKET |
Vé xem sự kiện. |
SERVICE_TYPE_TRIP_TOUR |
Chuyến tham quan. |
SERVICE_TYPE_APPOINTMENT |
Dịch vụ cung cấp cuộc hẹn hoặc lớp học. Nên dùng cho (1) dịch vụ sức khoẻ và thể dục, (2) spa và làm đẹp, (3) dịch vụ tư vấn và đánh giá tài chính. Vui lòng xem các loại dịch vụ được hỗ trợ: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Dịch vụ cung cấp lịch hẹn trực tuyến cho một lớp học hoặc phiên họp hoàn toàn qua mạng. Bạn phải đặt nếu bật tính năng đặt trước dịch vụ ảo. |
SERVICE_TYPE_SHOPPING |
Dịch vụ cho phép người dùng mua sắm từ người bán cụ thể. Đó có thể là dịch vụ giao hàng hoặc đến lấy hàng. |
TicketType
TicketType được dùng để phân biệt các vé có giá và/hoặc tình trạng còn hàng khác nhau do loại người dùng khác nhau, các thuộc tính dịch vụ khác nhau hoặc các lựa chọn/tiện ích bổ sung khác nhau.
Vé là đơn vị tối thiểu có thể đặt trước cho một dịch vụ, ví dụ: điểm trong chuyến đi bè, vé vào bảo tàng, dịch vụ cho thuê thuyền kayak cả ngày.
Biểu diễn dưới dạng JSON |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
Các trường | |
---|---|
ticketTypeId |
Mã phiếu yêu cầu hỗ trợ được dùng để phân biệt các loại vé khác nhau của cùng một dịch vụ và chỉ là mã duy nhất trong một dịch vụ. |
shortDescription |
Nội dung mô tả ngắn về TicketType này. Thông tin này có thể hiển thị cho người dùng, ví dụ: "người lớn", "trẻ em", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Ngừng sử dụng, chuyển sang sử dụng localeShortDescription. |
localizedShortDescription |
Nội dung mô tả ngắn về TicketType này có hỗ trợ i18n. Thông tin này có thể hiển thị cho người dùng, ví dụ: "người lớn", "trẻ em", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ. |
price |
Giá của một vé thuộc loại này, không bao gồm bất kỳ khoản thuế nào. Thuế suất của Dịch vụ được áp dụng cho vé của dịch vụ đó. |
perTicketFee |
Các khoản phí bổ sung khi mua vé này. (không bắt buộc) |
optionDescription |
Nội dung mô tả về mọi lựa chọn bổ sung thuộc loại vé này, nếu có. Không dùng nữa, hãy sử dụng localOptionDescription. |
localizedOptionDescription |
Nội dung mô tả về mọi lựa chọn bổ sung thuộc loại vé này, nếu có. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ. Các lựa chọn bổ sung sẽ hữu ích khi loại phiếu yêu cầu hỗ trợ đại diện cho nhiều phương diện. Ví dụ 1: "Option_vét Ví dụ 2: {Option_Option_ Không bắt buộc, nhưng nếu bất kỳ loại vé nào trong dịch vụ có trường này được đặt, thì chúng tôi dự kiến tất cả các loại vé khác cũng sẽ đặt trường này (có thể sử dụng optionsDescription mặc định). Ví dụ: [{ticket_type_1, child, english}, {ticket_type_1, người lớn, ''}] không phải là danh sách hợp lệ. Chỉ hỗ trợ hai thẻ định dạng HTML: và |
PerTicketFee
Phí phải trả cho mỗi vé mà người dùng mua.
Biểu diễn dưới dạng JSON |
---|
{ "serviceCharge": { object ( |
Các trường | |
---|---|
serviceCharge |
Thu phí bổ sung cho một dịch vụ. |
facilityFee |
Một khoản phí đi đến địa điểm/cơ sở y tế. |
taxes |
Thuế mỗi vé. |
RelatedMedia
Ảnh liên quan đến dịch vụ này. Google sẽ thu thập dữ liệu các nội dung đa phương tiện này để đảm bảo chúng hiển thị chính xác cho người dùng cuối. (không bắt buộc)
Biểu diễn dưới dạng JSON |
---|
{ "url": string, "type": enum ( |
Các trường | |
---|---|
url |
URL của nguồn nội dung nghe nhìn này. Google sẽ thu thập dữ liệu nội dung nghe nhìn được lưu trữ tại URL này. |
type |
Loại nguồn nội dung nghe nhìn này. |
localizedCaption |
Phụ đề của nội dung nghe nhìn hỗ trợ i18n, chỉ hỗ trợ văn bản thuần tuý. Mọi thành phần HTML sẽ bị xoá. (không bắt buộc) |
attribution |
Thông tin ghi nhận tác giả về nguồn nội dung nghe nhìn. Xin lưu ý rằng nếu thuộc tính bắt buộc phải hiển thị cùng với nội dung nghe nhìn để ghi nhận tác giả cho nhiếp ảnh gia hoặc công ty quảng cáo, thì bạn phải đặt trường này. (không bắt buộc) |
caption |
Không dùng nữa, hãy sử dụng bản địa hoá Caption. |
MediaType
Enum để cho biết loại nguồn nội dung nghe nhìn này. Chỉ hỗ trợ ảnh. Vui lòng liên hệ với nhóm Đặt chỗ với Google nếu bạn cần hỗ trợ các nội dung nghe nhìn khác ngoài ảnh.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Không sử dụng. |
PHOTO |
Cho biết nội dung nghe nhìn do URL cung cấp là ảnh. |
Phân bổ
Thông tin thuộc tính cho nội dung nghe nhìn này.
Biểu diễn dưới dạng JSON |
---|
{
"localizedText": {
object ( |
Các trường | |
---|---|
localizedText |
Văn bản để ghi nhận tác giả cho nhiếp ảnh gia hoặc đại lý hỗ trợ i18n. Văn bản này sẽ được hiển thị cùng với phương tiện nguồn. Xin lưu ý rằng trường này chỉ hỗ trợ văn bản thuần tuý và mọi thành phần HTML sẽ bị xoá (không hỗ trợ thuộc tính dựa trên siêu liên kết). |
text |
Không dùng nữa, hãy ưu tiên sử dụng localText. |
ServiceAttributeValueId
Xác định một giá trị cụ thể của thuộc tính dịch vụ sẽ được áp dụng cho một Dịch vụ.
Biểu diễn dưới dạng JSON |
---|
{ "attributeId": string, "valueId": string } |
Các trường | |
---|---|
attributeId |
Mã nhận dạng của một thuộc tính theo quy định trong phần Merchant.service_attribute, ví dụ: "service-type". |
valueId |
Mã của giá trị cho thuộc tính này, ví dụ: "cắt tóc". Phải khớp với một valueId trong định nghĩa thuộc tính dịch vụ. |
WaitlistRules
Quy tắc liên quan đến việc tham gia danh sách chờ.
Biểu diễn dưới dạng JSON |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
Các trường | |
---|---|
minPartySize |
Bắt buộc. Phải là số nguyên dương đối với các dịch vụ cung cấp chức năng danh sách chờ. Nếu dịch vụ hoặc người bán không cung cấp chức năng danh sách chờ thì không được điền thông tin này. |
maxPartySize |
Bắt buộc. Phải là số nguyên dương đối với các dịch vụ cung cấp chức năng danh sách chờ. Nếu dịch vụ hoặc người bán không cung cấp chức năng danh sách chờ thì không được điền thông tin này. |
supportsAdditionalRequest |
Nếu đúng, người dùng sẽ có thể gửi yêu cầu dạng văn bản bổ sung tuỳ ý khi tham gia danh sách chờ sử dụng dịch vụ này. |
aboveMaxPartySizeOptions[] |
Đặt tuỳ chọn cho các nhóm lớn hơn đặt maxPartySize. Hãy để trống nếu không cung cấp các lựa chọn thay thế cho việc tham gia danh sách chờ nếu các bên lớn hơn. |
UnsupportedPartySizeOption
Tuỳ chọn cho các nhóm nằm ngoài phạm vi.
Biểu diễn dưới dạng JSON |
---|
{
"callMerchant": {
object ( |
Các trường | |
---|---|
callMerchant |
Quy mô bữa tiệc nằm ngoài phạm vi của bữa tiệc có thể gọi cho doanh nghiệp. Một thông báo xác định trước sẽ hiển thị cho người dùng. Văn bản mẫu sẽ hiển thị: "Đối với các bữa tiệc có nhiều hơn {waitlistRules.max_party_size}, vui lòng gọi cho nhà hàng theo số {phone}." Bạn phải đặt CallMerchant nhưng giá trị này sẽ trống. |
CallMerchant
Thông báo trống sẽ được sử dụng trong supportedPartySizeOption. Khi bạn đặt thuộc tính này, người dùng sẽ thấy một lựa chọn để gọi cho doanh nghiệp để đặt trước.
TicketingVerticalSpecificData
Thông tin bổ sung dành riêng cho ngành dọc bán vé sự kiện.
Biểu diễn dưới dạng JSON |
---|
{ "eventCategory": enum ( |
Các trường | |
---|---|
eventCategory |
Danh mục của sự kiện. Chỉ thiết lập khi sự kiện thuộc một trong các danh mục được xác định trước. (không bắt buộc) |
eventUrl |
URL của sự kiện trên trang web của đối tác. (không bắt buộc) |
entity[] |
Danh sách các thực thể có liên quan đến sự kiện. (không bắt buộc) |
eventAttendanceMode |
Bắt buộc. Loại sự kiện tham dự sự kiện. |
eventVirtualLocationUrl[] |
Không bắt buộc. URL nơi có thể xem sự kiện. |
eventOrganizer |
Không bắt buộc. Người tổ chức sự kiện. |
eventOrganizerUrl |
Không bắt buộc. URL của người tổ chức sự kiện. |
eventOrganizerType |
Không bắt buộc. Loại người tổ chức. |
eventSourceUrl[] |
Bắt buộc. URL của các trang nơi có thông tin hoặc nội dung mô tả về sự kiện. |
eventState |
Không bắt buộc. Trạng thái của sự kiện. |
EventCategory
Một nhóm danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm sản phẩm. Lưu ý: không phải là một bản thể học phổ biến của sự kiện.
Enum | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
Chưa xác định. Không được dùng. |
EVENT_CATEGORY_CONCERT |
Chương trình âm nhạc. |
EVENT_CATEGORY_SPORTS |
Sự kiện thể thao. |
EVENT_CATEGORY_THEATRE |
Sự kiện tại nhà hát. |
EVENT_CATEGORY_EXHIBITS |
Triển lãm. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Hội thảo và lớp học. |
Thực thể
Đại diện cho một thực thể có liên quan đến sự kiện đó.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
Các trường | |
---|---|
id |
Giá trị nhận dạng duy nhất của thực thể trong cơ sở dữ liệu của đối tác. (không bắt buộc) |
name |
Tên thực thể. (bắt buộc) |
url |
URL của trang web mô tả rõ ràng thực thể. Đây là trang trên trang web của đối tác dành cho thực thể (nếu có). Đối với các URL công khai khác của thực thể, hãy sử dụng relevantUrl trong publicIdentificationData. (không bắt buộc) |
entityType |
Loại thực thể. (không bắt buộc) |
entityRole |
Vai trò của thực thể trong sự kiện. (không bắt buộc) |
publicIdentificationData |
Nguồn tham khảo công khai của thực thể. (không bắt buộc) |
EntityType
Loại thực thể. Lưu ý: không phải là một bản thể học phổ biến.
Enum | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
Chưa xác định. Không được dùng. |
ENTITY_TYPE_PERFORMER |
Thực thể này đại diện cho nghệ sĩ hoặc nhóm biểu diễn tại buổi hoà nhạc hoặc chương trình. Chỉ áp dụng khi danh mục sự kiện là CONCERT hoặc THEATRE. |
ENTITY_TYPE_PLAYER |
Thực thể này đại diện cho đội thể thao hoặc vận động viên tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO. |
ENTITY_TYPE_CONCERT_TOUR |
Thực thể này đại diện cho chuyến tham quan chứa sự kiện này. Chỉ áp dụng khi danh mục sự kiện là CONCERT. |
ENTITY_TYPE_SPORTS_SERIES |
Thực thể này đại diện cho một giải đấu thể thao chứa sự kiện này. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO. |
ENTITY_TYPE_PLAY |
Thực thể đại diện cho loại kịch (ví dụ: nhạc kịch, hài kịch, ba lê, v.v.) được biểu diễn tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THEATRE. |
EntityRole
Vai trò của thực thể trong sự kiện.
Enum | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
Chưa xác định. |
ENTITY_ROLE_HEADLINER |
Thực thể này đại diện cho một người tiêu đề hoặc người biểu diễn hàng đầu tại sự kiện. |
ENTITY_ROLE_SUPPORTER |
Thực thể này đại diện cho người biểu diễn hỗ trợ tại sự kiện. |
ENTITY_ROLE_HOME_TEAM |
Pháp nhân này đại diện cho đội chủ nhà tại sự kiện (thể thao). |
ENTITY_ROLE_AWAY_TEAM |
Pháp nhân này đại diện cho đội khách tại sự kiện (thể thao). |
PublicIdentificationData
Giá trị nhận dạng, trang web hoặc các nguồn công khai khác đề cập đến một thực thể.
Biểu diễn dưới dạng JSON |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
Các trường | |
---|---|
relevantUrl[] |
URL công khai của mọi trang web chỉ dành riêng cho một chủ đề. Những nội dung này có thể bao gồm các trang web chính thức, sàn nhảy, nền tảng mạng xã hội, các trang wikipedia hoặc imdb (ví dụ: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (không bắt buộc) |
musicbrainzId |
Giá trị nhận dạng musicbrainz gồm 36 ký tự của nghệ sĩ hoặc các pháp nhân âm nhạc khác, nếu có. Xem https://musicbrainz.org/doc/MusicBrainz_Identifier. (không bắt buộc) |
AttendanceMode
Loại sự kiện tham dự sự kiện.
Enum | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
Chưa xác định. |
ONLINE |
Đối với sự kiện trực tuyến. |
PHYSICAL |
Đối với sự kiện vật lý. |
PHYSICAL_ONLINE_MIXED |
Dành cho các sự kiện diễn ra cả thực tế và trực tuyến. |
OrganizerType
Loại người tổ chức.
Enum | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Chưa xác định. |
PERSON |
Đối với người tổ chức là một người. |
ORGANIZATION |
Đối với người tổ chức là một tổ chức. |
EventState
Trạng thái của sự kiện.
Enum | |
---|---|
EVENT_STATE_UNSPECIFIED |
Chưa xác định. |
SCHEDULED |
Sự kiện đã được lên lịch. |
RESCHEDULED |
Sự kiện này đã được lên lịch lại. |
CANCELLED |
Sự kiện đã bị huỷ. |
POSTPONED |
Sự kiện đã bị hoãn. |
IntegrationType
Hỗ trợ độ sâu tích hợp.
Enum | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
Giá trị mặc định là END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
Hoàn tất việc tích hợp để giúp khách hàng đặt phòng trọn vẹn thông qua Google. |
INTEGRATION_TYPE_INVENTORY_ONLY |
Máy chủ đặt phòng không cần hỗ trợ dịch vụ này. Bạn chỉ cần gửi dữ liệu về người bán, dịch vụ và tình trạng còn hàng (không bắt buộc). |
PerOrderFee
Các khoản phí phải thanh toán một lần cho mỗi đơn đặt hàng, bất kể số lượng vé.
Biểu diễn dưới dạng JSON |
---|
{ "deliveryFee": { object ( |
Các trường | |
---|---|
deliveryFee |
Phí có thể thay đổi tùy theo phương thức phân phối. |
processingFee |
Phí xử lý phương thức thanh toán của người dùng. |
ToursAndActivitiesContent
Các trường nội dung dành riêng cho Chuyến tham quan và Hoạt động. Mỗi phần tử trong trường lặp lại phải độc lập để cho phép hiển thị riêng biệt (ví dụ: dưới dạng dấu đầu dòng).
Bạn nên điền sẵn TourAndActivitiesContent cho các chuyến tham quan và hoạt động, nhưng không bắt buộc. Tất cả các trường đều hỗ trợ cả văn bản thuần tuý và văn bản giống HTML để định dạng cơ bản. Các thẻ định dạng giống HTML được hỗ trợ:
Thẻ cụm từ:
, , , : Chỉ hỗ trợ 3 thẻ nêu trên. Bạn có thể dùng
để ngắt dòng trong đoạn văn và dùng // để đánh dấu một văn bản quan trọng. Mọi thẻ cụm từ khác sẽ bị bỏ qua.
Tất cả các thẻ và kiểu tuỳ chỉnh khác không được phép và sẽ bị xoá. Mọi URL, mục liên kết và đường liên kết sẽ bị xoá và sẽ không bao giờ hiển thị với người dùng cuối.
Lưu ý quan trọng: * Đừng sao chép dữ liệu đã được cung cấp trong highlights
, exclusion
và các trường khác cụ thể hơn trong phần mô tả dịch vụ. * Tránh sử dụng các thẻ khác ngoại trừ những thẻ được hỗ trợ nêu trên, vì nội dung trong các thẻ không được hỗ trợ sẽ bị loại bỏ và có thể gây ra trải nghiệm không mong muốn cho người dùng.
Biểu diễn dưới dạng JSON |
---|
{ "highlights": [ { object ( |
Các trường | |
---|---|
highlights[] |
Danh sách các điểm nổi bật mà người dùng thấy được. |
inclusions[] |
Danh sách trang cần bao gồm mà người dùng thấy. |
exclusions[] |
Danh sách các tiêu chí loại trừ mà người dùng có thể thấy. |
mustKnow[] |
Danh sách mà người dùng thấy được gồm các lưu ý quan trọng, hãy dùng để biết thông tin chi tiết như giới hạn độ tuổi hoặc các điều kiện khác khiến dịch vụ này không phù hợp. |
Vị trí
Thông tin địa lý về một vị trí.
Biểu diễn dưới dạng JSON |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
Các trường | |
---|---|
placeId |
Mã địa điểm cho một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Truy cập vào https://developers.google.com/places/web-service/place-id để biết thêm thông tin về Mã địa điểm. Nếu cung cấp thông tin này, Google sẽ so khớp vị trí với địa điểm này. |
name |
Tên, số điện thoại, url và địa lý của vị trí được sử dụng để hỗ trợ việc so khớp vị trí với những địa điểm đã xuất hiện trên Google Maps. Trường này là không bắt buộc nhưng có thể bắt buộc trong một số ngữ cảnh. Ví dụ: Service.location không có tên sẽ không khớp với pháp nhân doanh nghiệp, ngay cả khi chúng ở cùng một địa chỉ. (không bắt buộc) |
telephone |
Số điện thoại công cộng của vị trí, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234. (không bắt buộc) |
url |
URL của trang web công khai của vị trí. (không bắt buộc) |
geo |
Thông tin địa lý của vị trí, bao gồm cả vĩ độ, kinh độ và địa chỉ. (không bắt buộc) |
locationType |
Bạn phải cung cấp loại vị trí nếu vị trí này được cung cấp cho một Dịch vụ. |
locationId |
Tham chiếu duy nhất về vị trí trong dịch vụ. Mã này có thể dùng để tham chiếu đến vị trí này trong các trường dịch vụ khác. Ví dụ: trong biểu mẫu nhập thông tin tuỳ chỉnh, bạn có thể sử dụng một nhóm mã vị trí để chỉ định các lựa chọn về vị trí đến lấy hàng. Nếu được đặt, mã nhận dạng này phải là duy nhất trong cùng một dịch vụ. (không bắt buộc) |
LocationType
Loại vị trí này.
Enum | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
Chưa xác định loại vị trí. |
VISITED_LOCATION |
Địa điểm nơi dịch vụ này đến. |
START_LOCATION |
Địa điểm mà dịch vụ này bắt đầu, cũng đóng vai trò là MEETING_LOCATION. |
END_LOCATION |
Vị trí mà dịch vụ này kết thúc. |
Rating
Xác định Xếp hạng cho một thực thể.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "numberOfRatings": string } |
Các trường | |
---|---|
value |
Giá trị xếp hạng trung bình (bắt buộc khi numberOfRating > 0). Giá trị phải nằm trong khoảng [1, 5] và có thể bỏ qua khi và chỉ khi numberOfRating bằng 0. |
numberOfRatings |
Số lượng điểm xếp hạng được dùng để tính giá trị (bắt buộc). |
HomeServiceData
Cần cung cấp thêm thông tin cho ngành dọc dịch vụ gia đình.
Biểu diễn dưới dạng JSON |
---|
{ "categoryType": string, "jobType": string } |
Các trường | |
---|---|
categoryType |
Danh mục cấp cao chứa dịch vụ gia đình này. Ví dụ: thợ sửa ống nước, thợ điện, v.v. |
jobType |
Loại công việc thuộc danh mục của dịch vụ gia đình cụ thể. Ví dụ: unclog_drain, install_faucet là các loại công việc thuộc danh mục thợ sửa ống nước. |
VirtualSession
Thông tin về phiên trực tuyến/trực tuyến. Ví dụ: Lớp học yoga trực tuyến, lớp học nấu ăn trực tuyến, v.v.
Biểu diễn dưới dạng JSON |
---|
{ "sessionInstructions": { object ( |
Các trường | |
---|---|
sessionInstructions |
Hướng dẫn về cách thiết lập lớp học ảo này. Nếu đối tác không cung cấp URL của video trong lượt đặt phòng thì đối tác phải có thông tin về thời điểm chia sẻ URL của video với người dùng. Ví dụ: "URL thu phóng sẽ được gửi qua thư 30 phút trước khi lớp học". (Nên dùng) |
sessionRequirements |
Các yêu cầu đối với phiên trực tuyến cụ thể. Ví dụ: thảm yoga, dụng cụ nấu ăn, v. v. (Nên dùng) |
virtualPlatformInfo |
Thông tin về nền tảng ảo được sử dụng trong phiên này. (Bắt buộc để bật dịch vụ ảo) |
isSessionPrerecorded |
Bắt buộc. Thiết lập là đúng nếu phiên ảo không diễn ra và đã được ghi hình sẵn. |
VirtualPlatformInfo
Thông tin về nền tảng sẽ được dùng cho phiên trực tuyến này.
Biểu diễn dưới dạng JSON |
---|
{ "platform": enum ( |
Các trường | |
---|---|
platform |
Nền tảng dùng cho phiên ảo. |
otherPlatformName |
Tên của nền tảng nếu nền tảng được đặt thành OTHER. (Bắt buộc nếu nền tảng được đặt thành OTHER) |
Nền tảng
Enum để cho biết người bán sẽ sử dụng nền tảng ảo nào.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Không sử dụng. |
FLEXIBLE |
Người bán có thể linh hoạt lựa chọn nền tảng video mà mình sử dụng. |
GOOGLE_HANGOUTS |
Sản phẩm Google Hangouts. |
GOOGLE_MEET |
Google Meet. |
ZOOM |
Truyền thông qua Zoom. |
SKYPE |
Super Chat và Super Stickers. |
YOUTUBE |
Phát trực tiếp trên YouTube. |
OTHER |
Bạn nên thiết lập thuộc tính này nếu nền tảng video được sử dụng khác với các nền tảng được đề cập ở đây. |
DirectMerchantPayment
Thông tin về cách người dùng có thể thanh toán trực tiếp cho người bán thay vì trả trước cho dịch vụ qua RwG.
Biểu diễn dưới dạng JSON |
---|
{
"paymentMethods": [
{
object ( |
Các trường | |
---|---|
paymentMethods[] |
Người dùng chỉ nên thanh toán qua các phương thức thanh toán được đề cập dưới đây. |
Phương thức |
|
---|---|
|
Tạo Service mới của một người bán do đơn vị tập hợp đã chỉ định quản lý, sau đó trả về tên này. |
|
Xoá Service của một người bán hiện có do đơn vị tập hợp được chỉ định quản lý. |
|
Cập nhật Service hiện tại của một người bán do đơn vị tập hợp đã chỉ định quản lý rồi trả lại trang này. |