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 theo ISO 3166-1 alpha-2. Để trống để hiển thị không bị hạn chế.

ActionPlatform

Nền tảng 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 đến trang đặt hàng trực tuyến. Hỗ trợ hành động có ActionLinkType là ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Siêu dữ liệu cho đường liên kết đến tính năng Đặt món ăn. Hỗ trợ loại thao tác: * 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 dành riêng cho ngành dọc sự kiện.

Surface

Khu vực 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 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 hàng được 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 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 phòng 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ố chỗ và số chỗ còn trống của lịch phát sóng này. Ví dụ:

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

Lưu ý: Nếu gửi yêu cầu 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 mờ tuỳ chọn để xác định vùng tình trạng rảnh/bận này. Nếu được đặt, thông tin này sẽ được đưa vào các yêu cầu đặt/cập nhật/huỷ cuộc hẹn.

Resources

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

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

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

string

Danh sách mã nhận dạng tham chiếu đến các phương thức thanh toán có thể dùng để thanh toán cho khung giờ này. Các phương thức 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 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ù phải được xác định ở cấp Người bán.

Recurrence

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

ScheduleException

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

Deposit

Khoản đặt cọc không bắt buộc cho tình trạng phòng này. Ghi đè khoản tiền đặt cọc dịch vụ nếu có.

NoShowFee

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

Prepayment

Không bắt buộc. Thông tin về khoản thanh toán trước (không bắt buộc) cho tình trạng phò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 khung giờ trống này hay không. Nếu bạn không đặt giá trị này, thì giá trị sẽ được kế thừa từ cấp dịch vụ (nếu được đặt tại đó). (không bắt buộc)

string

Cho biết danh sách các loại vé được hỗ trợ cho khung giờ trống này. Nếu không đặt, tất cả các loại vé trong dịch vụ mẹ đều dùng được cho vùng này. 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"...}. Để đại diện cho kho hàng trong dịp lễ: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• Dịch vụ có 3 loại vé: TicketType {ticket_type_id: "adult" short_description: "Adult"} 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 "tình trạng còn hàng {...}" (không đặt Ticket_type_id ở vị trí này).

(không bắt buộc)

DurationRequirement

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

SchedulingRuleOverrides

Quy tắc lên 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ên lịch tương ứng trên SchedulingRules cấp dịch vụ.

ConfirmationMode

Chế độ xác nhận sẽ được sử dụng khi đặt phòng tình trạng phòng này. Các lượt đặt trước cho tình trạng còn phòng có chế độ xác nhận là CONFIRMATION_MODE_SYNCHRONOUS phải được xác nhận hoặc từ chối ngay lập tức. Các yêu cầu tạo lượt đặt phòng cho tình trạng còn phò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 với trạng thái ĐANG CHỜ.

LinkoutRequiredReason

Không bắt buộc. Lý do cần phải có đường liên kết 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ó LinkoutTemplate hợp lệ. (không bắt buộc)

Timestamp

Dấu thời gian UTC tối đa bao gồm cả thời điểm mà tình trạng còn hàng lặp lại.

Duration

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

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

TimeRange

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

Ví dụ: Nếu lịch biểu định kỳ chỉ định thời lượng 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ờ từ 9:30 đến 9:50, 10 đến 10:20 và 10:30 đến 10:50 không hoạt động.

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

int64

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

int64

Thời gian đầu tiên (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ờ hoặc last_bookable_sec nếu được chỉ định.

int64

Nếu được đặt, thời gian gần nhất (tính bằng giây kể từ thời gian bắt đầu của hệ thống Unix) mà bạn có thể huỷ khung giờ nhận đặt hẹn cụ thể này thông qua tính năng Đặt chỗ 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)

string

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

GenericDeleteRecord

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

string

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

GenericRecord

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

string

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

ExtendedServiceAvailability

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

ExtendedServiceAvailability

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

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 khung giờ

string

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

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

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 yêu cầu đặt phòng

PaymentInformation

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

int64

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

Cause

Lý do không đặt được vé. (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 được dùng cho đối tác để chỉ cung cấp thông tin bổ sung cho mục đích gỡ lỗi. (không bắt buộc)

PaymentFailureInformation

Thông tin về các khoản thanh toán không thành công.

ThreeDS1Parameters

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

string

URL mà từ đó biểu mẫu sẽ được hiển thị cho người dùng để xác thực.

string

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

string

Giá trị nhận dạng do nhà cung cấp ACS sử dụng. Để đăng lên biểu mẫu ACSUrl nếu bạn cung cấp.

string

Dữ liệu người bán. Để đăng lên biểu mẫu ACSUrl nếu bạn cung cấp.

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.

Duration

Khoảng thời gian trước thời gian bắt đầu, cho đến khi khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí 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.

uint32

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

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 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 để sử dụng cho mối liên kết 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 gốc của đối tác sở hữu người bán này, ở định dạng partners/{partner_id}.

string

Mã người bán để sử 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 chính của người bán sở hữu dịch vụ này, ở định dạng partners/{partner_id}/merchants/{merchant_id}.

string

Mã dịch vụ để sử 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 có thẻ tín dụng nào được hỗ trợ nếu trống.

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 gửi.

int64

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

PriceType

Xác định cách xác định khoản đặt cọc từ tình trạng phòng.

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.

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 người vận hành 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 đặt hàng hoặc bất kỳ pháp nhân hoặc cá nhân nào khác chịu các nghĩa vụ liên quan đến việc sản xuất, cung cấp hoặc đưa sản phẩm vào sử dụng. 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 để xác định thông báo về tình trạng còn hàng bên dưới thuộc về người bán nào.

string

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

Timestamp

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

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

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

  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 chỗ trong một phạm vi thời gian nhất định.

Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ được hiểu 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_Limit sẽ có nghĩa là thời gian tồn tại đến hết thời gian end_time_Limit sẽ là tối đa.

Duration

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

Resources

Việc đặt resources_restrict sẽ hạn chế thêm phạm vi của bản cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác.

Availability

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

int64

Các mặt hàng mới được thêm bởi nguồn cấp dữ liệu này. Mục có thể là người bán, dịch vụ hoặc khung giờ 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 xuất hiệ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 ký tự mà con người đọc được, cung cấp thêm chi tiết nếu chúng tôi không xử lý được nguồn cấp dữ liệu này.

FeedStatistics

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

FeeDetails

Thông tin chi tiết về các khoản phí tính cho người dùng ngoài tổng số tiền của mặt hàng. Lặp lại cho nhiều loại phí như phí dịch vụ, phí giao hàng, v.v.

AdvanceOrderDetails

Thông tin chi tiết về dịch vụ hỗ trợ đặt hàng nâng cao, còn gọi là đặt hàng trước, trong đó người dùng có thể đặt hàng để thực hiện đơn muộn hơn ngay bây giờ.

Duration

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

DurationRange

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

bool

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

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 bị giới hạn) hoặc một tỷ lệ phần trăm cố định. Giá trị phải nằm trong khoảng từ 0 đến 100. Ví dụ: * Cố định 5,5% * Ít nhất 5,5% * Tối đa 5,5% * 4,5% đến 5,5%

Money

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

MoneyRange

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

bool

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

FulfillmentType

Bắt buộc. Loại phương thức thực hiện.

AvailableDay

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

FeeDetails

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

Price

Bắt buộc. Số lượng đơn đặt 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 cho một phương thức thực hiện. Giả định là theo múi giờ của người bán.

Timestamp

Bắt buộc. Dấu thời gian Unix. Lần gần nhất mà người dùng có thể đặt hàng và nhận mặt hàng muộn nhất vào ngày fulfillment_date. Nói cách khác, sau last_ordering_time, fulfillment_date 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à 10/8/2020: – giá trị last_ordering_time là 18:00-2020-08-10 có nghĩa là, để nhận được đơn đặt hàng vào ngày 10/8/2020, khách hàng phải đặt hàng trước 6 giờ chiều cùng ngày. – giá trị last_ordering_time 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 kết với phương thức thực hiện.

FixedFee

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 dùng để xác định thứ tự áp dụng thao tác xoá cho 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 proto.

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

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í (ưu tiên).

string

Bạn cũng có thể cung cấp một địa chỉ không có cấu trúc làm địa chỉ 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 với 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, ở đị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ụ 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 chứa dịch vụ gia đình nhất định. Ví dụ: unclog_drain, install_faucet là các loại công việc thuộc danh mục thợ sửa ống nước.

string

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

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

string

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

Price

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

int32

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

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

int32

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

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. Quy định hạn chế không bắt buộc để lọc kết quả theo trạng thái kho hàng đặt trước.

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

GeoMatchingStatus

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

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ã để 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.

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ục tối đa cần trả về.

string

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

State

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

TimeRange

Giới hạn (không bắt buộc) để lọc kết quả theo giới hạn trên và giới hạn dưới. Nếu bạn không đặt start_time, thì giá trị này 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, thì giá trị mặc định sẽ là hiện tại.

FeedStatus

Danh sách trạng thái theo thứ tự ngược dòng thời gian cho 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ã để 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.

string

Mã ngôn ngữ theo tiêu chuẩn 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 ở 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à thông tin địa lý của vị trí được dùng để hỗ trợ so khớp vị trí đó với những địa điểm đã có trên Google Maps.

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

string

Số điện thoại công khai 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)

string

URL của trang web công khai của địa điểm. (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 địa điểm nếu địa điểm này được cung cấp cho một Dịch vụ.

string

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

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ảng không quảng cáo của đối tác với những người bán đã có mặt trên Google Maps. Thông tin này sẽ không xuất hiện.

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

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 công cụ 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 theo điểm cơ bản (một phần trăm của một phần trăm). Ví dụ: Nếu thuế suất là 7,5% thì bạn phải đặt trường này là 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ẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được coi là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt.

Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, tổng giá tính cho người dùng cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được đánh giá theo thuế suất được cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phần thập phân 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 dùng nữa, vui lòng sử dụng tax_rate để thay thế.

TaxRate

Thuế suất của người bán. Nếu có, trường này sẽ ghi đè trường tax_rate_basis_points không còn được dùng nữa. Một thông báo trống (ví dụ: tax_rate { }) sẽ đặt lại thuế suất được áp dụng về 0.

PaymentRestrictions

Các quy định hạn chế đối với phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định rằng không có quy định hạn chế nào nếu bạn không thiết lập trường này.

PaymentOption

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

PaymentProcessorConfig

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

TokenizationConfig

Cấu hình cho 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 đó.

Terms

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

string

Một chuỗi mờ xác định thương hiệu dành cho người tiêu dùng để sử dụng khi hiển thị mô hình 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 hướng đến người tiêu dùng cung cấp người bán của tất cả các thương hiệu trong cùng một nguồn cấp dữ liệu.

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

Nếu chỉ có một thương hiệu đối tác tiếp xúc với người tiêu dùng, thì bạn không cần đặt trường này 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 đến người tiêu dùng? --> Bỏ qua trường này

Có nhiều thương hiệu được thiết lập 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 phải đặ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ụ dùng để mô tả Dịch vụ của Người bán này. (không bắt buộc)

ActionLink

Không bắt buộc. URL hành động có ngôn ngữ liên kết, 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 hành động này sẽ được thực hiện trên nền tảng nào,

Advisement

Không bắt buộc. Thông báo 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 thông báo phải có độ dài giới hạn là 100 byte.

EconomicOperator

Không bắt buộc. Thông tin của Nhà điều hành kinh tế liên kết với người bán cụ thể này 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 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 đị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 quy trình đặt phòng toàn diện.

WaitlistStatus

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

PlaceInfo

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

LocalServicesMatchInfo

Thông tin dịch vụ địa phương trùng khớ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ụ địa phương hoặc không khớp với nhà cung cấp nào.

DirectUrl

Danh sách URL minh hoạ nội dung của khoảng không quảng cáo 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 mà bạn nhìn thấy.

bool

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

UrlType

Loại của URL này.

string

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

MatchedProvider

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

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ụ vệ sinh thảm".

string

Tên đị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ể được dùng để tạo URL trên Google Maps hoặc tìm nạp thêm thông tin về địa điểm. Hãy 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 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ể phải trả nếu họ không xuất hiện trong giao dịch đặt chỗ.

PriceType

Xác định cách xác định phí từ 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 món.

PaymentInformation

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

string

Mã của người bán chứa tất cả dịch vụ trong đơn đặt hàng này.

LineItem

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

FulfillmentOption

Các lựa chọn thực hiện hiện có cho đường liên kết đến 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 payments_status là PREPAYMENT_PROVIDED hoặc PREPAYMENT_REFUNDED, thì payment_transaction_id sẽ chứa mã giao dịch duy nhất có liên quan.

string

Giá trị nhận dạng duy nhất của một giao dịch thanh toán được liên kết với yêu cầu đặt phòng. Để trống nếu không áp dụng.

string

Mã này được dùng để xác định lựa chọn thanh toán này.

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

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

string

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

string

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

Price

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

TaxRate

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

PaymentOptionType

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

int64

Số phiên có thể sử dụng phương thức thanh toán này. Chỉ hợp lệ cho nhiều phiên hoạt động / gói, trong đó giá trị phải > 1.

TimeRange

Bạn có thể mua phương thức thanh toán này trong khoảng thời gian này.

TimeRange

Bạn có thể sử dụng phương thức thanh toán này trong khoảng thời gian này (ví dụ: giá ưu đãi cho tháng 1 năm 2017). Nếu có, thuộc tính 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 cho phương thức thanh toán này.

UserPurchaseRestriction

Giới hạn những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để 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 giá trị này, tất cả người dùng đều đủ điều kiện.

Processor

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

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

CreditCardRestrictions

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

Price

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

Price

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

Price

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

Price

Phí dành cho địa điểm/cơ sở vật chất.

Price

Thuế theo vé.

string

Quốc gia, được chỉ định bằng mã quốc gia theo ISO 3166-1 alpha-2, ví dụ: "Hoa Kỳ" (bắt buộc)

string

Địa phương, ví dụ: "Đà Nẵng". (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 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 của đơn vị tiền tệ nhỏ nhất sẽ được làm tròn bằng cách làm tròn số chẵn gần nhất. (Ví dụ: Đối với 2,5 xu làm tròn thành 2 xu, 3,5 xu làm tròn thành 4 xu, 0,5 xu làm tròn thành 0 xu, 2,51 xu làm tròn thành 3 xu).

string

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

string

Chuỗi không bắt buộc và mờ xác định lựa chọn về 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 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 phí.

Price

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

Price

Số tiền tối đa. Phải luôn là > giá_tối_minh.

double

Một giá trị riêng. Ví dụ: 5,6

RangeValue

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

double

Giá trị nhỏ nhất.

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ị này phải nằm trong phạm vi [1, 5] và có thể được bỏ qua nếu và chỉ khi số_điểm_đánh_giá bằng 0.

uint64

Số 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 của nguồn nội dung nghe nhìn này.

Text

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

Attribution

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 bắt buộc phải hiển thị thông tin ghi công cùng với nội dung nghe nhìn để ghi công 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 được dùng nữa, ưu tiên sử dụng local_caption.

Text

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

string

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

ServiceAvailability

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

string

Giấy tờ tuỳ thân 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 hàng. Giá phòng cũng cần phải ổn định theo thời gian để có thể tương quan với các lượt đặt phòng trước đây. Bạn phải có trường này nếu có Staff_name.

string

Tên không bắt buộc của nhân viên cung cấp dịch vụ. Trường này sẽ hiển thị cho người dùng đặt phòng và phải có thể đọc được, chứ không phải giá trị nhận dạng không rõ ràng. Phải có trường này nếu có Staff_id.

string

Mã nhận dạng 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 phòng. Số liệu này cũng cần phải ổn định theo thời gian để cho phép mối tương quan với các lượt đặt phòng trước đây. Trường này phải có nếu có room_name.

string

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

int32

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

Text

Không bắt buộc. Nội dung mô tả phòng đã bản địa hoá. Nếu đặt giá trị này, 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 thông báo trước tối thiểu (tính bằng giây) cần thiết để huỷ một cuộc hẹn đã đặt trước trên mạng. (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í không xuất hiện mà không huỷ.

AdmissionPolicy

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

CancellationPolicy

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

int64

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ờ nhận phòng bắt đầu.

int64

Thời lượng (tính bằng giây) từ thời điểm có thể thực hiện lượt đặt phòng gần đây nhất đến khi kết thúc khung giờ có phò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 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 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ả về dịch vụ mà người dùng nhìn thấy.

Trường này hỗ trợ cả định dạng văn bản thuần tuý và văn bản giống HTML. Không giống như 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 tạo ra trải nghiệm tốt nhất cho người dùng.

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

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

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

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

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

Thẻ cụm từ: <br>, <strong>, <em>:
Chỉ hỗ trợ 3 thẻ nêu trên. Bạn có thể sử dụng <br> để ngắt dòng trong các đoạn văn bản và sử 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 sẽ bị bỏ qua.

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

• <html>, <header> và <body> thẻ không được phép.
• Mọi thẻ khác không được đề cập ở trên đều không được hỗ trợ (ví dụ: <table>, <td> ...).
  Mọi URL, 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 của ảnh.
  

Lưu ý quan trọng:

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

Price

Giá của dịch vụ.

PriceInterpretation

Mô tả cách diễn giải và hiển thị giá cho người dùng. Có thể cho bất kỳ ngành dọc nào, ngoại trừ Địa điểm ăn tối và Điểm tham quan, để thiết lập hiển thị giá dịch vụ.

SchedulingRules

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

PrepaymentType

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

PrepaymentTerms

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

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

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

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. Thông báo trống (tức là tax_rate { }) sẽ đặt lại mức thuế đã áp dụng về 0.

string

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

NoShowFee

Xác định phí vắng mặt mà người dùng có thể phải trả. Ghi đè phí dịch vụ không đến nếu bạn đã chỉ định phí này. 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 đến dự ở 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

Một đường liên kết hành động liên quan đến dịch vụ này. Nếu liên kết hành động tồn tại, loại (xem bên dưới) phải được đặt trong Dịch vụ.

ServiceType

Loại đượ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 trước/mua cho dịch vụ này, nếu vé được hỗ trợ. (không bắt buộc)

RelatedMedia

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

ServiceAttributeValueId

Các giá trị thuộc tính dịch vụ áp dụng cho dịch vụ này (không bắt buộc). Mỗi Dịch vụ có thể không có hoặc có nhiều giá trị cho từng thuộc tính dịch vụ được xác định trong Người bán tương ứng. (không bắt buộc)

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 liên quan đến việc tích hợp ban đầu. Đối với những đối tác này, tính năng bảo mật toàn diện sẽ luôn bị tắt.

PerOrderFee

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

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

VirtualSession

Không bắt buộc. Thông tin về phiên ảo. Bạn cần bật tính năng này để 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. Thuộc tính này là bắt buộc nếu bạn xác định virtual_session và dịch vụ không miễn phí hoặc prepayment_type KHÔNG được đặt 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 tạo URL đến trang web bên ngoài.

ChargeTiming

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

int64

Khoảng 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í. Bạn chỉ được đặt trường này khi ChargeTiming là CHARGE_LATER.

string

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

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ả 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ố các giá trị khác cho thuộc tính dịch vụ này, ví dụ: "cá nhân".

string

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

string

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

string

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

string

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

Timestamp

Nếu bạn cung cấp, chúng tôi sẽ xem xét các thực thể về tình trạng còn hàng là bản tổng quan đầ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 này sẽ bị hạn chế thêm:

  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 chỗ trong một phạm vi thời gian nhất định.

Việc đặt start_time_restrict trong khi không đặt end_time_restrict sẽ được hiểu 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_Limit sẽ có nghĩa là thời gian tồn tại đến hết thời gian end_time_Limit sẽ là tối đa.

Duration

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

Resources

Việc đặt resources_restrict sẽ hạn chế thêm phạm vi của bản cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác.

Availability

Danh sách lịch phát sóng mới.

ServiceIntakeFormField

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

bool

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

bool

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

string

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

FieldType

Loại trường này.

string

Văn bản hiển thị cho người dùng cho trường này. Không còn được 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. Có thể cung cấp trường này bằng nhiều ngôn ngữ. (bắt buộc)

string

Chỉ đặt khi 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

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

bool

Cho biết 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 bạn có được phép thêm giá trị tuỳ chỉnh ngoài các câu trả lời đượ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)

Text

Các tuỳ chọn khác được cung cấp ngoài các giá trị được cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: ngoài danh sách vị trí được cung cấp, bạn có thể thêm lựa 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é, thì bạn nên đặt trường này làm tập hợp mã loại vé áp dụng. Để trống trường này nếu câu hỏi luôn phù hợp.

Text

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

int32

Thuế suất tính theo phần triệu phần trăm, cho độ chính xác hiệu quả là 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 trường này hoặc đặt thành 0, thì tổng giá tính cho người dùng của mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được coi là được miễn hoặc đã bao gồm các khoản thuế hiện hành. 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, tổng giá tính cho người dùng cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được đánh giá theo thuế suất được cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phần thập phân 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 hàng riêng biệt.

string

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

Text

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

LocalizedString

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

string

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

string

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

Người dùng có thể nhìn thấy thông tin này, ví dụ: "người lớn", "trẻ em", "người đã nghỉ hưu", "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. 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", "người đã nghỉ hưu", "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é loại này, không bao gồm thuế. Thuế suất của Dịch vụ sẽ được áp dụng cho vé của dịch vụ đó.

PerTicketFee

Có phụ phí 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ả bất kỳ lựa chọn bổ sung nào đại diện cho loại vé này (nếu có). Không dùng nữa, hãy sử dụng localized_option_description.

Text

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

Các tuỳ 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ổng có nhiều loại "người lớn", "trẻ em" và ngôn ngữ là một tuỳ 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ụ thuê thuyền kayak nhiều giờ với 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 phiếu yêu cầu hỗ trợ nào trong dịch vụ có nhóm trường này, thì chúng tôi dự kiến tất cả các loại phiếu yêu cầu hỗ trợ khác cũng đặt trường này (có thể sử dụng tùy chọn mô tả mặc định). Ví dụ: [{ticket_type_1, lớn, tiếng Anh}, {ticket_type_1, người lớn, ''}] không phải là danh sách hợp lệ.

Chỉ hỗ trợ hai thẻ định dạng HTML: và
. Bạn nên sử dụng các thuộc tính này để chỉ định các lựa chọn có cả tiêu đề và nội dung mô tả chi tiết, ví dụ: "Premium Seating
Lựa chọn này cung cấp chỗ ngồi tại các phòng riêng bao gồm ghế ngồi có đệm đầy đủ, TV riêng, dịch vụ đồ ăn và đồ uống tại chỗ. Những chỗ ngồi này có tầm nhìn đẹp mắt 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é 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 sự kiện tham dự.

string

Không bắt buộc. URL để 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 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 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)

string

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

string

URL của trang web mô tả rõ ràng về thực thể. Đây là trang web trên trang web của đối tác cho pháp nhân (nếu có); đối với các URL công khai khác của pháp nhân, 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 chiếu 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 bất kỳ trang web nào chỉ dành riêng cho chủ đề đó. Những trang web này có thể bao gồm trang web chính thức, trang discogs, trang mạng xã hội, trang wikipedia hoặc trang 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)

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)

Timestamp

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

Timestamp

Giới hạn trên của khoảng 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à có giá trị là tên của đơn vị xử lý.

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

Ví dụ về Braintree: tokenization_parameter { key: "gateway" 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ụ của Adyen: tokenization_parameter { key: "gateway" giá trị: "adyen" } tokenization_parameter { key: &quot;gatewayMerchantId&quot; giá trị: "yourId" }

BillingInformationFormat

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