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ụ như 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)
  }
}
Các 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, 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ố khu vực.
description

string

Nội dung mô tả dịch vụ mà người dùng nhìn thấy. Ngừng sử dụng, chuyển sang sử dụng localeDescription.
localizedDescription

object (Text)

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

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

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

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

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

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

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

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

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

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

Lưu ý quan trọng:

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

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ể được sử dụng trong mọi ngành dọc, ngoại trừ Hoạt động ăn uống và Điểm tham quan để thiết lập cách trình bày giá dịch vụ.
rules

object (SchedulingRules)

Quy tắc đặt trước/huỷ cuộc hẹn.
prepaymentType

enum (PrepaymentType)

Liệu thanh toán trước là bắt buộc, tuỳ chọn hay không được hỗ trợ.
prepaymentTerms

object (PrepaymentTerms)

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

object (ServiceIntakeForm)

Không dùng nữa. Vui lòng sử dụng intakeForm và perticketIntakeForm.
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 trước 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 trước dịch vụ này. Người dùng phải điền vào biểu mẫu này một lần cho mỗi vé mà họ đặt. (không bắt buộc)
taxRate

object (TaxRate)

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

string

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

object (Deposit)

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

object (NoShowFee)

Loại này xác định phí vắng mặt có thể được tính cho người dùng. Ghi đè phí dịch vụ không xuất hiện nếu bạn đã chỉ định phí xuất hiện. Nếu bạn đặt thông báo này thành thông báo NoShowFee trống, thì mọi khoản phí không tham gia ở cấp dịch vụ sẽ bị xoá. (không bắt buộc)
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 độ khả dụ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/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 dữ liệu và lưu trữ nội dung nghe nhìn để đảm bảo người dùng cuối thấy những nội dung đó theo cách hiệu quả nhất. (không bắt buộc)
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 mỗi thuộc tính dịch vụ được xác định trong Người bán tương ứng. (không bắt buộc)
waitlistRules

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)

Chiều sâu tích hợp mà chúng tôi hỗ trợ cho dịch vụ này. (không bắt buộc) Không liên quan đến những đối tác sử dụng chức năng tích hợp ban đầu. Tính năng này sẽ luôn tắt từ đầu đến cuối đối với những đối tác này.
perOrderFee

object (PerOrderFee)

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

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

object (Rating)

Điểm xếp hạng của người dùng đối với dịch vụ này dưới dạng một chỉ số tổng hợp trên tất cả các bài đánh giá.
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. Cần có để 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 bổ sung nếu dịch vụ yêu cầu người dùng thanh toán trực tiếp cho người bán. LƯU Ý QUAN TRỌNG: RwG sẽ không tham gia vào giao dịch này. Đây là yêu cầu bắt buộc nếu VirtualSession được xác định và dịch vụ không miễn phí 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 phần diễn giải giá, mặc định là EXACT_AMOUNT.
EXACT_AMOUNT

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

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

Khi giá của một dịch vụ có thể thay đổi nhưng giá tối thiểu được xác định và hiển thị cho người tiêu dùng. Người tiêu dùng có thể đưa ra lựa chọn làm tăng giá sản phẩm.

Xin lưu ý rằng mọi dịch vụ sử dụng Thông tin diễn giải giá này đều phải sử dụng tính năng PrepaymentType NOT_ trùng.

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

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

Xin lưu ý rằng bất kỳ dịch vụ nào sử dụng Thông tin diễn giải giá này đều phải sử dụng loại thanh toán trước NOT_PLURAL và Giá phải để trống.

Ví dụ: Tư vấn về dịch vụ gia đình

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.
}
Các trường
minAdvanceOnlineCanceling

string (int64 format)

Thời gian thông báo trước tối thiểu tính bằng giây phải có để huỷ cuộc hẹn đã đặt trước qua mạng. (không bắt buộc)
lateCancellationFee
(deprecated)

object (Price)

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

object (Price)

Phí không đế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, thì chế độ 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ập lịch. (bắt buộc đối với Điểm tham quan)

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

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

Ví dụ:

  • Việc cắt tóc cần được đặt ít nhất 1 giờ trước thời gian bắt đầu. 'scheduling_rules{ min_advance_booking: 3600 ...}`

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

  • Vé xem phim cần phải được mua trước thời gian bắt đầu. 'schedule_rules{ ...}' (để trống trường này) (không bắt buộc) min_booking_buffer chỉ có thể là một trong những trạng thái sau:
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 phòng 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 đến khi thời gian còn phòng kết thúc. Nếu đặt trường này, thì bạn phải đặt trường "admissionPolicy" 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 nhập học của dịch vụ này.

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

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

Ví dụ về các trường hợp sử dụng có thể sử dụng với hàm TIME_FLEXIBLE: * Có thể sử dụng vé tham quan bảo tàng bất cứ lúc nào vào ngày mua. * Vé vào cửa công viên giải trí buổi chiều, có thể sử dụng từ 12:00 đến 21:00.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Khách hàng cần phải đến người bán vào thời điểm bắt đầu khung tình trạng còn hàng nhưng có thể rời khỏi danh sách bất cứ lúc nào họ muốn.

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

CancellationPolicy

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

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

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

string (Duration format)

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

PrepaymentType

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

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

PrepaymentTerms

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

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

enum (ChargeTiming)

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

string (int64 format)

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

ChargeTiming

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

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

ServiceIntakeForm

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

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

object (ServiceIntakeFormField)

Các trường mà người dùng sẽ thấy.
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 tiên. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu nhập thông tin.
returningCustomers
(deprecated)

boolean

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

ServiceIntakeFormField

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

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)
  }
}
Các trường
id

string

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

enum (FieldType)

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

string

Văn bản mà người dùng nhìn thấy trong trường này. Không dùng nữa, vui lòng sử dụng localizedLabel.
localizedLabel

object (Text)

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

string

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

object (Text)

Chỉ thiết lập khi loại trường là MULTIPLE_CHOICE, bắnBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể có.
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 cho phép trong các câu trả lời bổ sung được xác định trước hay không. Điều này chỉ áp dụng khi loại trường là LOCATION_SEARCH. (không bắt buộc)
additionalOption[]

object (Text)

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

string

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

object (Text)

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

FieldType

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

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

ServiceType

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

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

TicketType

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

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

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)
  }
}
Các 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ỉ 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", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Ngừng sử dụng, chuyển sang sử dụng localeShortDescription.
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", "veteran", "Row J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả để người dùng nhìn thấy được. Bạn có thể cung cấp các giá trị riêng biệt cho từng ngôn ngữ.
price

object (Price)

Giá của một vé thuộc loại này, không bao gồm bất kỳ khoản thuế nào. Thuế suất của Dịch vụ được áp dụng cho vé của dịch vụ đó.
perTicketFee

object (PerTicketFee)

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

string

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

object (Text)

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

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

Ví dụ 1: "Option_vét

Ví dụ 2: {Option_Option_

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

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

PerTicketFee

Phí phải trả 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)
  }
}
Các trường
serviceCharge

object (Price)

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

object (Price)

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

object (Price)

Thuế mỗi vé.

RelatedMedia

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

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

string

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

enum (MediaType)

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

object (Text)

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

object (Attribution)

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

string

Không dùng nữa, hãy sử dụng bản địa hoá Caption.

MediaType

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

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

Phân bổ

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

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

object (Text)

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

string

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

ServiceAttributeValueId

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

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

string

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

string

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

WaitlistRules

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)
    }
  ]
}
Các trường
minPartySize

integer

Bắt buộc. Phải là số nguyên dương đối với các 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ờ thì không được điền thông tin này.
maxPartySize

integer

Bắt buộc. Phải là số nguyên dương đối với các 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ờ thì 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 dạng văn bản bổ sung tuỳ ý khi tham gia danh sách chờ sử dụng dịch vụ này.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

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

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)
  }
}
Các trường
callMerchant

object (CallMerchant)

Quy mô bữa tiệc nằm ngoài phạm vi của bữa tiệc có thể gọi cho doanh nghiệp. Một thông báo xác định trước sẽ hiển thị cho người dùng. Văn bản mẫu sẽ hiển thị: "Đối với các bữa tiệc có nhiều 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 giá trị này sẽ trống.

CallMerchant

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

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)
}
Các trường
eventCategory

enum (EventCategory)

Danh mục của sự kiện. Chỉ thiết lập khi sự kiện thuộc một trong các danh mục được xác định trước. (không bắt buộc)
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 thực thể có liên quan đến sự kiện. (không bắt buộc)
eventAttendanceMode

enum (AttendanceMode)

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

string

Không bắt buộc. URL nơi 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 người 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 các trang nơi có 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 danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm sản phẩm. Lưu ý: không phải là một bản thể học phổ biến của sự kiện.

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

Thực thể

Đại diện cho một thực thể có 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)
  }
}
Các trường
id

string

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

string

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

string

URL của trang web mô tả rõ ràng thực thể. Đây là trang trên trang web của đối tác dành cho thực thể (nếu có). Đối với các URL công khai khác của thực thể, hãy sử dụng 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)

Nguồn tham khảo công khai của 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ổ biến.

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

EntityRole

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

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

PublicIdentificationData

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

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

string

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

AttendanceMode

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

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

OrganizerType

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

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

EventState

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

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

IntegrationType

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

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

PerOrderFee

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

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

object (Price)

Phí có thể thay đổi tùy 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 đều 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ợ 3 thẻ nêu trên. Bạn có thể dùng
để ngắt dòng trong đoạn văn và 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ả các thẻ và kiểu tuỳ chỉnh khác không được phép và sẽ bị xoá. Mọi URL, mục liên kết và đường liên kết sẽ bị xoá và sẽ không bao giờ hiển thị với người dùng cuối.

Lưu ý quan trọng: * Đừ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ừ những thẻ được hỗ trợ nêu trên, vì nội dung trong các thẻ không được hỗ trợ sẽ bị loại bỏ và có thể gây ra trải nghiệm không mong muốn cho người dùng.

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

object (Text)

Danh sách các điểm nổi bật mà người dùng thấy được.
inclusions[]

object (Text)

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

object (Text)

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

object (Text)

Danh sách mà người dùng thấy được gồm các lưu ý quan trọng, hãy dùng để biết thông tin chi tiết như giới hạn độ 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
}
Các trường
placeId

string

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

string

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

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

string

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

string

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

object (GeoCoordinates)

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

enum (LocationType)

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

string

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

LocationType

Loại vị trí này.

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

Rating

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

Biểu diễn dưới dạng JSON 
{
  "value": number,
  "numberOfRatings": string
}
Các 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 khoảng [1, 5] và có thể bỏ qua khi và chỉ khi numberOfRating 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

Cần 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
}
Các trường
categoryType

string

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

string

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

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
}
Các trường
sessionInstructions

object (Text)

Hướng dẫn về cách thiết lập lớp học ảo này. Nếu đối tác không cung cấp URL của video trong lượt đặt phòng thì đối tác phải có thông tin về thời điểm chia sẻ URL của video với người dùng. Ví dụ: "URL thu phóng sẽ được gửi qua thư 30 phút trước khi lớp học". (Nên dùng)
sessionRequirements

object (Text)

Các yêu cầu đối với phiên trực tuyến cụ thể. Ví dụ: thảm yoga, dụng cụ nấu ăn, v. v. (Nên dùng)
virtualPlatformInfo

object (VirtualPlatformInfo)

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

boolean

Bắt buộc. Thiết lập là đúng nếu phiên ảo không diễn ra và đã được ghi hình sẵn.

VirtualPlatformInfo

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

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

enum (Platform)

Nền tảng 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 lựa chọn nền tảng video mà mình sử dụng.
GOOGLE_HANGOUTS Sản phẩm Google Hangouts.
GOOGLE_MEET Google Meet.
ZOOM Truyền thông qua Zoom.
SKYPE Super Chat và Super Stickers.
YOUTUBE Phát trực tiếp trên YouTube.
OTHER Bạn nên thiết lập 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ụ qua RwG.

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

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

Phương thức

create

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

delete

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

patch

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