Package google.maps.booking.v1alpha

string

URL điểm truy cập cho đường liên kết hành động này.

string

Thẻ ngôn ngữ BCP-47 xác định ngôn ngữ mà nội dung từ URI này có sẵn.

string

Mã quốc gia ISO 3166-1 alpha-2. Để trống nếu bạn muốn hiển thị không hạn chế.

ActionPlatform

Nền tảng mà bạn nên thực hiện hành động này. Nếu bạn không đặt trường này, ACTION_PLATFORM_WEB_APPLICATION sẽ được dùng làm phương án dự phòng.

ActionLinkType

Loại hành động được xác định trước.

OrderOnlineMetadata

Siêu dữ liệu cho đường liên kết đặt hàng trực tuyến. Hỗ trợ thao tác có ActionLinkType là ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Siêu dữ liệu cho đường liên kết Đặt món ăn. Hỗ trợ loại hành động: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT KHÔNG hỗ trợ ACTION_LINK_TYPE_ORDER_FOOD.

EventMetadata

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

Surface

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

string

Giá trị nhận dạng. Tên tài nguyên của AdsAccountLink. Định dạng partners/{partner}/adsAccountLinks/{ads_account_link}

string

Bắt buộc. Danh sách mã mặt hàng trong kho để liên kết với tài khoản Google Ads.

State

Chỉ có đầu ra. Trạng thái của mối liên kết với tài khoản Google Ads.

Text

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

Timestamp

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

Duration

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

int64

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

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

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

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

int64

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

string

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

Resources

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

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

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

string

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

Trường này sẽ ghi đè mọi payment_option_ids được chỉ định trong thông báo dịch vụ. Tương tự, payment_option_ids được chỉ định ở đây KHÔNG bắt buộc phải có trong thông báo dịch vụ, mặc dù bạn phải xác định ở cấp Người bán.

Recurrence

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

ScheduleException

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

Deposit

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

NoShowFee

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

Prepayment

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

RequireCreditCard

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

string

Cho biết danh sách các loại vé được hỗ trợ cho khung giờ có thể đặt này. Nếu bạn không đặt giá trị này, tất cả các loại vé trong dịch vụ mẹ đều có sẵn cho khung giờ này. Xin lưu ý rằng bạn phải xác định các giá trị của trường này trong dịch vụ mẹ. Ví dụ:

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

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

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

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

(không bắt buộc)

DurationRequirement

Yêu cầu hiển thị thời lượng và/hoặc thời gian kết thúc của các khung giờ. Trường này sẽ bị bỏ qua nếu không có khe cắm. Không được dùng trong danh mục Việc cần làm. (không bắt buộc)

SchedulingRuleOverrides

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

ConfirmationMode

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

LinkoutRequiredReason

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

Timestamp

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

Duration

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

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

TimeRange

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

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

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

int64

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

int64

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

int64

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

string

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

GenericDeleteRecord

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

string

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

GenericRecord

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

string

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

ExtendedServiceAvailability

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

ExtendedServiceAvailability

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

string

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

string

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

string

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

Timestamp

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

Duration

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

ClientInformation

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

BookingStatus

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

PaymentInformation

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

int64

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

Cause

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

CreditCardType

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

string

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

PaymentFailureInformation

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

ThreeDS1Parameters

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

string

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

string

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

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.

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.

RefundCondition

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

Duration

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

uint32

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

string

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

string

Họ của khách hàng

PostalAddress

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

string

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

string

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

string

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

string

Bắt buộc. Mã nhận dạng cần dùng cho mối liên kết với tài khoản Google Ads. Mã này giống với mã khách hàng Google Ads. Để biết thông tin chi tiết, hãy xem https://support.google.com/google-ads/answer/1704344 Định dạng : xxx-xxx-xxxx.

AdsAccountLink

Bắt buộc. AdsAccountLink cần tạo.

string

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

string

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

Merchant

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

string

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

string

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

Service

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

CreditCardType

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

string

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

string

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

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}

Price

Số tiền ký quỹ.

int64

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

PriceType

Xác định cách xác định khoản tiền đặt cọc dựa trên tình trạng phòng.

Text

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

Duration

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

Duration

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

Text

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

string

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

string

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

Timestamp

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

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

Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:

  availability.duration == duration_restrict

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

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

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

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

Timestamp

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

Duration

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

Resources

Việc thiết lập resources_restrict sẽ hạn chế thêm phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải hoàn toàn khớp.

Availability

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

int64

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

int64

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

int64

Các mặt hàng không còn trong nguồn cấp dữ liệu này và đã bị xoá.

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

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

string

Chuỗi mà con người có thể đọc được, cung cấp thêm thông tin chi tiết nếu chúng tôi không xử lý được nguồn cấp dữ liệu này.

FeedStatistics

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

FeeDetails

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

AdvanceOrderDetails

Thông tin chi tiết về tính năng hỗ trợ đặt hàng nâng cao (còn gọi là đặt hàng trước), trong đó người dùng có thể đặt hàng để thực hiện đơn hàng vào thời điểm khác chứ không phải Ngay bây giờ.

Duration

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

DurationRange

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

bool

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

FeeType

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

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)

QuantitativeValue

Phí tính theo tỷ lệ phần trăm giá trị giỏ hàng. Hỗ trợ một phạm vi (có giới hạn và không giới hạn) hoặc một tỷ lệ phần trăm cố định. Giá trị phải nằm trong khoảng từ 0 đến 100. Ví dụ: * Cố định 5,5% * Ít nhất 5,5% * Nhiều nhất 5,5% * Từ 4,5% đến 5,5%

Money

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

MoneyRange

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

bool

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

FulfillmentType

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

AvailableDay

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

FeeDetails

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

Price

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

Date

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

Timestamp

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

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

NoFee

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

MinimumFee

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

FixedFee

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

Price

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

Price

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

Timestamp

Bắt buộc. Dấu thời gian này được dùng để xác định thứ tự xoá sẽ được áp dụng cho khoảng không quảng cáo.

bytes

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

Any

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

Timestamp

Bắt buộc. Dấu thời gian này được dùng để đảm bảo thứ tự chính xác của các bản cập nhật kho hàng.

bytes

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

Any

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

double

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

double

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

PostalAddress

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

string

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

string

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

string

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

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}

string

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

string

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

string

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

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

string

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

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.

int64

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

OrderedTickets

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

Price

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

BookingStatus

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

string

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

int32

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

string

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

string

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

int32

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

string

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

BookingInventoryStatus

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

WaitlistInventoryStatus

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

GeoMatchingStatus

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

MerchantStatus

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

string

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

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

int32

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

string

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

State

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

TimeRange

Bạn có thể chọn giới hạn để lọc kết quả theo giới hạn trên và giới hạn dưới. Nếu bạn không đặt start_time, thì hệ thống sẽ mặc định là thời gian bắt đầu của thời gian Unix. Nếu bạn không đặt end_time, hệ thống sẽ mặc định đặt giá trị là thời gian hiện tại.

FeedStatus

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

string

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

string

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

string

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

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.

string

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

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

string

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

string

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

GeoCoordinates

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

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

string

Thông tin tham chiếu riêng biệt của vị trí trong dịch vụ. Bạn có thể dùng mã nhận dạng này để tham chiếu đến vị trí này trong các trường dịch vụ khác. Ví dụ: trong biểu mẫu nhập tuỳ chỉnh, bạn có thể dùng một nhóm mã vị trí để chỉ định các lựa chọn về vị trí đến lấy hàng. Nếu được đặt, mã nhận dạng này phải là duy nhất trong cùng một dịch vụ. (không bắt buộc)

string

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

string

merchant_name, telephone, url và geo được dùng để hỗ trợ việc so khớp kho hàng của đối tác với những người bán đã có trên Google Maps. Thông tin này sẽ không được hiển thị.

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

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.

string

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

GeoCoordinates

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

string

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

int64

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

uint32

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

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

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

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

TaxRate

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

PaymentRestrictions

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

PaymentOption

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

PaymentProcessorConfig

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

TokenizationConfig

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

Terms

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

string

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

Thương hiệu bao gồm các tài sản dành cho người tiêu dùng như tên, biểu trưng, Điều khoản dịch vụ và Chính sách quyền riêng tư.

Nếu chỉ có một thương hiệu đối tác dành cho người tiêu dùng, thì bạn không cần phải đặt trường này và có thể bỏ qua.

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

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

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

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

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

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

MerchantMatchingHints

Gợi ý giúp Google so khớp người bán với một địa điểm trên Google Maps. Lưu ý: hầu hết các đối tác không cần đặt trường này, vì Google sẽ so khớp người bán với các địa điểm trên Google Maps bằng thông tin được cung cấp ở trên. (không bắt buộc)

ServiceAttribute

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

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 mà hành động này sẽ được thực hiện,

LinkoutTemplate

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

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

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

Advisement

Không bắt buộc. Lời khuyên chung của một người bán cụ thể dành cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Mỗi trường văn bản trong lời khuyên phải có độ dài tối đa là 100 byte.

EconomicOperator

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

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.

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

string

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

GeoCoordinates

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

ProcessingStatus

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

BookingStatus

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

WaitlistStatus

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

PlaceInfo

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

LocalServicesMatchInfo

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

DirectUrl

Danh sách URL minh hoạ nội dung trong kho hàng hiện tại của người bán. Xin lưu ý rằng điều này không có nghĩa là khoảng không quảng cáo thực sự đang được phân phát và URL có thể khác với URL công khai.

bool

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

UrlType

Loại URL này.

string

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

MatchedProvider

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

int64

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

string

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

string

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

string

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

string

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

bool

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

Money

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

Money

Số tiền tối đa.

Price

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

PriceType

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

string

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

ClientInformation

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

PaymentInformation

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

string

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

LineItem

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

FulfillmentOption

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

PrepaymentStatus

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

string

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

string

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

Mã nhận dạng này là mã nhận dạng chung cho toàn bộ đơn vị tổng hợp và việc sử dụng lại một giá trị cho nhiều người bán sẽ cho phép người dùng thanh toán bằng phương thức thanh toán tương ứng cho những người bán đó.

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

string

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

string

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

Price

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

TaxRate

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

PaymentOptionType

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

int64

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

TimeRange

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

TimeRange

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

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

ActivationType

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

UserPurchaseRestriction

Hạn chế những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để hạn chế một phương thức thanh toán khuyến mãi cho một nhóm nhỏ người dùng. Nếu bạn không đặt chính sách này, tất cả người dùng đều đủ điều kiện.

Processor

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

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

string

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

CreditCardRestrictions

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

Price

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

Price

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

Price

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

Price

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

Price

Thuế trên mỗi vé.

string

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

string

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

string

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

string

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

string

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

PriceInfo

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

int64

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

string

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

string

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

PriceType

Xác định cách áp dụng giá hoặc khoảng giá (mỗi người hoặc cố định)

Price

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

PriceRange

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

Price

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

Price

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

double

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

RangeValue

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

double

Giá trị tối thiểu.

double

Giá trị tối đa.

double

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

uint64

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

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.

MediaType

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

Text

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

Attribution

Thông tin phân bổ về nguồn của nội dung nghe nhìn. Xin lưu ý rằng nếu bạn phải hiển thị thông tin ghi công cùng với nội dung nghe nhìn để ghi công cho nhiếp ảnh gia hoặc công ty quảng cáo, thì bạn phải đặt trường này. (không bắt buộc)

string

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

Text

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

string

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

ServiceAvailability

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

string

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

string

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

string

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

string

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

int32

Chỉ áp dụng cho mục Ăn uống: Số người có thể được phục vụ trong khung giờ này. Một nhà hàng có thể được liên kết với nhiều Khung giờ cho cùng một thời điểm, mỗi Khung giờ chỉ định một party_size riêng, chẳng hạn như 2, 3 hoặc 4 người có thể đặt chỗ.

Text

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

int64

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

Price

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

Price

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

AdmissionPolicy

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

CancellationPolicy

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

int64

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

int64

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

string

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

string

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

Text

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

string

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

Text

Nội dung mô tả dịch vụ mà người dùng nhìn thấy.

Trường này hỗ trợ cả định dạng văn bản thuần tuý và định dạng tương tự như HTML. Không giống như các phần văn bản thuần tuý, bạn có thể tạo bố cục tuỳ chỉnh tại đây bằng cách sử dụng tiêu đề, đoạn văn, danh sách và một số thẻ cụm từ. Vui lòng đọc kỹ các hướng dẫn và lưu ý sau đây để đảm bảo bạn mang lại trải nghiệm người dùng tốt nhất.

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

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

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

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

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

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

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

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

Lưu ý quan trọng:

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

Price

Giá của dịch vụ.

PriceInterpretation

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

SchedulingRules

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

PrepaymentType

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

PrepaymentTerms

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

ServiceIntakeForm

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

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

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

string

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

Deposit

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

NoShowFee

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

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)

ActionLink

Đườ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, bạn phải đặt loại (xem bên dưới) trong Dịch vụ.

ServiceType

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

TicketType

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

RelatedMedia

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

ServiceAttributeValueId

Giá trị thuộc tính dịch vụ áp dụng cho dịch vụ này (không bắt buộc). Mỗi Dịch vụ có thể có từ 0 giá trị trở lên cho mỗi thuộc tính dịch vụ được xác định trong Người bán tương ứng. (không bắt buộc)

WaitlistRules

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

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)

IntegrationType

Mức độ tích hợp mà chúng tôi hỗ trợ cho dịch vụ này. (không bắt buộc) Không liên quan đến những đối tác có chế độ tích hợp cơ bản. Tính năng mã hoá đầu cuối sẽ luôn bị tắt đối với những đối tác này.

PerOrderFee

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

ToursAndActivitiesContent

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

Location

Các vị trí liên quan đến dịch vụ này. LƯU Ý QUAN TRỌNG: Nếu có nhiều vị trí đã ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION, bạn phải chỉ định START_LOCATION. Ví dụ: – Một chuyến tham quan bằng xe đạp có hướng dẫn viên đến 3 địa điểm, bạn cần chỉ định địa điểm bắt đầu. – Một chuyến tham quan bằng xe buýt, mọi người gặp nhau tại sảnh khách sạn rồi đến địa điểm tham quan. Bạn cần chỉ định địa điểm họp.

Rating

Đ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á.

HomeServiceData

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

VirtualSession

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

DirectMerchantPayment

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

UriTemplate

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

ChargeTiming

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

int64

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

string

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

string

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

Value

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

string

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

string

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

string

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

string

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

string

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

Timestamp

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

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

Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:

  availability.duration == duration_restrict

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

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

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

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

Timestamp

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

Duration

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

Resources

Việc thiết lập resources_restrict sẽ hạn chế thêm phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải hoàn toàn khớp.

Availability

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

ServiceIntakeFormField

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

bool

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

bool

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

string

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

FieldType

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

string

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

Text

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

string

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

Text

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

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.

bool

Cho biết liệu giá trị tuỳ chỉnh có được phép ngoài các câu trả lời định sẵn hay không. Điều này chỉ áp dụng khi loại trường là LOCATION_SEARCH. (không bắt buộc)

Text

Các lựa chọn bổ sung được cung cấp ngoài các giá trị đã cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: ngoài danh sách vị trí được cung cấp, bạn có thể chọn "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc)

string

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

Text

Văn bản gợi ý cho thông tin đầu vào, xuất hiện dưới dạng phần giữ chỗ văn bản. Điều này chỉ áp dụng khi loại trường là SHORT_ANSWER hoặc PARAGRAPH. (không bắt buộc)

int32

Tỷ lệ thuế tính bằng phần triệu của 1%, tức là có 6 chữ số thập phân. Ví dụ: nếu thuế suất là 7, 253%, thì bạn nên đặt trường này thành 7253000.

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

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

string

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

string

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

Text

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

string

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

LocalizedString

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

string

Mã vé được dùng để phân biệt các loại vé khác nhau của cùng một dịch vụ và chỉ được phép là mã riêng biệt trong một dịch vụ.

string

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

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

Text

Nội dung mô tả ngắn về TicketType này có hỗ trợ i18n.

Thông tin này có thể hiển thị cho người dùng, ví dụ: "người lớn", "trẻ em", "cựu chiến binh", "hàng J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ.

Price

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

PerTicketFee

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

PriceDisplayType

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

string

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

Text

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

Các lựa chọn bổ sung sẽ hữu ích khi loại vé thể hiện nhiều phương diện.

Ví dụ 1: vé vào cửa có nhiều loại "người lớn", "trẻ em" và ngôn ngữ là một lựa chọn bổ sung, danh sách TicketType dự kiến sẽ là: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

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

Không bắt buộc, nhưng nếu bất kỳ loại vé nào trong dịch vụ có trường này được đặt, thì chúng tôi cũng mong đợi tất cả các loại vé khác đều có trường này được đặt (bạn có thể sử dụng một option_description mặc định). Ví dụ: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] không phải là danh sách hợp lệ.

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

InventoryType

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

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)

string

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

Entity

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

AttendanceMode

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

string

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

Text

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

string

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

OrganizerType

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

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.

EventState

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

Text

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

EventCreator

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

string

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

string

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

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

Thông tin tham khảo công khai về thực thể. (không bắt buộc)

string

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

string

URL công khai của mọi trang web chỉ dành riêng cho chủ đề đó. Ví dụ: Trang web chính thức, Discogs, các nền tảng truyền thông xã hội, Wikipedia hoặc IMDb, chẳng hạn như https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (không bắt buộc)

string

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

Timestamp

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

Timestamp

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

map<string, string>

Cấu hình mã hoá thường sẽ có một tokenization_parameter có khoá là "gateway" và giá trị là tên của đơn vị xử lý.

Các tham số còn lại phụ thuộc vào bộ xử lý. Hãy xem tài liệu của Google Pay để biết thêm thông tin.

Ví dụ về Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

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

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

BillingInformationFormat

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