Package google.maps.booking.v1alpha

Chỉ mục

BookingNotification

Nhận thông báo về các cuộc hẹn từ các đối tác đặt lịch bên ngoài. Đối tác nên gọi Update Update hoặc UpdateOrder tuỳ thuộc vào việc đối tác có triển khai các RPC dựa trên lượt đặt trước, chẳng hạn như CreateReset và CheckAvailability hay các RPC cơ sở đặt hàng như CreateOrder và CheckOrderFulfillability hay không.

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

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

Phạm vi cấp phép

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 một Order hiện có.

Phạm vi cấp phép

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

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Truy xuất Status của nguồn cấp dữ liệu bạn đã tải lên trước đó bằng đơn vị tập hợp đã chỉ định, rồi trả lại nguồn cấp dữ liệu đó.

Phạm vi cấp phép

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 của người bán, dịch vụ hoặc tình trạng còn hàng mà đơn vị tập hợp đã chỉ định tải lên trước đó rồi trả lại các nguồn cấp dữ liệu đó.

Phạm vi cấp phép

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)

Vô hiệu hoá tài nguyên hiện có.

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

Các loại tài nguyên được hỗ trợ: - Đến lấy hàng

Phạm vi cấp phép

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 so khớp của những người bán đã tải lên.

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Lấy MerchantStatus của Merchant.

Phạm vi cấp phép

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 cấp phép

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 hàng 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 quy trình xác thực cơ bản (như yêu cầu không đúng định dạng), sau đó hệ thống sẽ trả về phản hồi thích hợp cho đối tác ngay lập tức. Google thực hiện xác thực logic nghiệp vụ cho 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 cấp phép

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 thuộc loại nguồn cấp dữ liệu đã chỉ định. Chỉ thực hiện quy trình xác thực cơ bản (như yêu cầu không đúng định dạng), sau đó hệ thống sẽ trả về phản hồi thích hợp cho đối tác ngay lập tức. Google thực hiện xác thực logic nghiệp vụ cho 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 cấp phép

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ề các khung giờ trống đã cập nhật thành công.

Phạm vi cấp phép

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 trang web tổng hợp mới Merchant do trang web tổng hợp đã chỉ định quản lý và trả về trang web đó.

Phạm vi cấp phép

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

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

rpc CreateService(CreateServiceRequest) returns (Service)

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

Phạm vi cấp phép

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 đơn vị tập hợp đã 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ị vô hiệu hoá. Nếu sau này bạn thêm lại người bán thì nhóm dịch vụ và tình trạng còn hàng đó sẽ xuất hiện.

Phạm vi cấp phép

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 người bán do đơn vị tập hợp đã chỉ định quản lý. Tất cả khả năng hoạt động của dịch vụ cũng sẽ bị xoá.

Phạm vi cấp phép

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 người bán do đơn vị tập hợp đã chỉ định quản lý và trả lại hàng đó.

Phạm vi cấp phép

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 một trang web tổng hợp Merchant hiện có do trang web tổng hợp đã chỉ định quản lý và trả về trang web đó.

Phạm vi cấp phép

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 người bán do đơn vị tập hợp đã chỉ định quản lý rồi trả lại hàng đó.

Phạm vi cấp phép

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

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

ActionLinkType

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

Enum

ActionPlatform

Nền tảng mà hành động được thực hiện. Ứng dụng web là phương án dự phòng chung. Bạn nên có ít nhất một Liên kết hành động với ACTION_PLATFORM_WEB_APPLICATION. Các đường liên kết với 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 chưa được chỉ định.
ACTION_PLATFORM_WEB_APPLICATION Nền tảng hành động nói chung là web.
ACTION_PLATFORM_MOBILE_WEB Nền tảng hành động là nền tảng 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.

Lời khuyên

Nội dung thông báo hiển thị cho người dùng khi họ đặt phòng thông qua tính năng Đặt chỗ với Google.

Trường
text

Text

Thông báo tuỳ chỉnh sẽ hiển thị cho người dùng khi họ đặt phòng thông qua tính năng Đặt chỗ với Google.

Phạm vi cung cấp

Vị trí cho biết tình trạng còn hàng trong dịch vụ của người bán, cho biết thời gian và số lượng mặt hàng.

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ố chỗ và chỗ trống trong thời gian trống này. Ví dụ:

  • Lớp Yoga gồm 10 chỗ, có 3 chỗ được đặt trước: availability {spots_total: 10, spots_open: 7 ...}
  • Buổi mát xa trên ghế đã được đặt kín: availability {spots_total: 1, spots_open: 0 ...}

Lưu ý: Nếu gửi yêu cầu sử dụng định dạng nén tính sẵn có được xác định bên dưới, hai trường này sẽ được suy ra.

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

int64

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

availability_tag

string

Một chuỗi mờ tuỳ chọn để xác định vùng tình trạng rảnh/bận này. Nếu được đặt, lịch hẹn này sẽ được đưa vào yêu cầu đặt lịch/cập nhật/huỷ cuộc hẹn.

resources

Resources

Các tài nguyên không bắt buộc dùng để phân biệt khung giờ trống này với những phòng khác khi dịch vụ có nhiều nhân viên hoặc phòng.

Ví dụ: cùng một lớp Yoga với 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ể được dùng để thanh toán cho vùng 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 nhất thiết phải xuất hiện trong thông báo dịch vụ, mặc dù phải được xác định ở cấp Người bán.

recurrence

Recurrence

Thông tin lặp lại về tình trạng rảnh/bận, cho biết nhiều thời gian bắt đầu. Một sự kiện lặp lại phải chứa các cuộc hẹn trong một ngày làm việc.

schedule_exception[]

ScheduleException

Thời gian không thể lên lịch 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 gửi không bắt buộc cho tính sẵn có này. Ghi đè khoản tiền gửi dịch vụ nếu đã được chỉ định.

no_show_fee

NoShowFee

Không bắt buộc phải trả phí không trình chiếu đối với tình trạng còn phòng này. Ghi đè phí dịch vụ không hiển thị nếu bạn đã chỉ định phí không hiển thị.

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 khung giờ trống này hay không. Nếu bạn không đặt giá trị này, thì giá trị sẽ được kế thừa từ cấp dịch vụ (nếu được đặt tại đó). (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òn trống này. Nếu không đặt, tất cả các loại vé trong dịch vụ mẹ đều dùng được cho vùng này. Lưu ý rằng bạn phải xác định các giá trị của trường này trong dịch vụ mẹ. Ví dụ:

  • Dịch vụ có 4 loại vé: TicketType {ticket_type_id: "adult_1" short_description: "Dành cho người lớn các ngày trong tuần"} Loại vé {ticket_type_id: "adult_2" short_description: "Ngày cuối tuần dành cho người lớn"} Loại vé {ticket_type_id: "youth_1" short_description: "Các ngày trong tuần của giới trẻ"} TicketType {ticket_type_id: "youth_2" short_description: "Ngày cuối tuần của giới trẻ"}

Để thể hiện khoảng không quảng cáo vào các ngày trong tuần: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Để đại diện cho kho hàng trong dịp lễ: 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"} Loại vé {ticket_type_id: "thanh niên" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Người cao tuổi"}

Để 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 "tình trạng còn hàng {...}" (không đặt đặt vé_type_id ở vị trí này).

(không bắt buộc)

duration_requirement

DurationRequirement

Yêu cầu về việc hiển thị thời lượng và/hoặc thời gian kết thúc của vùng quảng cáo. Trường này sẽ bị bỏ qua nếu vùng đó không có sẵn. Không được dùng trong ngành dọc Điểm tham quan. (không bắt buộc)

scheduling_rule_overrides

SchedulingRuleOverrides

Quy tắc lên lịch về tình trạng rảnh/bận. Nếu các trường được điền sẵn, chúng 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 tình trạng phòng này. Những nỗ lực tạo yêu cầu đặt trước cho tình trạng còn hàng bằng phương thức xác nhận là CONFIRMATION_MODE_SYNCHRONOUS phải được xác nhận hoặc bị từ chối ngay lập tức. Đối với những yêu cầu đặt lịch phát sóng cho lịch phát sóng có phương thức xác nhận là CONFIRMATION_MODE_ASYNCHRONOUS, hệ thống phải từ chối ngay lập tức hoặc được tạo với trạng thái PENDING.

ConfirmationMode

Các chế độ xác nhận được sử dụng khi đặt lịch hẹn.

Enum
CONFIRMATION_MODE_UNSPECIFIED Chưa chỉ định chế độ xác nhận. Trạng thái xác nhận đồng bộ sẽ được giả định.
CONFIRMATION_MODE_SYNCHRONOUS Các yêu cầu đặt trước cho tình trạng còn hàng này sẽ được xác nhận một cách đồng bộ.
CONFIRMATION_MODE_ASYNCHRONOUS Yêu cầu đặt trước cho tình trạng còn hàng này sẽ được xác nhận không đồng bộ.

DurationRequirement

Enum này cho biết những yêu cầu nào tồn tại để người dùng xác nhận hoặc xem thời lượng/thời gian kết thúc của khung giờ được yêu cầu.

Enum
DURATION_REQUIREMENT_UNSPECIFIED Chưa chỉ định thời gian 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 không nhìn 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 thì mới có thể đặt cuộc hẹn.

Tần suất

Không bắt buộc phải gửi thông báo định kỳ, nhưng cho phép trình bày ngắn gọn hơn các khung giờ trống lặp lại liên tục. Chúng thường thể hiện lịch biểu làm việc trong một ngày. Sau đó, các thông báo ScheduleException được dùng để biểu thị phạm vi 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 khung giờ phát sóng hoặc tần suất lặp lại KHÔNG được tạo ra các khung giờ giống nhau. Nếu các mã nhận dạng, thời gian bắt đầu, thời lượng và tài nguyên khớp với nhau, thì các vị trí sẽ được coi là giống hệt nhau.
  2. KHÔNG kết hợp định dạng tình trạng rảnh/bận chuẩn và tần suất lặp lại trong các vị trí của một dịch vụ. Việc định kỳ mang lại lợi ích cho người bán/dịch vụ cung cấp cuộc hẹn. Định dạng tiêu chuẩn 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 lặp lại không được kéo dài quá 24 giờ.
Trường
repeat_until

Timestamp

Dấu thời gian tối đa (theo giờ UTC) mà thời gian phát hành sẽ lặp lại cho đến.

repeat_every

Duration

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

Ví dụ: Một sự kiện có thời lượng là 20 phút, thời gian lặp lại là 30 phút, thời gian bắt đầu là 9 giờ sáng và thời gian lặp lại là 11 giờ sáng sẽ tạo ra các khung giờ là 9-9:20 sáng, 9:30-9:50 sáng, 10-10:20 sáng, 10:30-10:51 sáng. (bắt buộc)

ScheduleException

Thông báo ScheduleException thể hiện phạm vi thời gian đã đặt trước/không có sẵn trong ngày làm việc, là các trường hợp ngoại lệ đối với việc lặp lại được mô tả ở trên. Khi đã đặt trước các khung giờ, bạn phải cập nhật danh sách các trường hợp ngoại lệ để phản ánh các khoảng thời gian mới không hoạt động. Bạn không nên sửa đổi chính sự lặp lại này.

Trường
time_range

TimeRange

Phạm vi thời gian của ngoại lệ. Mọi khung giờ được mô tả theo sự kiện lặp lại và chồng chéo với phạm vi thời gian đóng cửa này sẽ được coi là không sử dụng được.

Ví dụ: Nếu thời gian lặp lại chỉ định thời lượng là 20 phút, thời gian lặp lại mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và thời gian lặp lại là 11:00 sáng, thì ScheduleException có phạm vi thời gian là 9:45 sáng – 11:00 sáng sẽ vô hiệu hoá các vị trí lúc 9:30 – 9:50 sáng, 10-1,01 sáng:

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

SchedulingRuleOverrides

Quy tắc lên lịch cấp tình trạng rảnh/bận.

Trường
last_bookable_sec

int64

Thời gian gần đây nhất (tính bằng giây) mà khung giờ này có thể đặt trước. Dấu thời gian này phải trước thời điểm start_sec của vùng mà bạn muốn tuân thủ (nếu người dùng có thể đặt phòng 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 thuộc scheduleRules của Dịch vụ tương ứng.

first_bookable_sec

int64

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

last_online_cancellable_sec

int64

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

BatchDeleteGenericRecordsRequest

Yêu cầu xoá hàng loạt bản ghi thuộc loại nguồn cấp dữ liệu đã 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

Các bản ghi cần xoá. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi.

BatchPushGenericRecordRequest

Yêu cầu chèn và/hoặc cập nhật bản ghi loại nguồn cấp dữ liệu theo lô đượ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

Các bản ghi cần chèn và/hoặc cập nhật. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi.

BatchReplaceServiceAvailabilityRequest

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

Trường
parent

string

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

extended_service_availability[]

ExtendedServiceAvailability

Phạm vi cung cấp dịch vụ mở rộng được dùng để thay thế các vùng tình trạng rảnh/bận hiện có.

BatchReplaceServiceAvailabilityResponse

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

Trường
extended_service_availability[]

ExtendedServiceAvailability

Các thông báo về tình trạng cung cấp dịch vụ mở rộng đã được cập nhật thành công được dùng để thay thế các khung giờ trống hiện có.

Đặt dịch vụ

Lượt đặt trước cho một vùng khoảng không quảng cáo

Trường
name

string

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

merchant_id

string

Mã của người bán cho vùng đó

service_id

string

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

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

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 yêu cầu đặt chỗ

payment_information

PaymentInformation

Thông tin về các giao dịch thanh toán liên quan đến việc đặt phòng.

party_size

int64

Quy mô bữa tiệc của yêu cầu đặt chỗ

BookingFailure

Dữ liệu trạng thái cho biết lý do khiến quá trình xử lý yêu cầu đặt phòng không thành công theo cách không đồng bộ. Mục đích của tính năng Đặt phòng không thành công là để chủ yếu phát hiện các lỗi về logic kinh doanh.

Trường
cause

Cause

Lý do không đặt được vé. (bắt buộc)

rejected_card_type

CreditCardType

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

description

string

Trường không bắt buộc này được dùng cho đối tác để chỉ cung cấp 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ề lỗi thanh toán.

Nguyên nhân

Liệt kê nguyên nhân 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ờ trống được tham chiếu không còn nữa.
SLOT_ALREADY_BOOKED_BY_USER Người dùng này đã đặt trước mộ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ể sử dụng được nữa để hoàn tất yêu cầu đặt phòng.
OUTSIDE_CANCELLATION_WINDOW Không thể thực hiện yêu cầu huỷ vào thời điểm hiện tại do quy định hạn chế về thời gian trong chính sách huỷ của người bán.
PAYMENT_ERROR_CARD_TYPE_REJECTED Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì người bán không chấp nhận loại thẻ tín dụng được cung cấp. Bạn phải cung cấp loại thẻ tín dụng trong từ chối_card_type.
PAYMENT_ERROR_CARD_DECLINED Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì thẻ tín dụng được cung cấp đã bị từ chối.
PAYMENT_OPTION_NOT_VALID Đã xảy ra lỗi với gói/gói thành viên dùng để thanh toán cho lượt đặt trước. Có thể không còn trường hợp sử dụng hợp lệ nào, có thể đã hết hạn, v.v.
PAYMENT_ERROR Đã xảy ra lỗi trong quá trình xử lý khoản thanh toán cho yêu cầu đặt vé này. Hãy sử dụng giá trị này để chỉ ra lỗi chung liên quan đến 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 lựa chọn thanh toán đã cho (ví dụ: người dùng cố gắng sử dụng giá lần đầu tiên lần thứ hai).
BOOKING_ALREADY_CANCELLED Một yêu cầu đặt vé mà người dùng muốn huỷ đã bị huỷ.
BOOKING_NOT_CANCELLABLE Không thể huỷ một lượt đặt phòng mà người dùng đã cố gắng huỷ.
OVERLAPPING_RESERVATION Người dùng có một đơn đặt chỗ hiện có quá gần thời điểm này.
USER_OVER_BOOKING_LIMIT Không đặt được phòng do người dùng vượt quá giới hạn số lượt đặt trước trên mỗi người dùng của đơn vị tập hợp.
PAYMENT_REQUIRES_3DS1

Đặt thời điểm khoản thanh toán bị từ chối vì bạn yêu cầu thử lại giao dịch, nhưng lần này là sau khi đã trải qua bước kiểm tra/phản hồi 3DS1. Lưu ý rằng trạng thái không thành công của giao dịch hiện tại sẽ vẫn là không thành công. Lần thử lại sẽ hoàn toàn riêng biệt.

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

PaymentFailureInformation

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

Trường
threeds1_parameters

ThreeDS1Parameters

Các thông số mà trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ bị bỏ qua trừ khi BookingErrors.Nguyên nhân được đặt thành PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Các thông số yêu cầu RwG thực hiện thử thách 3DS1.

Các tham số được thiết lập theo phần mô tả của EMVCo về giao thức 3DS1.

Trường
acs_url

string

URL mà từ đó biểu mẫu sẽ được hiển thị 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 trước

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

CallMerchant

Thông báo trống sẽ được dùng trong CompositionPartySizeOption. Khi bạn đặt thông báo này, thì người dùng sẽ thấy một lựa chọn để gọi cho doanh nghiệp đặt trước.

CancellationPolicy

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

Trường
refund_condition[]

RefundCondition

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

RefundCondition

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

Trường
min_duration_before_start_time

Duration

Thời lượng trước thời gian 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ể được hoàn lại, miễn là yêu cầu đặt dịch vụ bị huỷ ít nhất min_duration_before_start_time trước thời gian bắt đầu dịch vụ, trong khoảng [0, 100]. Khi được đặt thành 0 (mặc định), dịch vụ sẽ không được hoàn tiền. Khi bạn đặt thành 100, dịch vụ này sẽ được hoàn tiền toàn bộ.

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

CreateMerchantRequest

Yêu cầu tạo Merchant.

Trường
parent

string

Tên tài nguyên chính của đối tác sở hữu người bán này, ở định dạng partners/{partner_id}.

merchant_id

string

Mã người bán để sử 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 Service mới.

Trường
parent

string

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

service_id

string

Mã dịch vụ cần sử dụng cho dịch vụ này.

service

Service

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

CreditCardRestrictions

Các quy định hạn chế đối với loại thẻ tín dụng mà người bán 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 có thẻ tín dụng nào được hỗ trợ nếu trống.

CreditCardType

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

Enum
CREDIT_CARD_TYPE_UNSPECIFIED Không sử dụng.
VISA Thẻ tín dụng Visa.
MASTERCARD Thẻ tín dụng Mastercard.
AMERICAN_EXPRESS Thẻ tín dụng American Express.
DISCOVER Thẻ tín dụng trên Discover.
JCB Thẻ tín dụng JCB.

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 partner/{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

Một khoản tiền gửi mà người dùng có thể bị tính phí hoặc bị tạm giữ trong thẻ tín dụng.

Trường
deposit

Price

Số tiền gửi.

min_advance_cancellation_sec

int64

Số tiền huỷ trước tối thiểu đối với khoản tiền đặt cọc.

deposit_type

PriceType

Xác định cách khoản tiền gửi được xác định dựa trên số lượng phòng trố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 chỉ nên thanh toán qua những phương thức thanh toán nêu dưới đây.

DurationRange

Trình bao bọc trong một khoảng thời gian có thể bị ràng buộc hoặc không bị ràng buộc. Bạn phải nhập ít nhất một trong hai 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.

ExtendedServiceAvailability

Danh sách phạm vi cung cấp và đối tượng/thời điểm áp dụng ưu đãi.

Trường
merchant_id

string

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

service_id

string

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

start_time_restrict

Timestamp

Nếu bạn cung cấp thông tin này, chúng tôi sẽ coi các mục Tình trạng còn hàng được cung cấp là thông tin tổng quan nhanh đầy đủ từ [start_time_limited, end_time_Limit). Tức là tất cả tình trạng còn hàng hiện có đều sẽ bị xoá nếu đáp ứng điều kiện sau:

   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ế thêm:

  availability.duration == duration_restrict

Nếu bạn đặt thông báoresource_ đảo (hạn chế về tài nguyên), thì đ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 dùng để cung cấp thông tin cập nhật hoàn chỉnh về tình trạng còn hàng trong một khoảng thời gian nhất định.

Việc đặt start_time_limit và không đặt end_time_Restrict sẽ có nghĩa là toàn bộ thời gian bắt đầu từ start_time_limit.

end_time_restrict

Timestamp

Nếu bạn không đặt end_time_ dắt?

duration_restrict

Duration

Việc đặt thời hạn sẽ hạn chế hơn nữa phạm vi cập nhật thành chỉ cung cấp nội dung có thời lượng phù hợp.

resources_restrict

Resources

Việc đặt tài nguyên_ hạn chế về tài nguyên sẽ giới hạn hơn nữa phạm vi cập nhật chỉ đối với nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác.

availability[]

Availability

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

FeedStatistics

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

Trường
new_items

int64

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

existing_items

int64

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

deleted_items

int64

Các mặt hàng không còn xuất hiệ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ập 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 ký tự mà con người đọc được, cung cấp thêm 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

Thống kê cụ thể cho nguồn cấp dữ liệu này.

Tiểu bang

Enum cho biết trạng thái xử lý của nguồn cấp dữ liệu.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Không sử dụng.
IN_PROGRESS Nguồn cấp dữ liệu vẫn đang được xử lý.
SUCCESS Nguồn cấp dữ liệu đã được xử lý thành công.
FAILURE Chúng tôi đã gặp lỗi khi xử lý nguồn cấp dữ liệu.

FoodOrderingMetadata

Siêu dữ liệu cho các đườ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ả ngoài tổng chi phí của 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ề dịch vụ 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 muộn hơn ngay bây giờ.

Trường kết hợp 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, khoảng thời gian cho đến khi đồ ăn được giao. Đối với đơn đặt hàng tự đến lấy, khoảng thời gian cho đến khi bạn có thể đến lấy thực phẩm. fulfillment_duration_options chỉ có thể là một trong những trạng thái sau đây:
fulfillment_lead_time_duration

Duration

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

fulfillment_lead_time_duration_range

DurationRange

Phạm vi thời lượng. Ví dụ: * 30 phút đến 45 phút * Trên 30 phút * Dưới 50 phút

AdvanceOrderDetails

Để được hỗ trợ đặt hàng trước.

Trường
is_supported

bool

"True" nếu tính năng Đơn đặt hàng trước (còn gọi là Đặt hàng trước) được hỗ trợ. (bắt buộc)

FeeDetails

Chi tiết về các khoản 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

Ví dụ về FeeAmount: * Phí cố định: 0 USD (không tính phí), 1,5 USD * Phạm vi phí cố định: 1 USD (tối thiểu), 3 USD (tối đa), USD 5,0-6,0 * Tỷ lệ phần trăm kích thước giỏ hàng: 15,5%, 10%-20%, 10% (tối thiểu), 15% (tối đa) * Tổng phạm vi và tỷ lệ phần trăm: 25,5% 2,5 USD (tối thiểu), 25,5% và 4,5 USD (tối đa), 10% và USD 1,5-2,5, 10,5%-20% & USD 2,5-3,5

Trường
cart_percentage

QuantitativeValue

Phí 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 bị 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% * Tối đa 5,5% * 4,5% đến 5,5%

Trường kết hợp amount_options. Các tuỳ chọn để chỉ định số tiền. amount_options chỉ có thể là một trong những trạng thái sau đây:
amount

Money

Số tiền cố định. Ví dụ: 3,5 USD.

amount_range

MoneyRange

Phạm vi số tiền. Ví dụ: * 3,5 USD đến 5,5 USD * Tối thiểu 3,5 USD * Tối đa 5,5 USD

amount_unknown

bool

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

FeeType

Loại phí.

Enum
FEE_TYPE_UNSPECIFIED Chưa xác định loại phí.
DELIVERY Để biết phí giao hàng.
SERVICE Đối với phí dịch vụ.

FulfillmentOption

Tuỳ chọn thực hiện đơn hàng 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 phương thức thực hiện.

available_day[]

AvailableDay

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

fee_details

FeeDetails

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

minimum_order

Price

Bắt buộc. Đơn đặt hàng tối thiểu 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.

AvailableDay

Khả năng sử dụng trong ngày.

Trường
fulfillment_date

Date

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

last_ordering_time

Timestamp

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

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

FeeDetails

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

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

NoFee

Không mất 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

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

FixedFee

Phí cố định bắt buộc cho phương thức thực hiện đơn hàng 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 Chưa xác định loại phương thức thực hiện.
FULFILLMENT_TYPE_DELIVERY Phương thức thực hiện là phân phối.
FULFILLMENT_TYPE_PICKUP Phương thức thực hiện đơn hàng là đến lấy hàng.

MinimumFee

Phí tối thiểu bắt buộc đối với phương thức thực hiện đơn hàng 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

Không mất phí cho phương thức thực hiện đơn hàng 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 dùng để xác định thứ tự áp dụng thao tác xoá cho kho hàng.

Trường kết hợp record_type. Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) Đối tác có thể cung cấp bản ghi đầy đủ tương tự như cách cung cấp bản ghi trong nguồn cấp dữ liệu hoặc API BatchPush. Đối tác cũng có thể chỉ cung cấp các trường thiết yếu của một bản ghi cần thiết để xác định chính xác bản ghi đó. record_type chỉ có thể là một trong những trạng thái sau đây:
data_record

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

GenericRecord

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

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 thông tin cập nhật kho hàng.

Trường kết hợp record_type. Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) record_type chỉ có thể là một trong những trạng thái sau đây:
data_record

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

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 kết hợp addresses. Địa chỉ cho một vị trí, có thể theo cấu trúc hoặc không có cấu trúc. addresses chỉ có thể là một trong những trạng thái sau đây:
address

PostalAddress

Địa chỉ bưu chính của vị trí (ưu tiên).

unstructured_address

string

Địa chỉ không có cấu trúc cũng có thể được cung cấp dưới dạng phương án dự phòng. Ví dụ: "1600 Parkway Parkway Mountain View, ca 94043"

GetMerchantStatusRequest

Yêu cầu nhận 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ập 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ụ gia đình.

Trường
category_type

string

Danh mục cấp cao tương ứng với dịch vụ gia đình này. 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 chứa dịch vụ gia đình nhất định. Ví dụ: unclog_drain, install_faucet là các loại công việc trong danh mục thợ sửa ống nước.

IntegrationType

Hỗ trợ chiều sâu của tích hợp.

Enum
INTEGRATION_TYPE_UNSPECIFIED Giá trị mặc định là END_TO_END.
INTEGRATION_TYPE_END_TO_END Hoàn tất quy trình tích hợp để cho phép đặt phòng từ đầu đến cuối thông qua Google.
INTEGRATION_TYPE_INVENTORY_ONLY Máy chủ đặt vé không cần hỗ trợ dịch vụ này. Bạn chỉ cần gửi dữ liệu về người bán, dịch vụ và tình trạng còn hàng (không bắt buộc).

InvalidateResourceRequest

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

Trường
resource_id

string

Tên của tài nguyên sẽ bị vô hiệu hoá.

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

LineItem

Một mặt hàng trong một đơn đặt hàng – lượt đặt dịch vụ duy nhất tại một khung thời gian duy nhất.

Trường
service_id

string

Mã nhận dạng Dịch vụ của 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 sắp xếp theo Loại vé.

price

Price

Tổng giá (không 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ã của một loại phiếu yêu cầu hỗ trợ.

count

int32

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

ListMerchantStatusesRequest

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

Trường
parent

string

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

page_size

int32

Bắt buộc. Số lượng mục tối đa cần trả về. 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. Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái của kho hàng đặt trước.

waitlist_inventory_status_restrict

WaitlistInventoryStatus

Không bắt buộc. Quy định hạn chế không bắt buộc đối với việc lọc kết quả theo trạng thái của kho hàng trong danh sách chờ.

geo_match_restrict

GeoMatchingStatus

Không bắt buộc. Quy định hạn chế không bắt buộc đối với việc lọc kết quả theo trạng thái so khớp địa lý.

BookingInventoryStatus

Trạng thái của kho hàng đặt trước toàn diện.

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

GeoMatchingStatus

Trạng thái so khớp theo khu vực đị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 theo vị trí địa lý.
GEO_MATCHED Người bán được so khớp theo khu vực địa lý.

WaitlistInventoryStatus

Trạng thái còn hàng trong 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ó danh sách chờ hỗ trợ dịch vụ.
HAS_VALID_WAITLIST_SERVICE Người bán có danh sách chờ hỗ trợ dịch vụ.

ListMerchantStatusesResponse

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

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ã để truy xuất trang kết quả tiếp theo. Không có kết quả nào khác trong danh sách nếu trống.

ListStatusRequest

Yêu cầu truy xuất Status của 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ục tối đa cần trả về.

page_token

string

Giá trị next_page_token được trả về từ yêu cầu Danh sách trước đó, nếu có.

state_restrict

State

Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái nguồn cấp dữ liệu.

time_range_restrict

TimeRange

Giới hạn (không bắt buộc) để 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, giá trị mặc định sẽ là bắt đầu từ thời gian Unix. Nếu bạn không đặt thời gian kết thúc, thì thời gian kết thúc sẽ được đặt mặc định là ngay bây giờ.

ListStatusResponse

Yêu cầu truy xuất Status của 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 trình tự thời gian đảo ngược của các nguồn cấp dữ liệu đã tải lên. Số lượng mụ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ã để truy xuất trang kết quả tiếp theo. Không có kết quả nào khác trong danh sách nếu trống.

LocalizedString

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

Trường
locale

string

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

value

string

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

Vị trí

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

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 vị trí được dùng để hỗ trợ việc so khớp vị trí với các địa điểm đã có trên Google Maps.

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

telephone

string

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

url

string

Url trang web công khai của địa điểm. (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

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

location_id

string

Tệp tham chiếu duy nhất của vị trí trong dịch vụ. 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 dữ liệu tuỳ chỉnh, bạn có thể sử dụng một nhóm mã vị trí để chỉ định các lựa chọn về vị trí đến lấy hàng. Nếu được đặt, mã này phải là duy nhất trong cùng một dịch vụ. (không bắt buộc)

LocationType

Loại vị trí này.

Enum
LOCATION_TYPE_UNSPECIFIED Chưa xác định loại vị trí.
VISITED_LOCATION Vị trí mà dịch vụ này truy cập.
START_LOCATION Địa điểm mà dịch vụ này bắt đầu cũng đóng vai trò là HỌP.
END_LOCATION Vị trí nơi dịch vụ này kết thúc.

Người bán

Thông tin về người bán trên nền tảng của đơ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, số điện thoại, url và vị trí địa lý được dùng để hỗ trợ việc so khớp kho hàng của đối tác với những người bán đã có mặt trên Google Maps. Thông tin này sẽ không xuất hiện.

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ả quốc gia và mã vùng của người bán, ví dụ: +14567891234.

url

string

URL 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

Loại hình doanh nghiệp trên nền tảng của trang web 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 theo điểm cơ bản (một phần trăm của một phần trăm). Ví dụ: Nếu thuế suất là 7,5% thì bạn phải đặt trường này thành 750.

Nếu bạn không đặt trường này hoặc đặt thành 0, thì tổng giá tính cho người dùng của mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được coi là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt.

Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, tổng giá tính cho người dùng 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 đánh giá theo thuế suất được cung cấp tại đây. Các phân số của đơn vị tiền tệ nhỏ nhất (ví dụ: các phân số của một xu) sẽ được làm tròn bằng cách làm trò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 hàng riêng biệt.

Trường này không được dùng nữa, vui lòng sử dụng tax_rate để thay thế.

tax_rate

TaxRate

Thuế suất 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 (ví dụ: tax_rate { }) sẽ đặt lại thuế suất được áp dụng về 0.

payment_restrictions

PaymentRestrictions

Các quy định 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 định hạn chế nào nếu bạn không thiết lập trường này.

payment_option[]

PaymentOption

Các lựa chọn thanh toán dành cho người bán này. Các dịch vụ của người bán này sẽ có thể giới hạn riêng các phương thức thanh toán mà họ cho phép.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Cấu hình của một công ty xử lý thanh toán được mã hoá, nếu người bán có hỗ trợ.

tokenization_config

TokenizationConfig

Cấu hình của một công ty xử lý thanh toán được mã hoá, nếu người bán có hỗ trợ.

terms

Terms

Điều khoản và điều kiện của người bán cụ thể sẽ được hiển thị cho người dùng khi khách hàng đặt dịch vụ thông qua tính năng Đặt chỗ với Google. Ngoài các Điều khoản và điều kiện này của đối tác tổng hợp, điều khoản và điều kiện luôn được hiển thị cho người dùng và không được cung cấp tại đâ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ử dụng khi hiển thị thuộc tính của đối tác. Trường này cho phép những đối tác có nhiều thương hiệu hướng đến người tiêu dùng cung cấp người bán của tất cả cá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 hướng đến người tiêu dùng, thì bạn không cần đặt và bạn có thể bỏ qua trường này.

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

Không có nhiều thương hiệu hướng đến người tiêu dùng? --&gt; Bỏ qua trường này

Bạn đã thiết lập nhiều thương hiệu chưa?

  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 ý cẩn thận: hầu hết các đối tác không cần đặt trường này. Nếu muốn sử dụng trường này, đối tác phải liên hệ với chúng tôi trước để thiết lập các thương hiệu riêng biệt, bao gồm cả thương hiệu mặc định.

matching_hints

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 cách sử dụng thông tin được cung cấp ở trên. (không bắt buộc)

service_attribute[]

ServiceAttribute

Định nghĩa về bất kỳ thuộc tính dịch vụ nào dùng để mô tả các Dịch vụ dành cho Người bán này. (không bắt buộc)

waitlist_advisement

Advisement

Không bắt buộc. Tư vấn chung của 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. Các trường văn bản riêng lẻ trong tư vấn nên có độ dài tối đa là 100 byte.

MerchantMatchingHints

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

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 đị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ính năng đặt phòng từ đầu đến cuối.

waitlist_status

WaitlistStatus

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

geo_match

PlaceInfo

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

local_services_match

LocalServicesMatchInfo

Kết quả trùng khớp trong Quảng cáo dịch vụ địa phương của người bán này. Để trống nếu không phải là người bán dịch vụ địa phương hoặc không khớp với bất kỳ nhà cung cấp nào.

direct_urls[]

DirectUrl

Danh sách URL để minh hoạ nội dung của kho hàng hiện tại của người bán. Xin lưu ý rằng điều đó 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 hiển thị công khai.

BookingStatus

Trạng thái liên quan đến việc tích hợp tính năng đặt phòng từ đầu đến cuối.

Trường
has_valid_future_inventory

bool

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

DirectUrl

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

Trường
type

UrlType

Loại của URL này.

url

string

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

UrlType

Loại URL hiển thị.

Enum
URL_TYPE_UNSPECIFIED Chưa chỉ định.
BOOKING URL đặt phòng hoàn chỉnh.
WAITLIST URL danh sách chờ toàn diện.
LOCAL_SERVICES URL của Dịch vụ địa phương của Google.

LocalServicesMatchInfo

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

Trường
matched_providers[]

MatchedProvider

Nhà cung cấp dịch vụ phù hợp. Một người bán có thể được so khớp 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à "carpet_cleaning".

PlaceInfo

Thông tin về một địa điểm trùng khớp.

Trường
name

string

Tên đị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ể được dùng để tạo URL trên Google Maps hoặc tìm nạp thêm thông tin về địa điểm. Hãy truy cập vào https://developers.google.com/places/web-service/place-id để xem ví dụ về cách sử dụng.

ProcessingStatus

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

Enum
PROCESSING_STATUS_UNSPECIFIED Trạng thái chưa xác định.
IN_PROGRESS Madden đã nhận được người bán nhưng vẫn đang được xử lý. Những người bán có trạng thái này sẽ không có trạng thái khác được điền sẵn.
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 người bán thực sự được phục vụ khách hàng.

MoneyRange

Trình bao bọc cho phạm vi số tiền có thể bị ràng buộc hoặc không bị ràng buộc. Phải có í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

Một khoản phí mà người dùng có thể phải trả nếu họ đã đặt chỗ nhưng không xuất hiện.

Trường
fee

Price

Số tiền mà người dùng có thể phải trả nếu họ không xuất hiện trong giao dịch đặt chỗ.

fee_type

PriceType

Xác định cách khoản phí được xác định dựa trên tình trạng còn hàng.

Đặt

Đơn đặt hàng cho các cuộc 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 món.

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ã của người bán chứa tất cả dịch vụ trong đơn đặt hàng này.

item[]

LineItem

Mục hàng trong đơn đặt hàng này.

OrderOnlineMetadata

Siêu dữ liệu của đường liên kết đến 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 hàng hiện có cho đường liên kết đến hành động đặt hàng trực tuyến.

PaymentInformation

Thông tin thanh toán liên quan đến một lượt đặt phòng

Trường
prepayment_status

PrepaymentStatus

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

payment_transaction_id

string

Giá trị nhận dạng duy nhất của giao dịch thanh toán liên quan đến yêu cầu đặt phòng. Để trống nếu không có.

PaymentOption

Một tuỳ chọn thanh toán, có thể được dùng để thanh toán cho các dịch vụ do người bán cung cấp. Lựa chọn 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ã này được dùng để xác định lựa chọn thanh toán này.

Mã này áp dụng cho toàn bộ đơn vị tập 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 đối với những người bán đó.

Khi sử dụng lại mã nhận dạng cho nhiều người bán, việc cập nhật bất kỳ giá trị nào cho một tuỳ chọn thanh toán của một người bán cũng sẽ cập nhật mọi tuỳ chọn thanh toán khác có cùng mã nhận dạng với một người bán khác. Do đó, phương pháp hay nhất là thiết lập để tất cả các lựa chọn thanh toán có cùng một mã nhận dạng và luôn được cập nhật thành các giá trị giống nhau để tránh mọi khả năng xảy ra hành vi sai trái.

name

string

Tên của tuỳ chọn thanh toán. Người dùng có thể nhìn thấy thông tin này.

description

string

Nội dung mô tả về phương thức thanh toán. Người dùng có thể nhìn thấy thông tin này.

price

Price

Giá của lựa chọn 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ẽ thay thế trường tax_rate (tỷ lệ thuế) có trong Người bán hoặc Dịch vụ. Một thông báo trống (ví dụ: tax_rate { }) sẽ đặt lại thuế suất được áp dụng về 0.

payment_option_type

PaymentOptionType

Loại tùy chọn thanh toán này. Dùng một lần cho khách mua lẻ, dùng nhiều lần cho gói và không giới hạn cho gói thành viên.

session_count

int64

Số phiên có thể sử dụng tuỳ chọn thanh toán này. Chỉ hợp lệ cho nhiều phiên hoạt động / gói, trong đó giá trị phải > 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

Có thể sử dụng tùy chọn thanh toán trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, giá trị này sẽ ghi đè valid_duration và kích hoạt_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 có hiệu lực cho lựa chọn thanh toán này.

user_restriction

UserPurchaseRestriction

Giới hạn những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để giới hạn một tuỳ chọn 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 có hiệu lực.

Enum
ACTIVATION_TYPE_UNSPECIFIED Không sử dụng.
ACTIVATION_ON_PURCHASE Hiệu lực bắt đầu từ thời điểm mua.
ACTIVATION_ON_FIRST_USE Thời điểm bắt đầu có hiệu lực kể từ lần đầu tiên người dùng sử dụng lựa chọn thanh toán này.

PaymentOptionType

Loại tuỳ chọn thanh toán.

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

PaymentProcessorConfig

Cấu hình cho công ty xử lý thanh toán, được thiết lập trên cơ sở từng Người bán.

Trường
processor

Processor

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

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 công ty xử lý thanh toán cùng với yêu cầu thanh toán.

Bộ xử lý

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

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

PaymentRestrictions

Các quy định 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 quy định hạn chế đối với thẻ tín dụng mà người bán này chấp nhận. Chúng tôi giả định rằng tất cả cá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 theo thời gian, có nghĩa là việc để trống trường này sẽ tạo ra cấu hình cho các thay đổi trong tương lai.

PerOrderFee

Khoản phí phải được 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

Khoản phí có thể thay đổi tuỳ theo phương thức 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í phải thanh toán cho mỗi vé mà người dùng mua.

Trường
service_charge

Price

Có tính thêm phí cho một dịch vụ.

facility_fee

Price

Một khoản phí áp dụng cho địa điểm/cơ sở y tế.

taxes

Price

Thuế theo 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 theo ISO 3166-1 alpha-2, ví dụ: "Hoa Kỳ" (bắt buộc)

address_locality

string

Địa phương, ví dụ: "Đà Nẵng". (bắt buộc)

address_region

string

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

postal_code

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)

PrepaymentStatus

Trạng thái thanh toán trước của một 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 Phí đặt trước đã được thanh toán trước.
PREPAYMENT_NOT_PROVIDED Bạn chưa thanh toán trước phí đặt chỗ.
PREPAYMENT_REFUNDED Khoản phí trước đây là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại.

Giá

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

Trường
price_micros

int64

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

currency_code

string

Đơn vị tiền tệ của giá được xác định trong ISO 4217.

pricing_option_tag

string

Chuỗi mờ và không bắt buộc giúp xác định lựa chọn đặt giá liên kết với mức giá mở rộng.

PriceInterpretation

Mô tả cách diễn giải và hiển thị Giá cho người dùng.

Enum
PRICE_INTERPRETATION_UNSPECIFIED Chưa xác định thông tin diễn giải giá, giá trị mặc định là EXACT_AMOUNT.
EXACT_AMOUNT

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

Ví dụ: 20 USD cho một lớp học yoga; 15 USD cho cắt tóc 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 sẽ nắm rõ và cho biết mức giá tối thiểu. Người tiêu dùng có thể lựa chọn việc tăng giá.

Xin lưu ý rằng bất kỳ dịch vụ nào sử dụng PriceĐịnh nghĩa này đều phải sử dụng PrepaymentType NOT_supported.

Ví dụ: 30 đô la dịch vụ tỉa lông cho chó, nhưng những lựa chọn khác của người tiêu dùng có thể làm tăng giá

NOT_DISPLAYED

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

Xin lưu ý rằng bất kỳ dịch vụ nào sử dụng PriceĐịnh nghĩa này đều phải sử dụng PrepaymentType NOT_supported và Giá phải để trống.

Ví dụ: Dịch vụ tư vấn cho dịch vụ gia đình

PriceType

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

Enum
FIXED_RATE_DEFAULT

Giá là 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ụ: Khoản đặt cọc 50 đô la Mỹ để đặt bàn; 20 USD phí không đến chương trình cho một lớp yoga

PER_PERSON

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

Ví dụ: 10 đô la cho mỗi vé vào bảo tàng

QuantitativeValue

Trình bao bọc cho một giá trị số có thể là một dải ô hoặc một giá trị cố định. QuantitativeValue ví dụ: * Giá trị số ít: value: 10.5 * Phạm vi 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 kết hợp 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ị số ít. Ví dụ: 5,6

value_range

RangeValue

Một phạm vi giá trị cũng có thể là kết thúc mở hoặc bị giới hạn. Ví dụ: * Ít nhất là 5,5 * Tối đa là 5,5 * 5,5 đến 6,5

RangeValue

Phạm vi của các giá trị sao cho min_value < max_value Cần có ít nhất một trong hai giá trị min_valuemax_value.

Trường
min_value

double

Giá trị nhỏ nhất.

max_value

double

Giá trị tối đa.

Rating

Xác định Mức phân loại cho một thực thể.

Trường
value

double

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

number_of_ratings

uint64

Số lượng điểm xếp hạng được dùng để tính giá trị (bắt buộc).

RelatedMedia

Ảnh liên quan đến dịch vụ này. Google sẽ thu thập thông tin các nội dung nghe nhìn này để đảm bảo rằng chúng 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 lưu trữ tại URL này.

type

MediaType

Loại của nguồn nội dung nghe nhìn này.

localized_caption

Text

Chú thích của nội dung nghe nhìn hỗ trợ i18n, chỉ hỗ trợ văn bản thuần tuý. Mọi thành phần HTML sẽ bị xoá. (không bắt buộc)

attribution

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ắt buộc phải hiển thị thông tin ghi nhận tác giả cùng với nội dung nghe nhìn để ghi nhận tác giả cho nhiếp ảnh gia hoặc đại lý, thì bạn phải đặt trường này. (không bắt buộc)

caption
(deprecated)

string

Không được dùng nữa, ưu tiên sử dụng local_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 nhận tác giả cho nhiếp ảnh gia hoặc công ty quảng cáo hỗ trợ i18n. Văn bản này sẽ được hiển thị cùng với phương tiện nguồn. Xin lưu ý rằng trường này chỉ hỗ trợ văn bản thuần tuý cho trường này, mọi thành phần HTML sẽ bị xoá (không hỗ trợ thuộc tính dựa trên siêu liên kết).

text
(deprecated)

string

Không dùng nữa, ưu tiên sử dụng local_text.

MediaType

Enum để cho biết loại nguồn nội dung nghe nhìn này. Chỉ hỗ trợ ảnh. Vui lòng liên hệ với nhóm Đặt chỗ với Google nếu các phương tiện truyền thông khác ngoài ảnh cần được hỗ trợ.

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

ReplaceServiceAvailabilityRequest

Yêu cầu thay thế tình trạng rảnh/bận của Service.

Trường
service_availability

ServiceAvailability

Tình trạng cung cấp dịch vụ được dùng để thay thế những dịch vụ hiện có.

RequireCreditCard

Xác định xem có cần thẻ tín dụng để đặt cuộc 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 giống hệt với hành vi được chỉ định cho ĐIỀU KIỆN.
REQUIRE_CREDIT_CARD_CONDITIONAL Google sẽ yêu cầu bạn cung cấp thẻ tín dụng để đặt phòng nếu đáp ứng bất kỳ điều kiện nào sau đây: * tình trạng còn phòng có giá và thuộc tính checkout_type là BẮT BUỘC * no_show_fee được đặt * trường đặt cọc đã được thiết lập.
REQUIRE_CREDIT_CARD_ALWAYS Luôn phải có thẻ tín dụng để đặt phòng trống này bất kể các giá trị trường khác.

Tài nguyên

Tài nguyên được dùng để phân biệt tình trạng rảnh/bận của nhau khi các nhân viên hoặc phòng khác nhau là một phần của dịch vụ. Nhiều vị trí cho cùng một dịch vụ và khoảng thời gian có thể cùng tồn tại khi chúng có các tài nguyên khác nhau.

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 của tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Số liệu này cũng cần phải ổn định theo thời gian để cho phép mối tương quan với các lượt đặt phòng trước đây. Phải có trường này nếu có 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ẽ hiển thị cho người dùng đặt phòng và phải có thể đọc được, chứ không phải giá trị nhận dạng không rõ ràng. Phải có 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 chứa dịch vụ. Trường này xác định phòng trên tất cả người bán, dịch vụ và hồ sơ về tình trạng phòng. Số liệu này cũng cần phải ổn định theo thời gian để cho phép mối tương quan với các lượt đặt phòng trước đây. Bạn phải có trường này nếu có Room_name.

room_name

string

Tên không bắt buộc của phòng cung cấp dịch vụ. Trường này sẽ hiển thị cho người dùng đặt phòng và phải có thể đọc được, chứ không phải giá trị nhận dạng không rõ ràng. (không bắt buộc nhưng bắt buộc nếu có Room_id) Trong phòng ăn, chỉ nên sử dụng tên phòng cho khu vực ghế ngồi như quầy bar hoặc sân hiên và không được sử dụng cho thực đơn giá cố định, hoạt động đặc biệt hay bất kỳ giá trị nào khác không phải là phòng (chẳng hạn như đặt chỗ hoặc ăn tối). Khu vực ghế ngồi mặc định không được liên kết với khu vực ghế ngồi mặc định.

party_size

int32

Chỉ áp dụng cho Bữa tối: Quy mô bữa tiệc có thể chứa được trong khung giờ này. Một nhà hàng có thể được liên kết với nhiều chỗ trống cùng một lúc, mỗi vị trí chỉ định một bên_size khác nhau, nếu ví dụ: 2, 3 hoặc 4 người có thể ngồi trước khi đặt chỗ.

SchedulingRules

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

Trường
min_advance_online_canceling

int64

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

late_cancellation_fee
(deprecated)

Price

Phí huỷ dịch vụ trong thời gian thông báo trước tối thiểu.

noshow_fee
(deprecated)

Price

Phí không xuất hiện mà không huỷ.

admission_policy

AdmissionPolicy

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

cancellation_policy

CancellationPolicy

Chính sách huỷ quy tắc lên lịch. (bắt buộc đối với chương trình Điểm tham quan)

Trường kết hợp min_booking_buffer. Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất cho đến khi khung giờ còn trống bắt đầu hoặc kết thúc.

Nếu là "min_advance_booking" được đặt, thời gian có thể đặt phòng cuối cùng sẽ được tính là (<slot start time> - "min_advance_booking"). Nếu "min_booking_buffer_before_end_time" được đặt, thời gian có thể đặt trước cuối cùng sẽ được tính là (<slot end time> - "min_booking_buffer_before_end_time"). 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 bạn không đặt cả hai chính sách, thì cửa hàng có thể đặt trước cho đến khi khung giờ bắt đầu. Nếu bạn đặt cả hai trường, thì chỉ có một giá trị được chọn trong khi giá trị còn lại bị bỏ qua – chúng ta không thể dự đoán chính xác giá trị nào sẽ được chọn.

Ví dụ:

  • Bạn cần đặt trước ít nhất 1 giờ trước thời gian bắt đầu cho kiểu tóc này. &#39;scheduling_rules{ min_advance_booking: 3600 ...}`

  • Bảo tàng nơi khách có thể mua vé cuối cùng 30 phút trước khi đóng cửa: 'schedule_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Vé xem phim cần được mua trước thời gian bắt đầu. 'lập lịch_quy tắc{ ...}' (để trống trường này) (không bắt buộc) min_booking_buffer chỉ được là một trong các giá trị sau:

min_advance_booking

int64

Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất cho đến khi khung giờ còn trống bắt đầu.

min_booking_buffer_before_end_time

int64

Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất cho đến khi hết khung giờ còn trống. Nếu bạn đặt trường này, thông số "admission_policy" phải đặt trường thành Time_FLEXIBLE để cho biết rằng người dùng có thể sử dụng vé đã mua sau khi khung giờ bắt đầu.

AdmissionPolicy

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

Enum
ADMISSION_POLICY_UNSPECIFIED Không sử dụng.
TIME_STRICT Khách hàng phải có mặt vào thời điểm bắt đầu của vùng còn trống và dịch vụ dự kiến sẽ kết thúc vào thời điểm kết thúc của vùng đó. Ví dụ về trường hợp sử dụng THỜI GIAN_STRICT: * Chuyến tham quan bắt đầu lúc 9 giờ sáng yêu cầu tất cả người tham dự phải đến đúng giờ bắt đầu và quay lại vào khoảng 12 giờ đêm. * Đặt chỗ cắt tóc lúc 3 giờ chiều thứ Bảy và sẽ mất khoảng 30 phút. * Lớp thể dục từ 18:00 đến 20:00.
TIME_FLEXIBLE

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

Ví dụ về các trường hợp sử dụngTIME_FLEXIBLE: * Vé vào bảo tàng có thể được 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í vào buổi chiều từ 12 giờ trưa đến 9 giờ tối.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

Ví dụ: trong tình huống vào cửa bảo tàng, vé vào cửa theo thời gian 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ờ trống của dịch vụ này thể hiện thời gian vào cửa đã 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òn trống để đặt phòng.

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, thay vào đó, hãy sử dụngLocalized_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ả về dịch vụ mà người dùng nhìn thấy. Không dùng nữa, chuyển sang sử dụng local_description.

localized_description

Text

Nội dung mô tả về 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à văn bản giống HTML. Không giống như phần văn bản thuần tuý, bạn có thể tạo bố cục tuỳ chỉnh ở đâ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à ghi chú sau đây để đảm bảo bạn tạo ra trải nghiệm người dùng tốt nhất.

Các thẻ định dạng giống HTML được hỗ trợ:

Thẻ tiêu đề: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Thẻ tiêu đề có thể dùng để hiển thị tiêu đề và tiêu đề phụ. Ví dụ: <h1>Hành 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ẻ, kiểu hoặc thuộc tính HTML 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: <p>
Bạn có thể dùng thẻ đoạn để làm nổi bật phần giới thiệu hoặc nội dung chi tiết. Mọi thẻ, kiểu hoặc thuộc tính bên trong sẽ bị bỏ qua, trừ một vài ngoại lệ: <br>, <strong> và <em>. Vui lòng xem phần thẻ cụm từ bên dưới để biết thêm chi tiết.

Thẻ danh sách: <ul>, <ol>, <li>
Thẻ <ul> Có thể sử dụng thẻ này với phần tử <li> để hiển thị danh sách không theo thứ tự và thẻ <ol> có thể dùng với <li> để hiển thị danh sách được sắp xếp theo 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ụ: Cách trình bày danh sách các dịch vụ của một chuyến du thuyền:
<ol>
<li>Cảnh biển tuyệt vời và cơ hội chơi đùa với động vật hoang dã.</li>
<li>Các dịch vụ và bố trí đi lại được thiết kế tỉ mỉ.</li>
<li>Đảm bảo mức giá thấp nhất.</li>
</ol>
Lưu ý rằng chỉ <li> trẻ em dưới <ul> hoặc <ol> thẻ sẽ được chuyển đổi. Tất cả những trẻ 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ẻ bộ chia: <div>
Tất cả thẻ bên trong được hỗ trợ của <div> thẻ sẽ được phân tích cú pháp với các quy tắc nêu trên, ngụ ý <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ỉ hỗ trợ ba thẻ nêu trên. &lt;br&gt; có thể được dùng để ngắt dòng trong đoạn và <strong>/<em> có thể được dùng để đánh dấu văn bản quan trọng. Mọi thẻ cụm từ khác sẽ bị bỏ qua.

Các thẻ không được hỗ trợ:

  • <html>, <header> và <body> thẻ không được phép.
  • 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, quảng cáo cố định cuối màn hình và đường liên kết sẽ bị xoá và sẽ 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 người dùng phong phú, vui lòng sử dụng "related_media" trường 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 trừ các 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ể gây ra trải nghiệm không mong muốn cho người dùng.
  • Cố gắng tránh sử dụng các cấu trúc lồng nhau sâu như hơn 3 cấp độ tiêu đề hoặc danh sách lồng nhau. Việc giữ cho cấu trúc phẳng, đơn giản và dễ hiểu sẽ góp phần 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ỗ với Google.
  • Bạn nên nhập tối đa 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ể cho mọi ngành dọc (trừ Dịch vụ ăn uống và Điểm tham quan) để thiết lập cách hiển thị giá dịch vụ.

rules

SchedulingRules

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

prepayment_type

PrepaymentType

Cho dù thanh toán trước là bắt buộc, không bắt buộc hay không được hỗ trợ.

prepayment_terms

PrepaymentTerms

Các điều khoản xoay quanh 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

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

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à người dùng đang đặt. (không bắt buộc)

tax_rate

TaxRate

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

payment_option_id[]

string

Danh sách mã nhận dạng tham chiếu đến những 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 một khoản tiền gửi có thể được tính cho người dùng. Ghi đè khoản tiền gửi dịch vụ nếu đã được chỉ định. Việc đặt chính sách này thành thông báo Khoản tiền gửi trống sẽ xóa mọi khoản tiền gửi ở cấp dịch vụ. (không bắt buộc)

no_show_fee

NoShowFee

Xác định phí vắng mặt mà người dùng có thể phải trả. Ghi đè phí dịch vụ không hiển thị nếu bạn đã chỉ định phí không hiển thị. Nếu bạn đặt giá trị này thành thông báo NoShowFee trống, mọi khoản phí không hiển thị ở cấp dịch vụ sẽ bị xoá. (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 đượ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 trước/mua cho dịch vụ này, nếu vé được hỗ trợ. (không bắt buộc)

related_media[]

RelatedMedia

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

service_attribute_value_id[]

ServiceAttributeValueId

Các giá trị thuộc tính dịch vụ áp dụng cho dịch vụ này (không bắt buộc). Mỗi Dịch vụ có thể không có hoặc có nhiều giá trị cho từng 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

Khả năng tích hợp chuyên sâu mà chúng tôi hỗ trợ dịch vụ này. (không bắt buộc) Không liên quan đến những đối tác liên quan đến việc tích hợp ban đầu. Các đối tác này sẽ luôn tắt tính năng hai đầu cuối.

per_order_fee

PerOrderFee

Phí ở cấp đơn đặt hàng khi 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

Vị trí có liên quan đến dịch vụ này. LƯU Ý QUAN TRỌNG: Nếu có nhiều vị trí được ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION thì phải chỉ định START_LOCATION. Ví dụ: - Chuyến tham quan bằng xe đạp có hướng dẫn viên tham quan 3 địa điểm, bạn cần chỉ định địa điểm bắt đầu. – Một cuộc họp tham quan bằng xe buýt tại sảnh khách sạn và sau đó di chuyển đến địa điểm mà bạn đã ghé thăm. Cần phải chỉ định địa điểm cuộc 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ọc dịch vụ gia đình. (không bắt buộc)

virtual_session

VirtualSession

Không bắt buộc. Thông tin về phiên ảo. Bạn phải 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 liên quan đến giao dịch này. Bắt buộc phải có giá trị này nếu Virtual_session được xác định và dịch vụ không miễn phí hoặc checkout_type KHÔNG được đặt thành REQUIRED.

PrepaymentTerms

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

Trường
charge_timing

ChargeTiming

Thời điểm tính phí so với thời gian mua hàng.

charge_time_before_start_time_sec

int64

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

ChargeTiming

Enum để cho biết thời điểm tính phí so với thời gian mua.

Enum
CHARGE_TIMING_UNSPECIFIED Không sử dụng.
CHARGE_NOW Khách hàng sẽ bị tính phí ngay lập tức.
CHARGE_LATER Khách hàng sẽ được tính phí sau.

PrepaymentType

Enum để cho biết loại hình trả trước.

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

ServiceType

Loại dịch vụ định sẵn.

Enum
SERVICE_TYPE_UNSPECIFIED Không sử dụng.
SERVICE_TYPE_DINING_RESERVATION Đặt chỗ ăn tối.
SERVICE_TYPE_FOOD_ORDERING Đặt đồ ăn, có thể là giao đồ ăn hoặc mang đi hoặc cả hai.
SERVICE_TYPE_FOOD_DELIVERY Giao đồ ăn.
SERVICE_TYPE_FOOD_TAKEOUT Đồ ăn mang đi.
SERVICE_TYPE_EVENT_TICKET Vé xem sự kiện.
SERVICE_TYPE_TRIP_TOUR Chuyến đi tham quan.
SERVICE_TYPE_APPOINTMENT Dịch vụ cung cấp cuộc hẹn hoặc lớp học. Được đề xuất cho (1) sức khỏe và thể dục, (2) spa và làm đẹp và (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 phiên hoạt động hoàn toàn trên mạng. Bạn phải đặt giá trị này nếu bật tính năng đặt dịch vụ ảo.
SERVICE_TYPE_SHOPPING Dịch vụ cho phép người dùng mua sắm của một người bán cụ thể. Hình thức giao hàng hoặc đến lấy hàng.

ServiceAttribute

Thuộc tính dịch vụ là các danh mục do đối tác xác định, mô tả các Dịch vụ mà người bán cung cấp. Ví dụ: ngân hàng có thể xác định "Loại tài khoản" thuộc tính dịch vụ có thể có các giá trị "Cá nhân" và "Doanh nghiệp", trong khi tiệm làm tóc có thể xác định "Loại dịch vụ" với các giá trị có thể sử dụng là "Cắt tóc", "Màu" và "Kiểu".

Trường
attribute_id

string

Giá trị nhận dạng giúp xác định duy nhất thuộc tính dịch vụ này cùng các thuộc tính khác của cùng một người bán, ví dụ: "loại tài khoản".

attribute_name

string

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

value[]

Value

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

Giá trị

Biểu thị một giá trị có thể có cho một thuộc tính dịch vụ cụ thể.

Trường
value_id

string

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

value_name

string

Tên hiển thị cho người dùng cho giá trị, ví dụ: "Cá nhân".

ServiceAttributeValueId

Xác định giá trị cụ thể của thuộc tính dịch vụ sẽ được áp dụng cho Dịch vụ.

Trường
attribute_id

string

Mã của một thuộc tính như được xác định trong thuộc tính Merchant.service_attribute, ví dụ: "loại dịch vụ".

value_id

string

Mã nhận dạng của giá trị cho thuộc tính này, ví dụ: "cắt tóc". Phải khớp với một value_id trong định nghĩa thuộc tính dịch vụ.

ServiceAvailability

Danh sách phạm vi cung cấp và đối tượng/thời điểm áp dụng ưu đãi.

Trường
name

string

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

start_time_restrict

Timestamp

Nếu bạn cung cấp thông tin này, chúng tôi sẽ coi các mục Tình trạng còn hàng được cung cấp là thông tin tổng quan nhanh đầy đủ từ [start_time_limited, end_time_Limit). Tức là tất cả tình trạng còn hàng hiện có đều sẽ bị xoá nếu đáp ứng điều kiện sau:

   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ế thêm:

  availability.duration == duration_restrict

Nếu bạn đặt thông báoresource_ đảo (hạn chế về tài nguyên), thì đ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 dùng để cung cấp thông tin cập nhật hoàn chỉnh về tình trạng còn hàng trong một khoảng thời gian nhất định.

Việc đặt start_time_limit và không đặt end_time_Restrict sẽ có nghĩa là toàn bộ thời gian bắt đầu từ start_time_limit.

end_time_restrict

Timestamp

Nếu bạn không đặt end_time_ dắt?

duration_restrict

Duration

Việc đặt thời hạn sẽ hạn chế hơn nữa phạm vi cập nhật thành chỉ cung cấp nội dung có thời lượng phù hợp.

resources_restrict

Resources

Việc đặt tài nguyên_ hạn chế về tài nguyên sẽ giới hạn hơn nữa phạm vi cập nhật chỉ đối với nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác.

availability[]

Availability

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

ServiceIntakeForm

Xác định 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 đúng, biểu mẫu này sẽ hiển thị cho những 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 các biểu mẫu nhập thông tin.

returning_customers
(deprecated)

bool

Nếu đặt là true, biểu mẫu này sẽ hiển thị cho những khách hàng mua nhiều lần. Không dùng nữa. Chức năng này không được hỗ trợ cho các biểu mẫu nhập thông tin.

ServiceIntakeFormField

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

Trường
id

string

Một chuỗi của mộ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ã 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ã duy nhất trên cả cấp độ dịch vụ và mỗi biểu mẫu nhập phiếu yêu cầu hỗ trợ. (bắt buộc)

type

FieldType

Loại trường này.

label

string

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

localized_label

Text

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

value[]

string

Chỉ đặt khi và chỉ khi loại trường là LOCATION_SEARCH. Vui lòng sử dụng "location_id" trong "vị trí" để chỉ định giá trị vị trí.

choice_text[]

Text

Chỉ đặt khi có và chỉ khi loại trường là MULTIPLE_CHOOSE, CheckBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể có.

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 thêm vào 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 tuỳ chọn khác được cung cấp ngoài các giá trị được cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: ngoài danh sách vị trí được cung cấp, bạn có thể sử dụng một lựa chọn khác là "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc)

ticket_type_restrict[]

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é, 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 phù hợp.

hint

Text

Văn bản gợi ý để nhập dữ liệu, 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

Enum để 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 sẽ bị bỏ qua.
SHORT_ANSWER Trường nhập một dòng cho văn bản.
PARAGRAPH Một trường nhập nhiều dòng cho văn bản.
MULTIPLE_CHOICE Một tập hợp các nút chọn, trong đó yêu cầu phải có một lựa chọn trong số 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 theo dịch vụ.

Trường
micro_percent

int32

Thuế suất tính bằng phần triệu của 1 phần trăm, cho kết quả chính xác là 6 số thập phân. Ví dụ: Nếu thuế suất là 7, 253%, trường này phải được đặt thành 7253000.

Nếu bạn không đặt trường này hoặc đặt thành 0, thì tổng giá tính cho người dùng của mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được coi là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt.

Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, tổng giá tính cho người dùng 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 đánh giá theo thuế suất được cung cấp tại đây. Các phân số của đơn vị tiền tệ nhỏ nhất (ví dụ: các phân số của một xu) sẽ được làm tròn bằng cách làm trò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 hàng riêng biệt.

Điều khoản

Một bộ quy tắc và nguyên tắc mà người dùng nhìn thấy để đặt trước thông qua tính năng Đặt chỗ với Google.

Trường
url

string

URL đến Đ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ị với người dùng. Sử dụng native_text bên dưới cho các mục tích hợp mới.

localized_text

Text

Văn bản đã bản địa hoá sẽ hiển thị với 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 bằng ngôn ngữ không xác định. Bắt buộc khi và chỉ khi localized_value trống. Ngôn ngữ cho giá trị này có thể phụ thuộc vào đối tác hoặc nhà cung cấp dịch vụ -- không nên giả định rằng ngôn ngữ cụ thể là bất kỳ ngôn ngữ cụ thể nào.

localized_value[]

LocalizedString

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

TicketType

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

Vé là số lượng tối thiểu có thể đặt trước cho một dịch vụ, ví dụ: địa điểm cho chuyến đi bè, vé vào bảo tàng, thuê thuyền kayak hai ngày cho thuê cả ngày.

Trường
ticket_type_id

string

Mã phiếu yêu cầu hỗ trợ được dùng để phân biệt các loại vé khác nhau của cùng một dịch vụ và chỉ được coi là mã duy nhất trong một dịch vụ.

short_description

string

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

Thông tin này có thể hiển thị cho người dùng, ví dụ: "người lớn", "trẻ em", " 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 được. Không dùng nữa, thay vào đó, hãy sử dụng local_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 được. Có thể cung cấp các giá trị riêng cho từng ngôn ngữ.

price

Price

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

per_ticket_fee

PerTicketFee

Phí bổ sung khi mua vé này. (không bắt buộc)

option_description

string

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

localized_option_description

Text

Nội dung mô tả bất kỳ lựa chọn bổ sung nào đại diện cho loại vé này (nếu có). Có thể cung cấp các giá trị riêng cho từng ngôn ngữ.

Các tuỳ chọn bổ sung sẽ hữu ích khi loại phiếu yêu cầu hỗ trợ đại diện cho nhiều phương diện.

Ví dụ 1: vé vào cửa có các loại "người lớn", "trẻ em" và ngôn ngữ làm tuỳ chọn bổ sung, danh sách TicketType dự kiến sẽ là: - { Ticket_type_id: "ticket_type_1" segmentation_short_description { value: "adult" (người lớn) }localized_option_description { value: "tiếng anh" } } – { Ticket_type_id: "ticket_type_2" segmentation_short_description { value: "adult" (người lớn) } local_option_description { value: "spanish" (tiếng Tây Ban Nha) } } – { Ticket_type_id: "ticket_type_3" localized_short_description { value: &quot;child&quot; }localized_option_description { value: "tiếng anh" } } – { Ticket_type_id: "ticket_type_4" localized_short_description { value: &quot;child&quot; } local_option_description { value: "spanish" (tiếng Tây Ban Nha) }

Ví dụ 2: một khách thuê thuyền kayak nhiều giờ có thêm tiện ích bổ sung túi khô (không bắt buộc), đoạn mô tả short_description có thể là "3 giờ" và options_description có thể là "có túi khô" hoặc "không có túi khô": – { Ticket_type_id: "ticket_type_1" localized_short_description { value: "2 giờ" }localized_option_description { value: "tiếng anh" } } – { Ticket_type_id: "ticket_type_2" localized_short_description { value: "2 giờ" } local_option_description { value: "spanish" (tiếng Tây Ban Nha) } } – { Ticket_type_id: "ticket_type_3" segmentation_short_description { value: "3 giờ" }localized_option_description { value: "tiếng anh" } } – { Ticket_type_id: "ticket_type_4" segmentation_short_description { value: "3 giờ" } local_option_description { value: "spanish" (tiếng Tây Ban Nha) }

Không bắt buộc, nhưng nếu bất kỳ loại phiếu yêu cầu hỗ trợ nào trong dịch vụ có nhóm trường này, thì chúng tôi dự kiến tất cả các loại phiếu yêu cầu hỗ trợ khác cũng đặt trường này (có thể sử dụng tùy chọn mô tả mặc định). Ví dụ: [{ticket_type_1, lớn, tiếng Anh}, {ticket_type_1, người lớn, ''}] không phải là danh sách hợp lệ.

Chỉ hỗ trợ hai thẻ định dạng HTML:
. Mục đích sử dụng là để xác định các lựa chọn bằng cả tiêu đề và nội dung mô tả chi tiết, ví dụ: "Chỗ ngồi cao cấp
Lựa chọn này cung cấp chỗ ngồi tại các thùng hàng riêng, trong đó có ghế bọc đệm hoàn toàn, TV riêng, dịch vụ ăn uống tại chỗ. Những chỗ ngồi này nhìn ra cánh đồng đẹp như tranh."

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 mục 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 sẽ tham dự sự kiện.

event_virtual_location_url[]

string

Không bắt buộc. URL nơi khán giả 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 đơn vị 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 những trang có thể tìm thấy 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.

AttendanceMode

Loại hình sẽ 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 các sự kiện thực tế.
PHYSICAL_ONLINE_MIXED Dành cho những sự kiện diễn ra cả thực và ảo.

Thực thể

Đại diện cho một thực thể liên quan đến sự kiện.

Trường
id

string

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

name

string

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

url

string

URL của trang web mô tả rõ ràng về thực thể. Đây là trang trên trang web của đối tác cho pháp nhân (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 chiếu 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ể đại diện cho người tiêu đề hoặc người biểu diễn hàng đầu tại sự kiện.
ENTITY_ROLE_SUPPORTER Thực thể này đại diện cho người biểu diễn hỗ trợ tại sự kiện.
ENTITY_ROLE_HOME_TEAM Thực thể đại diện cho đội chủ nhà tại sự kiện (thể thao).
ENTITY_ROLE_AWAY_TEAM Thực thể đại diện cho đội khách tại sự kiện (thể thao).

EntityType

Loại thực thể. Lưu ý: không phải là một bản thể học phổ quát.

Enum
ENTITY_TYPE_UNSPECIFIED Chưa chỉ định. Không được dùng.
ENTITY_TYPE_PERFORMER Thực thể đại diện cho nghệ sĩ hoặc nhóm 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à BUỔI HÀI HƯỚC hoặc TỔNG HỢP.
ENTITY_TYPE_PLAYER Thực thể đại diện cho đội thể thao hoặc vận động viên tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO.
ENTITY_TYPE_CONCERT_TOUR Thực thể đại diện cho chuyến tham quan chứa sự kiện này. Chỉ áp dụng khi danh mục sự kiện là CONCERT.
ENTITY_TYPE_SPORTS_SERIES Thực thể này đại diện cho một giải đấu thể thao có liên quan đến sự kiện này. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO.
ENTITY_TYPE_PLAY Thực thể đại diện cho loại hình vở kịch (ví dụ: nhạc, hài, 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ỏ danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm sản phẩm. Lưu ý: không phải là một bản thể học phổ quát của 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 nhà hát.
EVENT_CATEGORY_EXHIBITS Vật trưng bày.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Hội thảo và lớp học.

EventState

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

Enum
EVENT_STATE_UNSPECIFIED Chưa 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à một người.
ORGANIZATION Dành cho 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 tham chiếu đến một pháp nhân.

Trường
relevant_url[]

string

URL công khai của bất kỳ trang web nào chỉ dành cho chủ đề này. Trang này có thể bao gồm các trang web chính thức, nhạc sàn, nền tảng mạng xã hội, trang wikipedia hoặc imdb, ví dụ: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (không bắt buộc)

musicbrainz_id

string

Giá trị nhận dạng musicbrainz gồm 36 ký tự của nghệ sĩ hoặc các pháp nhân âm nhạc khác, nếu có. Hãy truy cập vào https://musicbrainz.org/doc/MusicBrainz_Identifier. (không bắt buộc)

TimeRange

Phạm vi thời gian đóng, tức là [start_time, end_time).

Trường
start_time

Timestamp

Giới hạn dưới của khoảng thời gian này.

end_time

Timestamp

Giới hạn trên của khoảng thời gian này.

TokenizationConfig

Cấu hình để mã hoá đơn vị xử lý thanh toán, được thiết lập trên cơ sở 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à có 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ý. Vui lòng xem tài liệu của Google Pay để biết thêm thông tin.

Ví dụ về Braintree: tokenization_parameter { key: "gateway" giá trị: "cây não" } tokenization_parameter { key: &quot;braintree:apiVersion&quot; giá trị: "v1" } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; giá trị: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" giá trị: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; giá trị: "production_xxx_yyy" }

Ví dụ về Stripe: tokenization_parameter { key: "gateway" giá trị: "sọc" } tokenization_parameter { key: &quot;stripe:version&quot; giá trị: "28-02-2018" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; giá trị: "pk_1234" }

Ví dụ của Adyen: tokenization_parameter { key: "gateway" giá trị: "adyen" } tokenization_parameter { key: "gatewayMerchantId" giá trị: "yourId" }

billing_information_format

BillingInformationFormat

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

BillingInformationFormat

Lượng Địa chỉ thanh toán cần thiết cho người dùng và cung cấp mã thông báo. Các giá trị enum tương ứng với các thông số trong API Google Pay (xem https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Enum
BILLING_INFORMATION_FORMAT_UNSPECIFIED Chưa 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ố, địa phương, khu vực, mã quốc gia và mã bưu chính.

ToursAndActivitiesContent

Các trường nội dung dành riêng cho Chuyến tham quan và Hoạt động. Mỗi phần tử trong trường lặp lại phải độc lập để cho phép hiển thị riêng biệt (ví dụ: dưới dạng dấu đầu dòng).

Bạn nên điền sẵn TourAndActivitiesContent cho các chuyến tham quan và hoạt động, nhưng không bắt buộc. Tất cả các trường hỗ trợ cả văn bản thuần tuý và văn bản giống HTML để định dạng cơ bản. Các thẻ định dạng giống HTML được hỗ trợ:

Thẻ cụm từ:
, , , : Chỉ hỗ trợ ba thẻ nêu trên. Có thể dùng
để ngắt dòng trong đoạn và // có thể dùng để đánh dấu một văn bản quan trọng. Mọi thẻ cụm từ khác sẽ bị bỏ qua.

Tất cả thẻ và kiểu tuỳ chỉnh khác không được phép và sẽ bị xoá. Mọi URL, quảng cáo cố định cuối màn hình và đường liên kết đều sẽ bị xoá và người dùng cuối sẽ không nhìn thấy.

Lưu ý quan trọng: * Không sao chép dữ liệu đã được cung cấp trong highlights, exclusion và các trường khác cụ thể hơn trong phần mô tả dịch vụ. * Tránh sử dụng các thẻ khác ngoại trừ các 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ể gây ra trải nghiệm không mong muốn cho người dùng.

Trường
highlights[]

Text

Danh sách nội dung nổi bật mà người dùng nhìn thấy.

inclusions[]

Text

Danh sách bao gồm mà người dùng nhìn thấy.

exclusions[]

Text

Danh sách các tiêu chí loại trừ mà người dùng nhìn thấy.

must_know[]

Text

Danh sách các ghi chú quan trọng mà người dùng nhìn thấy. Bạn có thể sử dụng danh sách này để cung cấp thông tin chi tiết như giới hạn 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

Tuỳ chọn cho các nhóm nằm ngoài phạm vi.

Trường
call_merchant

CallMerchant

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

UpdateBookingRequest

Yêu cầu cập nhật mộ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 sẽ được cập nhật

booking

Booking

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

booking_failure

BookingFailure

Nếu một yêu cầu đặt phòng được xác nhận không đồng bộ không thành công và trạng thái của yêu cầu đặt phòng đang được cập nhật thành KHÔNG THÀNH CÔNG, thì trường này phải phản ánh lỗi logic nghiệp vụ (ví dụ: người dùng hiện có một yêu cầu đặt phòng quá gần thời điểm này). Bạn chỉ nên đặt trường này khi cập nhật trạng thái đặt phòng thành KHÔNG THÀNH CÔNG. Nếu không, bạn sẽ bỏ qua trường này.

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 mộ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 sẽ được cập nhật

order

Order

Đơn đặt hàng cần được 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ụ.

UserPurchaseRestriction

Giới hạn 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 phương thức thanh toán chỉ có thể được mua bởi người dùng chưa từng mua cùng một phương thức thanh toán đó.

VirtualSession

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

Trường
session_instructions

Text

Hướng dẫn về cách thiết lập lớp học trực tuyến này. Nếu đối tác không cung cấp URL của video khi đặt phòng, thì văn bản này phải kèm theo thời điểm chia sẻ URL của video với người dùng. Ví dụ: "Chúng tôi sẽ gửi URL của Zoom qua đường bưu điện 30 phút trước khi lớp học diễn ra". (Nên dùng)

session_requirements

Text

Các yêu cầu đối với phiên ảo nhất định. Ví dụ: thảm tập yoga, dụng cụ nấu ăn, v.v. (Được đề xuất)

virtual_platform_info

VirtualPlatformInfo

Thông tin về nền tảng ảo được sử dụng trong buổi chia sẻ 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 trực tuyến không 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 OTHER. (Bắt buộc nếu nền tảng được đặt thành OTHER)

Nền tảng

Enum cho biết người bán sẽ sử dụng nền tảng ảo nào.

Enum
PLATFORM_UNSPECIFIED Không sử dụng.
FLEXIBLE Người bán có thể linh hoạt sử dụng nền tảng video nào.
GOOGLE_HANGOUTS Sản phẩm Google Hangouts.
GOOGLE_MEET Sản phẩm Google Meet.
ZOOM Tính năng liên lạc bằng video của Zoom.
SKYPE Skype.
YOUTUBE Phát trực tiếp trên YouTube.
OTHER Bạn nên đặt thuộc tính này nếu nền tảng video được sử dụng khác với các nền tảng được đề cập ở đây.

WaitlistRules

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à một số nguyên dương đối với những 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ờ, bạn không được điền thông tin này.

max_party_size

int32

Bắt buộc. Phải là một số nguyên dương đối với những 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ờ, 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ờ của dịch vụ này.

above_max_party_size_options[]

UnsupportedPartySizeOption

Đặt tuỳ chọn cho các bên lớn hơn max_party_size đã đặt. Để trống nếu những nhóm có quy mô lớn hơn không được cung cấp lựa chọn thay thế cho việc tham gia danh sách chờ.