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)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
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 dịch vụ, ví dụ: "Cắt tóc nam". Không dùng nữa, hãy sử dụng localizedServiceName.
localizedServiceName

object (Text)

Tên 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ả dịch vụ mà người dùng nhìn thấy. Không dùng nữa, hãy sử dụng localizedDescription.
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 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>
Bạn có thể dùng thẻ tiêu đề để hiển thị tiêu đề và tiêu đề phụ. Ví dụ: <h1>Lộ 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 này. 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ữ nguyên.

Thẻ đoạn văn: <p>
Bạn có thể dùng thẻ đoạn văn để làm nổi bật nội dung 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: <br>, <strong> và <em>. Vui lòng xem phần thẻ cụm từ bên dưới để biết thêm thông tin chi tiết.

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

Thẻ phân đoạn: <div>
Tất cả thẻ bên trong được hỗ trợ của thẻ <div> sẽ được phân tích cú pháp theo các quy tắc nêu trên, ngụ ý rằng bản thân thẻ <div> không có nghĩa là nhóm hoặc thụt lề ở đâ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.

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

  • Không được phép sử dụng thẻ <html>, <header> và <body>.
  • Mọi thẻ khác không được đề cập ở trên đều không được hỗ trợ (ví dụ: <table>, <td> ...).
    Mọi URL, 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 "relatedMedia" (Nội dung nghe nhìn có liên quan) 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 những thẻ được hỗ trợ nêu trên, vì nội dung trong các thẻ không được hỗ trợ sẽ bị xoá và có thể dẫn đến trải nghiệm không mong muốn cho người dùng.
  • Cố gắng tránh các cấu trúc lồng nhau sâu như hơn 3 cấp tiêu đề khác nhau 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 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.
  • Kích thước tối đa được đề xuất là 32.000 ký tự.
price

object (Price)

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

enum (PriceInterpretation)

Mô tả cách diễn giải và hiển thị giá cho người dùng. Mọi ngành dọc đều có thể sử dụng, ngoại trừ ngành Dùng bữa và Điểm tham quan để định cấu hình chế độ hiển thị giá dịch vụ.
rules

object (SchedulingRules)

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

enum (PrepaymentType)

Liệu việc thanh toán trước có bắt buộc, không bắt buộc hay không được hỗ trợ hay không.
prepaymentTerms

object (PrepaymentTerms)

Các điều khoản liên quan đến 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à 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 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. Bạn phải điền 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 đè mọi taxRate được đặt ở cấp người bán. Thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng về 0.
paymentOptionId[]

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

object (Deposit)

Xác định cách tính phí đặt cọc cho người dùng. Ghi đè khoản tiền đặt cọc dịch vụ nếu có. Việc đặt giá trị này thành một thông báo Gửi tiền trống sẽ xoá 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 khoản phí không đến dự có thể được tính cho người dùng. 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

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/mua cho dịch vụ này (nếu đượ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 nội dung đó hiển thị cho người dùng cuối theo cách hiệu quả nhất. (không bắt buộc)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

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

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é xem sự kiện. (không bắt buộc)
integrationType

enum (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 các đối tác tích hợp trình khởi động. Đố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

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)

Các vị trí 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ụ: – Một chuyến đi 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 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

object (Rating)

Điểm xếp hạng của 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ả bài đánh giá.
homeServiceData

object (HomeServiceData)

Thông tin bổ sung dành riêng cho ngành dịch vụ 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 cần bật tính năng này để 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 tham gia vào giao dịch này. Bạn phải cung cấp thông tin này nếu đã xác định virtualSession và dịch vụ không miễn phí hoặc prepaymentType KHÔNG được đặt thành REQUIRED.
uriTemplate

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

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 chỉ định cách diễn giải giá, mặc định là EXACT_AMOUNT.
EXACT_AMOUNT

Khi giá được diễn giải là một giá trị cụ thể.

Ví dụ: 20 đô la Mỹ cho một lớp học yoga; 15 đô la Mỹ cho một lần cắt tóc cho 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 biết và thấy được giá tối thiểu. Người tiêu dùng có thể đưa ra lựa chọn làm tăng giá.

Xin lưu ý rằng mọi dịch vụ sử dụng PriceInterpretation này đều phải sử dụng PrepaymentType NOT_SUPPORTED.

Ví dụ: 30 đô la cho dịch vụ cắt tỉa lông chó, nhưng các lựa chọn bổ sung 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à không có thông tin về giá được hiển thị trước cho người tiêu dùng.

Xin lưu ý rằng mọi dịch vụ sử dụng PriceInterpretation này đều phải sử dụng PrepaymentType NOT_SUPPORTED và Price phải để trống.

Ví dụ: Tư vấn về dịch vụ tại 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ời gian thông báo trước tối thiểu (tính bằng giây) cần thiết để huỷ cuộc hẹn đã đặt trước trên mạng. (không bắt buộc)
lateCancellationFee
(deprecated)

object (Price)

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

object (Price)

Phí đối với trường hợp khách không đến nhận phòng mà không huỷ.
admissionPolicy

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

object (CancellationPolicy)

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

Trường hợp hợp nhất min_booking_buffer. Thời lượng (tính bằng giây) từ thời điểm có thể đặt phòng gần đây nhất đến thời điểm bắt đầu hoặc kết thúc khung giờ có sẵn.

Nếu bạn đặt "min_advance_booking", thì thời gian đặt trước cuối cùng 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 đặt trước cuối cùng sẽ được tính là (<slot end time> - "min_booking_buffer_before_end_time"). Xin 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, thì người dùng có thể đặt trước khung giờ cho đến thời gian bắt đầu khung giờ. Nếu bạn đặt cả hai trường, thì chỉ một giá trị sẽ đượ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ụ:

  • Dịch vụ cắt tóc cần được đặt trước í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 có thể bán vé cuối cùng 30 phút trước khi đóng cửa: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • Vé xem phim cần được mua trước thời gian bắt đầu. 'scheduling_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 giá trị sau:
minAdvanceBooking

string (int64 format)

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 thời điểm bắt đầu khung giờ có thể đặt phòng.
minBookingBufferBeforeEndTime

string (int64 format)

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ì trường "admissionPolicy" phải được đặt 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 về việc sử dụng 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 đúng thời gian bắt đầu của khung giờ trống và dịch vụ dự kiến sẽ kết thúc đúng thời gian kết thúc của khung giờ trống. Ví dụ về các trường hợp sử dụng TIME_STRICT: * Một 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à trở lại vào khoảng 12 giờ trưa. * Một cuộc hẹn cắt tóc vào lúc 3 giờ chiều thứ Bảy, kéo dài khoảng 30 phút. * Một lớp thể dục từ 6 giờ đế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 bắt đầu và kết thúc của khung giờ trống để sử dụng lượt đặt trước này.

Ví dụ về các trường hợp sử dụng TIME_FLEXIBLE: * Vé bảo tàng có thể sử dụng bất cứ lúc nào vào ngày mua. * Vé vào cổng công viên giải trí vào 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 đến địa điểm của người bán đúng thời gian bắt đầu khung giờ có sẵn nhưng có thể rời đi bất cứ lúc nào họ muốn.

Ví dụ: trong trường hợp mua vé vào bảo tàng, vé vào cửa có giới hạn thời gian lúc 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ờ có sẵn cho dịch vụ này thể hiện thời gian nhập được 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ó sẵn cho lượt đặ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ó điều kiện hoàn tiền áp dụng cho chính sách.

RefundCondition

Xác định một điều kiện hoàn tiền. Bạn có thể sử dụng nhiều điều kiện hoàn tiền 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
}
Trường
minDurationBeforeStartTime

string (Duration format)

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 refundPercent. Khi được đặt thành 0 (mặc định), bạn có thể huỷ dịch vụ bất cứ lúc nào.

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

integer (uint32 format)

Tỷ lệ phần trăm có thể hoàn tiền, miễn là khách huỷ đặt dịch vụ í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 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ẽ được hoàn tiền toàn bộ.

PrepaymentType

Enum để chỉ định loại khoản thanh toán 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_SUPPORTED.
REQUIRED Người dùng phải trả phí dịch vụ này tại thời điểm đặt phòng.
OPTIONAL Người dùng có thể chọn thanh toán trước cho dịch vụ này tại thời điểm đặt phòng hoặc sau đó, nhưng không bắt buộc phải thanh toán trước để đặt phòng.
NOT_SUPPORTED Dịch vụ này không hỗ trợ thanh toán trước.

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 điểm mua.
chargeTimeBeforeStartTimeSec

string (int64 format)

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

ChargeTiming

Enum để chỉ định 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 để 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 là true, khách hàng lần đầu sẽ thấy biểu mẫu này. Không dùng nữa. Chức năng này không được hỗ trợ cho biểu mẫu tiếp nhận.
returningCustomers
(deprecated)

boolean

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 biểu mẫu tiếp nhận.

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)
  }
}
Trường
id

string

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

enum (FieldType)

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

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

object (Text)

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

string

Chỉ đặt nếu 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ỉ đặt nếu loại trường là MULTIPLE_CHOICE, CHECKBOXES hoặc DROPDOWN. Dùng để liệt kê các lựa chọn có thể có.
isRequired

boolean

Cho biết 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 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)
additionalOption[]

object (Text)

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

object (Text)

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

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 văn bản một dòng.
PARAGRAPH Trường nhập văn bản nhiều dòng.
MULTIPLE_CHOICE Một nhóm nút chọn yêu cầu người dùng chọn một trong 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

Các 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 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 các cuộc hẹn hoặc lớp học. Nên dùng cho (1) dịch vụ chăm sóc sức khoẻ và thể chất, (2) dịch vụ spa và làm đẹp, cũng như (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 họp hoàn toàn trực tuyến. Bạn phải đặt giá trị này 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 của 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 giữa các vé có giá và/hoặc tình trạng còn vé khác nhau do các loại người dùng, các thuộc tính dịch vụ hoặc các lựa chọn/phần bổ sung khác nhau.

Vé là đơn vị đặt trước tối thiểu cho một dịch vụ, ví dụ: một chỗ trên chuyến đi bè, vé vào bảo tàng, dịch vụ thuê thuyền kayak đôi 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)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Trường
ticketTypeId

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

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

object (Text)

Nội dung mô tả ngắn về TicketType này với tính năng hỗ trợ i18n.

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. 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, chưa bao gồm thuế. Thuế suất của Dịch vụ được áp dụng cho vé của dịch vụ đó.
perTicketFee

object (PerTicketFee)

Có phụ phí khi mua vé này. (không bắt buộc)
priceDisplayType

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

string

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

object (Text)

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

Các 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à: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

Ví dụ 2: dịch vụ thuê thuyền kayak nhiều giờ với lựa chọn mua thêm túi chống nước (không bắt buộc), shortDescription có thể là "3 giờ" và optionDescription có thể là "có túi chống nước" hoặc "không có túi chống nước": - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { 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ụ đều đặt 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 sẽ đặt trường này (có thể sử dụng optionDescription mặc định). Ví dụ: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] không phải là danh sách hợp lệ.

Chỉ hỗ trợ 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

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

PerTicketFee

Các khoản 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)
  }
}
Trường
serviceCharge

object (Price)

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

object (Price)

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

object (Price)

Thuế trên mỗi vé.

PriceDisplayType

Cho biết định dạng giá xuất hiện trên trang đích.

Trường này sẽ bị bỏ qua đối với khoảng không quảng cáo không liên kết.

Trường này cho phép các nền tảng của Google hiển thị cùng một định dạng giá như được sử dụng trên trang đích của Dịch vụ. Định dạng giá nhất quán giúp cải thiện tỷ lệ chuyển đổi và giảm sự nhầm lẫn.

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Bạn chưa chỉ định loại hiển thị giá. Google sẽ xác định định dạng cần hiển thị.
PRICE_DISPLAY_TYPE_BASE Giá xuất hiện trên trang đích là giá cơ sở.
PRICE_DISPLAY_TYPE_ALL_IN Giá hiển thị trên trang đích bao gồm tất cả các khoản phí và thuế.

InventoryType

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.

Enum
INVENTORY_TYPE_UNSPECIFIED Chưa chỉ định loại khoảng không quảng cáo.
INVENTORY_TYPE_PRIMARY Khoảng không quảng cáo chính.
INVENTORY_TYPE_VERIFIED_RESALE Kho hàng bán lại đã được xác minh.
INVENTORY_TYPE_RESALE Khoảng không quảng cáo bán lại.
INVENTORY_TYPE_AGGREGATOR Khoảng không quảng cáo của trang web tổng hợp.

RelatedMedia

Ảnh liên quan đến dịch vụ này. Google sẽ thu thập thông tin về 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 được lưu trữ tại URL này.
type

enum (MediaType)

Loại nguồn nội dung đa phương tiệ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 ghi công 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)
caption
(deprecated)

string

Đã ngừng hoạt động, hãy ưu tiên sử dụng localizedCaption.

MediaType

Enum để cho biết loại nguồn phương tiện này. Chỉ hỗ trợ ảnh. Vui lòng liên hệ với nhóm Đặt trước với Google nếu bạn cần hỗ trợ về 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 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 công nhiếp ảnh gia hoặc công ty hỗ trợ bản địa hoá. Văn bản này sẽ xuất hiện cùng với nội dung nghe nhìn nguồn. Xin lưu ý rằng trường này chỉ hỗ trợ văn bản thuần tuý, mọi thành phần HTML sẽ bị xoá (không hỗ trợ mô hình phân bổ 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 localizedText.

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
}
Trường
attributeId

string

Mã của một thuộc tính được xác định trong Merchant.service_attribute, ví dụ: "service-type".
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 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à 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ì bạn không được điền trường 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ì bạn không được điền trường này.
supportsAdditionalRequest

boolean

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

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

Các lựa chọn cho các bên nằm ngoài phạm vi.

Biểu diễn dưới dạng JSON 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Trường
Trường hợp hợp nhất kind. Các lựa chọn hiện có cho những bên nằm ngoài phạm vi. kind chỉ có thể là một trong những giá trị sau:
callMerchant

object (CallMerchant)

Những nhóm khách hàng nằm ngoài phạm vi này có thể gọi điện cho doanh nghiệp. Người dùng sẽ thấy một thông báo được xác định trước. Văn bản mẫu sẽ hiển thị: "Đối với những bữa tiệc có hơn {waitlistRules.max_party_size} người tham dự, 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

Loại này không có trường nào.

Thông báo trống sẽ được sử dụng trong UnsupportedPartySizeOption, việc đặt thông báo này sẽ hiển thị cho người dùng một lựa chọn để gọi điện cho doanh nghiệp để đặt phòng.

TicketingVerticalSpecificData

Thông tin bổ sung dành riêng cho ngành dọc bán vé xem 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),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
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 thực thể 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ự.
eventVirtualLocationUrl[]

string

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

object (Text)

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

object (EventCreator)

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

EventCategory

Một tập hợp con của các 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 đồ khái niệm chung về sự kiện.

Enum
EVENT_CATEGORY_UNSPECIFIED Chưa chỉ định. Không được dùng.
EVENT_CATEGORY_CONCERT Buổi hòa nhạc.
EVENT_CATEGORY_SPORTS Sự kiện thể thao.
EVENT_CATEGORY_THEATRE Sự kiện tại rạp 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ể

Biểu thị 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 thực thể đó. Đây là trang web trên trang web của đối tác 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)

Tham chiếu 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 đồ khái niệm phổ quát.

Enum
ENTITY_TYPE_UNSPECIFIED Chưa chỉ định. Không được dùng.
ENTITY_TYPE_PERFORMER Thực thể này đại diện cho nghệ sĩ hoặc nhóm nhạc biểu diễn tại một buổi hòa nhạc hoặc chương trình. Chỉ áp dụng khi danh mục sự kiện là CONCERT (BẢN NHẠC) hoặc THEATRE (NHÀ HÀNG).
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à SPORTS (THỂ THAO).
ENTITY_TYPE_CONCERT_TOUR Thực thể này đại diện cho chuyến tham quan mà sự kiện này thuộc về. Chỉ áp dụng khi danh mục sự kiện là CONCERT (BẢN DIỄN).
ENTITY_TYPE_SPORTS_SERIES Thực thể này đại diện cho một giải đấu thể thao mà sự kiện này thuộc về. Chỉ áp dụng khi danh mục sự kiện là SPORTS (THỂ THAO).
ENTITY_TYPE_PLAY Thực thể này đại diện cho loại vở kịch (ví dụ: nhạc kịch, hài kịch, ba lê, v.v.) được trình diễn tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là RẠP.

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ể này đại diện cho nghệ sĩ chính hoặc nghệ sĩ biểu diễn chính tại sự kiện.
ENTITY_ROLE_SUPPORTER Thực thể này đại diện cho một nghệ sĩ hỗ trợ tại sự kiện.
ENTITY_ROLE_HOME_TEAM Thực thể này đại diện cho đội chủ nhà tại sự kiện (thể thao).
ENTITY_ROLE_AWAY_TEAM Thực thể 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 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 riêng cho chủ đề đó. Các 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)
musicbrainzId

string

Mã 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ự.

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

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à cá nhân.
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 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.

EventCreator

Thông tin về người tạo sự kiện. Chỉ phù hợp với những nền tảng có sự kiện nội dung do người dùng tạo.

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

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

IntegrationType

Độ sâu tích hợp được hỗ trợ.

Enum
INTEGRATION_TYPE_UNSPECIFIED Giá trị mặc định là END_TO_END.
INTEGRATION_TYPE_END_TO_END Quá trình tích hợp hoàn chỉnh cho phép khách hàng đặt phòng toàn bộ 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 trả 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)

Phí có thể thay đổi tuỳ theo phương thức giao hàng.
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 ToursAndActivitiesContent 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 các đoạn văn bản và 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.

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

Lưu ý quan trọng: * Đừng sao chép dữ liệu đã cung cấp trong highlights, exclusion và các trường khác, cụ thể hơn trong nội dung 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ể dẫn đến 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 điểm nổi bật mà người dùng nhìn thấy.
inclusions[]

object (Text)

Danh sách các phần tử có trong tệp mà người dùng có thể nhìn thấy.
exclusions[]

object (Text)

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

object (Text)

Danh sách ghi chú quan trọng mà người dùng có thể nhìn thấy, dùng để cung cấp thông tin chi tiết như quy định hạn chế 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à thông tin địa lý của vị trí được dùng để 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ụ: 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 chúng nằm ở cùng một địa chỉ. (không bắt buộc)
telephone

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

string

URL của 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)

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

string

Thông tin tham chiếu duy nhất của vị trí trong dịch vụ. Bạn có thể dùng mã nhận dạng này để tham chiếu đến vị trí này trong các trường dịch vụ khác. Ví dụ: trong biểu mẫu nhập 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ã 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 địa điểm này.

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

Rating

Xác định điểm xếp hạng 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ị điểm xếp hạng trung bình (bắt buộc khi numberOfRatings > 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 numberOfRatings bằng 0.
numberOfRatings

string

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

HomeServiceData

Bạn 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
}
Trường
categoryType

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

string

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

VirtualSession

Thông tin về phiên trực tuyến/ảo. Ví dụ: Lớp học yoga trực tuyến, lớp học nấu ăn ảo, 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 cách thiết lập lớp học trực tuyến này. Nếu đối tác không đưa URL video vào yêu cầu đặt phòng, thì văn bản này phải cho biết thời điểm URL video được chia sẻ với người dùng. Ví dụ: "URL Zoom sẽ được gửi qua email 30 phút trước khi lớp học bắt đầu". (Nên dùng)
sessionRequirements

object (Text)

Yêu cầu đối với phiên họp ảo nhất định. Ví dụ: thảm tập 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. Đặt giá trị này thành true nếu phiên họp ảo không phát 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 họp ả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 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 KHÁC. (Bắt buộc nếu nền tảng được đặt thành KHÁC)

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 mà họ muốn.
GOOGLE_HANGOUTS Sản phẩm Google Hangouts.
GOOGLE_MEET Sản phẩm Google Meet.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE Phát trực tiếp trên YouTube.
OTHER Bạn nên đặt giá trị này nếu nền tảng video được sử dụng khác với những 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ì thanh toán 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 các phương thức thanh toán được đề cập dưới đây.

UriTemplate

Mẫu chỉ định cách Google tạo URL đến trang web bên ngoài.

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

string

Không bắt buộc. Mẫu URI phải tuân theo RFC6570, hãy xem https://datatracker.ietf.org/doc/html/rfc6570. Hỗ trợ mẫu Cấp 2. Các tham số này sẽ được phân giải thành giá trị được chỉ định trong các thực thể tương ứng.

5 tham số có sẵn cho Đường liên kết đặt chỗ ăn uống: 1) (bắt buộc) {availability_slot_start_seconds} :: được điền từ trường startSec trong nguồn cấp dữ liệu về tình trạng phòng 2) (bắt buộc) {availability_slot_duration_seconds} :: được điền từ trường durationSec trong nguồn cấp dữ liệu về tình trạng phòng 3) (không bắt buộc) {resources_party_size} :: được điền từ trường partySize trong nguồn cấp dữ liệu về tình trạng phòng 4) (không bắt buộc) {availability_availability_tag} :: được điền từ trường availabilityTag trong nguồn cấp dữ liệu về tình trạng phòng 5) (không bắt buộc) {resources_room_id} :: được điền từ trường roomId trong nguồn cấp dữ liệu về tình trạng phòng

Ví dụ về cách sử dụng: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2

Phương thức

create

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

delete

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

patch

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