REST Resource: inventory.partners.merchants.services

Tài nguyên: Dịch vụ

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

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  }
}
Trường
name

string

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

string

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

object (Text)

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

string

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

object (Text)

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

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

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

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

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

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

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

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

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

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

Lưu ý quan trọng:

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

object (Price)

Giá của dịch vụ.
priceInterpretation

enum (PriceInterpretation)

Mô tả cách giá được diễn giải và hiển thị cho người dùng. Có thể cho mọi ngành dọc (trừ Dịch vụ ăn uống và Điểm tham quan) để thiết lập cách hiển thị giá dịch vụ.
rules

object (SchedulingRules)

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

enum (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

object (PrepaymentTerms)

Các điều khoản xoay quanh thời điểm hoàn tất khoản thanh toán trước.
form[]
(deprecated)

object (ServiceIntakeForm)

Không dùng nữa. Vui lòng sử dụng intakeForm và per TicketIntakeForm.
intakeForm

object (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)
perTicketIntakeForm

object (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

object (TaxRate)

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

string

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

object (Deposit)

Xác định cách một khoản tiền gửi có thể được tính cho người dùng. Ghi đè khoản tiền gửi dịch vụ nếu đã được chỉ định. Việc đặt chính sách này thành thông báo Khoản tiền gửi trống sẽ xóa mọi khoản tiền gửi ở cấp dịch vụ. (không bắt buộc)
noShowFee

object (NoShowFee)

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

enum (RequireCreditCard)

Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt dịch vụ này hay không. Bạn có thể ghi đè trường này ở cấp tình trạng còn hàng. (không bắt buộc)
type

enum (ServiceType)

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

object (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[]

object (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[]

object (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

object (WaitlistRules)

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

object (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

enum (IntegrationType)

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

object (PerOrderFee)

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

object (ToursAndActivitiesContent)

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

object (Location)

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

object (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

object (HomeServiceData)

Thông tin bổ sung dành riêng cho ngành dọc dịch vụ gia đình. (không bắt buộc)
virtualSession

object (VirtualSession)

Không bắt buộc. Thông tin về phiên ảo. Bạn phải bật các dịch vụ ảo.
directMerchantPayment

object (DirectMerchantPayment)

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

PriceInterpretation

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

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

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

Ví dụ: 20 USD cho một lớp học yoga; 15 USD cho cắt tóc trẻ em
STARTS_AT

Khi giá của một dịch vụ có thể thay đổi nhưng người tiêu dùng sẽ nắm rõ và cho biết mức giá tối thiểu. Người tiêu dùng có thể lựa chọn việc tăng giá.

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

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

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

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

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

SchedulingRules

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

Biểu diễn dưới dạng JSON 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Trường
minAdvanceOnlineCanceling

string (int64 format)

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

object (Price)

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

object (Price)

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

enum (AdmissionPolicy)

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

object (CancellationPolicy)

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

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

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

Ví dụ:

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

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

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

string (int64 format)

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

string (int64 format)

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

AdmissionPolicy

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

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

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

Ví dụ về các trường hợp sử dụngTIME_FLEXIBLE: * Vé vào bảo tàng có thể được sử dụng vào bất kỳ thời điểm nào trong ngày mua. * Vé vào cửa công viên giải trí vào buổi chiều từ 12 giờ trưa đến 9 giờ tối.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

Ví dụ: trong tình huống vào cửa bảo tàng, vé vào cửa theo thời gian 10 giờ sáng yêu cầu người dùng phải có mặt tại bảo tàng lúc 10 giờ sáng. Thời gian bắt đầu của các khung giờ trống của dịch vụ này thể hiện thời gian vào cửa đã chỉ định. Tuy nhiên, thời gian kết thúc chỉ được dùng làm khoá để xác định khung giờ còn trống để đặt phòng.

CancellationPolicy

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

Biểu diễn dưới dạng JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
Trường
refundCondition[]

object (RefundCondition)

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

RefundCondition

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

Biểu diễn dưới dạng JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Trường
minDurationBeforeStartTime

string (Duration format)

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

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".
refundPercent

integer (uint32 format)

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

PrepaymentType

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

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

PrepaymentTerms

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

Biểu diễn dưới dạng JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Trường
chargeTiming

enum (ChargeTiming)

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

string (int64 format)

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

ChargeTiming

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

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

ServiceIntakeForm

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

Biểu diễn dưới dạng JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Trường
field[]

object (ServiceIntakeFormField)

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

boolean

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.
returningCustomers
(deprecated)

boolean

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

ServiceIntakeFormField

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

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Trường
id

string

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

enum (FieldType)

Loại trường này.
label

string

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

object (Text)

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

string

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

object (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ó.
isRequired

boolean

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

boolean

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

object (Text)

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

string

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

object (Text)

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

FieldType

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

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

ServiceType

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

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

TicketType

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

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

Biểu diễn dưới dạng JSON 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
Trường
ticketTypeId

string

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

string

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

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

object (Text)

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

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

object (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

object (PerTicketFee)

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

string

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

object (Text)

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

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

Ví dụ 1: vé vào cửa có các loại "người lớn", "trẻ em" và ngôn ngữ làm lựa chọn bổ sung, danh sách TicketType dự kiến sẽ là: - { TicketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" (người lớn) } nativeOptionDescription { giá trị: "tiếng anh" } } – { TicketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" (người lớn) } localOptionDescription { value: "spanish" } } – { TicketTypeId: "ticket_type_3" localizedShortDescription { giá trị: "child" } nativeOptionDescription { giá trị: "tiếng anh" } } – { TicketTypeId: "ticket_type_4" localizedShortDescription { giá trị: "child" } localOptionDescription { value: "spanish" }

Ví dụ 2: dịch vụ thuê thuyền kayak nhiều giờ có tiện ích bổ sung túi khô (không bắt buộc), đoạn mô tả ngắn có thể là "3 giờ" và optionsDescription có thể là "có túi khô" hoặc "không có túi khô": – { TicketTypeId: "ticket_type_1" localShortDescription { value: "2 giờ" } nativeOptionDescription { giá trị: "tiếng anh" } } – { TicketTypeId: "ticket_type_2" localShortDescription { value: "2 giờ" } localOptionDescription { value: "spanish" } } – { TicketTypeId: "ticket_type_3" localizedShortDescription { value: "3 giờ" } nativeOptionDescription { giá trị: "tiếng anh" } } – { TicketTypeId: "ticket_type_4" localizedShortDescription { value: "3 giờ" } localOptionDescription { 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 cũng đặt trường này cho tất cả các loại phiếu yêu cầu hỗ trợ khác (có thể sử dụng tùy chọn mặc định OptionDescription). Ví dụ: [{ticket_type_1, lớn, tiếng Anh}, {ticket_type_1, người lớn, ''}] không phải là danh sách hợp lệ.

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

PerTicketFee

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

Biểu diễn dưới dạng JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Trường
serviceCharge

object (Price)

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

object (Price)

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

object (Price)

Thuế theo vé.

RelatedMedia

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

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Trường
url

string

URL của nguồn nội dung nghe nhìn này. Google sẽ thu thập dữ liệu nội dung nghe nhìn lưu trữ tại URL này.
type

enum (MediaType)

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

object (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

object (Attribution)

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

string

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

MediaType

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

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

Phân bổ

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

Biểu diễn dưới dạng JSON 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
Trường
localizedText

object (Text)

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

string

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

ServiceAttributeValueId

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

Biểu diễn dưới dạng JSON 
{
  "attributeId": string,
  "valueId": string
}
Trường
attributeId

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

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 valueId trong định nghĩa thuộc tính dịch vụ.

WaitlistRules

Các quy tắc liên quan đến việc tham gia danh sách chờ.

Biểu diễn dưới dạng JSON 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Trường
minPartySize

integer

Bắt buộc. Phải là một số nguyên dương đối với những dịch vụ cung cấp chức năng danh sách chờ. Nếu dịch vụ hoặc người bán không cung cấp chức năng danh sách chờ, bạn không được điền thông tin này.
maxPartySize

integer

Bắt buộc. Phải là một số nguyên dương đối với những dịch vụ cung cấp chức năng danh sách chờ. Nếu dịch vụ hoặc người bán không cung cấp chức năng danh sách chờ, bạn không được điền thông tin này.
supportsAdditionalRequest

boolean

Nếu đúng, người dùng sẽ có thể gửi yêu cầu bổ sung bằng văn bản tuỳ ý khi tham gia danh sách chờ của dịch vụ này.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

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

Biểu diễn dưới dạng JSON 
{
  "callMerchant": {
    object (CallMerchant)
  }
}
Trường
callMerchant

object (CallMerchant)

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

CallMerchant

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

TicketingVerticalSpecificData

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

Biểu diễn dưới dạng JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState)
}
Trường
eventCategory

enum (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)
eventUrl

string

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

object (Entity)

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

enum (AttendanceMode)

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

string

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

object (Text)

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

string

Không bắt buộc. URL của đơn vị tổ chức sự kiện.
eventOrganizerType

enum (OrganizerType)

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

string

Bắt buộc. URL của những trang có thể tìm thấy thông tin hoặc nội dung mô tả về sự kiện.
eventState

enum (EventState)

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

EventCategory

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

Enum
EVENT_CATEGORY_UNSPECIFIED Chưa chỉ định. Không được dùng.
EVENT_CATEGORY_CONCERT Sự kiện âm nhạc.
EVENT_CATEGORY_SPORTS Sự kiện thể thao.
EVENT_CATEGORY_THEATRE Sự kiện tại nhà hát.
EVENT_CATEGORY_EXHIBITS Vật trưng bày.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Hội thảo và lớp học.

Thực thể

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

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Trường
id

string

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

string

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

string

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

enum (EntityType)

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

enum (EntityRole)

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

object (PublicIdentificationData)

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

EntityType

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

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

EntityRole

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

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

PublicIdentificationData

Giá trị nhận dạng, trang web hoặc bất kỳ nguồn công khai nào khác tham chiếu đến một pháp nhân.

Biểu diễn dưới dạng JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
Trường
relevantUrl[]

string

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

string

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

AttendanceMode

Loại hình sẽ tham dự sự kiện.

Enum
ATTENDANCE_MODE_UNSPECIFIED Chưa chỉ định.
ONLINE Đối với sự kiện trực tuyến.
PHYSICAL Đối với các sự kiện thực tế.
PHYSICAL_ONLINE_MIXED Dành cho những sự kiện diễn ra cả thực và ảo.

OrganizerType

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

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

EventState

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

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

IntegrationType

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

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

PerOrderFee

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

Biểu diễn dưới dạng JSON 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Trường
deliveryFee

object (Price)

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

object (Price)

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

ToursAndActivitiesContent

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

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

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

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

Lưu ý quan trọng: * Không sao chép dữ liệu đã được cung cấp trong highlights, exclusion và các trường khác cụ thể hơn trong phần mô tả dịch vụ. * Tránh sử dụng các thẻ khác ngoại trừ các thẻ được hỗ trợ nêu trên, vì nội dung trong các thẻ không được hỗ trợ sẽ bị xoá và có thể gây ra trải nghiệm không mong muốn cho người dùng.

Biểu diễn dưới dạng JSON 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Trường
highlights[]

object (Text)

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

object (Text)

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

object (Text)

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

object (Text)

Danh sách các ghi chú quan trọng mà người dùng nhìn thấy. Bạn có thể sử dụng danh sách này để cung cấp thông tin chi tiết như giới hạn về độ tuổi hoặc các điều kiện khác khiến dịch vụ này không phù hợp.

Vị trí

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

Biểu diễn dưới dạng JSON 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Trường
placeId

string

Mã địa điểm của một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem https://developers.google.com/places/web-service/place-id để biết thêm về mã địa điểm. Nếu bạn cung cấp thông tin này, Google sẽ so khớp vị trí với địa điểm này.
name

string

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

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

string

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

string

Url trang web công khai của địa điểm. (không bắt buộc)
geo

object (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

enum (LocationType)

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

string

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

LocationType

Loại vị trí này.

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

Rating

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

Biểu diễn dưới dạng JSON 
{
  "value": number,
  "numberOfRatings": string
}
Trường
value

number

Giá trị xếp hạng trung bình (bắt buộc khi numberOfRating > 0). Giá trị phải nằm trong phạm vi [1, 5] và có thể bỏ qua khi và chỉ khi numberOf gán giá trị bằng 0.
numberOfRatings

string

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

HomeServiceData

Bạn phải cung cấp thêm thông tin cho ngành dọc dịch vụ gia đình.

Biểu diễn dưới dạng JSON 
{
  "categoryType": string,
  "jobType": string
}
Trường
categoryType

string

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

string

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

VirtualSession

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

Biểu diễn dưới dạng JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Trường
sessionInstructions

object (Text)

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

object (Text)

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

object (VirtualPlatformInfo)

Thông tin về nền tảng ảo được sử dụng trong buổi chia sẻ này. (Bắt buộc để bật dịch vụ ảo)
isSessionPrerecorded

boolean

Bắt buộc. Đặt giá trị này thành true nếu phiên trực tuyến không trực tiếp và được ghi hình trước.

VirtualPlatformInfo

Thông tin về nền tảng sẽ được dùng cho phiên ảo này.

Biểu diễn dưới dạng JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Trường
platform

enum (Platform)

Nền tảng được dùng cho phiên ảo.
otherPlatformName

object (Text)

Tên của nền tảng nếu nền tảng được đặt thành OTHER. (Bắt buộc nếu nền tảng được đặt thành OTHER)

Nền tảng

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

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

DirectMerchantPayment

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

Biểu diễn dưới dạng JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Trường
paymentMethods[]

object (Text)

Người dùng chỉ nên thanh toán qua những phương thức thanh toán nêu dưới đây.

Phương thức

create

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

delete

 Xoá Service hiện có của người bán do đơn vị tập hợp đã chỉ định quản lý.

patch

 Cập nhật Service hiện có của người bán do đơn vị tập hợp đã chỉ định quản lý rồi trả lại hàng đó.