Package google.maps.booking.v1alpha

Dấu thời gian UTC tối đa kể cả tình trạng còn hàng sẽ lặp lại cho đến.

repeat_every

ExtendedServiceAvailability

Xác định thời gian giữa các thời điểm tình trạng rảnh/bận liên tiếp.

Ví dụ: Tình trạng rảnh/bận có thời lượng 20 phút, repeat_mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và repeat_until 11:00 sáng sẽ tạo ra các vị trí là 9-9:20 sáng, 9:30-9:50 sáng, 10-10:20 sáng, 10:30-10:1-50 sáng, 10:30-10:1-50 sáng (bắt buộc)

ScheduleException

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

Các trường

Các trường
`time_range`	`TimeRange` Phạm vi thời gian của ngoại lệ. Mọi khung giờ được mô tả theo tần suất trùng lặp trong phạm vi thời gian đóng này sẽ được coi là không có sẵn. Ví dụ: Nếu việc lặp lại chỉ định khoảng thời gian 20 phút, repeat_mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và repeat_until 11:00 sáng, thì một ScheduleException có phạm vi thời gian là 9:45 sáng-11:00 sáng sẽ không có sẵn các khung giờ từ 9:30-9:50 sáng, 10:3-10 sáng, 10:3-10 sáng và 10:3-10 sáng: Xin lưu ý rằng vì phạm vi thời gian này đang đóng cửa, nên vị trí bắt đầu lúc 11 giờ sáng sẽ không bị ảnh hưởng.

time_range

TimeRange

Phạm vi thời gian của ngoại lệ. Mọi khung giờ được mô tả theo tần suất trùng lặp trong phạm vi thời gian đóng này sẽ được coi là không có sẵn.

Ví dụ: Nếu việc lặp lại chỉ định khoảng thời gian 20 phút, repeat_mỗi 30 phút, thời gian bắt đầu là 9:00 sáng và repeat_until 11:00 sáng, thì một ScheduleException có phạm vi thời gian là 9:45 sáng-11:00 sáng sẽ không có sẵn các khung giờ từ 9:30-9:50 sáng, 10:3-10 sáng, 10:3-10 sáng và 10:3-10 sáng:

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

SchedulingRuleOverrides

Quy tắc lên lịch ở cấp độ sẵn có.

Các trường

Các trường
`last_bookable_sec`	`int64` Thời gian gần đây nhất (tính bằng giây) mà bạn có thể đặt khung giờ này. Dấu thời gian này phải trước thời điểm bắt đầu (start_sec) của vị trí được áp dụng (nếu người dùng có thể đặt trước sau thời gian bắt đầu, hãy sử dụng SchedulingRules ở cấp dịch vụ.min_booking_before_end_time). Nếu có, tính năng này sẽ ghi đè mọi giá trị được chỉ định trong min_booking_buffer của Quy tắc lập lịch biểu của Dịch vụ tương ứng.
`first_bookable_sec`	`int64` Lần đầu tiên (tính bằng giây) mà người dùng có thể đặt khung giờ này. Dấu thời gian này phải trước start_sec của vị trí hoặc last_bookable_sec nếu được chỉ định.
`last_online_cancellable_sec`	`int64` Nếu được đặt, thời gian gần đây nhất (tính bằng giây kể từ thời gian bắt đầu của Unix) mà khung giờ nhận đặt hẹn cụ thể này có thể bị huỷ thông qua tính năng Đặt trước bằng Google. Trường này sẽ thay thế mọi quy tắc huỷ cấp dịch vụ. (không bắt buộc)

last_bookable_sec

int64

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

first_bookable_sec

int64

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

last_online_cancellable_sec

int64

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

BatchDeleteGenericRecordsRequest

Yêu cầu xoá các bản ghi của loại nguồn cấp dữ liệu đã chỉ định theo lô.

Các trường

Các trường
`parent`	`string` Tên tài nguyên có định dạng – `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericDeleteRecord` 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 – partners/{partner_id}/feeds/{feed_name}.

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

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

Các trường

Các trường
`parent`	`string` Tên tài nguyên có định dạng – `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericRecord` Bản ghi sẽ được chèn và/hoặc cập nhật. Mỗi lệnh gọi API được phép có tối đa 1.000 bản ghi.

parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

Yêu cầu theo lô để thay thế nhiều vị trí phát sóng của Service.

Các trường

Các trường
`parent`	`string` Định dạng `partners/{partner_id}`.
`extended_service_availability[]`	`ExtendedServiceAvailability` Khả năng cung cấp dịch vụ mở rộng dùng để thay thế các khung giờ hiện có.

parent

string

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

extended_service_availability[]

Khả năng cung cấp dịch vụ mở rộng dùng để thay thế các khung giờ hiện có.

BatchReplaceServiceAvailabilityResponse

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

Các trường

Các trường
`extended_service_availability[]`	`ExtendedServiceAvailability` Các thông báo về khả năng sử dụng dịch vụ mở rộng được cập nhật thành công dùng để thay thế các khung thời gian hỗ trợ hiện có.

extended_service_availability[]

ExtendedServiceAvailability

Các thông báo về khả năng sử dụng dịch vụ mở rộng được cập nhật thành công dùng để thay thế các khung thời gian hỗ trợ hiện có.

Thông tin đặt chỗ

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

Các trường
`name`	`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 quảng cáo
`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 phòng
`payment_information`	`PaymentInformation` Thông tin về các giao dịch thanh toán liên quan đến lượt đặt vé.
`party_size`	`int64` Số người tham gia bữa tiệc đã đặt trước

BookingFailure

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

Các trường
`cause`	`Cause` Lý do không đặt được chỗ. (bắt buộc)
`rejected_card_type`	`CreditCardType` (chỉ bắt buộc nếu nguyên nhân là PAYMENT_ERROR_CARD_TYPE_ đấu giả)
`description`	`string` Trường không bắt buộc này dùng để đối tác cung cấp thông tin bổ sung chỉ nhằm mục đích gỡ lỗi. (không bắt buộc)
`payment_failure`	`PaymentFailureInformation` Thông tin về các lỗi thanh toán.

Nguyên nhân

Bảng liệt kê các nguyên nhân gây lỗi.

Enum
`CAUSE_UNSPECIFIED`	Giá trị mặc định: Không sử dụng; dẫn đến "lỗi không xác định"
`SLOT_UNAVAILABLE`	Vị trí tình trạng rảnh/bận được đề cập không còn nữa.
`SLOT_ALREADY_BOOKED_BY_USER`	Người dùng đã đặt lịch hẹn cho khung giờ nhận đặt lịch hẹn được đề cập.
`LEASE_EXPIRED`	Hợp đồng thuê (nếu được cung cấp) đã hết hạn và không thể được dùng nữa để hoàn tất yêu cầu đặt phòng.
`OUTSIDE_CANCELLATION_WINDOW`	Hiện tại, không thể thực hiện yêu cầu huỷ do quy định hạn chế về thời gian trong chính sách huỷ của người bán.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì người bán không chấp nhận loại thẻ tín dụng đã cung cấp. Loại thẻ tín dụng phải được cung cấp trong keyword_card_type.
`PAYMENT_ERROR_CARD_DECLINED`	Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì thẻ tín dụng được cung cấp đã bị từ chối.
`PAYMENT_OPTION_NOT_VALID`	Đã xảy ra lỗi với gói/gói thành viên dùng để thanh toán cho yêu cầu đặt trước. Có thể không còn lượt sử dụng hợp lệ nào, ứng dụng có thể đã hết hạn, v.v.
`PAYMENT_ERROR`	Đã xảy ra lỗi khi xử lý khoản thanh toán cho yêu cầu đặt chỗ này. Sử dụng giá trị này để biểu thị lỗi liên quan đến thanh toán chung, chỉ khi lỗi không khớp với lỗi thanh toán cụ thể ở trên.
`USER_CANNOT_USE_PAYMENT_OPTION`	Người dùng không thể sử dụng phương thức thanh toán đã cho (ví dụ: người dùng cố gắng sử dụng giá lần đầu tiên).
`BOOKING_ALREADY_CANCELLED`	Lượt đặt chỗ mà người dùng cố gắng huỷ đã bị huỷ.
`BOOKING_NOT_CANCELLABLE`	Không thể huỷ lượt đặt phòng mà người dùng đã cố gắng huỷ.
`OVERLAPPING_RESERVATION`	Người dùng hiện có một yêu cầu đặt chỗ quá gần thời điểm này.
`USER_OVER_BOOKING_LIMIT`	Không đặt được vé do người dùng đã vượt quá giới hạn lượt đặt trước trên mỗi người dùng của đơn vị tập hợp.
`PAYMENT_REQUIRES_3DS1`	Đặt thời điểm khoản thanh toán bị từ chối vì bạn đang yêu cầu thử lại giao dịch, nhưng đây là lần này sau khi bạn trải qua quy trình thử thách/phản hồi 3DS1. Xin lưu ý rằng trạng thái không thành công của giao dịch hiện tại sẽ vẫn không thành công. Hoạt động thử lại sẽ hoàn toàn riêng biệt. Khi là lý do không thành công, bạn PHẢI đặt thông số payment_failure.3DS1_parameters. Nếu không, thì nguyên nhân hiện tại sẽ được xử lý như thể là PAYMENT_ERROR.

PaymentFailureInformation

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

Các trường

Các trường
`threeds1_parameters`	`ThreeDS1Parameters` Các tham số được trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ được bỏ qua trừ khi ĐặtFailure.Destroy được đặt thành PAYMENT_REQUIRES_3DS1.

threeds1_parameters

ThreeDS1Parameters

Các tham số được trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ được bỏ qua trừ khi ĐặtFailure.Destroy được đặt thành PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

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

Tham số được thiết lập theo mô tả của EMVCo về giao thức 3DS1.

Các trường
`acs_url`	`string` URL để tải biểu mẫu và hiển thị cho người dùng để xác thực.
`pa_req`	`string` Yêu cầu Xác thực Thanh toán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp.
`transaction_id`	`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 người bán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp.

BookingStatus

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

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

CallMerchant

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

CancellationPolicy

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

Các trường

Các 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 duy nhất. Nhiều điều kiện hoàn tiền có thể được sử dụng cùng nhau để mô tả "các bước hoàn tiền" dưới dạng các khoảng thời gian khác nhau trước thời gian bắt đầu dịch vụ.

Các trường

Các trường
`min_duration_before_start_time`	`Duration` Khoảng thời gian trước thời gian bắt đầu cho đến thời điểm khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí của dịch vụ được chỉ định trong `refund_percent`. 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 tiền, 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 bạn đặt giá trị này là 0 (mặc định), thì 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 lại toàn bộ.

min_duration_before_start_time

Khoảng thời gian trước thời gian bắt đầu cho đến thời điểm khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí của dịch vụ được chỉ định trong refund_percent. 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 tiền, 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 bạn đặt giá trị này là 0 (mặc định), thì 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 lại toàn bộ.

ClientInformation

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

Các 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 một Merchant.

Các trường

Các 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 một Service mới.

Các trường

Các trường
`parent`	`string` Tên tài nguyên chính cho 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 cho 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 hạn chế đối với các loại thẻ tín dụng mà người bán này chấp nhận.

Các trường

Các 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 thẻ 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 thẻ trống.

CreditCardType

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

Enum
`CREDIT_CARD_TYPE_UNSPECIFIED`	Không sử dụng.
`VISA`	Thẻ tín dụng Visa.
`MASTERCARD`	Thẻ tín dụng Mastercard.
`AMERICAN_EXPRESS`	Thẻ tín dụng American Express.
`DISCOVER`	Thẻ tín dụng của Khám phá.
`JCB`	Thẻ tín dụng JCB.

DeleteMerchantRequest

Yêu cầu xoá Merchant.

Các trường

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

name

string

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

DeleteServiceRequest

Yêu cầu xoá Service.

Các trường

Các trường
`name`	`string` Tên tài nguyên của dịch vụ cần xoá. Theo đị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á. Theo định dạng partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Ký quỹ

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

Các trường

Các trường
`deposit`	`Price` Số tiền gửi.
`min_advance_cancellation_sec`	`int64` Huỷ đặt trước tối thiểu cho khoản tiền đặt cọc.
`deposit_type`	`PriceType` Xác định cách xác định khoản tiền gửi dựa trên tình trạng còn hàng.

deposit

Số tiền gửi.

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

Xác định cách xác định khoản tiền gửi dựa trên tình trạng còn hàng.

DirectMerchantPayment

Thông tin về cách người dùng có thể thanh toán trực tiếp cho người bán thay vì trả trước cho dịch vụ qua RwG.

Các trường

Các trường
`payment_methods[]`	`Text` Người dùng chỉ nên thanh toán qua các phương thức thanh toán được đề cập dưới đây.

payment_methods[]

Text

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

DurationRange

Trình bao bọc trong một phạm vi thời lượng có thể được giới hạn hoặc không liên kết. Bạn phải có ít nhất một trong hai thời lượng min_duration và max_duration.

Các trường

Các 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 tình trạng rảnh/bận và người/thời điểm áp dụng.

Các trường
`merchant_id`	`string` Đây là trường bắt buộc để chỉ định người bán nào nhận được thông báo về tình trạng còn hàng bên dưới.
`service_id`	`string` Đây là trường bắt buộc để chỉ định dịch vụ của thông báo về tình trạng rảnh/bận bên dưới.
`start_time_restrict`	`Timestamp` Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Tình trạng còn hàng là bản tổng quan nhanh hoàn chỉnh từ ngày [start_time_restrict, end_time_restrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa: `availability.duration == duration_restrict` Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế hơn nữa: `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 để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định. Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict.
`end_time_restrict`	`Timestamp` Việc đặt end_time_restrict trong khi không đặt start_time_restrict sẽ có nghĩa là tất cả thời gian đã đạt đến end_time_restrict.
`duration_restrict`	`Duration` Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp.
`resources_restrict`	`Resources` Việc đặt tài nguyên_hạn chế sẽ giới hạn hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.
`availability[]`	`Availability` Danh sách tình trạng rảnh/bận mới.

FeedStatistics

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

Các trường

new_items

int64

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

existing_items

int64

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

deleted_items

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 nên kết quả là đã bị xoá.

FeedStatus

Trạng thái của nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.

Các trường
`name`	`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 đang xử lý của nguồn cấp dữ liệu này.
`error_details`	`string` Chuỗi ký tự đọc được, cung cấp thêm thông tin chi tiết nếu chúng tôi không xử lý được nguồn cấp dữ liệu này.
`statistics`	`FeedStatistics` Số liệu thống kê dành riêng cho nguồn cấp dữ liệu này.

Tiểu bang

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

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

FoodOrderingMetadata

Siêu dữ liệu cho đường liên kết về thao tác đặt món ăn.

Các trường
`fee_details[]`	`FeeDetails` Thông tin chi tiết về các khoản phí tính cho người dùng, được thêm vào tổng số tiền của mặt hàng. Lặp lại đối với các loại phí khác nhau như phí dịch vụ, phí giao hàng, v.v.
`advance_order_details`	`AdvanceOrderDetails` Thông tin chi tiết về dịch vụ hỗ trợ đặt hàng nâng cao (còn gọi là dịch vụ đặt hàng trước) mà người dùng có thể đặt hàng vào một thời điểm muộn hơn so với hiện tại.
Trường nhóm `fulfillment_duration_options`. Khoảng thời gian thực hiện đơn đặt hàng tính từ lúc xác nhận đơn đặt hàng. Đối với đơn đặt hàng giao tận nơi, khoảng thời gian cho đến khi giao đồ ăn. Đối với đơn đặt hàng tự đến lấy, khoảng thời gian cho đến khi thực phẩm sẵn sàng để khách đến lấy. `fulfillment_duration_options` chỉ có thể là một trong những trạng thái sau đây:
`fulfillment_lead_time_duration`	`Duration` Thời lượng cố định. Ví dụ: 30 phút.
`fulfillment_lead_time_duration_range`	`DurationRange` Một phạm vi thời lượng. Ví dụ: * 30 phút đến 45 phút * Trên 30 phút * Dưới 50 phút

AdvanceOrderDetails

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

Các trường

is_supported

bool

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

FeeDetails

Chi tiết về khoản phí.

Các trường

type

FeeType

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

fee_amount

FeeAmount

Số tiền phí có thể tính theo đơn vị tiền tệ, tỷ lệ phần trăm của giá trị giỏ hàng hoặc kết hợp cả hai. (bắt buộc)

FeeAmount

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

Các trường
`cart_percentage`	`QuantitativeValue` Phí tính theo tỷ lệ phần trăm của giá trị giỏ hàng. Hỗ trợ một phạm vi (có giới hạn và không giới hạn) hoặc một tỷ lệ phần trăm cố định. Giá trị phải nằm trong khoảng từ 0 đến 100. Ví dụ: * Cố định 5,5% * Tối thiểu 5,5% * Tối đa 5,5% * 4,5% đến 5,5%
Trường nhóm `amount_options`. Các lựa chọn để chỉ định số tiền. `amount_options` chỉ có thể là một trong những trạng thái sau đây:
`amount`	`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 là 3,5 USD * Tối đa là 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`	Về phí giao hàng.
`SERVICE`	Về phí dịch vụ.

FulfillmentOption

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

Các trường
`fulfillment_type`	`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 mà phương thức thực hiện này có thể được hỗ trợ (tốt nhất là ít nhất là 2).
`fee_details`	`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 liên kết với đường liên kết hành động.

AvailableDay

Khả năng cung cấp cấp ngày.

Các trường

fulfillment_date

Date

Bắt buộc. Ngày có thể sử dụng của một phương thức thực hiện. Được giả định nằm trong múi giờ của người bán.

last_ordering_time

Bắt buộc. Dấu thời gian Unix. Lần cuối cùng người dùng có thể đặt hàng và nhận mặt hàng muộn nhất vào fulfillment_date. Nói cách khác, sau last_ordering_time, kết quả thực hiện đơn hàng sẽ không còn hiển thị là có sẵn.

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

FeeDetails

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

Các trường
Trường nhóm `fee_details`. Mô hình phí cho phương thức thực hiện. `fee_details` chỉ có thể là một trong những trạng thái sau đây:
`no_fee`	`NoFee` Không mất phí cho phương thức thực hiện.
`base_fee`	`MinimumFee` Phí cơ bản liên kết với phương thức thực hiện đơn hàng.
`fixed_fee`	`FixedFee` Phí cố định liên kết với phương thức thực hiện đơn hàng.

FixedFee

Phí cố định bắt buộc cho phương thức thực hiện liên kết với đường liên kết hành động.

Các trường

amount

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

FulfillmentType

Loại phương thức thực hiện được liên kết với một đường liên kết hành động.

Enum
`FULFILLMENT_TYPE_UNSPECIFIED`	Chưa chỉ định kiểu phương thức thực hiện.
`FULFILLMENT_TYPE_DELIVERY`	Phương thức thực hiện là phân phối.
`FULFILLMENT_TYPE_PICKUP`	Phương thức thực hiện đơn hàng là đến lấy hàng.

MinimumFee

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

Các trường

base_fee_amount

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

NoFee

Bạn không phải trả phí cho phương thức thực hiện liên kết với đường liên kết hành động.

GenericDeleteRecord

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

Các trường
`delete_time`	`Timestamp` Bắt buộc. Dấu thời gian này dùng để xác định thứ tự áp dụng yêu cầu xoá đối với khoảng không quảng cáo.
Trường nhóm `record_type`. Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) Đối tác có thể cung cấp bản ghi đầy đủ tương tự như cách cung cấp bản ghi trong nguồn cấp dữ liệu hoặc BatchPush API. Đối tác cũng có thể chỉ thêm các trường cần thiết của hồ sơ để nhận dạng chính xác bản ghi đó. `record_type` chỉ có thể là một trong những trạng thái sau đây:
`data_record`	`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.

Các trường
`generation_timestamp`	`Timestamp` Bắt buộc. Dấu thời gian này dùng để đảm bảo thứ tự cập nhật kho hàng chính xác.
Trường nhóm `record_type`. Đóng gói nhiều loại nguồn cấp dữ liệu (ndjson, dựa trên proto, v.v.) `record_type` chỉ có thể là một trong những trạng thái sau đây:
`data_record`	`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.

GeoCoordinates

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

Các trường
`latitude`	`double` Vĩ độ tính bằng độ. (không bắt buộc)
`longitude`	`double` Kinh độ theo độ. (không bắt buộc)
Trường nhóm `addresses`. Địa chỉ của một vị trí, có thể có cấu trúc hoặc không có cấu trúc. `addresses` chỉ có thể là một trong những trạng thái sau đây:
`address`	`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 nhà hát vòng tròn parkway Mountain view, ca 94043"

GetMerchantStatusRequest

Yêu cầu nhận một MerchantStatus

Các trường

name

string

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

GetStatusRequest

Yêu cầu truy xuất Status cho một nguồn cấp dữ liệu cụ thể do nền tảng của đơn vị tập hợp tải lên.

Các trường

name

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

Cần cung cấp thêm thông tin cho ngành dọc dịch vụ gia đình.

Các trường

category_type

string

Danh mục cấp cao chứa dịch vụ gia đình này. Ví dụ: thợ sửa ống nước, thợ điện, v.v.

job_type

string

Loại công việc thuộc danh mục của dịch vụ gia đình cụ thể. Ví dụ: unclog_drain, install_faucet là các loại công việc thuộc danh mục thợ sửa ống nước.

IntegrationType

Hỗ trợ độ sâu tích hợp.

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

InvalidateResourceRequest

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

Các trường

resource_id

string

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

Ví dụ: đối với tài nguyên Lấy hàng, tên phải có định dạng partners/{partner_id}/pickups/{pickup_id}. Các quá trình 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 – việc đặt một dịch vụ duy nhất trong một khung giờ duy nhất.

Các trường
`service_id`	`string` Mã 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 bắt đầu của hệ thống 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é đã đặt 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é.

Các trường

ticket_id

string

Mã của Loại vé.

count

int32

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

ListMerchantStatusesRequest

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

Các trường
`parent`	`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ả lại. Xin lưu ý rằng máy chủ có thể giảm kích thước trang.
`page_token`	`string` Không bắt buộc. Giá trị nextPageToken được trả về từ 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ảng không quảng cáo đặ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) để lọc kết quả theo trạng thái khoảng không quảng cáo trong danh sách chờ.
`geo_match_restrict`	`GeoMatchingStatus` Không bắt buộc. Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái so khớp địa lý.

BookingInventoryStatus

Trạng thái của khoảng không quảng cáo đặt trước từ đầu đến cuối.

Enum
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	Chưa xác định.
`NO_VALID_FUTURE_INVENTORY`	Người bán không có kho hàng đặt trước trong 30 ngày tiếp theo.
`HAS_VALID_FUTURE_INVENTORY`	Người bán có kho hàng đã đặt trước trong 30 ngày tiếp theo.

GeoMatchingStatus

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

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

WaitlistInventoryStatus

Trạng thái khoảng không quảng cáo trong danh sách chờ từ đầu đến cuối.

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

ListMerchantStatusesResponse

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

Các trường

merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

Yêu cầu truy xuất Status cho nhiều nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.

Các trường
`name`	`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ả lại.
`page_token`	`string` Giá trị next_page_token được trả về từ yêu cầu List trước đó, nếu có.
`state_restrict`	`State` Hạn chế để lọc kết quả theo trạng thái nguồn cấp dữ liệu (không bắt buộc).
`time_range_restrict`	`TimeRange` Hạn chế tùy chọn lọc kết quả theo giới hạn trên và giới hạn dưới. Nếu bạn không đặt start_time, thì thời gian bắt đầu Unix sẽ được đặt mặc định. Nếu bạn không đặt end_time, thời gian kết thúc sẽ được đặt mặc định là bây giờ.

ListStatusResponse

Yêu cầu truy xuất Status cho nhiều nguồn cấp dữ liệu do nền tảng của đơn vị tập hợp tải lên.

Các trường

status[]

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ặt hàng tối đa được trả về dựa trên trường page_size trong yêu cầu.

next_page_token

string

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

LocalizedString

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

Các trường

locale

string

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

value

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

Các trường
`place_id`	`string` Mã địa điểm cho một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Truy cập vào https://developers.google.com/places/web-service/place-id để biết thêm thông tin về Mã địa điểm. Nếu cung cấp thông tin này, Google sẽ so khớp vị trí với địa điểm này.
`name`	`string` Tên, số điện thoại, url và địa lý của vị trí được sử dụng để hỗ trợ việc so khớp vị trí với những địa điểm đã xuất hiện trên Google Maps. Trường này là không bắt buộc nhưng có thể bắt buộc trong một số ngữ cảnh. Ví dụ: Service.location không có tên sẽ không khớp với pháp nhân doanh nghiệp, ngay cả khi chúng ở cùng một địa chỉ. (không bắt buộc)
`telephone`	`string` Số điện thoại công cộng của vị trí, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234. (không bắt buộc)
`url`	`string` URL của trang web công khai của vị trí. (không bắt buộc)
`geo`	`GeoCoordinates` Thông tin địa lý của vị trí, bao gồm cả vĩ độ, kinh độ và địa chỉ. (không bắt buộc)
`location_type`	`LocationType` Bạn phải cung cấp loại vị trí nếu vị trí này được cung cấp cho một Dịch vụ.
`location_id`	`string` Tham chiếu duy nhất về vị trí trong dịch vụ. Mã này có thể dùng để tham chiếu đến vị trí này trong các trường dịch vụ khác. Ví dụ: trong biểu mẫu nhập thông tin tuỳ chỉnh, bạn có thể sử dụng một nhóm mã vị trí để chỉ định các lựa chọn về vị trí đến lấy hàng. Nếu được đặt, mã nhận dạng này phải là duy nhất trong cùng một dịch vụ. (không bắt buộc)

LocationType

Loại vị trí này.

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

Người bán

Thông tin về người bán trên nền tảng của trang web tổng hợp.

Các trường
`name`	`string` Tên tài nguyên của người bán (có định dạng `partners/{partner_id}/merchants/{merchant_id}`).
`merchant_name`	`string` merchant_name, điện thoại, url và địa lý được dùng để hỗ trợ việc so khớp kho hàng của đối tác với những người bán đã có trên Google Maps. Thông tin này sẽ không xuất hiện. Tên người bán.
`telephone`	`string` Số điện thoại công khai của người bán, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234.
`url`	`string` URL 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 cả 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ặt hàng này không còn dùng nữa! Trường này không được dùng nữa.
`tax_rate_basis_points (deprecated)`	`uint32` Mặt hàng này không còn dùng nữa! Thuế suất của người bán tính theo điểm cơ bản (một phần trăm của một phần trăm). Ví dụ: nếu thuế suất là 7, 5%, bạn phải đặt giá trị cho trường này là 750. Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được giả định là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế đánh giá theo thuế suất cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phân số của 1 xu) sẽ được làm tròn bằng cách làm tròn chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Trường này không còn dùng nữa, vui lòng sử dụng tax_rate thay thế.
`tax_rate`	`TaxRate` Thuế suất của người bán. Nếu có trường này, hãy ghi đè trường tax_rate_basis_points không dùng nữa. Nếu bạn nhận được thông báo trống (tức là tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0.
`payment_restrictions`	`PaymentRestrictions` Các quy định hạn chế đối với các phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định không có quy định hạn chế nào nếu bạn không đặt trường này.
`payment_option[]`	`PaymentOption` Các phương thức thanh toán có sẵn cho người bán này. Các dịch vụ của người bán này sẽ có thể giới hạn từng lựa chọn thanh toán mà họ cho phép.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` Mặt hàng này không còn dùng nữa! Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó).
`tokenization_config`	`TokenizationConfig` Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó).
`terms`	`Terms` Điều khoản và điều kiện của người bán cụ thể mà người dùng nhìn thấy khi người dùng đang đặt dịch vụ thông qua tính năng Đặt chỗ với Google. Ngoài ra, Điều khoản và điều kiện của đối tác tổng hợp luôn hiển thị cho người dùng và không được cung cấp tại đây.
`brand_id`	`string` Một chuỗi mờ xác định thương hiệu mà người tiêu dùng nhìn thấy để sử dụng khi hiển thị thuộc tính của đối tác. Trường này cho phép các đối tác có nhiều thương hiệu tương tác trực tiếp với người tiêu dùng cung cấp cho người bán tất cả các thương hiệu trong cùng một nguồn cấp dữ liệu. Một thương hiệu bao gồm các đặc điểm mà người tiêu dùng nhìn thấy như tên, biểu trưng, Điều khoản dịch vụ và Chính sách quyền riêng tư. Nếu chỉ có một thương hiệu đối tác đại diện cho người tiêu dùng, thì bạn không cần đặt và có thể bỏ qua trường này. Nếu đối tác... Không có nhiều thương hiệu hướng tới người tiêu dùng? --> Bỏ qua trường này Bạn có định cấu hình nhiều thương hiệu không? `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 thiết lập trường này vì Google sẽ so khớp người bán với các địa điểm trên Google Maps dựa trên thông tin được cung cấp ở trên. (không bắt buộc)
`service_attribute[]`	`ServiceAttribute` Định nghĩa cho mọi thuộc tính dịch vụ dùng để mô tả Dịch vụ cho Người bán này. (không bắt buộc)
`action_link[]`	`ActionLink` Không bắt buộc. URL hành động có ngôn ngữ liên quan, danh sách quốc gia bị hạn chế, loại và nền tảng không bắt buộc cho biết nên thực hiện hành động này trên nền tảng nào,
`waitlist_advisement`	`Advisement` Không bắt buộc. Tư vấn chung của một người bán cụ thể cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Mỗi trường văn bản trong nội dung tư vấn chỉ được có độ dài tối đa là 100 byte.

MerchantMatchingHints

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

Các trường

place_id

string

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

MerchantStatus

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

Các trường
`name`	`string` Tên tài nguyên trạng thái của người bán, có định dạng `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 lượt đặ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` Địa điểm địa lý đã so khớp của người bán này. Để trống nếu người bán không khớp với vị trí địa lý.
`local_services_match`	`LocalServicesMatchInfo` Thông tin trùng khớp trong Quảng cáo dịch vụ địa phương của người bán này. Để trống nếu đó không phải là người bán dịch vụ địa phương hoặc không khớp với bất kỳ nhà cung cấp nào.
`direct_urls[]`	`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 này không có nghĩa là khoảng không quảng cáo thực sự đang được phân phát và URL có thể khác với các khoảng không quảng cáo hiển thị công khai.

BookingStatus

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

Các trường

has_valid_future_inventory

bool

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

DirectUrl

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

Các trường

type

UrlType

Loại 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 xác định.
`BOOKING`	URL đặt phòng từ đầu đến cuối.
`WAITLIST`	URL danh sách chờ hai đầu.
`LOCAL_SERVICES`	URL Dịch vụ địa phương của Google.

LocalServicesMatchInfo

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

Các trường

matched_providers[]

MatchedProvider

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

MatchedProvider

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

Các trường

customer_id

int64

Mã khách hàng bên ngoài cho 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.

Các trường

name

string

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

formatted_address

string

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

place_id

string

Mã địa điểm trên Google của địa điểm này. Có thể dùng để tạo URL trên Google Maps hoặc tìm nạp thêm thông tin chi tiết về địa điểm. Hãy tham khảo https://developers.google.com/places/web-service/place-id để xem ví dụ về cách sử dụng.

ProcessingStatus

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

Enum
`PROCESSING_STATUS_UNSPECIFIED`	Trạng thái chưa xác định.
`IN_PROGRESS`	Madden đã nhận được người bán này nhưng vẫn đang xử lý. Người bán ở trạng thái này sẽ không có trạng thái khác được điền.
`COMPLETED`	Chúng tôi đã tính toán các trạng thái khác của người bán.

WaitlistStatus

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

Các trường

has_valid_waitlist_service

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ân phát.

MoneyRange

Trình bao bọc cho một loạt số tiền có thể bị giới hạn hoặc không bị giới hạn. Bạn phải cung cấp ít nhất một trong hai giá trị min_amount và max_amount.

Các trường

min_amount

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.

Các trường

fee

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

fee_type

PriceType

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

Đặt

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

Các trường
`name`	`string` Tên tài nguyên của đơn đặt hàng: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` Thông tin cá nhân của khách hàng đặt hàng.
`payment_information`	`PaymentInformation` Thông tin về giao dịch thanh toán liên quan đến đơn đặt hàng.
`merchant_id`	`string` Mã nhận dạng người bán sở hữu tất cả dịch vụ trong đơn đặt hàng này.
`item[]`	`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 thao tác đặt hàng trực tuyến.

Các trường

fulfillment_option[]

FulfillmentOption

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

PaymentInformation

Thông tin thanh toán liên quan đến lượt đặt trước

Các trường

prepayment_status

PrepaymentStatus

Trạng thái thanh toán trước của lượt đặt trước. Nếu ignore_status là PREPAYMENT_PROVIDED hoặc PREPAYMENT_REFUNDED, thì payment_transaction_id sẽ chứa mã giao dịch duy nhất được liên kết.

payment_transaction_id

string

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

PaymentOption

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

Các trường
`payment_option_id`	`string` Mã này được dùng để xác định lựa chọn thanh toán này. Mã nhận dạng này áp dụng chung cho toàn bộ trang web tổng hợp, và việc sử dụng lại một giá trị cho nhiều người bán sẽ cho phép người dùng thanh toán bằng phương thức thanh toán tương ứng cho những người bán đó. Khi bạn sử dụng lại một mã nhận dạng cho nhiều người bán, việc cập nhật bất kỳ giá trị nào cho một tuỳ chọn thanh toán của một người bán cũng sẽ cập nhật mọi tuỳ chọn thanh toán khác có cùng mã nhận dạng đó ở một người bán khác. Do đó, phương pháp hay nhất là để tất cả lựa chọn thanh toán có cùng một mã nhận dạng và luôn được cập nhật thành các giá trị giống nhau để tránh mọi khả năng xảy ra hành vi suy yếu.
`name`	`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ề lựa chọn thanh toán. Người dùng có thể nhìn thấy thông tin này.
`price`	`Price` Giá của phương thức thanh toán.
`tax_rate`	`TaxRate` Thuế suất cho phương thức thanh toán này. Nếu có, trường này sẽ thay thế trường tax_rate trong Người bán hoặc Dịch vụ. Nếu bạn nhận được thông báo trống (tức là tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0.
`payment_option_type`	`PaymentOptionType` Loại của tuỳ chọn thanh toán này. Dùng một lần cho các gói thả xuống, dùng nhiều lần cho các gói và không giới hạn cho gói thành viên.
`session_count`	`int64` Số phiên hoạt động mà phương thức thanh toán này có thể được sử dụng. Chỉ hợp lệ cho nhiều phiên / gói, trong đó giá trị phải lớn hơn 1.
`purchase_interval`	`TimeRange` Người dùng có thể mua lựa chọn thanh toán trong khoảng thời gian này.
`valid_interval`	`TimeRange` Bạn có thể sử dụng tùy chọn thanh toán trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, tuỳ chọn này sẽ ghi đè valid_duration và Activate_type.
`valid_duration`	`Duration` Thời hạn có hiệu lực của lựa chọn thanh toán (ví dụ: gói thành viên 30 ngày).
`activation_type`	`ActivationType` Xác định cách xác định ngày bắt đầu có hiệu lực cho tuỳ chọn thanh toán này.
`user_restriction`	`UserPurchaseRestriction` Hạn chế người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để giới hạn phương thức thanh toán khuyến mãi cho một nhóm nhỏ người dùng. Nếu bạn không đặt chính sách này, thì tất cả người dùng đều đủ điều kiện.

ActivationType

Xác định cách xác định ngày bắt đầu hiệu lực.

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

PaymentOptionType

Một loại tuỳ chọn thanh toán.

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

PaymentProcessorConfig

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

Các trường

processor

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

version

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 của các khoản thanh toán bằng Stripe.
`PROCESSOR_BRAINTREE`	Cấu hình của các khoản thanh toán bằng Hearttree.

PaymentRestrictions

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

Các trường

credit_card_restrictions

CreditCardRestrictions

Các hạn chế đối với thẻ tín dụng mà người bán này chấp nhận. Chúng tôi giả định rằng tất cả thẻ tín dụng đều được chấp nhận nếu bạn không đặt trường này. Xin lưu ý rằng danh sách thẻ mà CreditCardType hỗ trợ sẽ tăng lên theo thời gian, nghĩa là việc để lại cấu hình cho các đối tượng trống này sẽ dẫn đến những thay đổi trong tương lai.

PerOrderFee

Các khoản phí phải thanh toán một lần cho mỗi đơn đặt hàng, bất kể số lượng vé.

Các trường

delivery_fee

Phí có thể thay đổi tùy theo phương thức phân phối.

processing_fee

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

PerTicketFee

Phí phải trả cho mỗi vé mà người dùng mua.

Các trường

service_charge

Thu phí bổ sung cho một dịch vụ.

facility_fee

Một khoản phí đi đến địa điểm/cơ sở y tế.

taxes

Thuế mỗi vé.

PostalAddress

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

Các trường
`address_country`	`string` Quốc gia được chỉ định bằng mã quốc gia theo ISO 3166-1 alpha-2, ví dụ: "US" (bắt buộc)
`address_locality`	`string` Địa phương, ví dụ: " Mountain View". (bắt buộc)
`address_region`	`string` Khu vực, ví dụ: "CA". Trường này chỉ bắt buộc ở 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 trước.

Enum
`PREPAYMENT_STATUS_UNSPECIFIED`	Chưa được chỉ định, mặc định là PREPAYMENT_NOT_PROVIDED.
`PREPAYMENT_PROVIDED`	Phí đặt vé đã được thanh toán trước.
`PREPAYMENT_NOT_PROVIDED`	Phí đặt vé chưa được thanh toán trước.
`PREPAYMENT_REFUNDED`	Phí trước đây là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại.

Giá

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

Các trường
`price_micros`	`int64` Giá tính theo đơn vị một phần triệu của tiền tệ. Các phân số của đơn vị tiền tệ nhỏ nhất sẽ được làm tròn bằng cách làm tròn số chẵn gần nhất. (Ví dụ: 2,5 xu làm tròn thành 2 xu, 3,5 xu làm tròn thành 4 xu, 0,5 xu làm tròn thành 0 xu, 2,51 xu làm tròn thành 3 xu).
`currency_code`	`string` Đơn vị tiền tệ của giá tiền được xác định trong ISO 4217.
`pricing_option_tag`	`string` Một chuỗi không bắt buộc và không rõ ràng giúp xác định lựa chọn đặt giá liên kết với giá mở rộng.

PriceInterpretation

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

Enum
`PRICE_INTERPRETATION_UNSPECIFIED`	Chưa xác định phần diễn giải giá, mặc định là EXACT_AMOUNT.
`EXACT_AMOUNT`	Khi giá cả được hiểu là một giá trị cụ thể. Ví dụ: $20 cho một lớp học yoga; $15 cho một kiểu cắt tóc trẻ em
`STARTS_AT`	Khi giá của một dịch vụ có thể thay đổi nhưng giá tối thiểu được xác định và hiển thị cho người tiêu dùng. Người tiêu dùng có thể đưa ra lựa chọn làm tăng giá sản phẩm. Xin lưu ý rằng mọi dịch vụ sử dụng Thông tin diễn giải giá này đều phải sử dụng tính năng PrepaymentType NOT_ trùng. Ví dụ: 30 USD cho dịch vụ chải lông cho chó nhưng các lựa chọn khác của người tiêu dùng có thể tăng giá
`NOT_DISPLAYED`	Khi giá của một dịch vụ thay đổi và không có thông tin nào về giá được hiển thị trước cho người tiêu dùng. Xin lưu ý rằng bất kỳ dịch vụ nào sử dụng Thông tin diễn giải giá này đều phải sử dụng loại thanh toán trước NOT_PLURAL và Giá phải để trống. Ví dụ: Tư vấn về dịch vụ gia đình

PriceType

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

Enum

FIXED_RATE_DEFAULT

Giá dành cho một số tiền cố định. Đây là giá trị mặc định nếu bạn không đặt trường này.

Ví dụ: Đặt bàn $50 để đặt bàn; không cần đặt bàn là $20 khi đăng ký lớp yoga

PER_PERSON

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

Ví dụ: 10 USD mỗi vé vào bảo tàng

QuantitativeValue

Trình bao bọc cho một giá trị số có thể là một dải ô hoặc một giá trị cố định. Ví dụ về QuantitativeValue: * Giá trị số ít: value: 10.5 * Giới hạn trên: value_range {min_value: 5.5, max_value 10.5} * Giới hạn dưới: value_range {min_value: 5.5} * Giới hạn trên: value_range {max_value: 10.5}

Các trường

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

value

double

Giá trị số ít. Ví dụ: 5,6

value_range

RangeValue

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

RangeValue

Phạm vi giá trị sao cho min_value < max_value. Cần có ít nhất một trong số min_value và max_value.

Các trường

min_value

double

Giá trị nhỏ nhất.

max_value

double

Giá trị tối đa.

Rating

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

Các trường

value

double

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

number_of_ratings

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 dữ liệu các nội dung đa phương tiện này để đảm bảo chúng hiển thị chính xác cho người dùng cuối. (không bắt buộc)

Các trường
`url`	`string` URL của nguồn nội dung nghe nhìn này. Google sẽ thu thập dữ liệu nội dung nghe nhìn được lưu trữ tại URL này.
`type`	`MediaType` Loại nguồn nội dung nghe nhìn này.
`localized_caption`	`Text` Phụ đề của nội dung nghe nhìn hỗ trợ i18n, chỉ hỗ trợ văn bản thuần tuý. Mọi thành phần HTML sẽ bị xoá. (không bắt buộc)
`attribution`	`Attribution` Thông tin ghi nhận tác giả về nguồn nội dung nghe nhìn. Xin lưu ý rằng nếu thuộc tính bắt buộc phải hiển thị cùng với nội dung nghe nhìn để ghi nhận tác giả cho nhiếp ảnh gia hoặc công ty quảng cáo, thì bạn phải đặt trường này. (không bắt buộc)
`caption (deprecated)`	`string` Mặt hàng này không còn dùng nữa! Không dùng nữa, hãy ưu tiên sử dụng local_caption.

Phân bổ

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

Các trường

localized_text

Text

Văn bản để ghi nhận tác giả cho nhiếp ảnh gia hoặc đại lý hỗ trợ i18n. Văn bản này sẽ được hiển thị cùng với phương tiện nguồn. Xin lưu ý rằng trường này chỉ hỗ trợ văn bản thuần tuý và mọi thành phần HTML sẽ bị xoá (không hỗ trợ thuộc tính dựa trên siêu liên kết).

text
(deprecated)

string

Không dùng nữa, muốn sử dụng local_text.

MediaType

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

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

ReplaceServiceAvailabilityRequest

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

Các trường

service_availability

ServiceAvailability

Khả năng cung cấp dịch vụ được dùng để thay thế các dịch vụ hiện có.

RequireCreditCard

Xác định xem người dùng có cần thẻ tín dụng để đặt lịch hẹn hay không.

Enum
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	Yêu cầu thẻ tín dụng không được chỉ định rõ ràng và hành vi giống hệt với hành vi được chỉ định cho điều kiện điều kiện.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	Google sẽ yêu cầu thẻ tín dụng để đặt chỗ nếu bất kỳ điều kiện nào sau đây được đáp ứng: * tình trạng còn phòng có giá và phương thức thanh toán trước_type là REQUIRED * thiết lập no_show_fee * trường đặt cọc tiền.
`REQUIRE_CREDIT_CARD_ALWAYS`	Khách hàng luôn phải có thẻ tín dụng để đặt trước tình trạng còn hàng này bất kể các giá trị khác của trường.

Tài nguyên

Tài nguyên được dùng để phân biệt các khung giờ còn trống với nhau khi các phòng hoặc nhân viên khác nhau sử dụng dịch vụ. Nhiều vị trí cho cùng một dịch vụ và khoảng thời gian có thể cùng tồn tại khi chúng có các tài nguyên khác nhau.

Các trường
`staff_id`	`string` Mã nhận dạng không bắt buộc của một nhân viên cung cấp dịch vụ. Trường này xác định nhân viên trên tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Thông tin này cũng cần phải ổn định theo thời gian để có thể tạo mối tương quan với các lượt đặt phòng trước đây. Trường này phải xuất hiện nếu có Staff_name.
`staff_name`	`string` Tên không bắt buộc của một nhân viên cung cấp dịch vụ. Trường này sẽ hiển thị cho những người dùng đang đặt chỗ và phải có thể đọc được chứ không phải là giá trị nhận dạng không rõ ràng. Bạn phải cung cấp trường này nếu có Staff_id.
`room_id`	`string` Mã không bắt buộc của phòng có dịch vụ. Trường này xác định phòng trên tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Thông tin này cũng cần phải ổn định theo thời gian để có thể tạo mối tương quan với các lượt đặt phòng trước đây. Trường này phải xuất hiện nếu có room_name.
`room_name`	`string` Tên không bắt buộc cho phòng có dịch vụ. Trường này sẽ hiển thị cho những người dùng đang đặt chỗ và phải có thể đọc được chứ không phải là giá trị nhận dạng không rõ ràng. (không bắt buộc nhưng bắt buộc nếu có room_id) Trong nhà hàng, tên phòng chỉ nên dùng cho khu vực ghế ngồi như quầy bar hoặc sân hiên và không nên sử dụng cho thực đơn có giá cố định, hoạt động đặc biệt hoặc bất kỳ giá trị nào khác không phải là phòng (chẳng hạn như đặt chỗ hoặc ăn tối). Bạn không nên liên kết với khu vực ghế ngồi mặc định.
`party_size`	`int32` Chỉ áp dụng cho bữa tối: Quy mô bữa tiệc có thể được phục vụ trong khung giờ này. Một nhà hàng có thể được liên kết với nhiều Slots cùng một lúc, mỗi khung giờ chỉ định một Party_size khác nhau, nếu chẳng hạn 2, 3 hoặc 4 người có thể đặt chỗ.

SchedulingRules

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

Các trường
`min_advance_online_canceling`	`int64` Thời gian thông báo trước tối thiểu tính bằng giây phải có để huỷ cuộc hẹn đã đặt trước qua mạng. (không bắt buộc)
`late_cancellation_fee (deprecated)`	`Price` Mặt hàng này không còn dùng nữa! Phí huỷ trong khoảng thời gian thông báo trước tối thiểu.
`noshow_fee (deprecated)`	`Price` Mặt hàng này không còn dùng nữa! Phí không đế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, thì chế độ 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ập lịch. (bắt buộc đối với Điểm tham quan)
Trường nhóm `min_booking_buffer`. Khoảng thời gian (tính bằng giây) kể từ khi có thể đặt phòng gần đây nhất cho đến khi thời gian còn phòng bắt đầu hoặc kết thúc. Nếu bạn đặt "min_advance_booking", thì thời gian có thể đặt trước gần đây nhất sẽ được tính là (<slot start time> – "min_advance_booking"). Nếu bạn đặt "min_booking_buffer_before_end_time", thì thời gian có thể đặt trước gần đây nhất sẽ được tính là (<slot end time> – "min_booking_buffer_before_end_time"). Xin lưu ý rằng nếu đặt giá trị này thì giá trị "min_booking_buffer_before_end_time" phải là số dương. Nếu bạn không đặt cả hai khung giờ, thì khung giờ có thể được đặt trước cho đến thời điểm bắt đầu khung giờ. Nếu bạn đặt cả hai trường, thì chỉ một giá trị được chọn trong khi giá trị còn lại bị bỏ qua – chúng tôi không thể dự đoán một cách chính xác giá trị nào được chọn. Ví dụ: Việc cắt tóc cần được đặt ít nhất 1 giờ trước thời gian bắt đầu. 'scheduling_rules{ min_advance_booking: 3600 ...}` Một bảo tàng nơi khách có thể mua vé cuối cùng trước khi đóng cửa 30 phút: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}' Vé xem phim cần phải được mua trước thời gian bắt đầu. 'schedule_rules{ ...}' (để trống trường này) (không bắt buộc) `min_booking_buffer` chỉ có thể là một trong những trạng thái sau:
`min_advance_booking`	`int64` Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất cho đến khi khung giờ còn phòng trống bắt đầu.
`min_booking_buffer_before_end_time`	`int64` Khoảng thời gian (tính bằng giây) từ khi có thể đặt phòng gần đây nhất đến khi thời gian còn phòng kết thúc. Nếu đặt trường này, thì bạn phải đặt trường "admission_policy" thành TIME_FLEXIBLE để cho biết người dùng có thể sử dụng vé đã mua sau khi khung giờ bắt đầu.

AdmissionPolicy

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

Enum
`ADMISSION_POLICY_UNSPECIFIED`	Không sử dụng.
`TIME_STRICT`	Khách hàng phải có mặt vào thời điểm bắt đầu của khung thời gian phát sóng và dịch vụ dự kiến sẽ kết thúc vào thời gian kết thúc của khung giờ này. Ví dụ về các trường hợp sử dụng TIME_STRICT: * Chuyến tham quan bắt đầu lúc 9 giờ sáng yêu cầu tất cả người tham dự đều đến thời điểm bắt đầu và quay trở lại vào khoảng 12 giờ đêm. * Lịch cắt tóc lúc 3 giờ chiều thứ Bảy sẽ mất khoảng 30 phút. * Lớp thể dục từ 6 giờ tối đến 8 giờ tối.
`TIME_FLEXIBLE`	Khách hàng có thể đến bất cứ lúc nào trong khoảng thời gian từ thời điểm bắt đầu đến kết thúc của khung thời gian còn phòng để sử dụng yêu cầu đặt chỗ này. Ví dụ về các trường hợp sử dụng có thể sử dụng với hàm TIME_FLEXIBLE: * Có thể sử dụng vé tham quan bảo tàng bất cứ lúc nào vào ngày mua. * Vé vào cửa công viên giải trí buổi chiều, có thể sử dụng từ 12:00 đến 21:00.
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	Khách hàng cần phải đến người bán vào thời điểm bắt đầu khung tình trạng còn hàng nhưng có thể rời khỏi danh sách bất cứ lúc nào họ muốn. Ví dụ: trong tình huống vé vào cửa bảo tàng, vé vào cổng có giới hạn thời gian là 10 giờ sáng yêu cầu người dùng phải có mặt tại bảo tàng từ 10 giờ sáng. Thời gian bắt đầu của khung giờ phát sóng cho dịch vụ này là thời gian bắt đầu được chỉ định. Tuy nhiên, thời gian kết thúc chỉ được dùng làm chìa khoá để xác định khung giờ còn trống để đặt trước.

Dịch vụ

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

Các trường
`name`	`string` Tên tài nguyên dịch vụ có định dạng `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`.
`service_name`	`string` Tên của dịch vụ, ví dụ: "Cắt tóc nam". Không dùng nữa, hãy chuyển sang sử dụng locale_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ố khu vực.
`description`	`string` Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Không dùng nữa, chuyển sang sử dụng local_description.
`localized_description`	`Text` Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Trường này hỗ trợ cả định dạng văn bản thuần tuý và định dạng giống HTML. Không giống như các mục văn bản thuần tuý, bạn có thể tạo bố cục tuỳ chỉnh tại đây bằng cách sử dụng tiêu đề, đoạn văn, danh sách và một số thẻ cụm từ. Vui lòng đọc kỹ hướng dẫn và ghi chú sau để đảm bảo bạn tạo ra trải nghiệm người dùng tốt nhất. Các thẻ định dạng giống HTML được hỗ trợ: Thẻ tiêu đề: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Bạn có thể dùng thẻ tiêu đề để 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 làm tiêu đề quan trọng nhất của phần này. Xin lưu ý rằng mọi thẻ, kiểu hoặc thuộc tính HTML bên trong đều sẽ bị bỏ qua. Ví dụ: <h1 style=".."> sẽ được xử lý giống như <h1>. Chỉ văn bản thuần tuý sẽ được lưu giữ. Thẻ đoạn: <p> Bạn có thể sử dụng thẻ đoạn để đánh dấu 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ể dùng với thẻ <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 theo thứ tự. Đây là một cách hiệu quả để hiển thị danh sách kiểm tra, lịch biểu hoặc bất kỳ danh sách nào khác phù hợp với trường hợp sử dụng của bạn. Ví dụ: Để hiển thị danh sách các đặc điểm của chuyến đi trên du thuyền: <ol> <li>Cảnh biển tuyệt đẹp và cơ hội vui chơi với động vật hoang dã.</li> <li>Dịch vụ và cách sắp xếp chuyến đi được thiết kế cẩn thận.</li> <li>Giá thấp nhất được đảm bảo.</li> </ol> Xin lưu ý rằng chỉ <li> trẻ em có thẻ <ul> hoặc <ol> mới được chuyển đổi. Tất cả các khung hiển thị con khác sẽ bị loại bỏ. Ngoài ra, mọi thẻ, thuộc tính và kiểu bên trong sẽ bị bỏ qua; chúng tôi chỉ giữ lại nội dung văn bản thuần tuý. Thẻ chia: <div> Tất cả các thẻ bên trong được hỗ trợ của thẻ <div> sẽ được phân tích cú pháp bằng các quy tắc nêu trên, ngụ ý rằng bản thân thẻ <div> không có nghĩa là bất kỳ nhóm hoặc thụt lề nào ở đây. Ngoài ra, mọi thuộc tính và kiểu bên trong sẽ bị bỏ qua. Thẻ cụm từ: <br>, <strong>, <em>: Chỉ hỗ trợ 3 thẻ nêu trên. Bạn có thể dùng <br> để ngắt dòng trong đoạn văn và <strong>/<em> có thể dùng để làm nổi bật văn bản quan trọng. Mọi thẻ cụm từ khác sẽ bị bỏ qua. Thẻ không được hỗ trợ: Không cho phép thẻ <html>, <header> và <body>. Mọi thẻ khác không được đề cập ở trên đều không được hỗ trợ (ví dụ: <table>, <td> ...). Mọi URL, ký tự liên kết và đường liên kết sẽ bị loại bỏ 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 để mang đến trải nghiệm phong phú cho người dùng, vui lòng sử dụng trường "related_media" bên dưới để gửi URL ảnh của bạn. Lưu ý quan trọng: Cố gắng không dùng các thẻ khác trừ những thẻ được hỗ trợ nêu trên, vì nội dung trong các thẻ không được hỗ trợ sẽ bị loại bỏ và có thể gây ra trải nghiệm không mong muốn cho người dùng. Cố gắng tránh các cấu trúc lồng nhau quá sâu như hơn 3 cấp tiêu đề khác nhau hoặc các danh sách lồng nhau. Việc duy trì cấu trúc phẳng, đơn giản và dễ hiểu giúp tạo ra trải nghiệm người dùng tốt hơn. Nếu những bố cục hiện được hỗ trợ không đủ cho trường hợp sử dụng của bạn, vui lòng liên hệ với nhóm Đặt trước với Google. Kích thước tối đa đề xuất là 32.000 ký tự.
`price`	`Price` Giá của dịch vụ.
`price_interpretation`	`PriceInterpretation` Mô tả cách giá được diễn giải và hiển thị cho người dùng. Có thể được sử dụng trong mọi ngành dọc, ngoại trừ Hoạt động ăn uống và Điểm tham quan để thiết lập cách trình bày giá dịch vụ.
`rules`	`SchedulingRules` Quy tắc đặt trước/huỷ cuộc hẹn.
`prepayment_type`	`PrepaymentType` Liệu thanh toán trước là bắt buộc, tuỳ chọn hay không được hỗ trợ.
`prepayment_terms`	`PrepaymentTerms` Các điều khoản xung quanh thời điểm hoàn tất thanh toán trước.
`form[] (deprecated)`	`ServiceIntakeForm` Mặt hàng này không còn 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 trước 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 trước dịch vụ này. Người dùng phải điền vào biểu mẫu này một lần cho mỗi vé mà họ đặt. (không bắt buộc)
`tax_rate`	`TaxRate` Thuế suất của dịch vụ. Nếu có trường này, trường này sẽ thay thế mọi thuế suất được đặt ở cấp người bán. Nếu bạn nhận được thông báo trống (tức là tax_rate { }) sẽ đặt lại thuế suất đã áp dụng về 0.
`payment_option_id[]`	`string` Danh sách mã nhận dạng tham chiếu các cách thanh toán có thể dùng để thanh toán cho dịch vụ này. Các tuỳ chọn thanh toán thực tế được xác định ở cấp Người bán và cũng có thể được dùng chung giữa nhiều Người bán.
`deposit`	`Deposit` Xác định cách tính một khoản tiền đặt cọc cho người dùng. Ghi đè khoản phí dịch vụ nếu bạn đã chỉ định khoản phí này. Nếu bạn đặt tùy chọn này thành thông báo Khoản tiền gửi trống, thì mọi khoản tiền gửi cấp dịch vụ sẽ bị xóa. (không bắt buộc)
`no_show_fee`	`NoShowFee` Loại này xác định phí vắng mặt có thể được tính cho người dùng. Ghi đè phí dịch vụ không xuất hiện nếu bạn đã chỉ định phí xuất hiện. Nếu bạn đặt thông báo này thành thông báo NoShowFee trống, thì mọi khoản phí không tham gia ở cấp dịch vụ sẽ bị xoá. (không bắt buộc)
`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 độ khả dụ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 có đường liên kết hành động, thì bạn phải đặt loại (xem bên dưới) trong Dịch vụ.
`type`	`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/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 dữ liệu và lưu trữ nội dung nghe nhìn để đảm bảo người dùng cuối thấy những nội dung đó theo cách hiệu quả nhất. (không bắt buộc)
`service_attribute_value_id[]`	`ServiceAttributeValueId` Các giá trị thuộc tính dịch vụ áp dụng cho dịch vụ này (không bắt buộc). Mỗi Dịch vụ có thể không có hoặc có nhiều giá trị cho mỗi thuộc tính dịch vụ được xác định trong Người bán tương ứng. (không bắt buộc)
`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` Chiều sâu tích hợp mà chúng tôi hỗ trợ cho dịch vụ này. (không bắt buộc) Không liên quan đến những đối tác sử dụng chức năng tích hợp ban đầu. Tính năng này sẽ luôn tắt từ đầu đến cuối đối với những đối tác này.
`per_order_fee`	`PerOrderFee` Phí ở cấp đơn đặt hàng để mua dịch vụ này. (không bắt buộc)
`tours_and_activities_content`	`ToursAndActivitiesContent` Các trường nội dung dành riêng cho Chuyến tham quan và Hoạt động.
`location[]`	`Location` Các vị trí liên quan đến dịch vụ này. LƯU Ý QUAN TRỌNG: Nếu có nhiều vị trí được ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION, thì bạn phải chỉ địnhSTART_LOCATION. Ví dụ: – Một chuyến tham quan bằng xe đạp có hướng dẫn viên đến thăm ba địa điểm, bạn cần chỉ định địa điểm bắt đầu. – Một chuyến tham quan bằng xe buýt tại sảnh của khách sạn, sau đó đi đến địa điểm khách tham quan. Bạn cần chỉ định địa điểm họp.
`rating`	`Rating` Điểm xếp hạng của người dùng đối với dịch vụ này dưới dạng một chỉ số tổng hợp trên tất cả các bài đánh giá.
`home_service_data`	`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. Cần có để bật các dịch vụ ảo.
`direct_merchant_payment`	`DirectMerchantPayment` Không bắt buộc. Thông tin bổ sung cần được bổ sung nếu dịch vụ yêu cầu người dùng thanh toán trực tiếp cho người bán. LƯU Ý QUAN TRỌNG: RwG sẽ không tham gia vào giao dịch này. Bắt buộc phải có nếu virtual_session được xác định và dịch vụ không miễn phí hoặcforeground_type KHÔNG được đặt thành REQUIRED.

PrepaymentTerms

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

Các trường

charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

int64

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

ChargeTiming

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

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

PrepaymentType

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

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

ServiceType

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

Enum
`SERVICE_TYPE_UNSPECIFIED`	Không sử dụng.
`SERVICE_TYPE_DINING_RESERVATION`	Đã đặt chỗ ăn uống.
`SERVICE_TYPE_FOOD_ORDERING`	Đặt đồ ăn có thể là giao đồ ăn hoặc đồ ăn mang đi hoặc cả hai.
`SERVICE_TYPE_FOOD_DELIVERY`	Giao đồ ăn.
`SERVICE_TYPE_FOOD_TAKEOUT`	Đồ ăn mang đi.
`SERVICE_TYPE_EVENT_TICKET`	Vé xem sự kiện.
`SERVICE_TYPE_TRIP_TOUR`	Chuyến tham quan.
`SERVICE_TYPE_APPOINTMENT`	Dịch vụ cung cấp cuộc hẹn hoặc lớp học. Nên dùng cho (1) dịch vụ sức khoẻ và thể dục, (2) spa và làm đẹp, (3) dịch vụ tư vấn và đánh giá tài chính. Vui lòng xem các loại dịch vụ được hỗ trợ: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
`SERVICE_TYPE_ONLINE_APPOINTMENT`	Dịch vụ cung cấp lịch hẹn trực tuyến cho một lớp học hoặc phiên họp hoàn toàn qua mạng. Bạn phải đặt nếu bật tính năng đặt trước dịch vụ ảo.
`SERVICE_TYPE_SHOPPING`	Dịch vụ cho phép người dùng mua sắm từ người bán cụ thể. Đó có thể là dịch vụ giao hàng hoặc đến lấy hàng.

ServiceAttribute

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

Các trường

attribute_id

string

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

attribute_name

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ả các giá trị có thể sử dụng cho thuộc tính dịch vụ này.

Giá trị

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

Các trường

value_id

string

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

value_name

string

Tên mà người dùng nhìn thấy cho giá trị, ví dụ: "Cá nhân".

ServiceAttributeValueId

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

Các trường

attribute_id

string

Mã nhận dạng của một thuộc tính theo quy định trong phần Merchant.service_attribute, ví dụ: "service-type".

value_id

string

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

ServiceAvailability

Danh sách tình trạng rảnh/bận và người/thời điểm áp dụng.

Các trường
`name`	`string` Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo định dạng `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`
`start_time_restrict`	`Timestamp` Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Tình trạng còn hàng là bản tổng quan nhanh hoàn chỉnh từ ngày [start_time_restrict, end_time_restrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau: `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa: `availability.duration == duration_restrict` Nếu bạn đặt thông báo resources_restrict, điều kiện sẽ bị hạn chế hơn nữa: `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 để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định. Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ có nghĩa là tất cả thời gian bắt đầu từ start_time_restrict.
`end_time_restrict`	`Timestamp` Việc đặt end_time_restrict trong khi không đặt start_time_restrict sẽ có nghĩa là tất cả thời gian đã đạt đến end_time_restrict.
`duration_restrict`	`Duration` Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp.
`resources_restrict`	`Resources` Việc đặt tài nguyên_hạn chế sẽ giới hạn hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.
`availability[]`	`Availability` Danh sách tình trạng rảnh/bận mới.

ServiceIntakeForm

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

Các trường

field[]

ServiceIntakeFormField

Các trường mà người dùng sẽ thấy.

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 tiên. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu nhập thông tin.

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

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

Các trường
`id`	`string` Một chuỗi từ đối tác tổng hợp xác định duy nhất một trường trên biểu mẫu. Mã này phải giống với mã trong câu trả lời của trường biểu mẫu tương ứng và phải là duy nhất trên cả cấp dịch vụ lẫn biểu mẫu nhập phiếu yêu cầu hỗ trợ. (bắt buộc)
`type`	`FieldType` Loại trường này.
`label`	`string` Văn bản mà người dùng nhìn thấy trong trường này. Không dùng nữa, vui lòng sử dụng `localized_label`.
`localized_label`	`Text` Văn bản mà người dùng nhìn thấy trong trường này. Trường có thể được cung cấp bằng nhiều ngôn ngữ. (bắt buộc)
`value[]`	`string` Chỉ đặt khi loại trường là LOCATION_SEARCH. Vui lòng sử dụng "location_id" trong trường "location" để chỉ định giá trị vị trí.
`choice_text[]`	`Text` Chỉ thiết lập khi loại trường là MULTIPLE_CHOICE, bắnBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể có.
`is_required`	`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 cho phép trong các câu trả lời bổ sung được xác định trước hay không. Điều này chỉ áp dụng khi loại trường là LOCATION_SEARCH. (không bắt buộc)
`additional_option[]`	`Text` Các tuỳ chọn khác được cung cấp ngoài các giá trị đã cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: Ngoài danh sách vị trí được cung cấp, bạn có thể sử dụng một lựa chọn khác là "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc)
`ticket_type_restrict[]`	`string` Nếu câu hỏi này chỉ hiển thị khi người dùng đặt một số loại vé nhất định, thì bạn phải đặt trường này làm tập hợp các mã loại vé thích hợp. Hãy để trống trường này nếu câu hỏi này luôn phù hợp.
`hint`	`Text` Văn bản gợi ý để nhập, xuất hiện dưới dạng một phần giữ chỗ văn bản. Điều này chỉ áp dụng khi loại trường là SHORT_ANSWER hoặc PARAGRAPH. (không bắt buộc)

FieldType

Enum để cho biết loại trường.

Enum
`FIELD_TYPE_UNSPECIFIED`	Các trường không xác định hoặc không xác định sẽ bị bỏ qua.
`SHORT_ANSWER`	Trường nhập một dòng cho văn bản.
`PARAGRAPH`	Trường nhập nhiều dòng cho văn bản.
`MULTIPLE_CHOICE`	Một tập hợp các nút chọn yêu cầu một lựa chọn từ nhiều tuỳ chọn.
`CHECKBOXES`	Một hoặc nhiều mục được liệt kê có hộp đánh dấu.
`DROPDOWN`	Một lựa chọn trong trình đơn thả xuống.
`BOOLEAN`	Nút có/không.
`LOCATION_SEARCH`	Hộp tìm kiếm hỗ trợ tìm vị trí phù hợp do người dùng nhập từ danh sách vị trí được cung cấp.

TaxRate

Thuế suất được áp dụng khi tính phí người dùng cho một dịch vụ và có thể đặt theo từng người bán hoặc theo dịch vụ.

Các trường

micro_percent

int32

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

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

Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế đánh giá theo thuế suất cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phân số của 1 xu) sẽ được làm tròn bằng cách làm tròn chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt.

Thuật ngữ

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

Các trường

url

string

URL dẫn đến Điều khoản và điều kiện (không bắt buộc).

text

string

Văn bản mà người dùng nhìn thấy. Sử dụng bản địa hoá_văn bản bên dưới để tích hợp mới.

localized_text

Text

Văn bản đã bản địa hoá mà người dùng sẽ thấy.

Văn bản

Tải trọng văn bản có thể được bản địa hoá. Một số trường Văn bản có thể chứa nội dung được đánh dấu.

Các trường

value

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ữ của 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 coi là ngôn ngữ cụ thể nào.

localized_value[]

LocalizedString

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

TicketType

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

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

Các trường
`ticket_type_id`	`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ỉ 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", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Không dùng nữa, chuyển sang sử dụng local_short_description.
`localized_short_description`	`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", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ.
`price`	`Price` Giá của một vé thuộc loại này, không bao gồm bất kỳ khoản thuế nào. Thuế suất của Dịch vụ được áp dụng cho vé của dịch vụ đó.
`per_ticket_fee`	`PerTicketFee` Các khoản phí bổ sung khi mua vé này. (không bắt buộc)
`option_description`	`string` Nội dung mô tả về mọi lựa chọn bổ sung thuộc loại vé này, nếu có. Ngừng sử dụng, chuyển sang sử dụng local_option_description.
`localized_option_description`	`Text` Nội dung mô tả về mọi lựa chọn bổ sung thuộc loại vé này, nếu có. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ. Các lựa chọn bổ sung sẽ hữu ích khi loại phiếu yêu cầu hỗ trợ đại diện cho nhiều phương diện. Ví dụ 1: một vé vào cửa có nhiều loại "người lớn", "trẻ em" và ngôn ngữ là một lựa chọn bổ sung, thì danh sách vé xem được chấp nhận là: {vé_type_id} "của vé_type_1" local_short_description {value: "adult" } local_options_description { value: "english_type_2" được bản địa hoá} - {vé_type_id} được bản địa hoá theo giá trị "vé_type_2" được bản địa hoá} {select_description_price_price}: " hết_4.0.3_._._ Không bắt buộc, nhưng nếu bất kỳ loại vé nào trong dịch vụ có trường này được đặt, thì chúng tôi dự kiến tất cả các loại vé khác cũng có trường này được đặt (có thể sử dụng options_description mặc định). Ví dụ: [{ticket_type_1, child, english}, {ticket_type_1, người lớn, ''}] không phải là danh sách hợp lệ. Chỉ hỗ trợ hai thẻ định dạng HTML: và . Các bảng này được dùng để xác định các lựa chọn kèm theo cả tiêu đề và nội dung mô tả chi tiết, ví dụ: "Ghế ngồi cao cấp Lựa chọn này có các chỗ ngồi tại các khoang riêng tư, bao gồm ghế đệm toàn bộ, 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 vẽ."

TicketingVerticalSpecificData

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

Các trường
`event_category`	`EventCategory` Danh mục của sự kiện. Chỉ thiết lập khi sự kiện thuộc một trong các danh mục được xác định trước. (không bắt buộc)
`event_url`	`string` URL của sự kiện trên trang web của đối tác. (không bắt buộc)
`entity[]`	`Entity` Danh sách các thực thể có liên quan đến sự kiện. (không bắt buộc)
`event_attendance_mode`	`AttendanceMode` Bắt buộc. Loại sự kiện tham dự sự kiện.
`event_virtual_location_url[]`	`string` Không bắt buộc. URL nơi có thể xem sự kiện.
`event_organizer`	`Text` Không bắt buộc. Người tổ chức sự kiện.
`event_organizer_url`	`string` Không bắt buộc. URL của người tổ chức sự kiện.
`event_organizer_type`	`OrganizerType` Không bắt buộc. Loại người tổ chức.
`event_source_url[]`	`string` Bắt buộc. URL của các trang nơi có thông tin hoặc nội dung mô tả về sự kiện.
`event_state`	`EventState` Không bắt buộc. Trạng thái của sự kiện.

AttendanceMode

Loại sự kiện tham dự sự kiện.

Enum
`ATTENDANCE_MODE_UNSPECIFIED`	Chưa xác định.
`ONLINE`	Đối với sự kiện trực tuyến.
`PHYSICAL`	Đối với sự kiện vật lý.
`PHYSICAL_ONLINE_MIXED`	Dành cho các sự kiện diễn ra cả thực tế và trực tuyến.

Thực thể

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

Các trường
`id`	`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 thực thể. Đây là trang web của đối tác trên trang web của đối tác (nếu có). Đối với các URL công khai khác của thực thể, hãy sử dụng relevant_url trong public_identification_data. (không bắt buộc)
`entity_type`	`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` Nguồn tham khảo công khai của thực thể. (không bắt buộc)

EntityRole

Vai trò của thực thể trong sự kiện.

Enum
`ENTITY_ROLE_UNSPECIFIED`	Chưa xác định.
`ENTITY_ROLE_HEADLINER`	Thực thể này đại diện cho một người tiêu đề hoặc người biểu diễn hàng đầu tại sự kiện.
`ENTITY_ROLE_SUPPORTER`	Thực thể này đại diện cho người biểu diễn hỗ trợ tại sự kiện.
`ENTITY_ROLE_HOME_TEAM`	Pháp nhân này đại diện cho đội chủ nhà tại sự kiện (thể thao).
`ENTITY_ROLE_AWAY_TEAM`	Pháp nhân này đại diện cho đội khách tại sự kiện (thể thao).

EntityType

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

Enum
`ENTITY_TYPE_UNSPECIFIED`	Chưa xác định. Không được dùng.
`ENTITY_TYPE_PERFORMER`	Thực thể này đại diện cho nghệ sĩ hoặc nhóm biểu diễn tại buổi hoà nhạc hoặc chương trình. Chỉ áp dụng khi danh mục sự kiện là CONCERT hoặc THEATRE.
`ENTITY_TYPE_PLAYER`	Thực thể này đại diện cho đội thể thao hoặc vận động viên tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO.
`ENTITY_TYPE_CONCERT_TOUR`	Thực thể này đại diện cho chuyến tham quan chứa sự kiện này. Chỉ áp dụng khi danh mục sự kiện là CONCERT.
`ENTITY_TYPE_SPORTS_SERIES`	Thực thể này đại diện cho một giải đấu thể thao chứa sự kiện này. Chỉ áp dụng khi danh mục sự kiện là THỂ THAO.
`ENTITY_TYPE_PLAY`	Thực thể đại diện cho loại kịch (ví dụ: nhạc kịch, hài kịch, ba lê, v.v.) được biểu diễn tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THEATRE.

EventCategory

Một nhóm danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm sản phẩm. Lưu ý: không phải là một bản thể học phổ biến của sự kiện.

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

EventState

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

Enum
`EVENT_STATE_UNSPECIFIED`	Chưa xác định.
`SCHEDULED`	Sự kiện đã được lên lịch.
`RESCHEDULED`	Sự kiện này đã được lên lịch lại.
`CANCELLED`	Sự kiện đã bị huỷ.
`POSTPONED`	Sự kiện đã bị hoãn.

OrganizerType

Loại người tổ chức.

Enum
`ORGANIZER_TYPE_UNSPECIFIED`	Chưa xác định.
`PERSON`	Đối với người tổ chức là một người.
`ORGANIZATION`	Đối với người tổ chức là một tổ chức.

PublicIdentificationData

Giá trị nhận dạng, trang web hoặc các nguồn công khai khác đề cập đến một thực thể.

Các trường

relevant_url[]

string

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

musicbrainz_id

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ó. Xem https://musicbrainz.org/doc/MusicBrainz_Identifier. (không bắt buộc)

TimeRange

Phạm vi thời gian đóng, tức là [thời_gian_bắt_đầu, thời_gian_kết_thúc).

Các trường

start_time

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

end_time