Chỉ mục
BookingNotification
(giao diện)Feed
(giao diện)InvalidationService
(giao diện)InventoryStatus
(giao diện)InventoryUpdate
(giao diện)ActionLink
(thông báo)ActionLink.ActionLinkType
(enum)ActionPlatform
(enum)Advisement
(thông báo)Availability
(thông báo)Availability.ConfirmationMode
(enum)Availability.DurationRequirement
(enum)Availability.Recurrence
(thông báo)Availability.ScheduleException
(thông báo)Availability.SchedulingRuleOverrides
(thông báo)BatchDeleteGenericRecordsRequest
(thông báo)BatchPushGenericRecordRequest
(thông báo)BatchReplaceServiceAvailabilityRequest
(thông báo)BatchReplaceServiceAvailabilityResponse
(thông báo)Booking
(thông báo)BookingFailure
(thông báo)BookingFailure.Cause
(enum)BookingFailure.PaymentFailureInformation
(thông báo)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(thông báo)BookingStatus
(enum)CallMerchant
(thông báo)CancellationPolicy
(thông báo)CancellationPolicy.RefundCondition
(thông báo)ClientInformation
(thông báo)CreateMerchantRequest
(thông báo)CreateServiceRequest
(thông báo)CreditCardRestrictions
(thông báo)CreditCardRestrictions.CreditCardType
(enum)DeleteMerchantRequest
(thông báo)DeleteServiceRequest
(thông báo)Deposit
(thông báo)DirectMerchantPayment
(thông báo)DurationRange
(thông báo)ExtendedServiceAvailability
(thông báo)FeedStatistics
(thông báo)FeedStatus
(thông báo)FeedStatus.State
(enum)FoodOrderingMetadata
(thông báo)FoodOrderingMetadata.AdvanceOrderDetails
(thông báo)FoodOrderingMetadata.FeeDetails
(thông báo)FoodOrderingMetadata.FeeDetails.FeeAmount
(thông báo)FoodOrderingMetadata.FeeDetails.FeeType
(enum)FulfillmentOption
(thông báo)FulfillmentOption.AvailableDay
(thông báo)FulfillmentOption.FeeDetails
(thông báo)FulfillmentOption.FixedFee
(thông báo)FulfillmentOption.FulfillmentType
(enum)FulfillmentOption.MinimumFee
(thông báo)FulfillmentOption.NoFee
(thông báo)GenericDeleteRecord
(thông báo)GenericRecord
(thông báo)GeoCoordinates
(thông báo)GetMerchantStatusRequest
(thông báo)GetStatusRequest
(thông báo)HomeServiceData
(thông báo)IntegrationType
(enum)InvalidateResourceRequest
(thông báo)LineItem
(thông báo)LineItem.OrderedTickets
(thông báo)ListMerchantStatusesRequest
(thông báo)ListMerchantStatusesRequest.BookingInventoryStatus
(enum)ListMerchantStatusesRequest.GeoMatchingStatus
(enum)ListMerchantStatusesRequest.WaitlistInventoryStatus
(enum)ListMerchantStatusesResponse
(thông báo)ListStatusRequest
(thông báo)ListStatusResponse
(thông báo)LocalizedString
(thông báo)Location
(thông báo)LocationType
(enum)Merchant
(thông báo)MerchantMatchingHints
(thông báo)MerchantStatus
(thông báo)MerchantStatus.BookingStatus
(thông báo)MerchantStatus.DirectUrl
(thông báo)MerchantStatus.DirectUrl.UrlType
(enum)MerchantStatus.LocalServicesMatchInfo
(thông báo)MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(thông báo)MerchantStatus.PlaceInfo
(thông báo)MerchantStatus.ProcessingStatus
(enum)MerchantStatus.WaitlistStatus
(thông báo)MoneyRange
(thông báo)NoShowFee
(thông báo)Order
(thông báo)OrderOnlineMetadata
(thông báo)PaymentInformation
(thông báo)PaymentOption
(thông báo)PaymentOption.ActivationType
(enum)PaymentOption.PaymentOptionType
(enum)PaymentProcessorConfig
(thông báo)PaymentProcessorConfig.Processor
(enum)PaymentRestrictions
(thông báo)PerOrderFee
(thông báo)PerTicketFee
(thông báo)PostalAddress
(thông báo)PrepaymentStatus
(enum)Price
(thông báo)PriceInterpretation
(enum)PriceType
(enum)QuantitativeValue
(thông báo)QuantitativeValue.RangeValue
(thông báo)Rating
(thông báo)RelatedMedia
(thông báo)RelatedMedia.Attribution
(thông báo)RelatedMedia.MediaType
(enum)ReplaceServiceAvailabilityRequest
(thông báo)RequireCreditCard
(enum)Resources
(thông báo)SchedulingRules
(thông báo)SchedulingRules.AdmissionPolicy
(enum)Service
(thông báo)Service.PrepaymentTerms
(thông báo)Service.PrepaymentTerms.ChargeTiming
(enum)Service.PrepaymentType
(enum)Service.ServiceType
(enum)ServiceAttribute
(thông báo)ServiceAttribute.Value
(thông báo)ServiceAttributeValueId
(thông báo)ServiceAvailability
(thông báo)ServiceIntakeForm
(thông báo)ServiceIntakeFormField
(thông báo)ServiceIntakeFormField.FieldType
(enum)TaxRate
(thông báo)Terms
(thông báo)Text
(thông báo)TicketType
(thông báo)TicketingVerticalSpecificData
(thông báo)TicketingVerticalSpecificData.AttendanceMode
(enum)TicketingVerticalSpecificData.Entity
(thông báo)TicketingVerticalSpecificData.Entity.EntityRole
(enum)TicketingVerticalSpecificData.Entity.EntityType
(enum)TicketingVerticalSpecificData.EventCategory
(enum)TicketingVerticalSpecificData.EventState
(enum)TicketingVerticalSpecificData.OrganizerType
(enum)TicketingVerticalSpecificData.PublicIdentificationData
(thông báo)TimeRange
(thông báo)TokenizationConfig
(thông báo)TokenizationConfig.BillingInformationFormat
(enum)ToursAndActivitiesContent
(thông báo)UnsupportedPartySizeOption
(thông báo)UpdateBookingRequest
(thông báo)UpdateMerchantRequest
(thông báo)UpdateOrderRequest
(thông báo)UpdateServiceRequest
(thông báo)UserPurchaseRestriction
(thông báo)VirtualSession
(thông báo)VirtualSession.VirtualPlatformInfo
(thông báo)VirtualSession.VirtualPlatformInfo.Platform
(enum)WaitlistRules
(thông báo)
BookingNotification
Nhận thông báo về cuộc hẹn từ các đối tác lên lịch bên ngoài. Đối tác nên gọi UpdateBooking hoặc UpdateOrder tuỳ thuộc vào việc đối tác có triển khai RPC dựa trên yêu cầu đặt phòng như CreateBooking và CheckAvailability hay không, hoặc RPC cơ sở đặt hàng như CreateOrder và CheckOrderFulfillability.
UpdateBooking |
---|
Cập nhật một
|
UpdateOrder |
---|
Cập nhật một
|
Nguồn cấp dữ liệu
Truy xuất trạng thái xử lý đối với nguồn cấp dữ liệu do đối tác tổng hợp bên ngoài tải lên.
GetStatus |
---|
Truy xuất
|
ListStatus |
---|
Truy xuất
|
InvalidationService
Nhận yêu cầu vô hiệu hoá tài nguyên từ các đối tác bên ngoài.
InvalidateResource |
---|
Vô hiệu hoá một tài nguyên hiện có. Một yêu cầu sẽ bị bỏ qua nếu tài nguyên bạn yêu cầu không được đăng ký với dịch vụ của Google. Các loại tài nguyên được hỗ trợ: – Đến lấy hàng
|
InventoryStatus
Truy xuất kho hàng và trạng thái so khớp của những người bán đã tải lên.
GetMerchantStatus |
---|
Lấy
|
ListMerchantStatuses |
---|
Liệt kê tất cả
|
InventoryUpdate
Nhận thông tin cập nhật về kho hàng từ các đơn vị tập hợp bên ngoài.
BatchDeleteGenericRecords |
---|
Xoá các bản ghi của loại nguồn cấp dữ liệu đã chỉ định. Chỉ thực hiện xác thực cơ bản (như yêu cầu có định dạng không đúng), sau đó phản hồi phù hợp sẽ được trả về đối tác ngay lập tức. Google thực hiện xác thực logic kinh doanh theo yêu cầu một cách không đồng bộ. Lệnh gọi lô này không đảm bảo tính nguyên thức.
|
BatchPushGenericRecord |
---|
Chèn và/hoặc cập nhật bản ghi của loại nguồn cấp dữ liệu được chỉ định. Chỉ thực hiện xác thực cơ bản (như yêu cầu có định dạng không đúng), sau đó phản hồi phù hợp sẽ được trả về đối tác ngay lập tức. Google thực hiện xác thực logic kinh doanh theo yêu cầu một cách không đồng bộ. Lệnh gọi lô này không đảm bảo tính nguyên thức.
|
BatchReplaceServiceAvailability |
---|
Thay thế
|
CreateMerchant |
---|
Tạo một
|
CreateService |
---|
Tạo
|
DeleteMerchant |
---|
Xoá
|
DeleteService |
---|
Xoá
|
ReplaceServiceAvailability |
---|
Thay thế
|
UpdateMerchant |
---|
Cập nhật một
|
UpdateService |
---|
Cập nhật
|
ActionLink
URL của hành động có ngôn ngữ liên quan, danh sách các quốc gia bị hạn chế và nền tảng không bắt buộc cho biết nên thực hiện hành động này trên nền tảng nào.
Các trường | |
---|---|
url |
URL điểm truy cập cho đường liên kết hành động này. |
language |
Thẻ ngôn ngữ BCP-47 xác định ngôn ngữ có sẵn nội dung trong URI này. |
restricted_country[] |
Mã quốc gia ISO 3166-1 alpha-2. Để trống để hiển thị không hạn chế. |
platform |
Nền tảng mà hành động này sẽ được thực hiện. Nếu bạn không đặt trường này, ACTION_PLATFORM_WEB_APPLICATION sẽ được dùng làm phương án dự phòng. |
action_link_type |
Loại hành động được xác định trước. |
order_online_metadata |
Siêu dữ liệu của đường liên kết đặt hàng trực tuyến. Hỗ trợ hành động bằng ActionLinkType là ACTION_LINK_TYPE_SHOP_TRỰC. |
food_ordering_metadata |
Siêu dữ liệu cho đường liên kết Đặt món ăn. Hỗ trợ loại hành động: * |
ActionLinkType
Loại hành động xác định trước được liên kết với một liên kết hành động.
Enum | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Chưa chỉ định loại đường liên kết hành động. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Loại đường liên kết hành động là đặt lịch hẹn. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Loại đường liên kết hành động là đặt lịch hẹn trực tuyến. |
ACTION_LINK_TYPE_ORDER_FOOD |
Loại đường liên kết hành động là đặt đồ ăn giao hàng hoặc mua mang đi hoặc cả hai. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Loại đường liên kết hành động là đặt đồ ăn để giao hàng. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Loại đường liên kết hành động là đặt đồ ăn mang đi. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Loại đường liên kết hành động là đặt chỗ ăn uống. |
ACTION_LINK_TYPE_SHOP_ONLINE |
Loại đường liên kết hành động là đặt hàng để mua sắm, có thể là giao hàng hoặc đến lấy hàng hoặc cả hai. |
ActionPlatform
Nền tảng nơi thực hiện hành động. Ứng dụng web là phương án dự phòng chung. Bạn nên có ít nhất một ActionLink với ACTION_PLATFORM_WEB_APPLICATION. Các đường liên kết đến nền tảng Android và iOS chỉ được dùng trên hệ thống tương ứng.
Enum | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
Chưa xác định nền tảng này. |
ACTION_PLATFORM_WEB_APPLICATION |
Nền tảng hành động nói chung là web. |
ACTION_PLATFORM_MOBILE_WEB |
Nền tảng hành động là web trên thiết bị di động. |
ACTION_PLATFORM_ANDROID |
Nền tảng hành động là hệ điều hành Android. |
ACTION_PLATFORM_IOS |
Nền tảng hành động là iOS. |
Khuyến cáo
Thông báo tư vấn hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google.
Các trường | |
---|---|
text |
Thông báo tuỳ chỉnh sẽ hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google. |
Phạm vi áp dụng
Một vùng tình trạng còn hàng của dịch vụ của người bán, cho biết thời gian và số lượng vị trí.
Các trường | |
---|---|
start_time |
Thời gian bắt đầu của khung giờ nhận đặt hẹn. |
duration |
Thời lượng của khung giờ nhận đặt hẹn |
spots_total |
Tổng số vị trí còn trống và còn trống trong tình trạng còn phòng này. Ví dụ:
Lưu ý: Nếu gửi yêu cầu bằng định dạng nén tình trạng rảnh/bận được xác định bên dưới, thì hai trường này sẽ được suy luận.
|
spots_open |
Số lượng vị trí còn trống. |
availability_tag |
Một chuỗi không rõ ràng (không bắt buộc) để xác định vị trí phát sóng này. Nếu được đặt thì thông tin này sẽ có trong các yêu cầu đặt lịch hẹn/cập nhật/huỷ cuộc hẹn. |
resources |
Các tài nguyên không bắt buộc dùng để phân biệt khu vực dành cho tình trạng rảnh/bận này với các phòng khác khi các phòng hoặc nhân viên khác nhau sử dụng dịch vụ. Ví dụ: cùng một lớp Yoga với 2 2 người hướng dẫn:
|
payment_option_id[] |
Danh sách mã nhận dạng tham khảo những cách thanh toán có thể dùng để thanh toán cho vị trí 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. Trường này sẽ ghi đè mọi payment_option_ids được chỉ định trong thông báo dịch vụ. Tương tự payment_option_ids được chỉ định ở đây KHÔNG cần phải xuất hiện trong thông báo dịch vụ, nhưng phải được xác định ở cấp Người bán. |
recurrence |
Thông tin lặp lại của tình trạng rảnh/bận, thể hiện nhiều thời gian bắt đầu. Sự lặp lại phải bao gồm các cuộc hẹn trong một ngày làm việc. |
schedule_exception[] |
Thời gian không thể lên lịch dịch vụ này. Để giới hạn số lượng thông báo schedule_exception, hãy cân nhắc việc tham gia cùng các ngoại lệ kế tiếp. |
deposit |
Khoản tiền đặt cọc không bắt buộc cho tình trạng còn hàng này. Ghi đè khoản phí dịch vụ nếu bạn đã chỉ định khoản phí này. |
no_show_fee |
Phí vắng mặt (không bắt buộc) đối với tình trạng còn phòng này (không bắt buộc). Ghi đè phí dịch vụ không xuất hiện nếu bạn đã chỉ định phí xuất hiện. |
require_credit_card |
Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt chỗ trong khung thời gian còn hàng này hay không. Nếu bạn không đặt giá trị này, thì giá trị đó sẽ được kế thừa từ cấp dịch vụ (nếu bạn đặt giá trị đó). (không bắt buộc) |
ticket_type_id[] |
Cho biết danh sách các loại vé được hỗ trợ cho khu vực còn hàng này. Nếu không được đặt, tất cả các loại vé trong dịch vụ chính đều có thể sử dụng cho vị trí này. Lưu ý rằng bạn phải xác định các giá trị của trường này trong dịch vụ mẹ. Ví dụ:
Để đại diện cho kho hàng vào các ngày trong tuần:
Để cho biết có cả ba loại vé cho khung giờ này, hãy sử dụng (không bắt buộc) |
duration_requirement |
Yêu cầu hiển thị thời lượng và/hoặc thời gian kết thúc của các khung giờ. Trường này sẽ bị bỏ qua nếu vị trí không có sẵn. Không được dùng trong danh mục Điểm tham quan. (không bắt buộc) |
scheduling_rule_overrides |
Quy tắc lên lịch về tình trạng rảnh/bận. Nếu các trường được điền sẵn, thì chúng sẽ ghi đè mọi quy tắc lập lịch tương ứng trong Lập lịch quy tắc cấp dịch vụ. |
confirmation_mode |
Chế độ xác nhận sẽ được dùng khi đặt tình trạng phòng này. Việc cố gắng tạo lượt đặt trước cho các tình trạng còn phòng bằng chế độ xác nhận CONFIRMATION_MODE_SYNCHRONOUS phải được xác nhận hoặc bị từ chối ngay lập tức. Việc cố gắng tạo lượt đặt trước cho các tình trạng còn phòng bằng chế độ xác nhận CONFIRMATION_MODE_ASYNCHRONOUS phải bị từ chối ngay lập tức hoặc được tạo với trạng thái ĐANG CHỜ XỬ LÝ. |
ConfirmationMode
Chế độ xác nhận dùng khi đặt trước tình trạng còn hàng.
Enum | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED |
Bạn chưa chỉ định chế độ xác nhận. Xác nhận đồng bộ sẽ được giả định. |
CONFIRMATION_MODE_SYNCHRONOUS |
Lượt đặt chỗ cho tình trạng rảnh/bận này sẽ được xác nhận đồng bộ. |
CONFIRMATION_MODE_ASYNCHRONOUS |
Các lượt đặt trước cho tình trạng còn hàng này sẽ được xác nhận không đồng bộ. |
DurationRequirement
Enum này cho biết những yêu cầu hiện có để người dùng xác nhận hoặc xem thời lượng/thời gian kết thúc được yêu cầu.
Enum | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
Bạn chưa chỉ định thời gian kết thúc xử lý. Đây là lựa chọn mặc định. |
DO_NOT_SHOW_DURATION |
Người dùng không thấy thời gian kết thúc. |
MUST_SHOW_DURATION |
Người dùng phải thấy thời gian kết thúc thì mới có thể tạo cuộc hẹn. |
Tần suất
Thông báo lặp lại là không bắt buộc nhưng cho phép trình bày ngắn gọn hơn các vị trí sẵn có lặp lại nhất quán. Chúng thường thể hiện lịch làm việc của một ngày. Sau đó, thông báo ScheduleException được dùng để thể hiện phạm vi thời gian đã đặt/không hoạt động trong ngày làm việc.
Yêu cầu:
- Việc mở rộng vùng hỗ trợ tình trạng rảnh/bận hoặc lặp lại KHÔNG được tạo các vùng giống nhau. Nếu mã, thời gian bắt đầu, thời lượng và tài nguyên khớp với nhau, thì các vị trí được coi là giống nhau.
- KHÔNG kết hợp định dạng sẵn có tiêu chuẩn và tần suất lặp lại trong các vị trí của dịch vụ. Việc lặp lại mang lại lợi ích cho những người bán/dịch vụ cung cấp cuộc hẹn. Định dạng chuẩn hướng đến người bán/dịch vụ có các lớp học được lên lịch thường xuyên.
- Việc lặp lại không được kéo dài quá 24 giờ.
Các trường | |
---|---|
repeat_until |
Dấu thời gian UTC tối đa kể cả tình trạng còn hàng sẽ lặp lại cho đến. |
repeat_every |
Xác định thời gian giữa các thời điểm tình trạng rảnh/bận liên tiếp. Ví dụ: Tình trạng rảnh/bận có thời lượng 20 phút, repeat_mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và repeat_until 11:00 sáng sẽ tạo ra các vị trí là 9-9:20 sáng, 9:30-9:50 sáng, 10-10:20 sáng, 10:30-10:1-50 sáng, 10:30-10:1-50 sáng (bắt buộc) |
ScheduleException
Thông báo ScheduleException biểu thị phạm vi thời gian đã đặt/không hoạt động trong ngày làm việc. Đây là các trường hợp ngoại lệ đối với việc lặp lại được mô tả ở trên. Khi các khung giờ đã được đặt trước, danh sách các trường hợp ngoại lệ phải được cập nhật để phản ánh các phạm vi thời gian mới không có sẵn. Việc lặp lại sẽ không được sửa đổi.
Các trường | |
---|---|
time_range |
Phạm vi thời gian của ngoại lệ. Mọi khung giờ được mô tả theo tần suất trùng lặp trong phạm vi thời gian đóng này sẽ được coi là không có sẵn. Ví dụ: Nếu việc lặp lại chỉ định khoảng thời gian 20 phút, repeat_mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và repeat_until 11:00 sáng, thì một ScheduleException có phạm vi thời gian là 9:45 sáng-11:00 sáng sẽ không có sẵn các khung giờ từ 9:30-9:50 sáng, 10:3-10 sáng, 10:3-10 sáng và 10:3-10 sáng: Xin lưu ý rằng vì phạm vi thời gian này đang đóng cửa, nên vị trí bắt đầu lúc 11 giờ sáng sẽ không bị ảnh hưởng. |
SchedulingRuleOverrides
Quy tắc lên lịch ở cấp độ sẵn có.
Các trường | |
---|---|
last_bookable_sec |
Thời gian gần đây nhất (tính bằng giây) mà bạn có thể đặt khung giờ này. Dấu thời gian này phải trước thời điểm bắt đầu (start_sec) của vị trí được áp dụng (nếu người dùng có thể đặt trước sau thời gian bắt đầu, hãy sử dụng SchedulingRules ở cấp dịch vụ.min_booking_before_end_time). Nếu có, tính năng này sẽ ghi đè mọi giá trị được chỉ định trong min_booking_buffer của Quy tắc lập lịch biểu của Dịch vụ tương ứng. |
first_bookable_sec |
Lần đầu tiên (tính bằng giây) mà người dùng có thể đặt khung giờ này. Dấu thời gian này phải trước start_sec của vị trí hoặc last_bookable_sec nếu được chỉ định. |
last_online_cancellable_sec |
Nếu được đặt, thời gian gần đây nhất (tính bằng giây kể từ thời gian bắt đầu của Unix) mà khung giờ nhận đặt hẹn cụ thể này có thể bị huỷ thông qua tính năng Đặt trước bằng Google. Trường này sẽ thay thế mọi quy tắc huỷ cấp dịch vụ. (không bắt buộc) |
BatchDeleteGenericRecordsRequest
Yêu cầu xoá các bản ghi của loại nguồn cấp dữ liệu đã chỉ định theo lô.
Các trường | |
---|---|
parent |
Tên tài nguyên có định dạng – |
records[] |
Bản ghi cần xoá. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi. |
BatchPushGenericRecordRequest
Yêu cầu theo lô để chèn và/hoặc cập nhật bản ghi của loại nguồn cấp dữ liệu được chỉ định trong URL yêu cầu.
Các trường | |
---|---|
parent |
Tên tài nguyên có định dạng – |
records[] |
Bản ghi sẽ được chèn và/hoặc cập nhật. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi. |
BatchReplaceServiceAvailabilityRequest
Yêu cầu theo lô để thay thế nhiều vị trí phát sóng của Service
.
Các trường | |
---|---|
parent |
Định dạng |
extended_service_availability[] |
Khả năng cung cấp dịch vụ mở rộng dùng để thay thế các khung giờ hiện có. |
BatchReplaceServiceAvailabilityResponse
Phản hồi hàng loạt để thay thế nhiều vị trí phát sóng của Service
. Chỉ những khung giờ đã cập nhật thành công mới được đính kèm trong thông báo này
Các trường | |
---|---|
extended_service_availability[] |
Các thông báo về khả năng sử dụng dịch vụ mở rộng được cập nhật thành công dùng để thay thế các khung thời gian hỗ trợ hiện có. |
Thông tin đặt chỗ
Lượt đặt trước cho vùng khoảng không quảng cáo
Các trường | |
---|---|
name |
Tên tài nguyên của lượt đặt trước: |
merchant_id |
Mã của người bán cho vùng quảng cáo |
service_id |
Mã dịch vụ của người bán |
start_time |
Thời gian bắt đầu của khung giờ nhận đặt hẹn |
duration |
Thời lượng của khung giờ nhận đặt hẹn |
client_information |
Thông tin cá nhân của khách hàng đặt lịch hẹn |
status |
Trạng thái của yêu cầu đặt phòng |
payment_information |
Thông tin về các giao dịch thanh toán liên quan đến lượt đặt vé. |
party_size |
Số người tham gia bữa tiệc đã đặt trước |
BookingFailure
Dữ liệu trạng thái cho biết lý do không thể xử lý yêu cầu đặt phòng theo cách không đồng bộ. Mục đích của tính năng Đặt chỗ không thành công là chủ yếu ghi lại các lỗi về logic kinh doanh.
Các trường | |
---|---|
cause |
Lý do không đặt được chỗ. (bắt buộc) |
rejected_card_type |
(chỉ bắt buộc nếu nguyên nhân là PAYMENT_ERROR_CARD_TYPE_ đấu giả) |
description |
Trường không bắt buộc này dùng để đối tác cung cấp thông tin bổ sung chỉ nhằm mục đích gỡ lỗi. (không bắt buộc) |
payment_failure |
Thông tin về các lỗi thanh toán. |
Nguyên nhân
Bảng liệt kê các nguyên nhân gây lỗi.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Giá trị mặc định: Không sử dụng; dẫn đến "lỗi không xác định" |
SLOT_UNAVAILABLE |
Vị trí tình trạng rảnh/bận được đề cập không còn nữa. |
SLOT_ALREADY_BOOKED_BY_USER |
Người dùng đã đặt lịch hẹn cho khung giờ nhận đặt lịch hẹn được đề cập. |
LEASE_EXPIRED |
Hợp đồng thuê (nếu được cung cấp) đã hết hạn và không thể được dùng nữa để hoàn tất yêu cầu đặt phòng. |
OUTSIDE_CANCELLATION_WINDOW |
Hiện tại, không thể thực hiện yêu cầu huỷ do quy định hạn chế về thời gian trong chính sách huỷ của người bán. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì người bán không chấp nhận loại thẻ tín dụng đã cung cấp. Loại thẻ tín dụng phải được cung cấp trong keyword_card_type. |
PAYMENT_ERROR_CARD_DECLINED |
Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì thẻ tín dụng được cung cấp đã bị từ chối. |
PAYMENT_OPTION_NOT_VALID |
Đã xảy ra lỗi với gói/gói thành viên dùng để thanh toán cho yêu cầu đặt trước. Có thể không còn lượt sử dụng hợp lệ nào, ứng dụng có thể đã hết hạn, v.v. |
PAYMENT_ERROR |
Đã xảy ra lỗi khi xử lý khoản thanh toán cho yêu cầu đặt chỗ này. Sử dụng giá trị này để biểu thị lỗi liên quan đến thanh toán chung, chỉ khi lỗi không khớp với lỗi thanh toán cụ thể ở trên. |
USER_CANNOT_USE_PAYMENT_OPTION |
Người dùng không thể sử dụng phương thức thanh toán đã cho (ví dụ: người dùng cố gắng sử dụng giá lần đầu tiên). |
BOOKING_ALREADY_CANCELLED |
Lượt đặt chỗ mà người dùng cố gắng huỷ đã bị huỷ. |
BOOKING_NOT_CANCELLABLE |
Không thể huỷ lượt đặt phòng mà người dùng đã cố gắng huỷ. |
OVERLAPPING_RESERVATION |
Người dùng hiện có một yêu cầu đặt chỗ quá gần thời điểm này. |
USER_OVER_BOOKING_LIMIT |
Không đặt được vé do người dùng đã vượt quá giới hạn lượt đặt trước trên mỗi người dùng của đơn vị tập hợp. |
PAYMENT_REQUIRES_3DS1 |
Đặt thời điểm khoản thanh toán bị từ chối vì bạn đang yêu cầu thử lại giao dịch, nhưng đây là lần này sau khi bạn trải qua quy trình thử thách/phản hồi 3DS1. Xin lưu ý rằng trạng thái không thành công của giao dịch hiện tại sẽ vẫn không thành công. Hoạt động thử lại sẽ hoàn toàn riêng biệt. Khi là lý do không thành công, bạn PHẢI đặt thông số payment_failure.3DS1_parameters. Nếu không, thì nguyên nhân hiện tại sẽ được xử lý như thể là PAYMENT_ERROR. |
PaymentFailureInformation
Thông tin về các lỗi thanh toán.
Các trường | |
---|---|
threeds1_parameters |
Các tham số được trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ được bỏ qua trừ khi ĐặtFailure.Destroy được đặt thành PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Các tham số yêu cầu RwG thực hiện thử thách 3DS1.
Tham số được thiết lập theo mô tả của EMVCo về giao thức 3DS1.
Các trường | |
---|---|
acs_url |
URL để tải biểu mẫu và hiển thị cho người dùng để xác thực. |
pa_req |
Yêu cầu Xác thực Thanh toán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |
transaction_id |
Giá trị nhận dạng do nhà cung cấp ACS sử dụng. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |
md_merchant_data |
Dữ liệu người bán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |
BookingStatus
Trạng thái của một lượt đặt phòng
Enum | |
---|---|
BOOKING_STATUS_UNSPECIFIED |
Chưa xác định. |
CONFIRMED |
Đã xác nhận đặt phòng |
PENDING_MERCHANT_CONFIRMATION |
Yêu cầu đặt vé đang chờ người bán xác nhận trước khi có thể chuyển sang trạng thái ĐÃ XÁC NHẬN (trạng thái này hiện KHÔNG được hỗ trợ) |
PENDING_CLIENT_CONFIRMATION |
Yêu cầu đặt phòng đang chờ khách hàng xác nhận trước khi có thể chuyển sang trạng thái ĐÃ XÁC NHẬN (trạng thái này hiện KHÔNG được hỗ trợ) |
CANCELED |
Yêu cầu đặt vé của bạn đã bị hủy thay mặt cho người dùng. |
NO_SHOW |
Khách hàng không có mặt trong cuộc hẹn |
NO_SHOW_PENALIZED |
Khách hàng không đến cuộc hẹn này do vi phạm chính sách huỷ lịch hẹn. |
FAILED |
Không thể hoàn tất yêu cầu đặt vé do lỗi xử lý. |
DECLINED_BY_MERCHANT |
Người bán đã từ chối lượt đặt trước một cách không đồng bộ. |
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.
CancellationPolicy
Chính sách huỷ một dịch vụ.
Các trường | |
---|---|
refund_condition[] |
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ụ.
Các trường | |
---|---|
min_duration_before_start_time |
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 |
refund_percent |
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 |
ClientInformation
Thông tin cá nhân về người đặt chỗ
Các trường | |
---|---|
given_name |
Tên của khách hàng |
family_name |
Họ của khách hàng |
address |
Địa chỉ của khách hàng |
telephone |
Số điện thoại của khách hàng |
email |
Địa chỉ email của khách hàng |
CreateMerchantRequest
Yêu cầu tạo một Merchant
.
Các trường | |
---|---|
parent |
Tên tài nguyên chính của đối tác sở hữu người bán này, ở định dạng |
merchant_id |
Mã người bán để sử dụng cho người bán này. |
merchant |
Người bán cần tạo. |
CreateServiceRequest
Yêu cầu tạo một Service
mới.
Các trường | |
---|---|
parent |
Tên tài nguyên chính cho người bán sở hữu dịch vụ này, ở định dạng |
service_id |
Mã dịch vụ cần sử dụng cho dịch vụ này. |
service |
Dịch vụ cần tạo. |
CreditCardRestrictions
Các hạn chế đối với các loại thẻ tín dụng mà người bán này chấp nhận.
Các trường | |
---|---|
credit_card_type[] |
Danh sách thẻ tín dụng được hỗ trợ. Không có thẻ tín dụng nào được hỗ trợ nếu thẻ trống. |
CreditCardType
Loại thẻ tín dụng.
Enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Không sử dụng. |
VISA |
Thẻ tín dụng Visa. |
MASTERCARD |
Thẻ tín dụng Mastercard. |
AMERICAN_EXPRESS |
Thẻ tín dụng American Express. |
DISCOVER |
Thẻ tín dụng của Khám phá. |
JCB |
Thẻ tín dụng JCB. |
DeleteMerchantRequest
Yêu cầu xoá Merchant
.
Các trường | |
---|---|
name |
Tên tài nguyên của người bán cần xoá. Theo định dạng đối tác/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
Yêu cầu xoá Service
.
Các trường | |
---|---|
name |
Tên tài nguyên của dịch vụ cần xoá. Theo định dạng |
Ký quỹ
Khoản tiền đặt cọc mà người dùng có thể bị tính hoặc bị tạm giữ trong thẻ tín dụng.
Các trường | |
---|---|
deposit |
Số tiền gửi. |
min_advance_cancellation_sec |
Huỷ đặt trước tối thiểu cho khoản tiền đặt cọc. |
deposit_type |
Xác định cách xác định khoản tiền gửi dựa trên tình trạng còn hàng. |
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.
Các trường | |
---|---|
payment_methods[] |
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. |
DurationRange
Trình bao bọc trong một phạm vi thời lượng có thể được giới hạn hoặc không liên kết. Bạn phải có ít nhất một trong hai thời lượng min_duration và max_duration.
Các trường | |
---|---|
min_duration |
Thời lượng tối thiểu. |
max_duration |
Thời lượng tối đa. |
ExtendedServiceAvailability
Danh sách tình trạng rảnh/bận và người/thời điểm áp dụng.
Các trường | |
---|---|
merchant_id |
Đây là trường bắt buộc để chỉ định người bán nào nhận được thông báo về tình trạng còn hàng bên dưới. |
service_id |
Đây là trường bắt buộc để chỉ định dịch vụ của thông báo về tình trạng rảnh/bận bên dưới. |
start_time_restrict |
Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Tình trạng còn hàng là bản tổng quan nhanh hoàn chỉnh từ ngày [start_time_restrict, end_time_restrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau:
Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:
Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế hơn nữa:
Các trường này thường dùng để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định. Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict. |
end_time_restrict |
Việc đặt end_time_restrict trong khi không đặt start_time_restrict sẽ có nghĩa là tất cả thời gian đã đạt đến end_time_restrict. |
duration_restrict |
Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp. |
resources_restrict |
Việc đặt tài nguyên_hạn chế sẽ giới hạn hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác. |
availability[] |
Danh sách tình trạng rảnh/bận mới. |
FeedStatistics
Số liệu thống kê thu được trong quá trình xử lý nguồn cấp dữ liệu đã tải lên.
Các trường | |
---|---|
new_items |
Các mặt hàng mới được thêm vào nguồn cấp dữ liệu này. Mặt hàng có thể là người bán, dịch vụ hoặc vị trí còn hàng, tuỳ thuộc vào loại nguồn cấp dữ liệu. |
existing_items |
Các mặt hàng hiện có, được cập nhật khi cần từ thông tin mới hơn từ nguồn cấp dữ liệu. |
deleted_items |
Các mặt hàng không còn xuất hiện trong nguồn cấp dữ liệu này nên kết quả là đã bị xoá. |
FeedStatus
Trạng thái của nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.
Các trường | |
---|---|
name |
Tên tài nguyên nguồn cấp dữ liệu, có định dạng
|
state |
Trạng thái đang xử lý của nguồn cấp dữ liệu này. |
error_details |
Chuỗi ký tự đọc được, cung cấp thêm thông tin chi tiết nếu chúng tôi không xử lý được nguồn cấp dữ liệu này. |
statistics |
Số liệu thống kê dành riêng cho nguồn cấp dữ liệu này. |
Tiểu bang
Enum cho biết trạng thái xử lý của nguồn cấp dữ liệu.
Enum | |
---|---|
STATE_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
IN_PROGRESS |
Nguồn cấp dữ liệu vẫn đang được xử lý. |
SUCCESS |
Nguồn cấp dữ liệu đã được xử lý thành công. |
FAILURE |
Chúng tôi đã gặp lỗi trong khi xử lý nguồn cấp dữ liệu. |
FoodOrderingMetadata
Siêu dữ liệu cho đường liên kết về thao tác đặt món ăn.
Các trường | |
---|---|
fee_details[] |
Thông tin chi tiết về các khoản phí tính cho người dùng, được thêm vào tổng số tiền của mặt hàng. Lặp lại đối với các loại phí khác nhau như phí dịch vụ, phí giao hàng, v.v. |
advance_order_details |
Thông tin chi tiết về dịch vụ hỗ trợ đặt hàng nâng cao (còn gọi là dịch vụ đặt hàng trước) mà người dùng có thể đặt hàng vào một thời điểm muộn hơn so với hiện tại. |
Trường nhóm fulfillment_duration_options . Khoảng thời gian thực hiện đơn đặt hàng tính từ lúc xác nhận đơn đặt hàng. Đối với đơn đặt hàng giao tận nơi, khoảng thời gian cho đến khi giao đồ ăn. Đối với đơn đặt hàng tự đến lấy, khoảng thời gian cho đến khi thực phẩm sẵn sàng để khách đến lấy. fulfillment_duration_options chỉ có thể là một trong những trạng thái sau đây: |
|
fulfillment_lead_time_duration |
Thời lượng cố định. Ví dụ: 30 phút. |
fulfillment_lead_time_duration_range |
Một phạm vi thời lượng. Ví dụ: * 30 phút đến 45 phút * Trên 30 phút * Dưới 50 phút |
AdvanceOrderDetails
Để được hỗ trợ đặt hàng trước.
Các trường | |
---|---|
is_supported |
Đúng nếu Đơn đặt hàng trước (còn gọi là Đơn đặt hàng trước) được hỗ trợ. (bắt buộc) |
FeeDetails
Chi tiết về khoản phí.
Các trường | |
---|---|
type |
Loại phí. (bắt buộc) |
fee_amount |
Số tiền phí có thể tính theo đơn vị tiền tệ, tỷ lệ phần trăm của giá trị giỏ hàng hoặc kết hợp cả hai. (bắt buộc) |
FeeAmount
FeeAmount
ví dụ: * Phí cố định: 0 USD (không tính phí), 1,5 USD * Phạm vi phí cố định: 1 USD (tối thiểu), 3 USD (tối đa), 5 – 6,0 USD * Tỷ lệ phần trăm kích thước giỏ hàng: 15,5% – 10% – 20%, 10% (tối thiểu), 15% (tối đa) và 25% USD
Các trường | |
---|---|
cart_percentage |
Phí tính theo tỷ lệ phần trăm của giá trị giỏ hàng. Hỗ trợ một phạm vi (có giới hạn và không giới hạn) hoặc một tỷ lệ phần trăm cố định. Giá trị phải nằm trong khoảng từ 0 đến 100. Ví dụ: * Cố định 5,5% * Tối thiểu 5,5% * Tối đa 5,5% * 4,5% đến 5,5% |
Trường nhóm amount_options . Các lựa chọn để chỉ định số tiền. amount_options chỉ có thể là một trong những trạng thái sau đây: |
|
amount |
Số tiền cố định. Ví dụ: 3,5 USD. |
amount_range |
Phạm vi số tiền. Ví dụ: * 3,5 USD đến 5,5 USD * Tối thiểu là 3,5 USD * Tối đa là 5,5 USD |
amount_unknown |
Số tiền không xác định. |
FeeType
Loại phí.
Enum | |
---|---|
FEE_TYPE_UNSPECIFIED |
Chưa xác định loại phí. |
DELIVERY |
Về phí giao hàng. |
SERVICE |
Về phí dịch vụ. |
FulfillmentOption
Phương thức thực hiện đơn hàng cho một đường liên kết đến hành động đặt hàng trực tuyến.
Các trường | |
---|---|
fulfillment_type |
Bắt buộc. Loại phương thức thực hiện. |
available_day[] |
Bắt buộc. Danh sách ngày mà phương thức thực hiện này có thể được hỗ trợ (tốt nhất là ít nhất là 2). |
fee_details |
Bắt buộc. Thông tin chi tiết về phí cho phương thức thực hiện đơn hàng. |
minimum_order |
Bắt buộc. Đơn đặt hàng tối thiểu cho phương thức thực hiện liên kết với đường liên kết hành động. |
AvailableDay
Khả năng cung cấp cấp ngày.
Các trường | |
---|---|
fulfillment_date |
Bắt buộc. Ngày có thể sử dụng của một phương thức thực hiện. Được giả định nằm trong múi giờ của người bán. |
last_ordering_time |
Bắt buộc. Dấu thời gian Unix. Lần cuối cùng người dùng có thể đặt hàng và nhận mặt hàng muộn nhất vào Ví dụ: nếu ngày thực hiện đơn hàng là 2020-08-10: – giá trị last_ordering_time là 2020-08-10 18:00 có nghĩa là khách hàng phải nhận được đơn đặt hàng vào ngày 10 tháng 8 năm 2020, phải đặt hàng muộn nhất vào 6 giờ tối cùng ngày. – Giá trị last_ordering_time là 20:00 của 2020-08-08 20:00 có nghĩa là để nhận được đơn đặt hàng vào ngày 10-08-2020, khách hàng phải đặt hàng muộn nhất vào 20:00 của 2 ngày trước đó. |
FeeDetails
Thông tin về phí cho phương thức thực hiện liên kết với đường liên kết hành động.
Các trường | |
---|---|
Trường nhóm fee_details . Mô hình phí cho phương thức thực hiện. fee_details chỉ có thể là một trong những trạng thái sau đây: |
|
no_fee |
Không mất phí cho phương thức thực hiện. |
base_fee |
Phí cơ bản liên kết với phương thức thực hiện đơn hàng. |
fixed_fee |
Phí cố định liên kết với phương thức thực hiện đơn hàng. |
FixedFee
Phí cố định bắt buộc cho phương thức thực hiện liên kết với đường liên kết hành động.
Các trường | |
---|---|
amount |
Bắt buộc. Số tiền phí cố định cho phương thức thực hiện đơn hàng. |
FulfillmentType
Loại phương thức thực hiện được liên kết với một đường liên kết hành động.
Enum | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Chưa chỉ định kiểu phương thức thực hiện. |
FULFILLMENT_TYPE_DELIVERY |
Phương thức thực hiện là phân phối. |
FULFILLMENT_TYPE_PICKUP |
Phương thức thực hiện đơn hàng là đến lấy hàng. |
MinimumFee
Phí tối thiểu bắt buộc cho phương thức thực hiện liên kết với đường liên kết hành động.
Các trường | |
---|---|
base_fee_amount |
Bắt buộc. Số tiền phí cơ bản cho phương thức thực hiện. |
NoFee
Bạn không phải trả phí cho phương thức thực hiện liên kết với đường liên kết hành động.
GenericDeleteRecord
Bản ghi cần xoá của loại nguồn cấp dữ liệu được đề cập trong yêu cầu URL.
Các trường | |
---|---|
delete_time |
Bắt buộc. Dấu thời gian này dùng để xác định thứ tự áp dụng yêu cầu xoá đối với khoảng không quảng cáo. |
Trường nhóm record_type . Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) Đối tác có thể cung cấp bản ghi đầy đủ tương tự như cách cung cấp bản ghi trong nguồn cấp dữ liệu hoặc BatchPush API. Đối tác cũng có thể chỉ thêm các trường cần thiết của hồ sơ để nhận dạng chính xác bản ghi đó. record_type chỉ có thể là một trong những trạng thái sau đây: |
|
data_record |
Đối với nguồn cấp dữ liệu không dựa trên proto. |
proto_record |
Đối với nguồn cấp dữ liệu dựa trên proto. |
GenericRecord
Bản ghi của loại nguồn cấp dữ liệu được đề cập trong yêu cầu URL.
Các trường | |
---|---|
generation_timestamp |
Bắt buộc. Dấu thời gian này dùng để đảm bảo thứ tự cập nhật kho hàng chính xác. |
Trường nhóm record_type . Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) record_type chỉ có thể là một trong những trạng thái sau đây: |
|
data_record |
Đối với nguồn cấp dữ liệu không dựa trên proto. |
proto_record |
Đối với nguồn cấp dữ liệu dựa trên proto. |
GeoCoordinates
Dữ liệu địa lý của một vị trí, bao gồm cả vĩ độ, kinh độ và địa chỉ.
Các trường | |
---|---|
latitude |
Vĩ độ tính bằng độ. (không bắt buộc) |
longitude |
Kinh độ theo độ. (không bắt buộc) |
Trường nhóm addresses . Địa chỉ của một vị trí, có thể có cấu trúc hoặc không có cấu trúc. addresses chỉ có thể là một trong những trạng thái sau đây: |
|
address |
Địa chỉ bưu chính của vị trí, ưu tiên. |
unstructured_address |
Địa chỉ không có cấu trúc cũng có thể được cung cấp dưới dạng phương án dự phòng. Ví dụ: "1600 nhà hát vòng tròn parkway Mountain view, ca 94043" |
GetMerchantStatusRequest
Yêu cầu nhận một MerchantStatus
Các trường | |
---|---|
name |
Bắt buộc. Tên tài nguyên, theo định dạng đối tác/{partner_id}/merchants/{merchant_id}/trạng thái. |
GetStatusRequest
Yêu cầu truy xuất Status
cho một nguồn cấp dữ liệu cụ thể do nền tảng của đơn vị tập hợp tải lên.
Các trường | |
---|---|
name |
Tên tài nguyên nguồn cấp dữ liệu, có định dạng
|
HomeServiceData
Cần cung cấp thêm thông tin cho ngành dọc dịch vụ gia đình.
Các trường | |
---|---|
category_type |
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. |
job_type |
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. |
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). |
InvalidateResourceRequest
Yêu cầu vô hiệu hoá tài nguyên.
Các trường | |
---|---|
resource_id |
Tên của tài nguyên cần vô hiệu hoá. Ví dụ: đối với tài nguyên Lấy hàng, tên phải có định dạng |
LineItem
Một mặt hàng trong một đơn đặt hàng – việc đặt một dịch vụ duy nhất trong một khung giờ duy nhất.
Các trường | |
---|---|
service_id |
Mã dịch vụ của người bán. |
start_sec |
Thời gian bắt đầu của khung giờ nhận đặt hẹn tính bằng giây theo giờ UTC kể từ thời gian bắt đầu của hệ thống Unix. |
duration_sec |
Thời lượng của khung giờ nhận đặt hẹn tính bằng giây. |
tickets[] |
Số lượng vé đã đặt theo Loại vé. |
price |
Tổng giá (không bao gồm thuế) của Mục hàng này. |
status |
Trạng thái của mục hàng. |
OrderedTickets
Số lượng vé đã đặt theo Loại vé.
Các trường | |
---|---|
ticket_id |
Mã của Loại vé. |
count |
Số lượng vé đã đặt cho loại này. |
ListMerchantStatusesRequest
Yêu cầu lấy danh sách MerchantStatus
Các trường | |
---|---|
parent |
Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp trạng thái người bán này. Định dạng |
page_size |
Bắt buộc. Số lượng mục tối đa cần trả lại. Xin lưu ý rằng máy chủ có thể giảm kích thước trang. |
page_token |
Không bắt buộc. Giá trị nextPageToken được trả về từ ListMerchantStatusResponse trước đó, nếu có. |
booking_inventory_status_restrict |
Không bắt buộc. Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái của khoảng không quảng cáo đặt trước. |
waitlist_inventory_status_restrict |
Không bắt buộc. Quy định hạn chế (không bắt buộc) để lọc kết quả theo trạng thái khoảng không quảng cáo trong danh sách chờ. |
geo_match_restrict |
Không bắt buộc. Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái so khớp địa lý. |
BookingInventoryStatus
Trạng thái của khoảng không quảng cáo đặt trước từ đầu đến cuối.
Enum | |
---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Chưa xác định. |
NO_VALID_FUTURE_INVENTORY |
Người bán không có kho hàng đặt trước trong 30 ngày tiếp theo. |
HAS_VALID_FUTURE_INVENTORY |
Người bán có kho hàng đã đặt trước trong 30 ngày tiếp theo. |
GeoMatchingStatus
Trạng thái so khớp theo địa lý của người bán.
Enum | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED |
Chưa xác định. |
GEO_UNMATCHED |
Người bán không được so khớp theo vị trí địa lý. |
GEO_MATCHED |
Người bán được so khớp theo vị trí địa lý. |
WaitlistInventoryStatus
Trạng thái khoảng không quảng cáo trong danh sách chờ từ đầu đến cuối.
Enum | |
---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Chưa xác định. |
NO_VALID_WAITLIST_SERVICE |
Người bán không có danh sách chờ hỗ trợ dịch vụ. |
HAS_VALID_WAITLIST_SERVICE |
Người bán có danh sách chờ hỗ trợ dịch vụ. |
ListMerchantStatusesResponse
Phản hồi cho danh sách MerchantStatus
.
Các trường | |
---|---|
merchant_statuses[] |
Danh sách trạng thái người bán đáp ứng các điều kiện lọc. |
next_page_token |
Mã thông báo để truy xuất trang kết quả tiếp theo. Không có kết quả nào khác trong danh sách nếu trống. |
ListStatusRequest
Yêu cầu truy xuất Status
cho nhiều nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.
Các trường | |
---|---|
name |
Tên tài nguyên nguồn cấp dữ liệu, có định dạng
|
page_size |
Số lượng mục tối đa cần trả lại. |
page_token |
Giá trị next_page_token được trả về từ yêu cầu List trước đó, nếu có. |
state_restrict |
Hạn chế để lọc kết quả theo trạng thái nguồn cấp dữ liệu (không bắt buộc). |
time_range_restrict |
Hạn chế tùy chọn lọc kết quả theo giới hạn trên và giới hạn dưới. Nếu bạn không đặt start_time, thì thời gian bắt đầu Unix sẽ được đặt mặc định. Nếu bạn không đặt end_time, thời gian kết thúc sẽ được đặt mặc định là bây giờ. |
ListStatusResponse
Yêu cầu truy xuất Status
cho nhiều nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.
Các trường | |
---|---|
status[] |
Danh sách trạng thái theo trình tự thời gian đảo ngược của các nguồn cấp dữ liệu đã tải lên. Số lượng mặt hàng tối đa được trả về dựa trên trường page_size trong yêu cầu. |
next_page_token |
Mã thông báo để truy xuất trang kết quả tiếp theo. Không có kết quả nào khác trong danh sách nếu trống. |
LocalizedString
Thực thể của một chuỗi trong một ngôn ngữ.
Các trường | |
---|---|
locale |
Mã ngôn ngữ IETF BCP 47, chẳng hạn như "en", "mas", "zh-Hant", "de-CH-1901". Hãy xem http://www.w3.org/International/articles/language-tags/. |
value |
Thông báo bằng ngôn ngữ ở trên (UTF-8). |
Vị trí
Thông tin địa lý về một vị trí.
Các trường | |
---|---|
place_id |
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) |
location_type |
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ụ. |
location_id |
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. |
Người bán
Thông tin về người bán trên nền tảng của trang web tổng hợp.
Các trường | |
---|---|
name |
Tên tài nguyên của người bán (có định dạng |
merchant_name |
merchant_name, điện thoại, url và địa lý được dùng để hỗ trợ việc so khớp kho hàng của đối tác với những người bán đã có trên Google Maps. Thông tin này sẽ không xuất hiện. Tên người bán. |
telephone |
Số điện thoại công khai của người bán, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234. |
url |
URL trang web công khai của người bán. |
geo |
Thông tin địa lý của người bán, bao gồm cả vĩ độ, kinh độ và địa chỉ. |
category |
Loại hình doanh nghiệp trên nền tảng của trang web tổng hợp. |
num_bookings_30d |
Trường này không được dùng nữa. |
tax_rate_basis_points |
Thuế suất của người bán tính theo điểm cơ bản (một phần trăm của một phần trăm). Ví dụ: nếu thuế suất là 7, 5%, bạn phải đặt giá trị cho trường này là 750. Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được giả định là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế đánh giá theo thuế suất cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phân số của 1 xu) sẽ được làm tròn bằng cách làm tròn chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Trường này không còn dùng nữa, vui lòng sử dụng tax_rate thay thế. |
tax_rate |
Thuế suất của người bán. Nếu có trường này, hãy ghi đè trường tax_rate_basis_points không dùng nữa. Nếu bạn nhận được thông báo trống (tức là tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
payment_restrictions |
Các quy định hạn chế đối với các phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định không có quy định hạn chế nào nếu bạn không đặt trường này. |
payment_option[] |
Các phương thức thanh toán có sẵn cho người bán này. Các dịch vụ của người bán này sẽ có thể giới hạn từng lựa chọn thanh toán mà họ cho phép. |
payment_processor_config |
Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó). |
tokenization_config |
Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó). |
terms |
Điều khoản và điều kiện của người bán cụ thể mà người dùng nhìn thấy khi người dùng đang đặt dịch vụ thông qua tính năng Đặt chỗ với Google. Ngoài ra, Điều khoản và điều kiện của đối tác tổng hợp luôn hiển thị cho người dùng và không được cung cấp tại đây. |
brand_id |
Một chuỗi mờ xác định thương hiệu mà người tiêu dùng nhìn thấy để sử dụng khi hiển thị thuộc tính của đối tác. Trường này cho phép các đối tác có nhiều thương hiệu tương tác trực tiếp với người tiêu dùng cung cấp cho người bán tất cả các thương hiệu trong cùng một nguồn cấp dữ liệu. Một thương hiệu bao gồm các đặc điểm mà người tiêu dùng nhìn thấy như tên, biểu trưng, Điều khoản dịch vụ và Chính sách quyền riêng tư. Nếu chỉ có một thương hiệu đối tác đại diện cho người tiêu dùng, thì bạn không cần đặt và có thể bỏ qua trường này. Nếu đối tác... Không có nhiều thương hiệu hướng tới người tiêu dùng? --> Bỏ qua trường này Bạn có định cấu hình nhiều thương hiệu không?
Lưu ý cẩn thận: hầu hết các đối tác không cần đặt trường này. Nếu muốn sử dụng trường này, đối tác phải liên hệ với chúng tôi trước để thiết lập các thương hiệu riêng biệt, bao gồm cả thương hiệu mặc định. |
matching_hints |
Gợi ý giúp Google so khớp người bán với một địa điểm trên Google Maps. Lưu ý: hầu hết các đối tác không cần thiết lập trường này vì Google sẽ so khớp người bán với các địa điểm trên Google Maps dựa trên thông tin được cung cấp ở trên. (không bắt buộc) |
service_attribute[] |
Định nghĩa cho mọi thuộc tính dịch vụ dùng để mô tả Dịch vụ cho Người bán này. (không bắt buộc) |
action_link[] |
Không bắt buộc. URL hành động có ngôn ngữ liên quan, danh sách quốc gia bị hạn chế, loại và nền tảng không bắt buộc cho biết nên thực hiện hành động này trên nền tảng nào, |
waitlist_advisement |
Không bắt buộc. Tư vấn chung của một người bán cụ thể cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Mỗi trường văn bản trong nội dung tư vấn chỉ được có độ dài tối đa là 100 byte. |
MerchantMatchingHints
Gợi ý dùng để giúp Google so khớp người bán với một địa điểm trên Google Maps.
Các trường | |
---|---|
place_id |
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. |
MerchantStatus
Trạng thái của người bán trong nền tảng Đặt chỗ với Google.
Các trường | |
---|---|
name |
Tên tài nguyên trạng thái của người bán, có định dạng |
merchant_name |
Tên của người bán do đối tác cung cấp. |
input_geo_info |
Đối tác đã cung cấp thông tin địa lý của người bán. |
processing_status |
Trạng thái xử lý của người bán. |
booking_status |
Trạng thái liên quan đến việc tích hợp lượt đặt phòng từ đầu đến cuối. |
waitlist_status |
Trạng thái liên quan đến việc tích hợp danh sách chờ. |
geo_match |
Địa điểm địa lý đã so khớp của người bán này. Để trống nếu người bán không khớp với vị trí địa lý. |
local_services_match |
Thông tin trùng khớp trong Quảng cáo dịch vụ địa phương của người bán này. Để trống nếu đó không phải là người bán dịch vụ địa phương hoặc không khớp với bất kỳ nhà cung cấp nào. |
direct_urls[] |
Danh sách URL để minh hoạ nội dung của kho hàng hiện tại của người bán. Xin lưu ý rằng điều này không có nghĩa là khoảng không quảng cáo thực sự đang được phân phát và URL có thể khác với các khoảng không quảng cáo hiển thị công khai. |
BookingStatus
Trạng thái liên quan đến việc tích hợp lượt đặt phòng từ đầu đến cuối.
Các trường | |
---|---|
has_valid_future_inventory |
Đúng nếu người bán có kho hàng trong 30 ngày tiếp theo. Không đảm bảo người bán thực sự được phân phát. |
DirectUrl
URL hiển thị người bán.
Các trường | |
---|---|
type |
Loại URL này. |
url |
URL có thể hiển thị người bán này. |
UrlType
Loại URL hiển thị.
Enum | |
---|---|
URL_TYPE_UNSPECIFIED |
Chưa xác định. |
BOOKING |
URL đặt phòng từ đầu đến cuối. |
WAITLIST |
URL danh sách chờ hai đầu. |
LOCAL_SERVICES |
URL Dịch vụ địa phương của Google. |
LocalServicesMatchInfo
Thông tin trùng khớp trong dịch vụ địa phương của Google (chỉ đặt cho người bán trên dịch vụ địa phương).
Các trường | |
---|---|
matched_providers[] |
Nhà cung cấp dịch vụ phù hợp. Một người bán có thể được kết nối với nhiều nhà cung cấp dịch vụ. |
MatchedProvider
Nhà cung cấp dịch vụ địa phương.
Các trường | |
---|---|
customer_id |
Mã khách hàng bên ngoài cho dịch vụ địa phương của Google. |
categories[] |
Danh mục dịch vụ địa phương (ngành dọc). Ví dụ: "thợ sửa ống nước" và "carpet_cleaning". |
PlaceInfo
Thông tin về một địa điểm trùng khớp.
Các trường | |
---|---|
name |
Tên của địa điểm. |
formatted_address |
Địa chỉ được định dạng bằng ngôn ngữ địa phương. |
place_id |
Mã địa điểm trên Google của địa điểm này. Có thể dùng để tạo URL trên Google Maps hoặc tìm nạp thêm thông tin chi tiết về địa điểm. Hãy tham khảo https://developers.google.com/places/web-service/place-id để xem ví dụ về cách sử dụng. |
ProcessingStatus
Trạng thái xử lý của người bán.
Enum | |
---|---|
PROCESSING_STATUS_UNSPECIFIED |
Trạng thái chưa xác định. |
IN_PROGRESS |
Madden đã nhận được người bán này nhưng vẫn đang xử lý. Người bán ở trạng thái này sẽ không có trạng thái khác được điền. |
COMPLETED |
Chúng tôi đã tính toán các trạng thái khác của người bán. |
WaitlistStatus
Trạng thái liên quan đến việc tích hợp danh sách chờ.
Các trường | |
---|---|
has_valid_waitlist_service |
Đúng nếu người bán có dịch vụ danh sách chờ. Không đảm bảo người bán thực sự được phân phát. |
MoneyRange
Trình bao bọc cho một loạt số tiền có thể bị giới hạn hoặc không bị giới hạn. Bạn phải cung cấp ít nhất một trong hai giá trị min_amount và max_amount.
Các trường | |
---|---|
min_amount |
Số tiền tối thiểu. |
max_amount |
Số tiền tối đa. |
NoShowFee
Một khoản phí mà người dùng có thể phải trả nếu họ đã đặt chỗ nhưng không xuất hiện.
Các trường | |
---|---|
fee |
Số tiền mà người dùng có thể phải trả nếu họ không xuất hiện trong lượt đặt chỗ của mình. |
fee_type |
Xác định cách hệ thống xác định khoản phí dựa trên tình trạng phòng. |
Đặt
Đơn đặt hàng cuộc hẹn dịch vụ với người bán.
Các trường | |
---|---|
name |
Tên tài nguyên của đơn đặt hàng: |
client_information |
Thông tin cá nhân của khách hàng đặt hàng. |
payment_information |
Thông tin về giao dịch thanh toán liên quan đến đơn đặt hàng. |
merchant_id |
Mã nhận dạng người bán sở hữu tất cả dịch vụ trong đơn đặt hàng này. |
item[] |
Mục hàng trong đơn đặt hàng này. |
OrderOnlineMetadata
Siêu dữ liệu của đường liên kết đến thao tác đặt hàng trực tuyến.
Các trường | |
---|---|
fulfillment_option[] |
Các lựa chọn thực hiện đơn hàng có sẵn cho đường liên kết đến hành động trực tuyến cho đơn đặt hàng. |
PaymentInformation
Thông tin thanh toán liên quan đến lượt đặt trước
Các trường | |
---|---|
prepayment_status |
Trạng thái thanh toán trước của lượt đặt trước. Nếu ignore_status là PREPAYMENT_PROVIDED hoặc PREPAYMENT_REFUNDED, thì payment_transaction_id sẽ chứa mã giao dịch duy nhất được liên kết. |
payment_transaction_id |
Giá trị nhận dạng duy nhất của một giao dịch thanh toán liên quan đến lượt đặt phòng đó. Để trống nếu không có. |
PaymentOption
Một phương thức thanh toán để thanh toán cho các dịch vụ do người bán cung cấp. Nhiều người bán có thể dùng chung phương thức thanh toán (ví dụ: những người bán thuộc cùng một chuỗi cửa hàng).
Các trường | |
---|---|
payment_option_id |
Mã này được dùng để xác định lựa chọn thanh toán này. Mã nhận dạng này áp dụng chung cho toàn bộ trang web tổng hợp, và việc sử dụng lại một giá trị cho nhiều người bán sẽ cho phép người dùng thanh toán bằng phương thức thanh toán tương ứng cho những người bán đó. Khi bạn sử dụng lại một mã nhận dạng cho nhiều người bán, việc cập nhật bất kỳ giá trị nào cho một tuỳ chọn thanh toán của một người bán cũng sẽ cập nhật mọi tuỳ chọn thanh toán khác có cùng mã nhận dạng đó ở một người bán khác. Do đó, phương pháp hay nhất là để tất cả lựa chọn thanh toán có cùng một mã nhận dạng và luôn được cập nhật thành các giá trị giống nhau để tránh mọi khả năng xảy ra hành vi suy yếu. |
name |
Tên của tuỳ chọn thanh toán. Người dùng có thể nhìn thấy thông tin này. |
description |
Nội dung mô tả về lựa chọn thanh toán. Người dùng có thể nhìn thấy thông tin này. |
price |
Giá của phương thức thanh toán. |
tax_rate |
Thuế suất cho phương thức thanh toán này. Nếu có, trường này sẽ thay thế trường tax_rate trong Người bán hoặc Dịch vụ. Nếu bạn nhận được thông báo trống (tức là tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
payment_option_type |
Loại của tuỳ chọn thanh toán này. Dùng một lần cho các gói thả xuống, dùng nhiều lần cho các gói và không giới hạn cho gói thành viên. |
session_count |
Số phiên hoạt động mà phương thức thanh toán này có thể được sử dụng. Chỉ hợp lệ cho nhiều phiên / gói, trong đó giá trị phải lớn hơn 1. |
purchase_interval |
Người dùng có thể mua lựa chọn thanh toán trong khoảng thời gian này. |
valid_interval |
Bạn có thể sử dụng tùy chọn thanh toán trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, tuỳ chọn này sẽ ghi đè valid_duration và Activate_type. |
valid_duration |
Thời hạn có hiệu lực của lựa chọn thanh toán (ví dụ: gói thành viên 30 ngày). |
activation_type |
Xác định cách xác định ngày bắt đầu có hiệu lực cho tuỳ chọn thanh toán này. |
user_restriction |
Hạn chế người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để giới hạn phương thức thanh toán khuyến mãi cho một nhóm nhỏ người dùng. Nếu bạn không đặt chính sách này, thì tất cả người dùng đều đủ điều kiện. |
ActivationType
Xác định cách xác định ngày bắt đầu hiệu lực.
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Không sử dụng. |
ACTIVATION_ON_PURCHASE |
Ưu đãi có hiệu lực tại thời điểm mua. |
ACTIVATION_ON_FIRST_USE |
Ưu đãi có hiệu lực kể từ lần đầu tiên người dùng sử dụng lựa chọn thanh toán này. |
PaymentOptionType
Một loại tuỳ chọn thanh toán.
Enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Không sử dụng. |
PAYMENT_OPTION_SINGLE_USE |
Lựa chọn thanh toán chỉ có thể được sử dụng một lần. |
PAYMENT_OPTION_MULTI_USE |
Bạn có thể sử dụng tuỳ chọn thanh toán nếu số phiên của chức năng đó > 0. |
PAYMENT_OPTION_UNLIMITED |
Có thể sử dụng tùy chọn thanh toán trong phạm vi thời gian hợp lệ - không thể áp dụng số phiên. |
PaymentProcessorConfig
Cấu hình cho công ty xử lý thanh toán, được thiết lập theo từng Người bán.
Các trường | |
---|---|
processor |
Xác định đối tác xử lý thanh toán để áp dụng cấu hình này. |
public_key |
Khoá dùng để xác định người bán này với công ty xử lý thanh toán. Đối với Stripe, vui lòng tham khảo: https://stripe.com/docs/dashboard#api-keys Đối với nãotree, hãy tham khảo: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Số phiên bản API được gửi đến công ty xử lý thanh toán cùng với yêu cầu thanh toán. |
Bộ xử lý
Xác định một đối tác xử lý thanh toán cụ thể.
Enum | |
---|---|
PROCESSOR_UNSPECIFIED |
Không sử dụng |
PROCESSOR_STRIPE |
Cấu hình của các khoản thanh toán bằng Stripe. |
PROCESSOR_BRAINTREE |
Cấu hình của các khoản thanh toán bằng Hearttree. |
PaymentRestrictions
Các quy định hạn chế đối với các phương thức thanh toán mà người bán này chấp nhận.
Các trường | |
---|---|
credit_card_restrictions |
Các hạn chế đối với thẻ tín dụng mà người bán này chấp nhận. Chúng tôi giả định rằng tất cả thẻ tín dụng đều được chấp nhận nếu bạn không đặt trường này. Xin lưu ý rằng danh sách thẻ mà CreditCardType hỗ trợ sẽ tăng lên theo thời gian, nghĩa là việc để lại cấu hình cho các đối tượng trống này sẽ dẫn đến những thay đổi trong tương lai. |
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é.
Các trường | |
---|---|
delivery_fee |
Phí có thể thay đổi tùy theo phương thức phân phối. |
processing_fee |
Phí xử lý phương thức thanh toán của người dùng. |
PerTicketFee
Phí phải trả cho mỗi vé mà người dùng mua.
Các trường | |
---|---|
service_charge |
Thu phí bổ sung cho một dịch vụ. |
facility_fee |
Một khoản phí đi đến địa điểm/cơ sở y tế. |
taxes |
Thuế mỗi vé. |
PostalAddress
Địa chỉ của khách hàng hoặc doanh nghiệp.
Các trường | |
---|---|
address_country |
Quốc gia được chỉ định bằng mã quốc gia theo ISO 3166-1 alpha-2, ví dụ: "US" (bắt buộc) |
address_locality |
Địa phương, ví dụ: " Mountain View". (bắt buộc) |
address_region |
Khu vực, ví dụ: "CA". Trường này chỉ bắt buộc ở các quốc gia nơi khu vực thường là một phần của địa chỉ. (không bắt buộc) |
postal_code |
Mã bưu chính, ví dụ: "94043". (bắt buộc) |
street_address |
Địa chỉ đường phố, ví dụ: "1600 Amphitheatre Pkwy". (bắt buộc) |
PrepaymentStatus
Trạng thái thanh toán trước của một lượt đặt trước.
Enum | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
Chưa được chỉ định, mặc định là PREPAYMENT_NOT_PROVIDED. |
PREPAYMENT_PROVIDED |
Phí đặt vé đã được thanh toán trước. |
PREPAYMENT_NOT_PROVIDED |
Phí đặt vé chưa được thanh toán trước. |
PREPAYMENT_REFUNDED |
Phí trước đây là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại. |
Giá
Giá của một dịch vụ hoặc một khoản phí.
Các trường | |
---|---|
price_micros |
Giá tính theo đơn vị một phần triệu của tiền tệ. Các phân số của đơn vị tiền tệ nhỏ nhất sẽ được làm tròn bằng cách làm tròn số chẵn gần nhất. (Ví dụ: 2,5 xu làm tròn thành 2 xu, 3,5 xu làm tròn thành 4 xu, 0,5 xu làm tròn thành 0 xu, 2,51 xu làm tròn thành 3 xu). |
currency_code |
Đơn vị tiền tệ của giá tiền được xác định trong ISO 4217. |
pricing_option_tag |
Một chuỗi không bắt buộc và không rõ ràng giúp xác định lựa chọn đặt giá liên kết với giá mở rộng. |
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 |
PriceType
Xác định cách xác định tổng giá từ tình trạng còn hàng.
Enum | |
---|---|
FIXED_RATE_DEFAULT |
Giá dành cho một số tiền cố định. Đây là giá trị mặc định nếu bạn không đặt trường này. Ví dụ: Đặt bàn $50 để đặt bàn; không cần đặt bàn là $20 khi đăng ký lớp yoga |
PER_PERSON |
Giá được chỉ định là giá cho mỗi người, và tổng giá được tính theo số người được chỉ định trong phần Tài nguyên dưới dạng price_micros * Party_size. Giá Per_PERSON phải đi kèm với quy mô bữa tiệc trong các tài nguyên về tình trạng rảnh/bận. Nếu không, nhóm sẽ sử dụng một nhóm. Ví dụ: 10 USD mỗi vé vào bảo tàng |
QuantitativeValue
Trình bao bọc cho một giá trị số có thể là một dải ô hoặc một giá trị cố định. Ví dụ về QuantitativeValue
: * Giá trị số ít: value: 10.5
* Giới hạn trên: value_range {min_value: 5.5, max_value 10.5}
* Giới hạn dưới: value_range {min_value: 5.5}
* Giới hạn trên: value_range {max_value: 10.5}
Các trường | |
---|---|
Trường nhóm value_options . (bắt buộc) value_options chỉ có thể là một trong các trạng thái sau: |
|
value |
Giá trị số ít. Ví dụ: 5,6 |
value_range |
Một dải giá trị cũng có thể là giá trị mở hoặc bị giới hạn. Ví dụ: * Tối thiểu là 5,5 * Tối đa 5,5 * 5,5 đến 6,5 |
RangeValue
Phạm vi giá trị sao cho min_value
< max_value
. Cần có ít nhất một trong số min_value
và max_value
.
Các trường | |
---|---|
min_value |
Giá trị nhỏ nhất. |
max_value |
Giá trị tối đa. |
Rating
Xác định Xếp hạng cho một thực thể.
Các trường | |
---|---|
value |
Giá trị điểm xếp hạng trung bình (bắt buộc khi số_xếp_hạng > 0). Giá trị phải nằm trong khoảng [1, 5] và có thể bỏ qua khi và chỉ khi số_xếp_hạng bằng 0. |
number_of_ratings |
Số lượng điểm xếp hạng được dùng để tính giá trị (bắt buộc). |
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)
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. |
localized_caption |
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 ưu tiên sử dụng local_caption. |
Phân bổ
Thông tin thuộc tính cho nội dung nghe nhìn này.
Các trường | |
---|---|
localized_text |
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, muốn sử dụng local_text. |
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. |
ReplaceServiceAvailabilityRequest
Yêu cầu thay thế tình trạng rảnh/bận của Service
.
Các trường | |
---|---|
service_availability |
Khả năng cung cấp dịch vụ được dùng để thay thế các dịch vụ hiện có. |
RequireCreditCard
Xác định xem người dùng có cần thẻ tín dụng để đặt lịch hẹn hay không.
Enum | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
Yêu cầu thẻ tín dụng không được chỉ định rõ ràng và hành vi giống hệt với hành vi được chỉ định cho điều kiện điều kiện. |
REQUIRE_CREDIT_CARD_CONDITIONAL |
Google sẽ yêu cầu thẻ tín dụng để đặt chỗ nếu bất kỳ điều kiện nào sau đây được đáp ứng: * tình trạng còn phòng có giá và phương thức thanh toán trước_type là REQUIRED * thiết lập no_show_fee * trường đặt cọc tiền. |
REQUIRE_CREDIT_CARD_ALWAYS |
Khách hàng luôn phải có thẻ tín dụng để đặt trước tình trạng còn hàng này bất kể các giá trị khác của trường. |
Tài nguyên
Tài nguyên được dùng để phân biệt các khung giờ còn trống với nhau khi các phòng hoặc nhân viên khác nhau sử dụng dịch vụ. Nhiều vị trí cho cùng một dịch vụ và khoảng thời gian có thể cùng tồn tại khi chúng có các tài nguyên khác nhau.
Các trường | |
---|---|
staff_id |
Mã nhận dạng không bắt buộc của một nhân viên cung cấp dịch vụ. Trường này xác định nhân viên trên tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Thông tin này cũng cần phải ổn định theo thời gian để có thể tạo mối tương quan với các lượt đặt phòng trước đây. Trường này phải xuất hiện nếu có Staff_name. |
staff_name |
Tên không bắt buộc của một nhân viên cung cấp dịch vụ. Trường này sẽ hiển thị cho những người dùng đang đặt chỗ và phải có thể đọc được chứ không phải là giá trị nhận dạng không rõ ràng. Bạn phải cung cấp trường này nếu có Staff_id. |
room_id |
Mã không bắt buộc của phòng có dịch vụ. Trường này xác định phòng trên tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Thông tin này cũng cần phải ổn định theo thời gian để có thể tạo mối tương quan với các lượt đặt phòng trước đây. Trường này phải xuất hiện nếu có room_name. |
room_name |
Tên không bắt buộc cho phòng có dịch vụ. Trường này sẽ hiển thị cho những người dùng đang đặt chỗ và phải có thể đọc được chứ không phải là giá trị nhận dạng không rõ ràng. (không bắt buộc nhưng bắt buộc nếu có room_id) Trong nhà hàng, tên phòng chỉ nên dùng cho khu vực ghế ngồi như quầy bar hoặc sân hiên và không nên sử dụng cho thực đơn có giá cố định, hoạt động đặc biệt hoặc bất kỳ giá trị nào khác không phải là phòng (chẳng hạn như đặt chỗ hoặc ăn tối). Bạn không nên liên kết với khu vực ghế ngồi mặc định. |
party_size |
Chỉ áp dụng cho bữa tối: Quy mô bữa tiệc có thể được phục vụ trong khung giờ này. Một nhà hàng có thể được liên kết với nhiều Slots cùng một lúc, mỗi khung giờ chỉ định một Party_size khác nhau, nếu chẳng hạn 2, 3 hoặc 4 người có thể đặt chỗ. |
SchedulingRules
Quy tắc lên lịch cho một dịch vụ.
Các trường | |
---|---|
min_advance_online_canceling |
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) |
late_cancellation_fee |
Phí huỷ trong khoảng thời gian thông báo trước tối thiểu. |
noshow_fee |
Phí không đến mà không huỷ. |
admission_policy |
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) |
cancellation_policy |
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ụ:
|
|
min_advance_booking |
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. |
min_booking_buffer_before_end_time |
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 "admission_policy" thành TIME_FLEXIBLE để cho biết 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. |
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.
Các trường | |
---|---|
name |
Tên tài nguyên dịch vụ có định dạng |
service_name |
Tên của dịch vụ, ví dụ: "Cắt tóc nam". Không dùng nữa, hãy chuyển sang sử dụng locale_service_name. |
localized_service_name |
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. Không dùng nữa, chuyển sang sử dụng local_description. |
localized_description |
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ụ. |
price_interpretation |
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. |
prepayment_type |
Liệu thanh toán trước là bắt buộc, tuỳ chọn hay không được hỗ trợ. |
prepayment_terms |
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 intake_form và per_ticket_intake_form. |
intake_form |
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) |
per_ticket_intake_form |
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) |
tax_rate |
Thuế suất của dịch vụ. Nếu có trường này, 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à tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
payment_option_id[] |
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) |
no_show_fee |
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) |
require_credit_card |
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) |
action_link[] |
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) |
ticket_type[] |
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) |
related_media[] |
Ả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) |
service_attribute_value_id[] |
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) |
waitlist_rules |
Quy tắc tham gia danh sách chờ. |
ticketing_vertical_specific_data |
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) |
integration_type |
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. |
per_order_fee |
Phí ở cấp đơn đặt hàng để mua dịch vụ này. (không bắt buộc) |
tours_and_activities_content |
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á. |
home_service_data |
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) |
virtual_session |
Không bắt buộc. Thông tin về phiên ảo. Cần có để bật các dịch vụ ảo. |
direct_merchant_payment |
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. Bắt buộc phải có nếu virtual_session được xác định và dịch vụ không miễn phí hoặcforeground_type KHÔNG được đặt thành REQUIRED. |
PrepaymentTerms
Thông tin cụ thể về thời điểm hoàn tất khoản trả trước.
Các trường | |
---|---|
charge_timing |
Thời điểm tính phí tương ứng với thời gian mua hàng. |
charge_time_before_start_time_sec |
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. |
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. |
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. |
ServiceAttribute
Thuộc tính dịch vụ là danh mục do đối tác xác định, mô tả các Dịch vụ cho Người bán. Ví dụ: ngân hàng có thể xác định thuộc tính dịch vụ "Loại tài khoản" với các giá trị có thể là "Cá nhân" và "Doanh nghiệp", trong khi tiệm làm tóc có thể xác định thuộc tính dịch vụ "Loại dịch vụ" với các giá trị có thể là "Cắt tóc", "Màu sắc" và "Kiểu".
Các trường | |
---|---|
attribute_id |
Giá trị nhận dạng giúp xác định duy nhất thuộc tính dịch vụ này trong số các thuộc tính khác của cùng một người bán, ví dụ như "loại tài khoản". |
attribute_name |
Tên hiển thị cho người dùng cho thuộc tính này, ví dụ: "Loại tài khoản". |
value[] |
Tất cả các giá trị có thể sử dụng cho thuộc tính dịch vụ này. |
Giá trị
Biểu thị một giá trị có thể có cho một thuộc tính cụ thể của dịch vụ.
Các trường | |
---|---|
value_id |
Một giá trị nhận dạng giúp xác định duy nhất giá trị này trong số các giá trị khác cho thuộc tính dịch vụ này, ví dụ như "cá nhân". |
value_name |
Tên mà người dùng nhìn thấy cho giá trị, ví dụ: "Cá nhân". |
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ụ.
Các trường | |
---|---|
attribute_id |
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". |
value_id |
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 value_id trong định nghĩa thuộc tính dịch vụ. |
ServiceAvailability
Danh sách tình trạng rảnh/bận và người/thời điểm áp dụng.
Các trường | |
---|---|
name |
Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo định dạng |
start_time_restrict |
Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Tình trạng còn hàng là bản tổng quan nhanh hoàn chỉnh từ ngày [start_time_restrict, end_time_restrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau:
Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:
Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế hơn nữa:
Các trường này thường dùng để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định. Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict. |
end_time_restrict |
Việc đặt end_time_restrict trong khi không đặt start_time_restrict sẽ có nghĩa là tất cả thời gian đã đạt đến end_time_restrict. |
duration_restrict |
Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp. |
resources_restrict |
Việc đặt tài nguyên_hạn chế sẽ giới hạn hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác. |
availability[] |
Danh sách tình trạng rảnh/bận mới. |
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.
Các trường | |
---|---|
field[] |
Các trường mà người dùng sẽ thấy. |
first_time_customers |
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. |
returning_customers |
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.
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 |
localized_label |
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 "location_id" trong trường "location" để chỉ định giá trị vị trí. |
choice_text[] |
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ó. |
is_required |
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. |
allow_custom_answer |
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) |
additional_option[] |
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) |
ticket_type_restrict[] |
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. |
TaxRate
Thuế suất được áp dụng khi tính phí người dùng cho một dịch vụ và có thể đặt theo từng người bán hoặc theo dịch vụ.
Các trường | |
---|---|
micro_percent |
Thuế suất tính bằng phần triệu của 1 phần trăm, cho ra 6 số thập phân chính xác. Ví dụ: nếu thuế suất là 7, 253%, bạn phải đặt trường này thành 7253000. Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được giả định là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế đánh giá theo thuế suất cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phân số của 1 xu) sẽ được làm tròn bằng cách làm tròn chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. |
Thuật ngữ
Một bộ quy tắc và nguyên tắc mà người dùng nhìn thấy để đặt trước thông qua tính năng Đặt chỗ với Google.
Các trường | |
---|---|
url |
URL dẫn đến Điều khoản và điều kiện (không bắt buộc). |
text |
Văn bản mà người dùng nhìn thấy. Sử dụng bản địa hoá_văn bản bên dưới để tích hợp mới. |
localized_text |
Văn bản đã bản địa hoá mà người dùng sẽ thấy. |
Văn bản
Tải trọng văn bản có thể được bản địa hoá. Một số trường Văn bản có thể chứa nội dung được đánh dấu.
Các trường | |
---|---|
value |
Giá trị văn bản bằng ngôn ngữ không xác định. Bắt buộc khi và chỉ khi |
localized_value[] |
Giá trị văn bản theo từng ngôn ngữ. Không bắt buộc. |
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.
Các trường | |
---|---|
ticket_type_id |
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ụ. |
short_description |
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. Không dùng nữa, chuyển sang sử dụng local_short_description. |
localized_short_description |
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ụ đó. |
per_ticket_fee |
Các khoản phí bổ sung khi mua vé này. (không bắt buộc) |
option_description |
Nội dung mô tả về mọi lựa chọn bổ sung thuộc loại vé này, nếu có. Ngừng sử dụng, chuyển sang sử dụng local_option_description. |
localized_option_description |
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: một vé vào cửa có nhiều loại "người lớn", "trẻ em" và ngôn ngữ là một lựa chọn bổ sung, thì danh sách vé xem được chấp nhận là: {vé_type_id} "của vé_type_1" local_short_description {value: "adult" } local_options_description { value: "english_type_2" được bản địa hoá} - {vé_type_id} được bản địa hoá theo giá trị "vé_type_2" được bản địa hoá} {select_description_price_price}: " hết_4.0.3_._._ 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 có trường này được đặt (có thể sử dụng options_description 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à |
TicketingVerticalSpecificData
Thông tin bổ sung dành riêng cho ngành dọc bán vé sự kiện.
Các trường | |
---|---|
event_category |
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) |
event_url |
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) |
event_attendance_mode |
Bắt buộc. Loại sự kiện tham dự sự kiện. |
event_virtual_location_url[] |
Không bắt buộc. URL nơi có thể xem sự kiện. |
event_organizer |
Không bắt buộc. Người tổ chức sự kiện. |
event_organizer_url |
Không bắt buộc. URL của người tổ chức sự kiện. |
event_organizer_type |
Không bắt buộc. Loại người tổ chức. |
event_source_url[] |
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. |
event_state |
Không bắt buộc. Trạng thái của sự kiện. |
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. |
Thực thể
Đại diện cho một thực thể có liên quan đến sự kiện đó.
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 web của đối tác trên trang web của đối tác (nếu có). Đối với các URL công khai khác của thực thể, hãy sử dụng relevant_url trong public_identification_data. (không bắt buộc) |
entity_type |
Loại thực thể. (không bắt buộc) |
entity_role |
Vai trò của thực thể trong sự kiện. (không bắt buộc) |
public_identification_data |
Nguồn tham khảo công khai của thực thể. (không bắt buộc) |
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). |
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. |
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. |
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. |
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. |
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ể.
Các trường | |
---|---|
relevant_url[] |
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) |
musicbrainz_id |
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) |
TimeRange
Phạm vi thời gian đóng, tức là [thời_gian_bắt_đầu, thời_gian_kết_thúc).
Các trường | |
---|---|
start_time |
Giới hạn dưới của phạm vi thời gian. |
end_time |
Giới hạn trên của phạm vi thời gian. |
TokenizationConfig
Cấu hình để mã hoá đơn vị xử lý thanh toán, thiết lập trên cơ sở từng Người bán.
Các trường | |
---|---|
tokenization_parameter |
Cấu hình mã hoá thường sẽ có một tokenization_parameter có khoá là "gateway" và giá trị là tên của bộ xử lý. Các thông số còn lại phụ thuộc vào bộ xử lý. Hãy xem tài liệu của Google Pay để biết thêm thông tin. Ví dụ: tokenization_parameter { key: "gateway" giá trị: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" giá trị: "abc_defparameter key: "braintree:merchantId" giá trị: "abc_defparameter" } Ví dụ về Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" giá trị: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" giá trị: "pk_1234" } Ví dụ về Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" } |
billing_information_format |
Cung cấp thông tin thanh toán của người dùng khi đã nhập thông tin thanh toán vào Google Pay bằng phương thức FOP của họ vào mã thanh toán (xem ở trên). Để trống trường này tương đương với việc chỉ định MIN. |
BillingInformationFormat
Số lượng Địa chỉ thanh toán cần yêu cầu ở người dùng và thêm vào mã thông báo. Các giá trị enum tương ứng với các thông số trong API Google Pay (xem https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Chưa xác định. Giá trị mặc định là MIN. |
MIN |
tên, mã quốc gia và mã bưu chính (chế độ cài đặt mặc định của Google Pay). |
FULL |
tên, địa chỉ đường phố, địa phương, khu vực, mã quốc gia và mã bưu chính. |
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.
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. |
must_know[] |
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. |
UnsupportedPartySizeOption
Tuỳ chọn cho các nhóm nằm ngoài phạm vi.
Các trường | |
---|---|
call_merchant |
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ẽ được hiển thị: "Đối với các bữa tiệc có nhiều hơn {waitlist_rules.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. |
UpdateBookingRequest
Yêu cầu cập nhật một google.maps.booking.v1alpha.Booking
Các trường | |
---|---|
update_mask |
Mặt nạ cho trường (field mask) của tất cả các trường đặt lịch hẹn sẽ được cập nhật |
booking |
Lượt đặt chỗ cần được cập nhật |
booking_failure |
Nếu yêu cầu đặt vé đã được xác nhận không đồng bộ và trạng thái của lượt đặt phòng đó đang được cập nhật thành KHÔNG THÀNH CÔNG, trường này sẽ phản ánh lỗi logic kinh doanh (ví dụ: người dùng hiện có một yêu cầu đặt chỗ quá gần với thời điểm này). Bạn chỉ nên đặt trường này khi cập nhật trạng thái đặt phòng thành FAILED và sẽ bị bỏ qua nếu không cập nhật. |
UpdateMerchantRequest
Yêu cầu cập nhật một Merchant
.
Các trường | |
---|---|
merchant |
Dữ liệu mới của người bán. |
update_mask |
Các trường cụ thể cần cập nhật cho người bán. |
UpdateOrderRequest
Yêu cầu cập nhật một google.maps.booking.v1alpha.Order
Các trường | |
---|---|
update_mask |
Mặt nạ trường (field mask) của tất cả các trường trong đơn đặt hàng cần được cập nhật |
order |
Đơn đặt hàng cần được cập nhật |
UpdateServiceRequest
Yêu cầu cập nhật một Service
.
Các trường | |
---|---|
service |
Dữ liệu dịch vụ mới. |
update_mask |
Các trường cụ thể cần cập nhật cho dịch vụ. |
UserPurchaseRestriction
Hạn chế người dùng đủ điều kiện mua phương thức thanh toán.
Các trường | |
---|---|
new_to_merchant |
Đây là phương thức thanh toán chỉ dành cho những người dùng chưa từng mua hàng của cùng một người bán. |
new_to_payment_option |
Một lựa chọn thanh toán chỉ dành cho những người dùng chưa từng mua loại hình thanh toán này trước đây. |
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.
Các trường | |
---|---|
session_instructions |
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) |
session_requirements |
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) |
virtual_platform_info |
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) |
is_session_prerecorded |
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.
Các trường | |
---|---|
platform |
Nền tảng dùng cho phiên ảo. |
other_platform_name |
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. |
WaitlistRules
Quy tắc liên quan đến việc tham gia danh sách chờ.
Các trường | |
---|---|
min_party_size |
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. |
max_party_size |
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. |
supports_additional_request |
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. |
above_max_party_size_options[] |
Đặt tuỳ chọn cho các nhóm có quy mô lớn hơn giá trị max_party_size đã đặt. 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. |