Package google.maps.booking.v1alpha

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

ExtendedServiceAvailability

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

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.

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

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)

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

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.

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

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.

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

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

parent

string

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

extended_service_availability[]

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

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

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

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.

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

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.

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

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

min_duration_before_start_time

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

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.

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

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.

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

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.

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

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}

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

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}`

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

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.

deposit

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

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.

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

Trường
`min_duration`	`Duration` Thời lượng tối thiểu.
`max_duration`	`Duration` Thời lượng tối đa.

min_duration

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

max_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

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

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

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` Mục này không được dùng nữa! Trường này không được dùng nữa.
`tax_rate_basis_points (deprecated)`	`uint32` Mục này không được dùng nữa! 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` Mục này không được dùng nữa! 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? --> 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)
`action_link[]`	`ActionLink` Không bắt buộc. Một URL hành động có ngôn ngữ liên kết, danh sách các quốc gia bị hạn chế, loại và nền tảng không bắt buộc cho biết nền tảng nào sẽ thực hiện hành động này,
`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

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

Khoản phí có thể thay đổi tuỳ theo phương thức phân phối.

processing_fee

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

PerTicketFee

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

Trường

service_charge

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

facility_fee

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

taxes

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_value và max_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` Mục này không được dùng nữa! 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` Mục này không được dùng nữa! Phí huỷ dịch vụ trong thời gian thông báo trước tối thiểu.
`noshow_fee (deprecated)`	`Price` Mục này không được dùng nữa! 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. '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 vụ

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. <br> 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 ý quan trọ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` Mục này không được dùng nữa! 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)
`action_link[]`	`ActionLink` Một đường liên kết hành động liên quan đến dịch vụ này. Nếu liên kết hành động tồn tại, loại (xem bên dưới) phải được đặt trong Dịch vụ.
`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.
`LOCATION_SEARCH`	Hộp tìm kiếm hỗ trợ tìm vị trí phù hợp do người dùng nhập vào từ danh sách vị trí được cung cấp.

TaxRate

Thuế suất được áp dụng khi tính phí người dùng cho một dịch vụ và có thể đượ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: "child" }localized_option_description { value: "tiếng anh" } } – { Ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } 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: và . 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

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

end_time