Package google.maps.booking.v1alpha

Chỉ mục

AdsAccountLinkingService

Dịch vụ quản lý việc liên kết tài khoản giữa Google Ads và Trung tâm đối tác.

BookingNotification

Nhận thông báo về cuộc hẹn từ các đối tác lập 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 triển khai các RPC dựa trên việc đặt chỗ (chẳng hạn như CreateBooking và CheckAvailability) hay các RPC dựa trên đơn đặt hàng (chẳng hạn như CreateOrder và CheckOrderFulfillability).

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

Cập nhật Booking hiện có.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

Cập nhật Order hiện có.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

Nguồn cấp dữ liệu

Truy xuất trạng thái xử lý của nguồn cấp dữ liệu do các đối tác tập hợp bên ngoài tải lên.

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Truy xuất Status của một nguồn cấp dữ liệu đã tải lên trước đó theo trình tổng hợp được chỉ định và trả về nguồn cấp dữ liệu đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

Truy xuất Status của nhiều nguồn cấp dữ liệu về người bán, dịch vụ hoặc tình trạng còn hàng đã được tải lên trước đó theo đơn vị tổng hợp được chỉ định và trả về các nguồn cấp dữ liệu đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

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

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

Làm mất hiệu lực một tài nguyên hiện có.

Yêu cầu sẽ bị bỏ qua nếu tài nguyên được yêu cầu không đăng ký dịch vụ của Google.

Các loại tài nguyên được hỗ trợ: – Nhận tại cửa hàng

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

Truy xuất kho hàng và trạng thái trùng khớp của những người bán đã tải lên.

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Nhận MerchantStatus của Merchant.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

Liệt kê tất cả MerchantStatus của một đối tác đáp ứng các điều kiện lọc.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

Nhận thông tin cập nhật về khoảng không quảng cáo từ các đơn vị tập hợp bên ngoài.

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

Xoá các bản ghi thuộc loại nguồn cấp dữ liệu đã chỉ định. Chỉ thực hiện xác thực cơ bản (chẳng hạn như yêu cầu không đúng định dạng), sau đó trả về ngay phản hồi thích hợp cho đối tác. Google thực hiện quy trình xác thực logic nghiệp vụ đối với yêu cầu một cách không đồng bộ. Lệnh gọi hàng loạt này không đảm bảo tính nguyên tử.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

Chèn và/hoặc cập nhật các 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 (chẳng hạn như yêu cầu không đúng định dạng), sau đó trả về ngay phản hồi thích hợp cho đối tác. Google thực hiện quy trình xác thực logic nghiệp vụ đối với yêu cầu một cách không đồng bộ. Lệnh gọi hàng loạt này không đảm bảo tính nguyên tử.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

Thay thế Availability của Services hiện có. Lệnh gọi hàng loạt này không đảm bảo tính nguyên tử. Hệ thống sẽ chỉ trả về những khung giờ có thể đặt lịch hẹn đã được cập nhật thành công.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

Tạo một Merchant mới do trình tổng hợp đã chỉ định quản lý và trả về Merchant đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService(CreateServiceRequest) returns (Service)

Tạo một Service mới của người bán do đơn vị tập hợp đã chỉ định quản lý và trả về Service đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

Xoá một Merchant hiện có do trình tổng hợp được chỉ định quản lý. Tất cả dịch vụ và tình trạng còn hàng của người bán cũng sẽ bị tắt. Nếu bạn thêm lại người bán sau này, thì cùng một nhóm dịch vụ và khung giờ còn trống sẽ xuất hiện.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Empty)

Xoá Service hiện có của một người bán do đơn vị tổng hợp được chỉ định quản lý. Tất cả thông tin về phạm vi cung cấp dịch vụ cũng sẽ bị xoá.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

Thay thế Availability của Service hiện có của một người bán do trình tổng hợp đã chỉ định quản lý và trả về Service đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

Cập nhật Merchant hiện có do trình tổng hợp đã chỉ định quản lý và trả về Merchant đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Service)

Cập nhật Service hiện có của một người bán do trình tổng hợp được chỉ định quản lý và trả về Service đó.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

Loại hành động được xác định trước liên kết với một đường liên kết hành động.

Enum

EventMetadata

Thông tin bổ sung về đường liên kết hành động, chỉ có trong danh mục dọc sự kiện.

Trường
surface

Surface

Bề mặt sự kiện được xác định trước liên kết với một đường liên kết hành động. Thuộc tính này chỉ được dùng cho ngành dọc Sự kiện.

Bề mặt

Bề mặt sự kiện được xác định trước liên kết với một đường liên kết hành động. Thuộc tính này chỉ được dùng cho ngành dọc Sự kiện.

Enum
SURFACE_UNSPECIFIED Bề mặt chưa được chỉ định.
SURFACE_YOUTUBE Đường liên kết hành động là đặt vé xem sự kiện trên YouTube.
SURFACE_ADS Đường liên kết hành động là đường liên kết để nhấp vào quảng cáo cho sự kiện.

ActionPlatform

Nền tảng mà hành động được thực hiện. Ứng dụng web là giải pháp dự phòng chung. Bạn nên có ít nhất một ActionLink có ACTION_PLATFORM_WEB_APPLICATION. Đường liên kết có Android và iOS làm nền tảng chỉ được dùng trên hệ thống tương ứng.

Enum
ACTION_PLATFORM_UNSPECIFIED Nền tảng không được chỉ định.
ACTION_PLATFORM_WEB_APPLICATION Nền tảng hành động thường 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.

Tiểu bang

Trạng thái của mối liên kết với tài khoản Google Ads.

Enum
STATE_UNSPECIFIED Trạng thái không xác định.
LINKED Tài khoản được liên kết giữa Trung tâm đối tác và Cổng thông tin Google Ads.
PENDING Tài khoản đang chờ phê duyệt trên Trung tâm đối tác hoặc Cổng thông tin Google Ads.
DELETED Đã xoá mối liên kết tài khoản.
REJECTED Yêu cầu liên kết tài khoản bị Trung tâm đối tác hoặc Cổng thông tin Google Ads từ chối.

Lời khuyên

Những lời khuyên được hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google.

Trường
text

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 cung cấp

Một khung giờ còn trống của dịch vụ do người bán cung cấp, cho biết thời gian và số lượng vị trí.

Trường
start_time

Timestamp

Thời gian bắt đầu của khung giờ nhận đặt hẹn.
duration

Duration

Thời lượng của khung giờ nhận đặt hẹn
spots_total

int64

Tổng số và số lượng chỗ còn trống của tình trạng còn hàng này. Ví dụ:

  • Lớp học yoga có 10 chỗ và 3 chỗ đã được đặt: availability {spots_total: 10, spots_open: 7 ...}
  • Phiên mát xa trên ghế đã được đặt hết chỗ: availability {spots_total: 1, spots_open: 0 ...}

Lưu ý: Nếu gửi yêu cầu bằng định dạng nén tình trạng còn hàng được xác định bên dưới, thì hai trường này sẽ được suy luận.

  • Sự kiện lặp lại ngụ ý spots_total=1 và spots_open=1.
  • ScheduleException ngụ ý spots_total=1 và spots_open=0.
spots_open

int64

Số lượng chỗ trống.
availability_tag

string

Một chuỗi không công khai không bắt buộc để xác định khung giờ trống này. Nếu được đặt, mã này sẽ được đưa vào các yêu cầu đặt/cập nhật/huỷ cuộc hẹn.
resources

Resources

Tài nguyên không bắt buộc được dùng để phân biệt khung giờ có thể đặt này với các khung giờ khác khi có nhiều nhân viên hoặc phòng tham gia vào dịch vụ.

Ví dụ: cùng một lớp Yoga có 2 người hướng dẫn:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_option_id[]

string

Danh sách mã nhận dạng tham chiếu đến các lựa chọn thanh toán có thể dùng để thanh toán cho khung giờ này. Các lựa chọn thanh toán thực tế được xác định ở cấp Người bán và cũng có thể được chia sẻ 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 bắt buộc phải có trong thông báo dịch vụ, mặc dù bạn phải xác định ở cấp Người bán.
recurrence

Recurrence

Thông tin định kỳ về lịch rảnh, thể hiện nhiều thời gian bắt đầu. Một sự kiện định kỳ phải chứa các cuộc hẹn cho một ngày làm việc.
schedule_exception[]

ScheduleException

Thời gian không thể lên lịch cho dịch vụ này. Để hạn chế số lượng thông báo schedule_exception, hãy cân nhắc việc kết hợp các trường hợp ngoại lệ liền kề.
deposit

Deposit

Khoản tiền đặt cọc không bắt buộc cho lịch sử có thể đặt này. Ghi đè khoản tiền đặt cọc dịch vụ nếu bạn đã chỉ định một khoản tiền.
no_show_fee

NoShowFee

Phí không xuất hiện không bắt buộc đối với khoảng trống này. Ghi đè phí vắng mặt của dịch vụ nếu bạn đã chỉ định một khoản phí.
prepayment

Prepayment

Không bắt buộc. Thông tin thanh toán trước không bắt buộc cho tình trạng phòng trống này.
require_credit_card

RequireCreditCard

Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt chỗ cho khung giờ này hay không. Nếu bạn không đặt giá trị này, thì giá trị này sẽ được kế thừa từ cấp dịch vụ nếu bạn đặt giá trị đó ở cấp dịch vụ. (không bắt buộc)
ticket_type_id[]

string

Cho biết danh sách các loại vé được hỗ trợ cho khung giờ có thể đặt này. Nếu bạn không đặt giá trị này, tất cả các loại vé trong dịch vụ mẹ đều có sẵn cho khung giờ này. Xin 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ụ:

  • Dịch vụ có 4 loại vé: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

Để thể hiện khoảng không quảng cáo trong các ngày trong tuần: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Để thể hiện khoảng không quảng cáo trong dịp lễ, hãy làm như sau: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

  • Dịch vụ có 3 loại vé: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

Để cho biết cả 3 loại vé đều có sẵn cho khung giờ này, hãy sử dụng availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} hoặc "availability {...}' (không đặt ticket_type_id trong khung giờ này).

(không bắt buộc)
duration_requirement

DurationRequirement

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 không có khe cắm. Không được dùng trong danh mục Việc cần làm. (không bắt buộc)
scheduling_rule_overrides

SchedulingRuleOverrides

Quy tắc lập lịch về tình trạng còn hàng. Nếu được điền sẵn, các trường này sẽ ghi đè mọi quy tắc lập lịch tương ứng trên SchedulingRules ở cấp dịch vụ.
confirmation_mode

ConfirmationMode

Chế độ xác nhận sẽ được dùng khi đặt lịch hẹn này. Bạn phải xác nhận hoặc từ chối ngay các yêu cầu tạo lượt đặt trước cho những khoảng thời gian có chế độ xác nhận là CONFIRMATION_MODE_SYNCHRONOUS. Các yêu cầu tạo lượt đặt cho những khoảng thời gian còn trống có chế độ xác nhận là CONFIRMATION_MODE_ASYNCHRONOUS phải bị từ chối ngay lập tức hoặc được tạo ở trạng thái ĐANG CHỜ XỬ LÝ.
linkout_required_reason

LinkoutRequiredReason

Không bắt buộc. Lý do bạn phải có đường liên kết bên ngoài cho vị trí này. Nếu được đặt, Tài nguyên người bán cho vị trí này phải có một LinkoutTemplate hợp lệ. (không bắt buộc)

ConfirmationMode

Các chế độ xác nhận được dùng khi đặt chỗ.

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 Các lượt đặt phòng cho khoảng thời gian này sẽ được xác nhận đồng bộ.
CONFIRMATION_MODE_ASYNCHRONOUS Các yêu cầu đặt phòng cho lịch trố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 mà người dùng cần xác nhận hoặc xem thời lượng/thời gian kết thúc của các khung giờ được yêu cầu.

Enum
DURATION_REQUIREMENT_UNSPECIFIED Bạn chưa chỉ định cách xử lý thời gian kết thúc. Đây là tuỳ chọn mặc định.
DO_NOT_SHOW_DURATION Người dùng sẽ không thấy thời gian kết thúc.
MUST_SHOW_DURATION Người dùng phải nhìn thấy thời gian kết thúc trước khi có thể đặt lịch hẹn.

LinkoutRequiredReason

Lý do một vị trí có trải nghiệm liên kết bên ngoài.

Enum
LINKOUT_REQUIRED_REASON_UNSPECIFIED Giá trị mặc định: Không sử dụng, tương đương với không xác định.
PAYMENT_REQUIRED Bạn phải thanh toán trong nền tảng của đối tác để đặt được khung giờ.

Tần suất

Thông báo định kỳ là không bắt buộc, nhưng cho phép thể hiện các khung giờ có sẵn lặp lại liên tục một cách gọn gàng hơn. Chúng thường đại diện cho lịch làm việc trong ngày. Sau đó, các thông báo ScheduleException được dùng để biểu thị các khoảng thời gian đã đặt trước/không có sẵn trong ngày làm việc.

Yêu cầu:

  1. Việc mở rộng các khung giờ hoặc tần suất có sẵn KHÔNG ĐƯỢC tạo ra các khung giờ giống hệt nhau. Nếu mã nhận dạng, start_time, duration và resources trùng khớp, thì các khoảng thời gian được coi là giống hệt nhau.
  2. KHÔNG kết hợp định dạng lịch rảnh tiêu chuẩn và định dạng lịch rảnh định kỳ trong các khung giờ của một dịch vụ. Lợi ích của tính năng định kỳ đối với những người bán/dịch vụ cung cấp cuộc hẹn. Định dạng tiêu chuẩn này dành cho những người bán/dịch vụ có các lớp học được lên lịch thường xuyên.
  3. Sự kiện định kỳ không được kéo dài quá 24 giờ.
Trường
repeat_until

Timestamp

Dấu thời gian UTC tối đa (bao gồm) mà lịch có thể lặp lại cho đến.
repeat_every

Duration

Xác định khoảng thời gian giữa các khung giờ trống liên tiếp.

Ví dụ: Lịch trống có thời lượng 20 phút, repeat_every là 30 phút, thời gian bắt đầu là 9:00 và repeat_until là 11:00 sẽ tạo ra các khung giờ từ 9:00 đến 9:20, 9:30 đến 9:50, 10:00 đến 10:20, 10:30 đến 10:50, 11:00 đến 11:20. (bắt buộc)

ScheduleException

Thông báo ScheduleException biểu thị các khoảng thời gian đã đặt/không có sẵn trong ngày làm việc, đây là những trường hợp ngoại lệ đối với mẫu định kỳ được mô tả ở trên. Khi các khung giờ được đặt, bạn nên cập nhật danh sách ngoại lệ để phản ánh các khoảng thời gian mới không còn trống. Bạn không nên sửa đổi tần suất.

Trường
time_range

TimeRange

Khoảng thời gian xảy ra ngoại lệ. Mọi khung giờ được mô tả bằng quy tắc định kỳ trùng với khoảng thời gian bán mở này sẽ được coi là không có sẵn.

Ví dụ: Nếu quy tắc định kỳ chỉ định khoảng thời gian là 20 phút, repeat_every là 30 phút, start_time là 9:00 và repeat_until là 11:00, thì ScheduleException có time_range là 9:45 – 11:00 sẽ khiến các khung giờ 9:30 – 9:50, 10:00 – 10:20 và 10:30 – 10:50 không có sẵn.

Xin lưu ý rằng vì phạm vi thời gian là phạm vi nửa kín nửa mở, nên khung giờ bắt đầu từ 11 giờ sáng sẽ không bị ảnh hưởng.

SchedulingRuleOverrides

Quy tắc lập lịch theo mức độ sẵn có.

Trường
last_bookable_sec

int64

Thời gian cuối cùng (tính bằng giây) mà bạn có thể đặt trước khung giờ này. Dấu thời gian này phải trước start_sec của khung giờ cần được tôn trọng (nếu người dùng có thể đặt lịch sau thời gian bắt đầu, hãy sử dụng SchedulingRules.min_booking_before_end_time ở cấp dịch vụ). Nếu có, sẽ ghi đè mọi nội dung được chỉ định trong min_booking_buffer của SchedulingRules của Dịch vụ tương ứng.
first_bookable_sec

int64

Thời gian (tính bằng giây) lần đầu tiên có thể đặt trước khung giờ này. Dấu thời gian này phải trước start_sec của khung giờ hoặc last_bookable_sec nếu được chỉ định.
last_online_cancellable_sec

int64

Nếu được đặt, đây là lần cuối cùng (tính bằng giây kể từ thời gian Unix) mà bạn có thể huỷ một khung giờ nhận đặt hẹn cụ thể thông qua tính năng Đặt chỗ bằng Google. Trường này sẽ ghi đè mọi quy tắc huỷ ở cấp dịch vụ. (không bắt buộc)

BatchDeleteGenericRecordsRequest

Yêu cầu hàng loạt để xoá các bản ghi thuộc loại nguồn cấp dữ liệu được chỉ định.

Trường
parent

string

Tên tài nguyên có định dạng là partners/{partner_id}/feeds/{feed_name}.
records[]

GenericDeleteRecord

Bản ghi cần xoá. Bạn có thể có tối đa 1.000 bản ghi trong một lệnh gọi API.

BatchPushGenericRecordRequest

Yêu cầu hàng loạt để chèn và/hoặc cập nhật các bản ghi của loại nguồn cấp dữ liệu được chỉ định trong URL yêu cầu.

Trường
parent

string

Tên tài nguyên có định dạng là partners/{partner_id}/feeds/{feed_name}.
records[]

GenericRecord

Bản ghi cần chèn và/hoặc cập nhật. Bạn có thể có tối đa 1.000 bản ghi trong một lệnh gọi API.

BatchReplaceServiceAvailabilityRequest

Yêu cầu hàng loạt để thay thế nhiều khung giờ trống của Service.

Trường
parent

string

Định dạng của partners/{partner_id}.
extended_service_availability[]

ExtendedServiceAvailability

Thời gian cung cấp dịch vụ mở rộng được dùng để thay thế các khung giờ cung cấp dịch vụ hiện có.

BatchReplaceServiceAvailabilityResponse

Phản hồi hàng loạt để thay thế nhiều khung giờ trống của Service. Chỉ những khoảng thời gian đã cập nhật thành công mới được đưa vào thông báo này

Trường
extended_service_availability[]

ExtendedServiceAvailability

Đã cập nhật thành công thông báo về phạm vi cung cấp dịch vụ mở rộng để thay thế các khung giờ cung cấp hiện có.

Đặt dịch vụ

Lượt đặt trước cho một vị trí trong kho hàng

Trường
name

string

Tên tài nguyên của lượt đặt phòng: partners/{partner ID}/bookings/{booking ID}
merchant_id

string

Mã nhận dạng của người bán cho vị trí
service_id

string

Mã nhận dạng của dịch vụ người bán
start_time

Timestamp

Giờ bắt đầu của khung giờ nhận đặt hẹn
duration

Duration

Thời lượng của khung giờ nhận đặt hẹn
client_information

ClientInformation

Thông tin cá nhân của khách hàng đặt lịch hẹn
status

BookingStatus

Trạng thái của lượt đặt phòng
payment_information

PaymentInformation

Thông tin về các giao dịch thanh toán liên quan đến lượt đặt chỗ.
party_size

int64

Số người tham gia bữa tiệc trong yêu cầu đặt chỗ

BookingFailure

Dữ liệu trạng thái truyền tải lý do khiến việc xử lý lượt đặt phòng không thành công một cách không đồng bộ. BookingFailure chủ yếu dùng để ghi lại các lỗi logic nghiệp vụ.

Trường
cause

Cause

Lý do khiến yêu cầu đặt chỗ không thành công. (bắt buộc)
rejected_card_type

CreditCardType

(chỉ bắt buộc nếu nguyên nhân là PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

Trường không bắt buộc này chỉ được dùng để đối tác thêm thông tin bổ sung cho mục đích gỡ lỗi. (không bắt buộc)
payment_failure

PaymentFailureInformation

Thông tin về các lỗi thanh toán.

Nguyên nhân

Liệt kê các nguyên nhân gây ra lỗi.

Enum
CAUSE_UNSPECIFIED Giá trị mặc định: Không sử dụng; tương đương với "lỗi không xác định"
SLOT_UNAVAILABLE Khung giờ có thể đặt lịch hẹn được tham chiếu không còn nữa.
SLOT_ALREADY_BOOKED_BY_USER Người dùng đã đặt cuộc hẹn cho khung giờ trống được tham chiếu.
LEASE_EXPIRED Hợp đồng thuê (nếu có) đã hết hạn và không thể dùng để hoàn tất yêu cầu đặt chỗ nữa.
OUTSIDE_CANCELLATION_WINDOW Bạn không thể huỷ yêu cầu vào thời điểm hiện tại do các 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 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 được cung cấp. Bạn phải cung cấp loại thẻ tín dụng trong rejected_card_type.
PAYMENT_ERROR_CARD_DECLINED Đã xảy ra lỗi trong quá trình xử lý khoản thanh toán vì thẻ tín dụng bạn cung cấp đã bị từ chối.
PAYMENT_OPTION_NOT_VALID Đã xảy ra lỗi với gói/chế độ thành viên được dùng để thanh toán cho yêu cầu đặt chỗ. Có thể không còn lượt sử dụng hợp lệ nào, hoặc lượt sử 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 lượt đặt chỗ này. Sử dụng giá trị này để cho biết lỗi chung liên quan đến việc thanh toán, chỉ khi lỗi không khớp với một 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 đang cố gắng sử dụng mức giá lần đầu cho lần thứ hai).
BOOKING_ALREADY_CANCELLED Lượt đặt chỗ mà người dùng tìm cách huỷ đã bị huỷ.
BOOKING_NOT_CANCELLABLE Người dùng đã cố gắng huỷ một lượt đặt chỗ không thể huỷ.
OVERLAPPING_RESERVATION Người dùng đã có một lượt đặt chỗ hiện tại quá gần với thời gian này.
USER_OVER_BOOKING_LIMIT Bạn không đặt được vé do người dùng vượt quá giới hạn đặt vé trên mỗi người dùng của đơn vị tập hợp.
PAYMENT_REQUIRES_3DS1

Đặt khi 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 lần này là sau khi trải qua quy trình xác thực 3DS1. Xin lưu ý rằng trạng thái thất bại của giao dịch hiện tại sẽ vẫn là thất bại. Lần thử lại sẽ hoàn toàn tách biệt.

Khi đây là lý do thất bại, bạn PHẢI đặt payment_failure.3DS1_parameters. Nếu không, nguyên nhân hiện tại sẽ được coi như là PAYMENT_ERROR.

PaymentFailureInformation

Thông tin về các lỗi thanh toán.

Trường
threeds1_parameters

ThreeDS1Parameters

Các tham số mà đơn vị 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ẽ bị bỏ qua trừ phi BookingFailure.cause được đặt thành PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Các tham số yêu cầu RwG thực hiện một thử thách 3DS1.

Các thông số này được thiết lập theo nội dung mô tả của EMVCo về giao thức 3DS1.

Trường
acs_url

string

URL để tải một biểu mẫu nhằm trình bày cho Người dùng để xác thực.
pa_req

string

Yêu cầu PaymentAuthentication. Được đăng lên biểu mẫu ACSUrl nếu được cung cấp.
transaction_id

string

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

string

Dữ liệu của 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 lượt đặt phòng

Enum
BOOKING_STATUS_UNSPECIFIED Chưa chỉ định.
CONFIRMED Đã xác nhận yêu cầu đặt chỗ
PENDING_MERCHANT_CONFIRMATION Người bán đang chờ xác nhận đặt phòng trước khi chuyển sang trạng thái ĐÃ XÁC NHẬN (hiện KHÔNG được hỗ trợ)
PENDING_CLIENT_CONFIRMATION Khách hàng đang chờ xác nhận đặt chỗ trước khi chuyển sang trạng thái ĐÃ XÁC NHẬN (hiện KHÔNG được hỗ trợ)
CANCELED Lượt đặt chỗ đã bị huỷ thay cho người dùng.
NO_SHOW Khách hàng không đến cuộc hẹn
NO_SHOW_PENALIZED Khách hàng không đến cuộc hẹn, vi phạm chính sách huỷ cuộc hẹn.
FAILED Không thể hoàn tất quy trình đặt vé do lỗi xử lý.
DECLINED_BY_MERCHANT Người bán đã từ chối yêu cầu đặt chỗ không đồng bộ.

CallMerchant

Loại này không có trường nào.

Thông báo trống sẽ được dùng trong UnsupportedPartySizeOption. Việc đặt thông báo này sẽ hiển thị cho người dùng một lựa chọn để gọi điện cho doanh nghiệp để đặt chỗ.

CancellationPolicy

Chính sách huỷ đối với một dịch vụ.

Trường
refund_condition[]

RefundCondition

Không có hoặc có một số điều kiện hoàn tiền áp dụng cho chính sách.

RefundCondition

Xác định một điều kiện hoàn tiền duy nhất. Bạn có thể sử dụng nhiều điều kiện hoàn tiền cùng nhau để mô tả "các bước hoàn tiền" theo nhiều khoảng thời gian trước thời gian bắt đầu dịch vụ.

Trường
min_duration_before_start_time

Duration

Khoảng thời gian trước giờ bắt đầu, cho đến khi khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí dịch vụ được chỉ định trong refund_percent. Khi được đặt thành 0 (mặc định), dịch vụ có thể bị huỷ bất cứ lúc nào.
refund_percent

uint32

Tỷ lệ phần trăm có thể hoàn lại, miễn là bạn huỷ đặt lịch hẹn dịch vụ ít nhất min_duration_before_start_time trước thời gian bắt đầu dịch vụ, trong phạm vi [0, 100]. Khi được đặt thành 0 (mặc định), dịch vụ sẽ không được hoàn tiền. Khi được đặt thành 100, dịch vụ này sẽ được hoàn tiền đầy đủ.

ClientInformation

Thông tin cá nhân về người đặt chỗ

Trường
given_name

string

Tên của khách hàng
family_name

string

Họ của khách hàng
address

PostalAddress

Địa chỉ của khách hàng
telephone

string

Số điện thoại của khách hàng
email

string

Địa chỉ email của khách hàng

CreateAdsAccountLinkRequest

Thông báo yêu cầu cho AdsAccountLinkingService.CreateAdsAccountLink.

Trường
parent

string

Bắt buộc. Tài nguyên mẹ nơi mối liên kết tài khoản Google Ads này sẽ được tạo. Mã này giống với mã tài khoản Trung tâm đối tác. Định dạng: partners/{partner}

CreateMerchantRequest

Yêu cầu tạo Merchant.

Trường
parent

string

Tên tài nguyên mẹ cho đối tác sở hữu người bán này, theo định dạng partners/{partner_id}.
merchant_id

string

Mã người bán cần dùng cho người bán này.
merchant

Merchant

Người bán cần tạo.

CreateServiceRequest

Yêu cầu tạo một Service mới.

Trường
parent

string

Tên tài nguyên mẹ của người bán sở hữu dịch vụ này, theo định dạng partners/{partner_id}/merchants/{merchant_id}.
service_id

string

Mã dịch vụ cần dùng cho dịch vụ này.
service

Service

Dịch vụ cần tạo.

CreditCardRestrictions

Các loại thẻ tín dụng mà nhà bán hàng này chấp nhận.

Trường
credit_card_type[]

CreditCardType

Danh sách thẻ tín dụng được hỗ trợ. Không hỗ trợ thẻ tín dụng nếu không có thẻ nào.

CreditCardType

Loại thẻ tín dụng.

Enum
CREDIT_CARD_TYPE_UNSPECIFIED Không dùng đến.
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 Discover.
JCB Thẻ tín dụng JCB.

DeleteAdsAccountLinkRequest

Thông báo yêu cầu cho AdsAccountLinkingService.DeleteAdsAccountLink.

Trường
name

string

Bắt buộc. Tên của AdsAccountLink cần xoá. Định dạng: partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

Yêu cầu xoá Merchant.

Trường
name

string

Tên tài nguyên của người bán cần xoá. Theo định dạng partners/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

Yêu cầu xoá Service.

Trường
name

string

Tên tài nguyên của dịch vụ cần xoá. Ở định dạng partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Khoản tiền gửi

Khoản tiền đặt cọc mà người dùng có thể bị tính phí hoặc bị tạm giữ trên thẻ tín dụng.

Trường
deposit

Price

Số tiền ký quỹ.
min_advance_cancellation_sec

int64

Thời gian huỷ tối thiểu trước khi nhận tiền đặt cọc.
deposit_type

PriceType

Xác định cách xác định khoản tiền đặt cọc dựa trên tình trạng phò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ụ thông qua RwG.

Trường
payment_methods[]

Text

Người dùng nên chỉ thanh toán qua các phương thức thanh toán được đề cập bên dưới.

DurationRange

Trình bao bọc cho một dải ô thời lượng có thể có giới hạn hoặc không có giới hạn. Bạn phải cung cấp ít nhất một trong hai giá trị thời lượng min_duration và max_duration.

Trường
min_duration

Duration

Thời lượng tối thiểu.
max_duration

Duration

Thời lượng tối đa.

EconomicOperator

Thông tin về Nhà khai thác kinh tế cho Nhà tổng hợp.

Trường
text

Text

Bắt buộc. Tên, địa chỉ, số điện thoại và địa chỉ email của chủ thể kinh tế, được xác định là nhà sản xuất, người đại diện được uỷ quyền, nhà nhập khẩu, nhà phân phối, nhà cung cấp dịch vụ thực hiện đơn hàng hoặc bất kỳ thể nhân hoặc pháp nhân nào khác phải chịu nghĩa vụ liên quan đến việc sản xuất sản phẩm, cung cấp sản phẩm hoặc đưa sản phẩm vào sử dụng. Giá trị biểu thị chuỗi dạng tự do của economic_operator. Thông tin này có thể được định dạng bằng " " và "\n".

ExtendedServiceAvailability

Danh sách tình trạng còn hàng và đối tượng/thời điểm áp dụng.

Trường
merchant_id

string

Đây là trường bắt buộc để chỉ định người bán mà các thông báo về tình trạng còn hàng bên dưới thuộc về.
service_id

string

Đây là trường bắt buộc mà bạn phải chỉ định để cho biết dịch vụ nào mà các thông báo về tình trạng còn hàng bên dưới thuộc về.
start_time_restrict

Timestamp

Nếu được cung cấp, chúng tôi sẽ coi các thực thể Lịch trình cung cấp được cung cấp là thông tin đầy đủ từ [start_time_restrict, end_time_restrict). Tức là tất cả lịch phát sóng hiện có sẽ bị xoá nếu điều kiện sau đây là đúng:

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

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:

  availability.duration == duration_restrict

Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế thêm:

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

Các trường này thường được dùng để cung cấp thông tin cập nhật đầy đủ về tình trạng còn hàng trong một phạm vi thời gian nhất định.

Nếu bạn đặt start_time_restrict mà không đặt end_time_restrict, thì điều này có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict.
end_time_restrict

Timestamp

Việc đặt end_time_restrict trong khi không đặt start_time_restrict được hiểu là tất cả thời gian cho đến end_time_restrict.
duration_restrict

Duration

Việc đặt thời lượng sẽ hạn chế thêm phạm vi cập nhật chỉ đối với những khoảng thời gian rảnh/bận có thời lượng trùng khớp.
resources_restrict

Resources

Việc thiết lập resources_restrict sẽ hạn chế thêm 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 hoàn toàn khớp.
availability[]

Availability

Danh sách mới về tình trạng còn phòng.

FeedStatistics

Số liệu thống kê thu được trong khi xử lý một nguồn cấp dữ liệu được tải lên.

Trường
new_items

int64

Các mục mới được thêm vào nguồn cấp dữ liệu này. Các mục có thể là người bán, dịch vụ hoặc khung giờ còn trống, tuỳ thuộc vào loại nguồn cấp dữ liệu.
existing_items

int64

Các mặt hàng hiện có, được cập nhật khi cần dựa trên thông tin mới hơn trong nguồn cấp dữ liệu.
deleted_items

int64

Các mặt hàng không còn trong nguồn cấp dữ liệu này và đã 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ổng hợp tải lên.

Trường
name

string

Tên tài nguyên nguồn cấp dữ liệu, có định dạng

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

State

Trạng thái xử lý của nguồn cấp dữ liệu này.
error_details

string

Chuỗi mà con người có thể đọ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

FeedStatistics

Số liệu thống kê dành riêng cho nguồn cấp dữ liệu này.

Tiểu bang

Liệt kê để cho biết trạng thái xử lý của một nguồn cấp dữ liệu.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Không dùng đến.
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 Đã xảy ra lỗi trong quá trình xử lý nguồn cấp dữ liệu.

FoodOrderingMetadata

Siêu dữ liệu cho đường liên kết đến hành động đặt món ăn.

Trường
fee_details[]

FeeDetails

Thông tin chi tiết về các khoản phí mà người dùng phải trả thêm vào tổng giá trị mặt hàng. Lặp lại cho các loại phí khác nhau như phí dịch vụ, phí giao hàng, v.v.
advance_order_details

AdvanceOrderDetails

Thông tin chi tiết về tính năng hỗ trợ đặt hàng nâng cao (còn gọi là đặt hàng trước), trong đó người dùng có thể đặt hàng để thực hiện đơn hàng vào thời điểm khác chứ không phải Ngay bây giờ.
Trường nhóm fulfillment_duration_options. Khoảng thời gian thực hiện đơn đặt hàng kể từ khi xác nhận đơn đặt hàng. Đối với đơn đặt hàng giao tận nơi, thời gian cho đến khi đồ ăn được giao. Đối với đơn đặt hàng đến lấy, khoảng thời gian cho đến khi đồ ăn sẵn sàng để bạn đến lấy. fulfillment_duration_options chỉ có thể là một trong những trạng thái sau:
fulfillment_lead_time_duration

Duration

Thời lượng cố định. Ví dụ: 30 phút.
fulfillment_lead_time_duration_range

DurationRange

Một khoảng thời gian. Ví dụ: * Từ 30 phút đến 45 phút * Hơn 30 phút * Dưới 50 phút

AdvanceOrderDetails

Để được hỗ trợ về tính năng đặt trước.

Trường
is_supported

bool

True nếu Advance Orders (Đơn đặt hàng trước), còn được gọi là Order Ahead (Đặt hàng trước), được hỗ trợ. (bắt buộc)

FeeDetails

Thông tin về phí.

Trường
type

FeeType

Loại phí. (bắt buộc)
fee_amount

FeeAmount

Số tiền phí bằng đơ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 * Khoảng phí cố định: 1 USD (tối thiểu), 3 USD (tối đa), 5 – 6 USD * Tỷ lệ phần trăm theo quy mô giỏ hàng: 15,5%, 10% – 20%, 10% (tối thiểu), 15% (tối đa) * Kết hợp khoảng phí và tỷ lệ phần trăm: 25,5% và 2,5 USD (tối thiểu), 25,5% và 4,5 USD (tối đa), 10% và 1,5 – 2,5 USD, 10,5% – 20% và 2,5 – 3,5 USD

Trường
cart_percentage

QuantitativeValue

Phí tính theo tỷ lệ phần trăm 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 nhất 5,5% * Nhiều nhất 5,5% * Từ 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:
amount

Money

Số tiền cố định. Ví dụ: 35.000 VND.
amount_range

MoneyRange

Phạm vi số tiền. Ví dụ: * Từ 3,5 USD đến 5,5 USD * Ít nhất 3,5 USD * Nhiều nhất 5,5 USD
amount_unknown

bool

Số tiền không xác định.

FeeType

Loại phí.

Enum
FEE_TYPE_UNSPECIFIED Bạn chưa chỉ định loại phí.
DELIVERY Đối với phí giao hàng.
SERVICE Đối với phí dịch vụ.

FulfillmentOption

Phương thức thực hiện cho đường liên kết hành động đặt hàng trực tuyến.

Trường
fulfillment_type

FulfillmentType

Bắt buộc. Loại hình thực hiện đơn hàng.
available_day[]

AvailableDay

Bắt buộc. Danh sách các ngày có thể thực hiện phương thức thực hiện này (tốt nhất là ít nhất 2 ngày).
fee_details

FeeDetails

Bắt buộc. Thông tin chi tiết về phí của phương thức thực hiện đơn hàng.
minimum_order

Price

Bắt buộc. Đơn hàng tối thiểu cho phương thức thực hiện được liên kết với đường liên kết hành động.

AvailableDay

Tình trạng phòng theo ngày.

Trường
fulfillment_date

Date

Bắt buộc. Ngày có thể thực hiện một phương thức thực hiện đơn hàng. Được giả định là theo múi giờ của người bán.
last_ordering_time

Timestamp

Bắt buộc. Dấu thời gian Unix. Thời gian muộn nhất mà người dùng có thể đặt hàng và nhận hàng là fulfillment_date. Nói cách khác, sau last_ordering_time, fulfillment_date sẽ không còn xuất hiện nữa.

Ví dụ: nếu fulfillment_date là 2020-08-10: – giá trị last_ordering_time là 2020-08-10 18:00 có nghĩa là để nhận được đơn đặt hàng vào ngày 2020-08-10, khách hàng phải đặt đơn hàng đó trước 6 giờ chiều cùng ngày. – giá trị last_ordering_time là 2020-08-08 20:00 có nghĩa là để nhận được đơn đặt hàng vào ngày 2020-08-10, khách hàng phải đặt đơn hàng đó trước 8 giờ tối hai ngày trước.

FeeDetails

Thông tin chi tiết về phí của phương thức thực hiện được liên kết với đường liên kết hành động.

Trường
Trường nhóm fee_details. Mô hình tính phí cho phương thức thực hiện đơn hàng. fee_details chỉ có thể là một trong những trạng thái sau:
no_fee

NoFee

Không tính phí cho phương thức thực hiện đơn hàng.
base_fee

MinimumFee

Phí cơ bản liên quan đến phương thức thực hiện đơn hàng.
fixed_fee

FixedFee

Khoản phí cố định liên quan đến phương thức thực hiện đơn hàng.

FixedFee

Khoản phí cố định cần thiết cho phương thức thực hiện đơn hàng được liên kết với đường liên kết hành động.

Trường
amount

Price

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 liên kết với một đường liên kết hành động.

Enum
FULFILLMENT_TYPE_UNSPECIFIED Bạn chưa chỉ định kiểu thực hiện đơn hàng.
FULFILLMENT_TYPE_DELIVERY Loại hình thực hiện đơn hàng là giao hàng.
FULFILLMENT_TYPE_PICKUP Loại hình thực hiện đơn hàng là đến lấy hàng.

MinimumFee

Khoản phí tối thiểu cần thiết cho phương thức thực hiện được liên kết với đường liên kết hành động.

Trường
base_fee_amount

Price

Bắt buộc. Số tiền phí cơ bản cho phương thức thực hiện đơn hàng.

NoFee

Loại này không có trường nào.

Bạn không phải trả phí cho phương thức thực hiện được 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.

Trường
delete_time

Timestamp

Bắt buộc. Dấu thời gian này được dùng để xác định thứ tự xoá sẽ được áp dụng cho 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 giao thức, v.v.) Đối tác có thể cung cấp một 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. Các đối tác cũng có thể chỉ thêm những trường cần thiết của một bản ghi để xác định duy nhất bản ghi đó. record_type chỉ có thể là một trong những trạng thái sau:
data_record

bytes

Đối với nguồn cấp dữ liệu không dựa trên proto.
proto_record

Any

Đối với nguồn cấp dữ liệu dựa trên giao thức.

GenericRecord

Bản ghi về loại nguồn cấp dữ liệu được đề cập trong yêu cầu url.

Trường
generation_timestamp

Timestamp

Bắt buộc. Dấu thời gian này được dùng để đảm bảo thứ tự chính xác của các bản cập nhật kho hàng.
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 giao thức, v.v.) record_type chỉ có thể là một trong những trạng thái sau:
data_record

bytes

Đối với nguồn cấp dữ liệu không dựa trên proto.
proto_record

Any

Đối với nguồn cấp dữ liệu dựa trên giao thức.

GeoCoordins

Dữ liệu địa lý của một vị trí, bao gồm vĩ độ, kinh độ và địa chỉ.

Trường
latitude

double

Vĩ độ tính bằng độ. (không bắt buộc)
longitude

double

Kinh độ tính bằng độ. (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:
address

PostalAddress

Địa chỉ bưu chính của vị trí (nên dùng).
unstructured_address

string

Bạn cũng có thể cung cấp một địa chỉ không có cấu trúc làm phương án dự phòng. Ví dụ: "1600 amphitheatre parkway mountain view, ca 94043"

GetAdsAccountLinkRequest

Thông báo yêu cầu cho AdsAccountLinkingService.GetAdsAccountLink.

Trường
name

string

Bắt buộc. Tên của mối liên kết tài khoản Google Ads cần truy xuất. Định dạng partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

Yêu cầu lấy MerchantStatus

Trường
name

string

Bắt buộc. Tên tài nguyên, theo định dạng partners/{partner_id}/merchants/{merchant_id}/status.

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ổng hợp tải lên.

Trường
name

string

Tên tài nguyên nguồn cấp dữ liệu, có định dạng

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

HomeServiceData

Bạn phải cung cấp thêm thông tin cho ngành dọc dịch vụ tại nhà.

Trường
category_type

string

Danh mục cấp cao mà dịch vụ tại nhà này thuộc về. Ví dụ: thợ sửa ống nước, thợ điện, v.v.
job_type

string

Loại công việc thuộc danh mục mà dịch vụ tại nhà đã cho thuộc về. 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

Mức độ tích hợp được hỗ trợ.

Enum
INTEGRATION_TYPE_UNSPECIFIED Giá trị mặc định là END_TO_END.
INTEGRATION_TYPE_END_TO_END Hoàn tất quá trình tích hợp để cho phép đặt lịch hẹn từ đầu đến cuối thông qua Google.
INTEGRATION_TYPE_INVENTORY_ONLY Máy chủ đặt chỗ 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à (không bắt buộc) tình trạng còn hàng.

InvalidateResourceRequest

Yêu cầu vô hiệu hoá một tài nguyên.

Trường
resource_id

string

Tên của tài nguyên cần được vô hiệu hoá.

Ví dụ: đối với tài nguyên Lấy tại cửa hàng, tên phải có định dạng partners/{partner_id}/pickups/{pickup_id}. Các cách triển khai PHẢI xoá các phiên bản lưu trong bộ nhớ đệm của tài nguyên được xác định.

LineItem

Một mục duy nhất trong đơn đặt hàng – việc đặt một dịch vụ duy nhất trong một khung giờ duy nhất.

Trường
service_id

string

Mã nhận dạng của Dịch vụ người bán.
start_sec

int64

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 Unix.
duration_sec

int64

Thời lượng của khung giờ nhận đặt hẹn tính bằng giây.
tickets[]

OrderedTickets

Số lượng vé được đặt theo Loại vé.
price

Price

Tổng giá (chưa bao gồm thuế) của Mục hàng này.
status

BookingStatus

Trạng thái của Mục hàng.

OrderedTickets

Số lượng vé đã đặt theo Loại vé.

Trường
ticket_id

string

Mã nhận dạng của một Loại vé.
count

int32

Số lượng vé đã đặt cho loại vé này.

LinkoutTemplate

Một mẫu chỉ định cách Google nên tạo URL cho trang web của đối tác.

Trường
uri_template

string

Mẫu uri phải tuân theo RFC 6570, xem https://datatracker.ietf.org/doc/html/rfc6570. Hỗ trợ mẫu Cấp 1 và tất cả mẫu hỗn hợp Cấp 4. ví dụ: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

ListMerchantStatusesRequest

Yêu cầu lấy danh sách MerchantStatus

Trường
parent

string

Bắt buộc. Phần tử mẹ sở hữu bộ sưu tập trạng thái người bán này. Định dạng partners/{partner_id}/merchants
page_size

int32

Bắt buộc. Số lượng mặt hàng tối đa cần trả về. Xin lưu ý rằng máy chủ có thể giảm kích thước trang.
page_token

string

Không bắt buộc. Giá trị nextPageToken được trả về từ một ListMerchantStatusResponse trước đó (nếu có).
booking_inventory_status_restrict

BookingInventoryStatus

Không bắt buộc. Hạn chế không bắt buộc để lọc kết quả theo trạng thái kho đặt phòng.
waitlist_inventory_status_restrict

WaitlistInventoryStatus

Không bắt buộc. Hạn chế không bắt buộc để lọc kết quả theo trạng thái còn hàng trong danh sách chờ.
geo_match_restrict

GeoMatchingStatus

Không bắt buộc. Hạn chế không bắt buộc để lọc kết quả theo trạng thái khớp địa lý.

BookingInventoryStatus

Trạng thái kho hàng đặt chỗ từ đầu đến cuối.

Enum
BOOKING_INVENTORY_STATUS_UNSPECIFIED Chưa chỉ định.
NO_VALID_FUTURE_INVENTORY Người bán không có khoảng không quảng cáo đặt lịch hẹn trong 30 ngày tới.
HAS_VALID_FUTURE_INVENTORY Người bán có khoảng không quảng cáo đặt lịch hẹn trong 30 ngày tới.

GeoMatchingStatus

Trạng thái khớp vị trí địa lý của người bán.

Enum
GEO_MATCHING_STATUS_UNSPECIFIED Chưa chỉ định.
GEO_UNMATCHED Người bán không khớp với vị trí địa lý.
GEO_MATCHED Người bán được so khớp theo vị trí địa lý.

WaitlistInventoryStatus

Trạng thái còn hàng của danh sách chờ từ đầu đến cuối.

Enum
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Chưa chỉ định.
NO_VALID_WAITLIST_SERVICE Người bán không có dịch vụ hỗ trợ danh sách chờ.
HAS_VALID_WAITLIST_SERVICE Người bán có dịch vụ hỗ trợ danh sách chờ.

ListMerchantStatusesResponse

Phản hồi cho danh sách MerchantStatus.

Trường
merchant_statuses[]

MerchantStatus

Danh sách trạng thái của người bán đáp ứng các điều kiện lọc.
next_page_token

string

Mã thông báo để truy xuất trang kết quả tiếp theo. Nếu danh sách trống thì sẽ không có kết quả nào khác.

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ổng hợp tải lên.

Trường
name

string

Tên tài nguyên nguồn cấp dữ liệu, có định dạng

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

int32

Số lượng mặt hàng tối đa cần trả về.
page_token

string

Giá trị next_page_token được trả về từ một yêu cầu List trước đó (nếu có).
state_restrict

State

Không bắt buộc: hạn chế lọc kết quả theo trạng thái nguồn cấp dữ liệu.
time_range_restrict

TimeRange

Bạn có thể chọn giới hạ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ì hệ thống sẽ mặc định là thời gian bắt đầu của thời gian Unix. Nếu bạn không đặt end_time, hệ thống sẽ mặc định đặt giá trị là thời gian hiện tại.

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ổng hợp tải lên.

Trường
status[]

FeedStatus

Danh sách trạng thái theo thứ tự thời gian đảo ngược cho các nguồn cấp dữ liệu đã tải lên. Số lượng mục tối đa được trả về dựa trên trường page_size trong yêu cầu.
next_page_token

string

Mã thông báo để truy xuất trang kết quả tiếp theo. Nếu danh sách trống thì sẽ không có kết quả nào khác.

LocalizedString

Một thực thể của chuỗi trong một ngôn ngữ.

Trường
locale

string

Mã ngôn ngữ IETF BCP 47, chẳng hạn như "en", "mas", "zh-Hant", "de-CH-1901". Xem http://www.w3.org/International/articles/language-tags/.
value

string

Thông báo bằng ngôn ngữ ở trên (UTF-8).

Thông tin vị trí

Thông tin địa lý về một vị trí.

Trường
place_id

string

Mã địa điểm của một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem https://developers.google.com/places/web-service/place-id để biết thêm về mã địa điểm. Nếu bạn cung cấp thông tin này, Google sẽ so khớp vị trí với địa điểm này.
name

string

Tên, số điện thoại, URL và vị trí địa lý của địa điểm được dùng để hỗ trợ việc so khớp địa điểm với những địa điểm đã có trên Google Maps.

Đây là trường không bắt buộc, nhưng có thể là trường bắt buộc trong một số ngữ cảnh. Ví dụ: Service.location không có tên sẽ không được so khớp với một thực thể kinh doanh, ngay cả khi chúng có cùng địa chỉ. (không bắt buộc)
telephone

string

Số điện thoại công khai của địa điểm, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234. (không bắt buộc)
url

string

URL của trang web công khai của vị trí. (không bắt buộc)
geo

GeoCoordinates

Thông tin địa lý của vị trí, bao gồm vĩ độ, kinh độ và địa chỉ. (không bắt buộc)
location_type

LocationType

Bạn phải cung cấp loại vị trí nếu vị trí này được cung cấp cho một Dịch vụ.
location_id

string

Thông tin tham chiếu riêng biệt của vị trí trong dịch vụ. Bạn có thể dùng mã nhận dạng này để 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 tuỳ chỉnh, bạn có thể 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 chỉ định loại vị trí.
VISITED_LOCATION Vị trí mà dịch vụ này đến.
START_LOCATION Vị trí bắt đầu dịch vụ này cũng là MEETING_LOCATION.
END_LOCATION Vị trí nơi dịch vụ này kết thúc.

Người bán

Thông tin về một người bán có trên nền tảng của đơn vị tập hợp.

Trường
name

string

Tên tài nguyên của người bán, có định dạng là partners/{partner_id}/merchants/{merchant_id}.
merchant_name

string

merchant_name, telephone, url và geo đượ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 được hiển thị.

Tên của người bán.
telephone

string

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

string

URL của trang web công khai của người bán.
geo

GeoCoordinates

Thông tin địa lý của người bán, bao gồm vĩ độ, kinh độ và địa chỉ.
category

string

Danh mục của doanh nghiệp trong nền tảng của đơn vị tổng hợp.
num_bookings_30d
(deprecated)

int64

Trường này không được dùng nữa.
tax_rate_basis_points
(deprecated)

uint32

Thuế suất của người bán tính bằng điểm cơ bản (một phần trăm trăm). Ví dụ: Nếu thuế suất là 7, 5%, thì bạn nên đặt trường này thành 750.

Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ chính xác bằng giá mà bạn chỉ định theo Service.price. 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. Người dùng sẽ không thấy thuế dưới dạng một mục riêng.

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á mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được tính theo mức thuế mà bạn cung cấp ở đây. Phần nhỏ nhất của đơn vị tiền tệ (ví dụ: phần nhỏ nhất của một xu) sẽ được làm tròn bằng cách làm tròn đến số 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 riêng.

Trường này không còn được dùng nữa, vui lòng sử dụng tax_rate.
tax_rate
(deprecated)

TaxRate

Mức thuế của người bán. Nếu có, trường này sẽ ghi đè trường tax_rate_basis_points không dùng nữa. Một thông báo trống (tức là tax_rate { }) sẽ đặt lại mức thuế đã áp dụng thành 0. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
payment_restrictions
(deprecated)

PaymentRestrictions

Các hạn chế đối với phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định rằng không có quy tắc hạn chế nào nếu bạn không đặt trường này. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
payment_option[]
(deprecated)

PaymentOption

Các phương thức thanh toán mà người bán này chấp nhận. Các dịch vụ thuộc người bán này sẽ có thể tự giới hạn những phương thức thanh toán mà họ cho phép. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
payment_processor_config
(deprecated)

PaymentProcessorConfig

Cấu hình cho một công ty xử lý thanh toán bằng mã thông báo, nếu người bán có hỗ trợ công ty này.
tokenization_config
(deprecated)

TokenizationConfig

Cấu hình cho một công ty xử lý thanh toán bằng mã thông báo, nếu người bán có hỗ trợ công ty này. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
terms

Terms

Điều khoản và điều kiện cụ thể của người bán được hiển thị cho người dùng khi họ đặt dịch vụ thông qua tính năng Đặt chỗ bằng Google. Ngoài ra, Điều khoản và điều kiện của đối tác đơn vị tập hợp luôn được hiển thị cho người dùng và bạn không được cung cấp ở đây.
brand_id

string

Một chuỗi mờ xác định thương hiệu dành cho người tiêu dùng sẽ sử dụng khi hiển thị thông tin phân bổ đối tác. Trường này cho phép những đối tác có nhiều thương hiệu dành cho người tiêu dùng cung cấp người bán cho tất cả thương hiệu trong cùng một nguồn cấp dữ liệu.

Thương hiệu bao gồm các tài sản dành cho người tiêu dùng 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 dành cho người tiêu dùng, thì bạn không cần phải đặt trường này và có thể bỏ qua.

Nếu đối tác...

Không có nhiều thương hiệu dành cho người tiêu dùng? --> Bỏ qua trường này

Đã định cấu hình Nhiều thương hiệu?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Lưu ý quan trọng: hầu hết các đối tác đều 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

MerchantMatchingHints

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 đặt 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 bằng thông tin được cung cấp ở trên. (không bắt buộc)
service_attribute[]

ServiceAttribute

Định nghĩa cho mọi thuộc tính dịch vụ được dùng để mô tả Dịch vụ cho Nhà bán hàng này. (không bắt buộc)
reservation_linkout_template[]

LinkoutTemplate

Không bắt buộc. Mẫu đường liên kết bên ngoài chỉ định cách Google tạo URL của đối tác để đặt bàn trên nền tảng của họ.

Xin lưu ý rằng hiện tại, hệ thống sẽ chỉ sử dụng mục đầu tiên nếu bạn cung cấp nhiều mục.

Mẫu URI hỗ trợ các trường sẽ được điền sẵn dựa trên lựa chọn đặt chỗ trước của người dùng. Bạn cần có tất cả các trường bắt buộc để tạo thành công một URL để đặt chỗ trước: * (bắt buộc) party_size, int: Số người trong nhóm mà người dùng đang yêu cầu đặt chỗ trước. * (bắt buộc) selected_date_time, ngày giờ theo tiêu chuẩn ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): Thời gian mà người dùng đang yêu cầu đặt chỗ. * (không bắt buộc) merchant_id, chuỗi: Mã nhận dạng của nhà bán hàng mà người dùng đang yêu cầu đặt trước, không cần thiết nếu mẫu đã có mã nhận dạng người bán. * (không bắt buộc) room_id, chuỗi: Mã nhận dạng của phòng mà người dùng đang yêu cầu đặt chỗ.
waitlist_advisement

Advisement

Không bắt buộc. Lời khuyên chung của một người bán cụ thể dành 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 lời khuyên phải có độ dài tối đa là 100 byte.
economic_operator

EconomicOperator

Không bắt buộc. Thông tin về Nhà khai thác kinh tế được liên kết với người bán cụ thể này là thông tin cần thiết để tuân thủ quy định. (không bắt buộc)

MerchantMatchingHints

Gợi ý được dùng để giúp Google so khớp người bán với một địa điểm trên Google Maps.

Trường
place_id

string

Mã địa điểm của một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem https://developers.google.com/places/web-service/place-id để biết thêm về mã địa điểm.

MerchantStatus

Trạng thái của người bán trong nền tảng Đặt chỗ bằng Google.

Trường
name

string

Tên tài nguyên trạng thái người bán, có định dạng là partners/{partner_id}/merchants/{merchant_id}/status
merchant_name

string

Tên của người bán do đối tác cung cấp.
input_geo_info

GeoCoordinates

Đối tác cung cấp thông tin về vị trí địa lý của người bán.
processing_status

ProcessingStatus

Trạng thái xử lý của người bán.
booking_status

BookingStatus

Trạng thái liên quan đến việc tích hợp đặt chỗ toàn diện.
waitlist_status

WaitlistStatus

Trạng thái liên quan đến việc tích hợp danh sách chờ.
geo_match

PlaceInfo

Địa điểm địa lý trùng khớp của người bán này. Để trống nếu người bán không được so khớp theo vị trí địa lý.
local_services_match

LocalServicesMatchInfo

Dịch vụ địa phương phù hợp với người bán này. Để trống nếu đó không phải là người bán dịch vụ tại địa phương hoặc không khớp với bất kỳ nhà cung cấp nào.
direct_urls[]

DirectUrl

Danh sách URL minh hoạ nội dung trong 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 URL công khai.

BookingStatus

Trạng thái liên quan đến việc tích hợp đặt chỗ toàn diện.

Trường
has_valid_future_inventory

bool

Đúng nếu người bán có kho hàng trong 30 ngày tới. Không đảm bảo rằng người bán thực sự được phân phát.

DirectUrl

URL hiển thị người bán.

Trường
type

UrlType

Loại URL này.
url

string

URL có thể hiển thị người bán này.

UrlType

Loại URL xuất hiện.

Enum
URL_TYPE_UNSPECIFIED Chưa chỉ định.
BOOKING URL đặt vé hoàn chỉnh.
WAITLIST URL danh sách chờ từ đầu đến cuối.
LOCAL_SERVICES URL của Dịch vụ địa phương của Google.

LocalServicesMatchInfo

Thông tin về kết quả trùng khớp dịch vụ tại địa phương của Google (chỉ đặt cho người bán dịch vụ tại địa phương).

Trường
matched_providers[]

MatchedProvider

Nhà cung cấp dịch vụ trùng khớp. Một người bán có thể được liên kết với nhiều nhà cung cấp dịch vụ.

MatchedProvider

Nhà cung cấp dịch vụ địa phương.

Trường
customer_id

int64

Mã khách hàng bên ngoài của dịch vụ địa phương của Google.
categories[]

string

Danh mục dịch vụ địa phương (ngành dọc). Ví dụ: "thợ sửa ống nước" và "dịch vụ giặt thảm".

PlaceInfo

Thông tin về một địa điểm phù hợp.

Trường
name

string

Tên của địa điểm.
formatted_address

string

Địa chỉ được định dạng bằng ngôn ngữ địa phương.
place_id

string

Mã địa điểm trên Google của địa điểm này. Có thể dùng để tạo URL của Google Maps hoặc tìm nạp thêm thông tin chi tiết về địa điểm. Hãy xem https://developers.google.com/places/web-service/place-id để biết 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 không xác định.
IN_PROGRESS Madden đã nhận được nhà bán hàng 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 nào khác.
COMPLETED Các trạng thái khác của người bán đã được tính toán.

WaitlistStatus

Trạng thái liên quan đến việc tích hợp danh sách chờ.

Trường
has_valid_waitlist_service

bool

Đúng nếu người bán có dịch vụ danh sách chờ. Không đảm bảo rằng người bán thực sự được phân phát.

MoneyRange

Trình bao bọc cho một dải ô số tiền có thể có giới hạn hoặc không có 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.

Trường
min_amount

Money

Số tiền tối thiểu.
max_amount

Money

Số tiền tối đa.

NoShowFee

Khoản phí mà người dùng có thể phải trả nếu đã đặt chỗ nhưng không đến.

Trường
fee

Price

Số tiền mà người dùng có thể bị tính phí nếu không đến đặt chỗ.
fee_type

PriceType

Xác định cách tính phí dựa trên tình trạng phòng.

Đặt hàng

Đơn đặt lịch hẹn dịch vụ với người bán.

Trường
name

string

Tên tài nguyên của đơn đặt hàng: partners/{partner ID}/orders/{order ID}
client_information

ClientInformation

Thông tin cá nhân của khách hàng đặt hàng.
payment_information

PaymentInformation

Thông tin về các giao dịch thanh toán liên quan đến đơn đặt hàng.
merchant_id

string

Mã nhận dạng của người bán mà tất cả các dịch vụ trong đơn đặt hàng này thuộc về.
item[]

LineItem

Các mục hàng trong đơn đặt hàng này.

OrderOnlineMetadata

Siêu dữ liệu cho đường liên kết hành động đặt hàng trực tuyến.

Trường
fulfillment_option[]

FulfillmentOption

Các lựa chọn thực hiện đơn đặt hàng có sẵn cho đường liên kết hành động đặt hàng trực tuyến.

PaymentInformation

Thông tin thanh toán liên quan đến lượt đặt chỗ

Trường
prepayment_status

PrepaymentStatus

Trạng thái trả trước của lượt đặt phòng. Nếu prepayment_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

string

Mã nhận dạng riêng biệt cho giao dịch thanh toán liên quan đến lượt đặt chỗ. Để trống nếu không áp dụng.

PaymentOption

Một lựa chọn thanh toán mà bạn có thể dùng để thanh toán cho các dịch vụ do người bán cung cấp. Các phương thức thanh toán có thể được dùng chung giữa nhiều người bán (ví dụ: những người bán thuộc cùng một chuỗi).

Trường
payment_option_id

string

Mã nhận dạng này được dùng để xác định phương thức thanh toán này.

Mã nhận dạng này là mã nhận dạng chung cho toàn bộ đơn vị 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 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 lựa chọn thanh toán của một người bán cũng sẽ cập nhật mọi lựa chọn thanh toán khác có cùng mã nhận dạng của một người bán khác. Do đó, bạn nên sử dụng cùng một mã nhận dạng cho tất cả các lựa chọn thanh toán và luôn cập nhật các lựa chọn này thành các giá trị giống nhau để tránh mọi trường hợp hành vi không xác định.
name

string

Tên của phương thức thanh toán. Người dùng có thể thấy thông tin này.
description

string

Nội dung mô tả về lựa chọn thanh toán. Người dùng có thể thấy thông tin này.
price

Price

Giá của phương thức thanh toán.
tax_rate

TaxRate

Thuế suất cho phương thức thanh toán này. Nếu có, trường này sẽ ghi đè trường tax_rate có trong Người bán hoặc Dịch vụ. Một thông báo trống (tức là tax_rate { }) sẽ đặt lại mức thuế đã áp dụng thành 0.
payment_option_type

PaymentOptionType

Loại phương thức thanh toán này. Sử dụng một lần cho các buổi tập luyện không cần đặt lịch trước, sử dụng nhiều lần cho các gói và không giới hạn cho các gói thành viên.
session_count

int64

Số phiên mà bạn có thể sử dụng phương thức thanh toán này. Chỉ có hiệu lực đối với gói / nhiều phiên, trong đó giá trị phải lớn hơn 1.
purchase_interval

TimeRange

Bạn có thể mua lựa chọn thanh toán trong khoảng thời gian này.
valid_interval

TimeRange

Bạn có thể sử dụng lựa chọn thanh toán này trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, tham số này sẽ ghi đè valid_duration và activation_type.
valid_duration

Duration

Thời hạn 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

ActivationType

Xác định cách xác định ngày bắt đầu hiệu lực của phương thức thanh toán này.
user_restriction

UserPurchaseRestriction

Hạn chế những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để hạn chế một 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, 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 dùng đến.
ACTIVATION_ON_PURCHASE Thời gian hiệu lực bắt đầu từ thời điểm mua.
ACTIVATION_ON_FIRST_USE Thời gian hiệu lực bắt đầu khi bạn sử dụng phương thức thanh toán lần đầu tiên.

PaymentOptionType

Một loại lựa chọn thanh toán.

Enum
PAYMENT_OPTION_TYPE_UNSPECIFIED Không dùng đến.
PAYMENT_OPTION_SINGLE_USE Bạn chỉ có thể sử dụng phương thức thanh toán một lần.
PAYMENT_OPTION_MULTI_USE Bạn có thể sử dụng phương thức thanh toán nếu số phiên của phương thức đó > 0.
PAYMENT_OPTION_UNLIMITED Bạn có thể sử dụng phương thức thanh toán trong phạm vi thời gian hợp lệ – số phiên không áp dụng.

PaymentProcessorConfig

Cấu hình cho một công ty xử lý thanh toán, được thiết lập theo từng người bán.

Trường
processor

Processor

Xác định đối tác công ty xử lý thanh toán mà cấu hình này áp dụng.
public_key

string

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, hãy tham khảo: https://stripe.com/docs/dashboard#api-keys Đối với Braintree, hãy tham khảo: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

Số phiên bản API được gửi đến đơn vị xử lý thanh toán cùng với các yêu cầu thanh toán.

Bộ xử lý

Xác định một đối tác cụ thể là công ty xử lý thanh toán.

Enum
PROCESSOR_UNSPECIFIED Không Sử Dụng
PROCESSOR_STRIPE Một cấu hình cho các khoản thanh toán qua Stripe.
PROCESSOR_BRAINTREE Cấu hình cho các khoản thanh toán bằng Braintree.

PaymentRestrictions

Các hạn chế đối với phương thức thanh toán mà người bán này chấp nhận.

Trường
credit_card_restrictions

CreditCardRestrictions

Các hạn chế đối với thẻ tín dụng mà nhà bán hàng 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 để trống danh sách này sẽ khiến cấu hình phải chịu 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é.

Trường
delivery_fee

Price

Một khoản phí có thể thay đổi tuỳ theo cách phân phối.
processing_fee

Price

Phí xử lý phương thức thanh toán của người dùng.

PerTicketFee

Các khoản phí mà người dùng phải trả cho mỗi vé họ mua.

Trường
service_charge

Price

Khoản phí bổ sung được tính cho một dịch vụ.
facility_fee

Price

Một khoản phí được trả cho địa điểm/cơ sở.
taxes

Price

Thuế trên mỗi vé.

PostalAddress (Địa chỉ bưu điện)

Địa chỉ của khách hàng hoặc doanh nghiệp.

Trường
address_country

string

Quốc gia, được chỉ định bằng mã quốc gia gồm 2 chữ cái theo ISO 3166-1, ví dụ: "US" (bắt buộc)
address_locality

string

Thành phố, ví dụ: "Mountain View". (bắt buộc)
address_region

string

Khu vực, ví dụ: "CA". Trường này chỉ bắt buộc ở những quốc gia mà khu vực thường là một phần của địa chỉ. (không bắt buộc)
postal_code

string

Mã bưu chính, ví dụ: "94043". (bắt buộc)
street_address

string

Địa chỉ đường phố, ví dụ: "1600 Amphitheatre Pkwy". (bắt buộc)

Trả Tiền Trước

Khoản thanh toán mà người dùng có thể phải trả khi đặt chỗ.

Trường
price_info

PriceInfo

Vùng chứa thông tin chi tiết về giá.

PrepaymentStatus

Trạng thái thanh toán trước của lượt đặt phòng.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Không được chỉ định, giá trị mặc định là PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Bạn đã trả trước phí đặt chỗ.
PREPAYMENT_NOT_PROVIDED Bạn chưa trả trước phí đặt chỗ.
PREPAYMENT_REFUNDED Trước đây, khoản phí nà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í.

Trường
price_micros

int64

Giá tính theo đơn vị một phần triệu của đơn vị tiền tệ. Các phần nhỏ của đơn vị tiền tệ nhỏ nhất sẽ được làm tròn bằng cách làm tròn đến số chẵn gần nhất. (ví dụ: 2,5 xu Mỹ được làm tròn thành 2 xu, 3,5 xu được làm tròn thành 4 xu, 0,5 xu được làm tròn thành 0 xu, 2,51 xu được làm tròn thành 3 xu).
currency_code

string

Đơn vị tiền tệ của giá được xác định theo tiêu chuẩn ISO 4217.
pricing_option_tag

string

Một chuỗi không bắt buộc và không công khai xác định lựa chọn định giá được liên kết với giá mở rộng.

PriceInfo

Vùng chứa thông tin chi tiết về giá.

Trường
price_type

PriceType

Xác định cách áp dụng giá hoặc khoảng giá (mỗi người hoặc cố định)
Trường nhóm price_options. Các lựa chọn về giá là chỉ định giá chính xác hoặc một khoảng giá. price_options chỉ có thể là một trong những trạng thái sau:
price

Price

Giá của một dịch vụ hoặc một khoản phí.
price_range

PriceRange

Giới hạn trên và/hoặc giới hạn dưới của một dịch vụ hoặc một khoản phí.

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 chỉ định cách diễn giải giá, mặc định là EXACT_AMOUNT.
EXACT_AMOUNT

Khi giá phải được hiểu là một giá trị cụ thể.

Ví dụ: 200.000 VND cho một lớp học yoga; 150.000 VND cho dịch vụ cắt tóc cho trẻ em
STARTS_AT

Khi giá của một dịch vụ có thể thay đổi nhưng người tiêu dùng biết và nhìn thấy giá tối thiểu. Người tiêu dùng có thể đưa ra những lựa chọn làm tăng giá.

Xin lưu ý rằng mọi dịch vụ sử dụng PriceInterpretation này đều phải sử dụng PrepaymentType NOT_SUPPORTED.

Ví dụ: 300.000 VND cho dịch vụ chải chuốt cho chó, nhưng giá có thể tăng nếu người tiêu dùng có thêm lựa chọn
NOT_DISPLAYED

Khi giá của một dịch vụ có thể thay đổi và người tiêu dùng không thấy thông tin về giá trước đó.

Xin lưu ý rằng mọi dịch vụ sử dụng PriceInterpretation này đều phải sử dụng PrepaymentType NOT_SUPPORTED và Price phải trống.

Ví dụ: Một buổi tư vấn về dịch vụ tại nhà

PriceRange

Trình bao bọc cho một phạm vi số tiền được coi là không giới hạn, trừ phi cả hai giá trị đều được đặt. Bạn phải cung cấp ít nhất một trong hai giá trị min_amount và max_amount.

Trường
min_price

Price

Số tiền tối thiểu.
max_price

Price

Số tiền tối đa. Phải luôn lớn hơn min_price.

PriceType

Xác định cách xác định tổng giá từ tình trạng phòng.

Enum
FIXED_RATE_DEFAULT

Giá được tính theo 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ụ: Tiền đặt cọc 500.000 VND để đặt bàn; phí vắng mặt 200.000 VND cho một lớp học yoga
PER_PERSON

Giá được chỉ định là giá cho mỗi người và tổng giá được tính theo quy mô nhóm được chỉ định trong Tài nguyên dưới dạng price_micros * party_size. Giá PER_PERSON phải kèm theo quy mô nhóm trong tài nguyên tình trạng còn phòng. Nếu không, hệ thống sẽ sử dụng kích thước nhóm là một.

Ví dụ: 100.000 VND cho mỗi vé vào bảo tàng

QuantitativeValue

Trình bao bọc cho một giá trị bằng số có thể là một dải ô hoặc một giá trị cố định. QuantitativeValueVí dụ: * Giá trị đơn lẻ: value: 10.5 * Phạm vi có giới hạ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}

Trường
Trường nhóm value_options. (bắt buộc) value_options chỉ có thể là một trong những trạng thái sau:
value

double

Một giá trị duy nhất. Ví dụ: 5.6
value_range

RangeValue

Một dải giá trị cũng có thể là dải giá trị mở hoặc có giới hạn. Ví dụ: * Ít nhất 5,5 * Nhiều nhất 5,5 * Từ 5,5 đến 6,5

RangeValue

Phạm vi giá trị sao cho min_value < max_value. Bạn phải cung cấp ít nhất một trong hai thông tin min_value và max_value.

Trường
min_value

double

Giá trị tối thiểu.
max_value

double

Giá trị tối đa.

Rating

Xác định điểm xếp hạng cho một thực thể.

Trường
value

double

Giá trị điểm xếp hạng trung bình (bắt buộc khi number_of_ratings > 0). Giá trị phải nằm trong phạm vi [1, 5] và bạn chỉ có thể bỏ qua giá trị này nếu số lượng lượt đánh giá bằng 0.
number_of_ratings

uint64

Số lượng lượt 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 về những nội dung nghe nhìn này để đảm bảo rằng nội dung được hiển thị chính xác cho người dùng cuối. (không bắt buộc)

Trường
url

string

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

MediaType

Loại nguồn nội dung nghe nhìn này.
localized_caption

Text

Chú thích của nội dung nghe nhìn có 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

Attribution

Thông tin phân bổ về nguồn của nội dung nghe nhìn. Xin lưu ý rằng nếu bạn phải hiển thị thông tin ghi công cùng với nội dung nghe nhìn để ghi công 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
(deprecated)

string

Không dùng nữa, bạn nên sử dụng localized_caption.

Phân bổ

Thông tin ghi công cho nội dung nghe nhìn này.

Trường
localized_text

Text

Văn bản ghi công cho nhiếp ảnh gia hoặc công ty hỗ trợ i18n. Văn bản này sẽ xuất hiện cùng với nội dung nghe nhìn nguồn. Xin lưu ý rằng trường này chỉ hỗ trợ văn bản thuần túy, mọi thành phần HTML sẽ bị loại bỏ (không hỗ trợ thông tin ghi nhận dựa trên siêu liên kết).
text
(deprecated)

string

Không dùng nữa, bạn nên sử dụng localized_text.

MediaType

Liệt kê để 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ỗ bằng Google nếu bạn cần hỗ trợ các loại nội dung nghe nhìn khác ngoài ảnh.

Enum
TYPE_UNSPECIFIED Không dùng đến.
PHOTO Cho biết nội dung nghe nhìn do URL cung cấp là ảnh.

ReplaceServiceAvailabilityRequest

Yêu cầu thay thế thông tin về tình trạng còn phòng của Service.

Trường
service_availability

ServiceAvailability

Phạm vi cung cấp dịch vụ được dùng để thay thế các phạm vi hiện có.

RequireCreditCard

Xác định xem 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 về thẻ tín dụng không được chỉ định rõ ràng và hành vi này giống với hành vi được chỉ định cho CONDITIONAL.
REQUIRE_CREDIT_CARD_CONDITIONAL Google sẽ yêu cầu thẻ tín dụng để đặt chỗ nếu bạn đáp ứng bất kỳ điều kiện nào sau đây: * tình trạng còn phòng có giá và prepayment_type là REQUIRED * bạn đã đặt no_show_fee * bạn đã đặt trường deposit.
REQUIRE_CREDIT_CARD_ALWAYS Bạn luôn phải cung cấp thông tin thẻ tín dụng để đặt chỗ này, bất kể giá trị của các trường khác.

Tài nguyên

Tài nguyên được dùng để phân biệt các khung giờ trống với nhau khi có nhiều nhân viên hoặc phòng tham gia vào dịch vụ. Nhiều khung giờ 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.

Trường
staff_id

string

Mã nhận dạng không bắt buộc của 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à bản ghi về tình trạng còn chỗ. Giá trị này cũng cần ổn định theo thời gian để cho phép tương quan với các lượt đặt phòng trước đây. Bạn phải điền vào trường này nếu có trường staff_name.
staff_name

string

Tên không bắt buộc của nhân viên cung cấp dịch vụ. Trường này sẽ xuất hiện với người dùng đặt chỗ và phải dễ đọc, thay vì là một giá trị nhận dạng không rõ ràng. Bạn phải điền vào trường này nếu có staff_id.
room_id

string

Mã nhận dạng không bắt buộc cho phòng nơi dịch vụ được đặt. Trường này xác định phòng trên tất cả các bản ghi về người bán, dịch vụ và tình trạng còn phòng. Giá trị này cũng cần ổn định theo thời gian để cho phép tương quan với các lượt đặt phòng trước đây. Bạn phải cung cấp trường này nếu có room_name.
room_name

string

Tên không bắt buộc của phòng nơi đặt dịch vụ. Trường này sẽ xuất hiện với người dùng đặt chỗ và phải dễ đọc, thay vì là một giá trị nhận dạng không rõ ràng. (không bắt buộc nhưng phải có nếu có room_id) Trong nhà hàng, tên phòng chỉ được dùng cho khu vực chỗ ngồi (chẳng hạn như quầy bar hoặc hiên) và không được 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 trước hoặc bữa tối). Bạn nên thiết lập khu vực chỗ ngồi mặc định không có phòng liên kết.
party_size

int32

Chỉ áp dụng cho mục Ăn uống: Số người 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 Khung giờ cho cùng một thời điểm, mỗi Khung giờ chỉ định một party_size riêng, chẳng hạn như 2, 3 hoặc 4 người có thể đặt chỗ.
room_description

Text

Không bắt buộc. Nội dung mô tả phòng được bản địa hoá. Nếu được đặt, bạn phải cung cấp giá trị mặc định. Bạn cũng nên cung cấp các ngôn ngữ phổ biến cho ngôn ngữ của người bán. (không bắt buộc)

SchedulingRules

Quy tắc lên lịch cho một dịch vụ.

Trường
min_advance_online_canceling

int64

Thời gian tối thiểu để thông báo trước (tính bằng giây) cần thiết để huỷ cuộc hẹn đã đặt trực tuyến. (không bắt buộc)
late_cancellation_fee
(deprecated)

Price

Phí huỷ trong thời gian thông báo trước tối thiểu.
noshow_fee
(deprecated)

Price

Phí vắng mặt mà không huỷ.
admission_policy

AdmissionPolicy

Chính sách nhập học áp dụng cho dịch vụ này. Nếu bạn không đặt, giá trị mặc định sẽ là TIME_STRICT. (không bắt buộc)
cancellation_policy

CancellationPolicy

Chính sách huỷ đối với quy tắc lập lịch. (bắt buộc đối với Điểm tham quan)

Trường nhóm min_booking_buffer. Khoảng thời gian (tính bằng giây) từ thời điểm có thể đặt chỗ lần cuối cho đến khi khung giờ trống bắt đầu hoặc kết thúc.

Nếu bạn đặt "min_advance_booking", thì thời gian đặt chỗ muộn nhất được tính là (<thời gian bắt đầu của khung giờ> – "min_advance_booking"). Nếu bạn đặt "min_booking_buffer_before_end_time", thì thời gian đặt phòng muộn nhất được tính là (<giờ kết thúc của khung giờ> – "min_booking_buffer_before_end_time"). Xin lưu ý rằng giá trị của "min_booking_buffer_before_end_time" phải là số dương nếu được đặt. Nếu cả hai đều chưa được đặt, thì bạn có thể đặt lịch hẹn cho khung giờ cho đến thời gian bắt đầu của khung giờ. Nếu bạn đặt cả hai trường, thì hệ thống sẽ chỉ chọn một giá trị và bỏ qua giá trị còn lại. Chúng tôi không thể dự đoán một cách đáng tin cậy giá trị nào sẽ được chọn.

Ví dụ:

  • Dịch vụ cắt tóc cần được đặt trước ít nhất 1 giờ trước thời gian bắt đầu. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Một bảo tàng cho phép mua vé muộn nhất 30 phút trước khi đóng cửa: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • Vé xem phim cần được mua trước giờ bắt đầu. "scheduling_rules{ ...}" (để trống trường này) (không bắt buộc) min_booking_buffer chỉ có thể là một trong những trạng thái sau:
min_advance_booking

int64

Khoảng thời gian (tính bằng giây) từ thời điểm có thể đặt lượt đặt phòng cuối cùng đến thời điểm bắt đầu khung giờ trống.
min_booking_buffer_before_end_time

int64

Khoảng thời gian (tính bằng giây) từ thời điểm có thể đặt lượt đặt phòng cuối cùng cho đến khi kết thúc khung giờ trống. Nếu bạn đặt trường này, thì bạn phải đặt trường "admission_policy" thành TIME_FLEXIBLE để cho biết rằng người dùng có thể sử dụng vé đã mua sau khi các khung giờ bắt đầu.

AdmissionPolicy

Chính sách tiếp nhận của dịch vụ này.

Enum
ADMISSION_POLICY_UNSPECIFIED Không dùng đến.
TIME_STRICT Khách hàng phải có mặt vào thời gian bắt đầu của khung giờ có thể đặt lịch 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ờ đó. Ví dụ về các trường hợp sử dụng TIME_STRICT: * Một chuyến tham quan bắt đầu lúc 9 giờ sáng, yêu cầu tất cả người tham dự phải đến đúng giờ bắt đầu và quay lại vào khoảng 12 giờ trưa. Đặt lịch cắt tóc vào lúc 3 giờ chiều thứ Bảy, thời gian dự kiến là khoảng 30 phút. * Lớp học thể dục từ 6 giờ tối đến 8 giờ tối.
TIME_FLEXIBLE

Khách hàng có thể đến vào bất kỳ thời điểm nào trong khoảng thời gian bắt đầu và kết thúc của khung giờ có thể đặt để sử dụng lượt đặt này.

Ví dụ về các trường hợp sử dụng TIME_FLEXIBLE: * Vé bảo tàng có thể sử dụng vào bất kỳ thời điểm nào trong 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 giờ trưa đến 9 giờ tối.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Khách hàng cần đến cửa hàng của người bán vào thời gian bắt đầu của khung giờ có thể đến lấy nhưng có thể rời đi bất cứ lúc nào họ muốn.

Ví dụ: trong trường hợp vé vào cửa bảo tàng, vé vào cửa có khung giờ là 10 giờ sáng yêu cầu người dùng phải có mặt tại bảo tàng lúc 10 giờ sáng. Thời gian bắt đầu của các khung giờ có thể đặt lịch hẹn cho dịch vụ này là thời gian vào cửa được chỉ định. Tuy nhiên, thời gian kết thúc chỉ được dùng làm khoá để xác định khung giờ có thể đặt lịch hẹn.

Dịch vụ

Thông tin về một dịch vụ do người bán cung cấp, ví dụ: cắt tóc.

Trường
name

string

Tên tài nguyên dịch vụ có định dạng partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.
service_name

string

Tên của dịch vụ, ví dụ: "Cắt tóc nam". Không dùng nữa, hãy sử dụng localized_service_name.
localized_service_name

Text

Tên của dịch vụ, ví dụ: "Cắt tóc nam". Có thể ở một số ngôn ngữ.
description

string

Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Không dùng nữa, hãy sử dụng localized_description.
localized_description

Text

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 tương tự như HTML. Không giống như các phần 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ỹ các hướng dẫn và lưu ý sau đây để đảm bảo bạn mang lại trải nghiệm người dùng tốt nhất.

Các thẻ định dạng tương tự như HTML được hỗ trợ:

Thẻ tiêu đề: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Bạn có thể dùng thẻ tiêu đề để hiển thị tiêu đề và tiêu đề phụ. Ví dụ: <h1>Lịch trình</h1> sẽ hiển thị văn bản cùng dòng dưới dạng tiêu đề quan trọng nhất của phần. Xin lưu ý rằng mọi thẻ HTML, kiểu hoặc thuộc tính bên trong sẽ bị bỏ qua. Ví dụ: <h1 style=".."> sẽ được xử lý giống như <h1>. Chỉ văn bản thuần tuý mới được giữ lại.

Thẻ đoạn văn: <p>
Bạn có thể dùng thẻ đoạn văn để làm nổi bật nội dung hoặc phần giới thiệu chi tiết. Mọi thẻ, kiểu hoặc thuộc tính bên trong sẽ bị bỏ qua, ngoại trừ một số trường hợp: <br>, <strong> và <em>. Vui lòng xem phần thẻ cụm từ bên dưới để biết thêm thông tin chi tiết.

Thẻ danh sách: <ul>, <ol>, <li>
Bạn có thể dùng thẻ <ul> với thẻ <li> để hiển thị danh sách không có thứ tự và dùng thẻ <ol> với thẻ <li> để hiển thị danh sách có thứ tự. Đây là một cách hay để hiển thị danh sách kiểm tra, lịch biểu hoặc bất kỳ danh sách nào khác phù hợp với trường hợp sử dụng của bạn.
Ví dụ: Để hiện danh sách các tính năng của một chuyến du thuyền:
<ol>
<li>Cảnh biển tuyệt đẹp và cơ hội vui chơi với động vật hoang dã.</li>
<li>Dịch vụ và sắp xếp chuyến đi được thiết kế cẩn thận.</li>
<li>Đảm bảo giá thấp nhất.</li>
</ol>
Xin lưu ý rằng chỉ các phần tử con <li> trong thẻ <ul> hoặc <ol> mới được chuyển đổi. Tất cả các nút con khác sẽ bị loại bỏ. Ngoài ra, mọi thẻ, thuộc tính và kiểu bên trong sẽ bị bỏ qua; chúng tôi chỉ giữ lại nội dung văn bản thuần tuý.

Thẻ phân chia: <div>
Tất cả các thẻ bên trong được hỗ trợ của thẻ <div> sẽ được phân tích cú pháp theo các quy tắc nêu trên, ngụ ý rằng bản thân thẻ <div> không có nghĩa là bất kỳ nhóm hoặc thụt lề nào ở đây. Ngoài ra, mọi thuộc tính và kiểu bên trong sẽ bị bỏ qua.

Thẻ cụm từ: <br>, <strong>, <em>:
Chúng tôi chỉ hỗ trợ 3 thẻ nêu trên. Bạn có thể dùng <br> để ngắt dòng trong đoạn văn và dùng <strong>/<em> để làm nổi bật văn bản quan trọng. Mọi thẻ cụm từ khác đều sẽ bị bỏ qua.

Thẻ không được hỗ trợ:

  • Bạn không được phép dùng thẻ <html>, <header> và <body>.
  • Mọi thẻ khác không được đề cập ở trên đều không được hỗ trợ (ví dụ: <table>, <td> ...).
    Mọi URL, điểm neo và đường liên kết sẽ bị xoá và không bao giờ hiển thị cho người dùng cuối. Nếu bạn muốn sử dụng ảnh để tạo trải nghiệm phong phú cho người dùng, vui lòng sử dụng trường "related_media" bên dưới để gửi URL ảnh của bạn.

Lưu ý quan trọng:

  • Cố gắng không sử dụng các thẻ khác ngoài 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ị xoá và có thể dẫn đến trải nghiệm không mong muốn cho người dùng.
  • Cố gắng tránh các cấu trúc lồng sâu như có hơn 3 cấp tiêu đề khác nhau hoặc danh sách lồng nhau. Việc duy trì cấu trúc đơn giản, dễ hiểu và rõ ràng sẽ giúp mang lại trải nghiệm tốt hơn cho người dùng.
  • Nếu các bố cục hiện được hỗ trợ không đủ cho các trường hợp sử dụng của bạn, vui lòng liên hệ với nhóm Đặt chỗ bằng Google.
  • Kích thước tối đa nên dùng là 32.000 ký tự.
price

Price

Giá của dịch vụ.
price_interpretation

PriceInterpretation

Mô tả cách giá được diễn giải và hiển thị cho người dùng. Có thể được sử dụng bởi mọi ngành dọc, ngoại trừ ngành dọc Ăn uống và Điểm tham quan để định cấu hình cách hiển thị giá dịch vụ.
rules

SchedulingRules

Quy tắc đặt/huỷ lịch hẹn.
prepayment_type

PrepaymentType

Bạn có bắt buộc, không bắt buộc hay không được hỗ trợ thanh toán trước.
prepayment_terms

PrepaymentTerms

Các điều khoản về thời điểm hoàn tất khoản thanh toán trước.
form[]
(deprecated)

ServiceIntakeForm

Không dùng nữa. Vui lòng sử dụng intake_form và per_ticket_intake_form.
intake_form

ServiceIntakeForm

Một biểu mẫu yêu cầu người dùng cung cấp thêm thông tin khi họ đặt dịch vụ này. (không bắt buộc)
per_ticket_intake_form

ServiceIntakeForm

Một biểu mẫu yêu cầu người dùng cung cấp thêm thông tin khi họ đặt dịch vụ này. Người dùng phải điền thông tin 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

TaxRate

Thuế suất của dịch vụ. Nếu có, trường này sẽ ghi đè mọi tax_rate được đặt ở cấp người bán. Một thông báo trống (tức là tax_rate { }) sẽ đặt lại mức thuế đã áp dụng thành 0.
payment_option_id[]

string

Danh sách mã nhận dạng tham chiếu đến các lựa chọn thanh toán có thể dùng để thanh toán cho dịch vụ này. Các lựa chọn thanh toán thực tế được xác định ở cấp Người bán và cũng có thể được chia sẻ giữa nhiều Người bán.
deposit

Deposit

Xác định cách tính phí tiền đặt cọc cho người dùng. Ghi đè khoản tiền đặt cọc dịch vụ nếu bạn đã chỉ định một khoản tiền. Khi bạn đặt giá trị này thành một thông báo trống về Khoản tiền đặt cọc, mọi khoản tiền đặt cọc ở cấp dịch vụ sẽ bị xoá. (không bắt buộc)
no_show_fee

NoShowFee

Xác định một khoản phí vắng mặt mà người dùng có thể phải trả. Ghi đè phí vắng mặt của dịch vụ nếu bạn đã chỉ định một khoản phí. Việc đặt giá trị này thành thông báo NoShowFee trống sẽ xoá mọi khoản phí không xuất hiện ở cấp dịch vụ. (không bắt buộc)
require_credit_card

RequireCreditCard

Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt dịch vụ này hay không. Bạn có thể ghi đè trường này ở cấp độ tình trạng còn hàng. (không bắt buộc)
type

ServiceType

Loại dịch vụ được xác định trước của dịch vụ này. (không bắt buộc)
ticket_type[]

TicketType

Các loại vé có thể đặt/mua cho dịch vụ này, nếu dịch vụ có hỗ trợ vé. (không bắt buộc)
related_media[]

RelatedMedia

Ảnh liên quan đến dịch vụ này. Google sẽ thu thập dữ liệu và lưu trữ nội dung nghe nhìn để đảm bảo rằng nội dung đó được hiển thị cho người dùng cuối một cách hiệu quả nhất. (không bắt buộc)
service_attribute_value_id[]

ServiceAttributeValueId

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ể có từ 0 giá trị trở lên 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

WaitlistRules

Quy tắc tham gia danh sách chờ.
ticketing_vertical_specific_data

TicketingVerticalSpecificData

Thông tin bổ sung dành riêng cho ngành dọc bán vé sự kiện. (không bắt buộc)
integration_type

IntegrationType

Mức độ 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 có chế độ tích hợp cơ bản. Tính năng mã hoá đầu cuối sẽ luôn bị tắt đối với những đối tác này.
per_order_fee

PerOrderFee

Phí ở cấp đơn đặt hàng để mua dịch vụ này. (không bắt buộc)
tours_and_activities_content

ToursAndActivitiesContent

Các trường nội dung dành riêng cho Chuyến tham quan và Hoạt động.
location[]

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í đã ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION, bạn phải chỉ định START_LOCATION. Ví dụ: – Một chuyến tham quan bằng xe đạp có hướng dẫn viên đến 3 đị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, mọi người gặp nhau tại sảnh khách sạn rồi đến địa điểm tham quan. Bạn cần chỉ định địa điểm họp.
rating

Rating

Điểm xếp hạng từ người dùng cho dịch vụ này dưới dạng chỉ số tổng hợp trên tất cả các bài đánh giá.
home_service_data

HomeServiceData

Thông tin bổ sung dành riêng cho ngành dịch vụ tại nhà. (không bắt buộc)
virtual_session

VirtualSession

Không bắt buộc. Thông tin về phiên ảo. Đây là yêu cầu bắt buộc để bật các dịch vụ ảo.
direct_merchant_payment

DirectMerchantPayment

Không bắt buộc. Thông tin bổ sung cần được thêm vào nếu dịch vụ yêu cầu người dùng thanh toán trực tiếp cho người bán. LƯU Ý QUAN TRỌNG: RwG sẽ không tham gia vào giao dịch này. Đây là thông tin bắt buộc nếu bạn xác định virtual_session và dịch vụ không miễn phí hoặc bạn KHÔNG đặt prepayment_type thành REQUIRED.
uri_template

UriTemplate

Không bắt buộc. Một mẫu không bắt buộc chỉ định cách Google nên tạo URL cho trang web bên ngoài.

PrepaymentTerms

Thông tin cụ thể về thời điểm hoàn tất việc thanh toán trước.

Trường
charge_timing

ChargeTiming

Thời điểm tính phí so với thời điểm mua.
charge_time_before_start_time_sec

int64

Thời gian tính bằng giây trước thời gian bắt đầu dịch vụ mà người dùng phải trả phí. Bạn chỉ nên đặt trường này khi ChargeTiming là CHARGE_LATER.

ChargeTiming

Enum để chỉ định thời điểm tính phí so với thời điểm mua.

Enum
CHARGE_TIMING_UNSPECIFIED Không dùng đến.
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

Liệt kê để cho biết loại trả trước.

Enum
PREPAYMENT_TYPE_UNSPECIFIED Theo mặc định, chúng tôi sẽ giả định rằng khoản trả trước là NOT_SUPPORTED.
REQUIRED Người dùng phải thanh toán dịch vụ này tại thời điểm đặt phòng.
OPTIONAL Người dùng có thể chọn trả trước dịch vụ này tại thời điểm đặt chỗ hoặc sau đó, nhưng không bắt buộc phải trả trước để đặt chỗ.
NOT_SUPPORTED Dịch vụ này không hỗ trợ thanh toán trước.

ServiceType

Các loại dịch vụ được xác định trước.

Enum
SERVICE_TYPE_UNSPECIFIED Không dùng đến.
SERVICE_TYPE_DINING_RESERVATION Đặt chỗ dùng bữa.
SERVICE_TYPE_FOOD_ORDERING Đặt món ăn, có thể là giao đồ ăn hoặc mang đi hoặc cả hai.
SERVICE_TYPE_FOOD_DELIVERY Dịch vụ 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 các cuộc hẹn hoặc lớp học. Được đề xuất cho (1) sức khoẻ và thể dục, (2) spa và làm đẹp, cũng như (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 cuộc hẹn trực tuyến cho một lớp học hoặc buổi học hoàn toàn ảo. Bạn phải đặt thuộc tính này nếu bật tính năng đặt lịch hẹn dịch vụ ảo.
SERVICE_TYPE_SHOPPING Dịch vụ cho phép người dùng mua sắm tại người bán được chỉ định. Bạn có thể chọn giao hàng hoặc đến lấy hàng.

ServiceAttribute

Thuộc tính dịch vụ là những danh mục do đối tác xác định, mô tả các dịch vụ của người bán. Ví dụ: một 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 một 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", "Nhuộm tóc" và "Tạo kiểu tóc".

Trường
attribute_id

string

Giá trị nhận dạng xác định duy nhất thuộc tính dịch vụ này trong số những thuộc tính khác của cùng một người bán, ví dụ: "account-type".
attribute_name

string

Tên hiển thị cho người dùng của thuộc tính này, ví dụ: "Loại tài khoản".
value[]

Value

Tất cả các giá trị có thể có cho thuộc tính dịch vụ này.

Giá trị

Đại diện cho một giá trị có thể có của một thuộc tính dịch vụ cụ thể.

Trường
value_id

string

Giá trị nhận dạng giúp xác định riêng giá trị này trong số những giá trị khác cho thuộc tính dịch vụ này, ví dụ: "cá nhân".
value_name

string

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ụ.

Trường
attribute_id

string

Mã nhận dạng của một thuộc tính như được xác định trong Merchant.service_attribute, ví dụ: "service-type".
value_id

string

Mã nhận dạng của giá trị cho thuộc tính này, ví dụ: "haircut". 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 còn hàng và đối tượng/thời điểm áp dụng.

Trường
name

string

Tên tài nguyên của dịch vụ cần áp dụng chế độ cài đặt này. Ở định dạng partners/{partner_id}/merchants/{merchant_id}/services/{service_id}
start_time_restrict

Timestamp

Nếu được cung cấp, chúng tôi sẽ coi các thực thể Lịch trình cung cấp được cung cấp là thông tin đầy đủ từ [start_time_restrict, end_time_restrict). Tức là tất cả lịch phát sóng hiện có sẽ bị xoá nếu điều kiện sau đây là đúng:

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

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:

  availability.duration == duration_restrict

Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế thêm:

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

Các trường này thường được dùng để cung cấp thông tin cập nhật đầy đủ về tình trạng còn hàng trong một phạm vi thời gian nhất định.

Nếu bạn đặt start_time_restrict mà không đặt end_time_restrict, thì điều này có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict.
end_time_restrict

Timestamp

Việc đặt end_time_restrict trong khi không đặt start_time_restrict được hiểu là tất cả thời gian cho đến end_time_restrict.
duration_restrict

Duration

Việc đặt thời lượng sẽ hạn chế thêm phạm vi cập nhật chỉ đối với những khoảng thời gian rảnh/bận có thời lượng trùng khớp.
resources_restrict

Resources

Việc thiết lập resources_restrict sẽ hạn chế thêm 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 hoàn toàn khớp.
availability[]

Availability

Danh sách mới về tình trạng còn phòng.

ServiceIntakeForm

Xác định một biểu mẫu nhập thông tin giúp tuỳ chỉnh dịch vụ do người bán cung cấp.

Trường
field[]

ServiceIntakeFormField

Các trường sẽ hiển thị cho người dùng.
first_time_customers
(deprecated)

bool

Nếu là true, biểu mẫu này sẽ xuất hiện cho khách hàng lần đầu. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu tiếp nhận.
returning_customers
(deprecated)

bool

Nếu đúng, biểu mẫu này sẽ xuất hiện cho 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 tiếp nhận.

ServiceIntakeFormField

Xác định một trường có trong ServiceIntakeForm.

Trường
id

string

Một chuỗi từ đối tác tổng hợp giúp xác định duy nhất một trường biểu mẫu. Mã nhận dạng này phải giống với mã nhận dạng trong câu trả lời của trường biểu mẫu tương ứng và phải là mã nhận dạng riêng biệt ở cả cấp dịch vụ và theo từng biểu mẫu tiếp nhận phiếu yêu cầu hỗ trợ. (bắt buộc)
type

FieldType

Loại của trường này.
label

string

Văn bản hiển thị cho người dùng cho trường này. Không dùng nữa, vui lòng sử dụng localized_label.
localized_label

Text

Văn bản hiển thị cho người dùng cho trường này. Bạn có thể cung cấp trường này bằng nhiều ngôn ngữ. (bắt buộc)
value[]

string

Đặt nếu và chỉ 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[]

Text

Đặt nếu và chỉ khi loại trường là MULTIPLE_CHOICE, CHECKBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể.
is_required

bool

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

bool

Cho biết liệu giá trị tuỳ chỉnh có được phép ngoài các câu trả lời định sẵn 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[]

Text

Các lựa chọn bổ sung đượ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ể chọn "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc)
ticket_type_restrict[]

string

Nếu câu hỏi này chỉ xuất hiện khi người dùng đặt một số loại vé nhất định, thì bạn nên đặt trường này làm tập hợp mã loại vé áp dụng. Để trống trường này nếu câu hỏi luôn áp dụng.
hint

Text

Văn bản gợi ý cho thông tin đầu vào, xuất hiện dưới dạng 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

Liệt kê để cho biết loại trường.

Enum
FIELD_TYPE_UNSPECIFIED Các trường thuộc loại không xác định hoặc không xác định được sẽ bị bỏ qua.
SHORT_ANSWER Một trường nhập dữ liệu có một dòng.
PARAGRAPH Một trường nhập dữ liệu nhiều dòng cho văn bản.
MULTIPLE_CHOICE Một nhóm nút chọn yêu cầu chọn một trong nhiều lựa 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.

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ể được đặt trên cơ sở mỗi người bán hoặc mỗi dịch vụ.

Trường
micro_percent

int32

Tỷ lệ thuế tính bằng phần triệu của 1%, tức là có 6 chữ số thập phân. Ví dụ: nếu thuế suất là 7, 253%, thì bạn nên đặ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á mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ chính xác bằng giá mà bạn chỉ định theo Service.price. 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. Người dùng sẽ không thấy thuế dưới dạng một mục riêng.

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á mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được tính theo mức thuế mà bạn cung cấp ở đây. Phần nhỏ nhất của đơn vị tiền tệ (ví dụ: phần nhỏ nhất của một xu) sẽ được làm tròn bằng cách làm tròn đến số 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 riêng.

Điều khoản

Một bộ quy tắc và nguyên tắc được hiển thị cho người dùng để đặt chỗ thông qua tính năng Đặt chỗ bằng Google.

Trường
url

string

Bạn có thể cung cấp URL cho Điều khoản và điều kiện (không bắt buộc).
text

string

Văn bản sẽ hiển thị cho người người dùng. Sử dụng localized_text bên dưới cho các chế độ tích hợp mới.
localized_text

Text

Văn bản đã bản địa hoá sẽ hiển thị cho người dùng.

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.

Trường
value

string

Giá trị văn bản ở một ngôn ngữ không xác định. Bắt buộc nếu và chỉ nếu localized_value trống. Ngôn ngữ của giá trị này có thể tuỳ thuộc vào đối tác hoặc nhà cung cấp dịch vụ. Bạn không nên giả định rằng đó là một ngôn ngữ cụ thể.
localized_value[]

LocalizedString

Giá trị văn bản theo ngôn ngữ. Không bắt buộc.

TicketType

TicketType được dùng để phân biệt các loại vé có giá và/hoặc tình trạng còn vé khác nhau do các loại người dùng, thuộc tính dịch vụ hoặc lựa chọn/tiện ích bổ sung khác nhau.

Vé là đơn vị tối thiểu có thể đặt cho một dịch vụ, ví dụ: một chỗ trong chuyến đi bè, vé vào cửa bảo tàng, dịch vụ cho thuê thuyền kayak đôi cả ngày.

Trường
ticket_type_id

string

Mã vé đượ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ỉ được phép là mã riêng biệt trong một dịch vụ.
short_description

string

Nội dung mô tả ngắn về TicketType này.

Đây có thể là thông tin mà người dùng nhìn thấy, ví dụ: "người lớn", "trẻ em", "cựu chiến binh", "hàng J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả mà người dùng nhìn thấy. Không dùng nữa, hãy sử dụng localized_short_description.
localized_short_description

Text

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", "cựu chiến binh", "hàng 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. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ.
price

Price

Giá của một vé thuộc loại này, không bao gồm thuế. Mức thuế của Dịch vụ được áp dụng cho vé của dịch vụ đó.
per_ticket_fee

PerTicketFee

Các khoản phí bổ sung khi mua vé này. (không bắt buộc)
price_display_type

PriceDisplayType

Không bắt buộc. Loại hiển thị giá được xác định trước của một vé thuộc loại này.
option_description

string

Nội dung mô tả về mọi lựa chọn bổ sung mà loại vé này đại diện (nếu có). Không dùng nữa, hãy sử dụng localized_option_description.
localized_option_description

Text

Nội dung mô tả về mọi lựa chọn bổ sung mà loại vé này đại diện (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 vé thể hiện nhiều phương diện.

Ví dụ 1: 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, danh sách TicketType dự kiến sẽ là: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

Ví dụ 2: dịch vụ cho thuê thuyền kayak nhiều giờ có thêm gói bổ sung túi chống nước (không bắt buộc), short_description có thể là "3 giờ" và option_description có thể là "có túi chống nước" hoặc "không có túi chống nước": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

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 cũng mong đợi tất cả các loại vé khác đều có trường này được đặt (bạn có thể sử dụng một option_description mặc định). Ví dụ: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] không phải là danh sách hợp lệ.

Chỉ hỗ trợ 2 thẻ định dạng HTML: và
. Các lựa chọn này được dùng để chỉ định các lựa chọn có cả tiêu đề và nội dung mô tả chi tiết, ví dụ: "Ghế cao cấp
Lựa chọn này cung cấp ghế ngồi tại các hộp riêng, bao gồm cả ghế có đệm đầy đủ, TV riêng, dịch vụ Thực phẩm và đồ uống tại chỗ. Những chỗ ngồi này có tầm nhìn đẹp như tranh vẽ ra sân."
inventory_type

InventoryType

Không bắt buộc. Loại khoảng không quảng cáo được xác định trước của một vé duy nhất thuộc loại này.

InventoryType

Loại khoảng không quảng cáo được xác định trước của một vé duy nhất thuộc loại này.

Enum
INVENTORY_TYPE_UNSPECIFIED Bạn chưa chỉ định loại khoảng không quảng cáo.
INVENTORY_TYPE_PRIMARY Khoảng không quảng cáo chính.
INVENTORY_TYPE_VERIFIED_RESALE Kho hàng bán lại đã được xác minh.
INVENTORY_TYPE_RESALE Khoảng không quảng cáo bán lại.
INVENTORY_TYPE_AGGREGATOR Kho hàng của đơn vị tổng hợp. Trang web tổng hợp (ví dụ: www.bandsintown.com) nghĩa là đối tác cung cấp thông tin về sự kiện và vé. Tuy nhiên, vé không phải do đối tác bán trực tiếp. Người bán vé thực tế có thể là người bán vé chính, người bán lại đã xác minh hoặc người bán lại. Giờ đây, chúng tôi chỉ phân biệt loại khoảng không quảng cáo của đối tác cấp cao nhất và bỏ qua loại khoảng không quảng cáo thực tế của người bán vé trong một đơn vị tổng hợp.

PriceDisplayType

Cho biết định dạng giá xuất hiện trên trang đích.

Trường này sẽ bị bỏ qua đối với khoảng không quảng cáo không có đường liên kết.

Trường này cho phép các nền tảng của Google hiển thị cùng một định dạng giá như trang đích của Dịch vụ. Định dạng giá nhất quán giúp cải thiện tỷ lệ chuyển đổi và giảm nhầm lẫn.

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Bạn chưa chỉ định loại giá hiển thị. Google sẽ xác định định dạng cần hiển thị.
PRICE_DISPLAY_TYPE_BASE Giá xuất hiện trên trang đích là giá cơ sở.
PRICE_DISPLAY_TYPE_ALL_IN Giá hiển thị trên trang đích bao gồm tất cả các khoản phí và thuế.

TicketingVerticalSpecificData

Thông tin bổ sung dành riêng cho ngành dọc bán vé sự kiện.

Trường
event_category

EventCategory

Danh mục của sự kiện. Chỉ đặt 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

string

URL của sự kiện trên trang web của đối tác. (không bắt buộc)
entity[]

Entity

Danh sách các thực thể liên quan đến sự kiện. (không bắt buộc)
event_attendance_mode

AttendanceMode

Bắt buộc. Loại hình tham dự sự kiện.
event_virtual_location_url[]

string

Không bắt buộc. URL nơi có thể xem sự kiện.
event_organizer

Text

Không bắt buộc. Người tổ chức sự kiện.
event_organizer_url

string

Không bắt buộc. URL của người tổ chức sự kiện.
event_organizer_type

OrganizerType

Không bắt buộc. Loại người tổ chức.
event_source_url[]

string

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

EventState

Không bắt buộc. Trạng thái của sự kiện.
brand_name

Text

Không bắt buộc. Tên thương hiệu đã bản địa hoá.
event_creator

EventCreator

Không bắt buộc. Thông tin về người tạo sự kiện.

AttendanceMode

Loại hình tham dự sự kiện.

Enum
ATTENDANCE_MODE_UNSPECIFIED Chưa chỉ định.
ONLINE Đối với sự kiện trực tuyến.
PHYSICAL Đối với sự kiện thực tế.
PHYSICAL_ONLINE_MIXED Đối với những sự kiện diễn ra cả ngoài đời thực và trên mạng.

Thực thể

Biểu thị một thực thể liên quan đến sự kiện.

Trường
id

string

Giá trị nhận dạng riêng biệt của thực thể trong cơ sở dữ liệu của đối tác. (không bắt buộc)
name

string

Tên của thực thể. (bắt buộc)
url

string

URL của trang web mô tả rõ ràng thực thể. Đây là trang trên trang web của đối tác dành cho thực thể (nếu có); đối với các URL công khai khác của thực thể, hãy sử dụng relevant_url trong public_identification_data. (không bắt buộc)
entity_type

EntityType

Loại thực thể. (không bắt buộc)
entity_role

EntityRole

Vai trò của thực thể trong sự kiện. (không bắt buộc)
public_identification_data

PublicIdentificationData

Thông tin tham khảo công khai về 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 chỉ định.
ENTITY_ROLE_HEADLINER Thực thể này đại diện cho một nghệ sĩ chính 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 một người biểu diễn phụ tại sự kiện.
ENTITY_ROLE_HOME_TEAM Thực thể này đại diện cho đội nhà tại sự kiện (thể thao).
ENTITY_ROLE_AWAY_TEAM Thực thể 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 nhằm mục đích trở thành một bản thể học phổ quát.

Enum
ENTITY_TYPE_UNSPECIFIED Chưa chỉ định. Không được dùng.
ENTITY_TYPE_PERFORMER Thực thể này đại diện cho nghệ sĩ hoặc nhóm nhạc biểu diễn tại một 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 cầu thủ 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 mà sự kiện này thuộc về. 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 mà sự kiện này thuộc về. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO.
ENTITY_TYPE_PLAY Thực thể này đại diện cho loại vở 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 nhỏ các danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm về sản phẩm. Lưu ý: không nhằm mục đích trở thành một bản thể học phổ quát về các sự kiện.

Enum
EVENT_CATEGORY_UNSPECIFIED Chưa chỉ định. Không được dùng.
EVENT_CATEGORY_CONCERT Sự kiện âm nhạc.
EVENT_CATEGORY_SPORTS Sự kiện thể thao.
EVENT_CATEGORY_THEATRE Sự kiện tại rạp hát.
EVENT_CATEGORY_EXHIBITS Triển lãm.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Hội thảo và lớp học.

EventCreator

Thông tin về người tạo sự kiện. Chỉ liên quan đến những nền tảng có sự kiện nội dung do người dùng tạo.

Trường
name

string

Không bắt buộc. Tên của người tạo sự kiện. Không có quy định hạn chế về ký tự.

EventState

Trạng thái của sự kiện.

Enum
EVENT_STATE_UNSPECIFIED Chưa chỉ định.
SCHEDULED Sự kiện đã được lên lịch.
RESCHEDULED Sự kiện đượ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 chỉ định.
PERSON Đối với người tổ chức là cá nhân.
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 bất kỳ nguồn công khai nào khác đề cập đến một thực thể.

Trường
relevant_url[]

string

URL công khai của mọi trang web chỉ dành riêng cho chủ đề đó. Ví dụ: Trang web chính thức, Discogs, các nền tảng truyền thông xã hội, Wikipedia hoặc IMDb, chẳng hạn như 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

string

Mã nhận dạng gồm 36 ký tự của nghệ sĩ hoặc các thực thể âm nhạc khác trên MusicBrainz (nếu có). Xem https://musicbrainz.org/doc/MusicBrainz_Identifier. (không bắt buộc)

TimeRange

Một phạm vi thời gian đóng-mở, tức là [start_time, end_time).

Trường
start_time

Timestamp

Giới hạn dưới của phạm vi thời gian.
end_time

Timestamp

Giới hạn trên của phạm vi thời gian.

TokenizationConfig

Một cấu hình để mã hoá bằng mã thông báo của công ty xử lý thanh toán, được thiết lập theo từng người bán.

Trường
tokenization_parameter

map<string, string>

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 đơn vị xử lý.

Các tham 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ụ về Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Ví dụ về Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Ví dụ về Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }
billing_information_format

BillingInformationFormat

Đưa thông tin thanh toán của người dùng vào mã thông báo thanh toán khi họ nhập thông tin này vào Google Pay bằng FOP (xem ở trên). Việc để trống trường này tương đương với việc chỉ định MIN.

BillingInformationFormat

Bạn yêu cầu người dùng cung cấp bao nhiêu thông tin về Địa chỉ thanh toán và đưa vào mã thông báo. Các giá trị enum tương ứng với các tham số trong Google Pay API (xem https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Enum
BILLING_INFORMATION_FORMAT_UNSPECIFIED Chưa chỉ đị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ố, thành phố, vùng, 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 kết xuất riêng (ví dụ: dưới dạng dấu đầu dòng).

Bạn nên điền sẵn ToursAndActivitiesContent 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 túy và văn bản tương tự như HTML để định dạng cơ bản. Các thẻ định dạng tương tự như 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 // để làm nổi bật một văn bản quan trọng. Mọi thẻ cụm từ khác đều sẽ bị bỏ qua.

Tất cả các thẻ và kiểu tuỳ chỉnh khác đều không được phép và sẽ bị xoá. Mọi URL, điểm neo và đường liên kết sẽ bị xoá và không bao giờ hiển thị cho 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 nội dung mô tả dịch vụ. * Tránh sử dụng các thẻ khác ngoài 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ị xoá và có thể dẫn đến trải nghiệm người dùng không mong muốn.

Trường
highlights[]

Text

Danh sách điểm nổi bật mà người dùng nhìn thấy.
inclusions[]

Text

Danh sách các nội dung được đưa vào mà người dùng có thể thấy.
exclusions[]

Text

Danh sách loại trừ mà người dùng có thể thấy.
must_know[]

Text

Danh sách các ghi chú quan trọng mà người dùng nhìn thấy, dùng để biết các thông tin chi tiết như quy định hạn chế về độ 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

Các lựa chọn cho những bên nằm ngoài phạm vi.

Trường
Trường nhóm kind. Các lựa chọn hiện có cho những bên nằm ngoài phạm vi. kind chỉ có thể là một trong những trạng thái sau:
call_merchant

CallMerchant

Những nhóm có số lượng người ngoài phạm vi có thể gọi điện cho doanh nghiệp. Một thông báo được xác định trước sẽ xuất hiện cho người dùng. Văn bản mẫu sẽ xuất hiện: "Đối với những buổi tiệc có hơn {waitlist_rules.max_party_size} người tham dự, vui lòng gọi cho nhà hàng theo số {phone}." Bạn phải đặt CallMerchant nhưng sẽ để trống.

UpdateAdsAccountLinkRequest

Thông báo yêu cầu cho AdsAccountLinkingService.UpdateAdsAccountLink.

Trường
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

UpdateBookingRequest

Yêu cầu cập nhật google.maps.booking.v1alpha.Booking

Trường
update_mask

FieldMask

Mặt nạ trường của tất cả các trường đặt phòng cần được cập nhật
booking

Booking

Thông tin đặt chỗ cần cập nhật
booking_failure

BookingFailure

Nếu quá trình xử lý yêu cầu đặt chỗ được xác nhận không đồng bộ không thành công và trạng thái đặt chỗ đang được cập nhật thành THẤT BẠI, thì trường này phải phản ánh lỗi logic nghiệp vụ (ví dụ: người dùng đã có một lượt đặt chỗ quá gần với thời gian 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 THẤT BẠI, nếu không, trường này sẽ bị bỏ qua.

UpdateMerchantRequest

Yêu cầu cập nhật Merchant.

Trường
merchant

Merchant

Dữ liệu mới của người bán.
update_mask

FieldMask

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 google.maps.booking.v1alpha.Order

Trường
update_mask

FieldMask

Mặt nạ trường của tất cả các trường đơn đặt hàng cần được cập nhật
order

Order

Đơn đặt hàng cần cập nhật

UpdateServiceRequest

Yêu cầu cập nhật Service.

Trường
service

Service

Dữ liệu dịch vụ mới.
update_mask

FieldMask

Các trường cụ thể cần cập nhật cho dịch vụ.

UriTemplate

Một mẫu chỉ định cách Google nên tạo URL cho trang web bên ngoài.

Trường
uri_template

string

Không bắt buộc. Mẫu uri phải tuân theo RFC6570, hãy xem https://datatracker.ietf.org/doc/html/rfc6570. Hỗ trợ mẫu Cấp 2. Các tham số này sẽ được phân giải thành các giá trị được chỉ định trong các thực thể tương ứng.

Các tham số có sẵn cho đường liên kết đặt chỗ ăn uống: 1) (bắt buộc) {availability_slot_start_seconds} :: được điền sẵn từ trường start_sec trong nguồn cấp dữ liệu về tình trạng còn chỗ 2) (bắt buộc) {resources_party_size} :: được điền sẵn từ trường party_size trong nguồn cấp dữ liệu về tình trạng còn chỗ 3) (không bắt buộc) {availability_slot_duration_seconds} :: được điền sẵn từ trường duration_sec trong nguồn cấp dữ liệu về tình trạng còn chỗ 4) (không bắt buộc) {availability_slot_availability_tag} :: được điền sẵn từ trường availability_tag trong nguồn cấp dữ liệu về tình trạng còn chỗ

Ví dụ về cách sử dụng: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

Với: * start_sec = 123456 * party_size = 2

https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

Hạn chế những người dùng đủ điều kiện mua một phương thức thanh toán.

Trường
new_to_merchant

bool

Một lựa chọn thanh toán chỉ dành cho 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

bool

Một lựa chọn thanh toán mà chỉ những người dùng chưa từng mua lựa chọn thanh toán đó mới có thể mua.

VirtualSession

Thông tin về phiên ảo/trực tuyến. Ví dụ: Lớp học yoga trực tuyến, lớp học nấu ăn ảo, v.v.

Trường
session_instructions

Text

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 cùng với thông tin đặt chỗ, thì văn bản này phải cho biết thời điểm URL của video sẽ được chia sẻ với người dùng. Ví dụ: "URL Zoom sẽ được gửi qua email 30 phút trước khi lớp học bắt đầu". (Nên dùng)
session_requirements

Text

Yêu cầu đối với phiên ảo đã cho. Ví dụ: thảm tập yoga, đồ dùng nấu ăn, v. v. (Nên dùng)
virtual_platform_info

VirtualPlatformInfo

Thông tin về nền tảng ảo được dùng trong phiên này. (Bắt buộc để bật dịch vụ ảo)
is_session_prerecorded

bool

Bắt buộc. Đặt giá trị này thành true nếu phiên họp ảo không diễn ra trực tiếp và được ghi hình trước.

VirtualPlatformInfo

Thông tin về nền tảng sẽ được dùng cho phiên ảo này.

Trường
platform

Platform

Nền tảng được dùng cho phiên ảo.
other_platform_name

Text

Tên của nền tảng nếu nền tảng được đặt thành KHÁC. (Bắt buộc nếu nền tảng được đặt thành OTHER)

Nền tảng

Liệt kê để cho biết người bán sẽ sử dụng nền tảng ảo nào.

Enum
PLATFORM_UNSPECIFIED Không dùng đến.
FLEXIBLE Người bán có thể linh hoạt trong việc sử dụng nền tảng video.
GOOGLE_HANGOUTS Sản phẩm Google Hangouts.
GOOGLE_MEET Sản phẩm Google Meet.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE Phát trực tiếp trên YouTube.
OTHER Bạn nên đặt thông số này nếu nền tảng video bạn sử dụng khác với những nền tảng được đề cập ở đây.

WaitlistRules

Các quy tắc liên quan đến việc tham gia danh sách chờ.

Trường
min_party_size

int32

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ì bạn không được điền thông tin này.
max_party_size

int32

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ì bạn không được điền thông tin này.
supports_additional_request

bool

Nếu đúng, người dùng sẽ có thể gửi yêu cầu bổ sung bằng văn bản tuỳ ý khi tham gia danh sách chờ dịch vụ này.
above_max_party_size_options[]

UnsupportedPartySizeOption

Đặt các lựa chọn cho những nhóm lớn hơn max_party_size đã đặt. Để trống nếu bạn không muốn đưa ra lựa chọn thay thế cho những nhóm có số người lớn hơn để tham gia danh sách chờ.