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 của 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 của dịch vụ, ví dụ: "Cắt tóc nam". Có thể ở một số ngôn ngữ.
description

string

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

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

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

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

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

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

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

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

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

Lưu ý quan trọng:

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

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 bởi mọi ngành dọc, ngoại trừ ngành dọc Ăn uống và Điểm tham quan để định cấu hình cách hiển thị giá dịch vụ.
rules

object (SchedulingRules)

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

enum (PrepaymentType)

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

object (PrepaymentTerms)

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

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

object (ServiceIntakeForm)

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

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. Một thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng thành 0.
paymentOptionId[]

string

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

object (Deposit)

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

object (NoShowFee)

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

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 dịch vụ đượ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 dịch vụ có hỗ trợ vé. (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 rằng nội dung đó được hiển thị cho người dùng cuối một cách hiệu quả nhất. (không bắt buộc)
serviceAttributeValueId[]

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é 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 những đối tác có chế độ tích hợp cơ bản. Tính năng mã hoá đầu cuối sẽ luôn bị tắt đối với những đối tác này.
perOrderFee

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í đã ghé thăm liên quan đến dịch vụ này hoặc START_LOCATION khác với VISITED_LOCATION, bạn phải chỉ định START_LOCATION. Ví dụ: – Một chuyến tham quan bằng xe đạp có hướng dẫn viên đến 3 địa điểm, bạn cần chỉ định địa điểm bắt đầu. – Một chuyến tham quan bằng xe buýt, mọi người gặp nhau tại sảnh khách sạn rồi đến địa điểm tham quan. Bạn cần chỉ định địa điểm họp.
rating

object (Rating)

Điểm xếp hạng từ người dùng cho dịch vụ này dưới dạng chỉ số tổng hợp trên tất cả các bài đánh giá.
homeServiceData

object (HomeServiceData)

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

object (VirtualSession)

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

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. Đây là thông tin bắt buộc nếu bạn 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 nên tạo URL cho 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á phải được hiểu là một giá trị cụ thể.

Ví dụ: 200.000 VND cho một lớp học yoga; 150.000 VND cho dịch vụ 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à nhìn thấy giá tối thiểu. Người tiêu dùng có thể đưa ra những 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ụ: 300.000 VND cho dịch vụ chải chuốt cho chó, nhưng giá có thể tăng nếu người tiêu dùng có thêm lựa chọn
NOT_DISPLAYED

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

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ụ: Một buổi 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 tối thiểu để thông báo trước (tính bằng giây) cần thiết để huỷ cuộc hẹn đã đặt trực tuyến. (không bắt buộc)
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í vắng mặt mà không huỷ.
admissionPolicy

enum (AdmissionPolicy)

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

object (CancellationPolicy)

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

Trường nhóm min_booking_buffer. Khoảng thời gian (tính bằng giây) từ thời điểm có thể đặt chỗ lần cuối cho đến khi khung giờ trống bắt đầu hoặc kết thúc.

Nếu bạn đặt "min_advance_booking", thì thời gian đặt chỗ muộn nhất được tính là (<thời gian bắt đầu của khung giờ> – "min_advance_booking"). Nếu bạn đặt "min_booking_buffer_before_end_time", thì thời gian đặt phòng muộn nhất được tính là (<giờ kết thúc của khung giờ> – "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 cả hai đều chưa được đặt, thì bạn có thể đặt lịch hẹn cho khung giờ cho đến thời gian bắt đầu của khung giờ. Nếu bạn đặt cả hai trường, thì hệ thống sẽ chỉ chọn một giá trị và bỏ qua giá trị còn lại. Chúng tôi không thể dự đoán một cách đáng tin cậy 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 cho phép mua vé muộn nhất 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 giờ 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 trạng thái sau:
minAdvanceBooking

string (int64 format)

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

string (int64 format)

Khoảng thời gian (tính bằng giây) từ thời điểm có thể đặt lượt đặt phòng cuối cùng cho đến khi kết thúc khung giờ trống. Nếu bạn đặt trường này, thì 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 các khung giờ bắt đầu.

AdmissionPolicy

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

Enum
ADMISSION_POLICY_UNSPECIFIED Không dùng đến.
TIME_STRICT Khách hàng phải có mặt vào thời gian bắt đầu của khung giờ có thể đặt lịch 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ờ đó. 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à quay lại vào khoảng 12 giờ trưa. Đặt lịch cắt tóc vào lúc 3 giờ chiều thứ Bảy, thời gian dự kiến là khoảng 30 phút. * Lớp học thể dục từ 6 giờ tối đến 8 giờ tối.
TIME_FLEXIBLE

Khách hàng có thể đến vào bất kỳ thời điểm nào trong khoảng thời gian bắt đầu và kết thúc của khung giờ có thể đặt để sử dụng lượt đặt 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 vào bất kỳ thời điểm nào trong ngày mua. * Vé vào cửa công viên giải trí buổi chiều, có thể sử dụng từ 12 giờ trưa đến 9 giờ tối.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

Ví dụ: trong trường hợp vé vào cửa bảo tàng, vé vào cửa có khung giờ là 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ó thể đặt lịch hẹn cho dịch vụ này là thời gian vào cửa đượ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ó thể đặt lịch hẹn.

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ó một số đ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 duy nhất. 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" theo nhiều khoảng thời gian 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 giờ bắt đầu, cho đến khi khách hàng có thể nhận được tiền hoàn lại cho một phần chi phí dịch vụ được chỉ định trong 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ố 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 lại, miễn là bạn huỷ đặt lịch hẹn dịch vụ ít nhất minDurationBeforeStartTime trước thời gian bắt đầu dịch vụ, trong phạm vi [0, 100]. Khi được đặt thành 0 (mặc định), dịch vụ sẽ không được hoàn tiền. Khi được đặt thành 100, dịch vụ này sẽ được hoàn tiền đầy đủ.

PrepaymentType

Liệt kê để cho biết loại trả trước.

Enum
PREPAYMENT_TYPE_UNSPECIFIED Theo mặc định, chúng tôi sẽ giả định rằng khoản trả trước là NOT_SUPPORTED.
REQUIRED Người dùng phải thanh toán dịch vụ này tại thời điểm đặt phòng.
OPTIONAL Người dùng có thể chọn trả trước dịch vụ này tại thời điểm đặt chỗ hoặc sau đó, nhưng không bắt buộc phải trả trước để đặt chỗ.
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 việc 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 gian bắt đầu dịch vụ mà người dùng phải trả phí. Bạn chỉ nên đặt trường này khi ChargeTiming là CHARGE_LATER.

ChargeTiming

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

Enum
CHARGE_TIMING_UNSPECIFIED Không dùng đến.
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 một biểu mẫu nhập thông tin giúp tuỳ chỉnh dịch vụ do người bán cung cấp.

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

object (ServiceIntakeFormField)

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

boolean

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

boolean

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

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ã nhận dạng này phải giống với mã nhận dạng trong câu trả lời của trường biểu mẫu tương ứng và phải là mã nhận dạng riêng biệt ở cả cấp dịch vụ và theo từng biểu mẫu tiếp nhận phiếu yêu cầu hỗ trợ. (bắt buộc)
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 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 bằng nhiều ngôn ngữ. (bắt buộc)
value[]

string

Đặt nếu và chỉ 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)

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

boolean

Cho biết liệu người dùng có bắt buộc phải trả lời trường này hay không.
allowCustomAnswer

boolean

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

object (Text)

Các lựa chọn bổ sung được cung cấp ngoài các giá trị đã cung cấp. Chỉ áp dụng khi loại trường là LOCATION_SEARCH. Ví dụ: ngoài danh sách vị trí được cung cấp, bạn có thể chọn "Tôi sẽ liên hệ với nhà cung cấp sau". (không bắt buộc)
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é áp dụng. Để 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 thông tin đầu vào, xuất hiện dưới dạng phần giữ chỗ văn bản. Điều này chỉ áp dụng khi loại trường là SHORT_ANSWER hoặc PARAGRAPH. (không bắt buộc)

FieldType

Liệt kê để 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 được sẽ bị bỏ qua.
SHORT_ANSWER Một trường nhập dữ liệu có một dòng.
PARAGRAPH Một trường nhập dữ liệu nhiều dòng cho văn bản.
MULTIPLE_CHOICE Một nhóm nút chọn yêu cầu 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 dùng đến.
SERVICE_TYPE_DINING_RESERVATION Đặt chỗ dùng bữa.
SERVICE_TYPE_FOOD_ORDERING Đặt món ăn, có thể là giao đồ ăn hoặc mang đi hoặc cả hai.
SERVICE_TYPE_FOOD_DELIVERY Dịch vụ 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. Được đề xuất cho (1) sức khoẻ và thể dục, (2) 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 buổi học hoàn toàn ảo. Bạn phải đặt thuộc tính này nếu bật tính năng đặt lịch hẹn dịch vụ ảo.
SERVICE_TYPE_SHOPPING Dịch vụ cho phép người dùng mua sắm tại người bán được chỉ định. Bạn có thể chọn giao hàng hoặc đến lấy hàng.

TicketType

TicketType được dùng để phân biệt các loại 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, thuộc tính dịch vụ hoặc lựa chọn/tiện ích bổ sung khác nhau.

Vé là đơn vị tối thiểu có thể đặt cho một dịch vụ, ví dụ: một chỗ trong chuyến đi bè, vé vào cửa bảo tàng, dịch vụ cho 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ã vé được dùng để phân biệt các loại vé khác nhau của cùng một dịch vụ và chỉ được phép là mã riêng biệt trong một dịch vụ.
shortDescription

string

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

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

object (Text)

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

Đây có thể là thông tin mà người dùng nhìn thấy, ví dụ: "người lớn", "trẻ em", "cựu chiến binh", "hàng J", v.v. Bắt buộc, mỗi loại vé phải có nội dung mô tả mà người dùng nhìn thấy. 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 thuế. Mức thuế 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)
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 lựa chọn bổ sung mà loại vé này đại diện (nếu có). Không dùng nữa, hãy sử dụng localizedOptionDescription.
localizedOptionDescription

object (Text)

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

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

Ví dụ 1: vé vào cửa có nhiều loại "người lớn", "trẻ em" và ngôn ngữ là một lựa chọn bổ sung, danh sách TicketType dự kiến sẽ là: - { 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ụ cho thuê thuyền kayak nhiều giờ có thêm tiện ích bổ sung 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 vé nào trong dịch vụ có trường này được đặt, thì chúng tôi cũng mong đợi tất cả các loại vé khác đều có trường này được đặt (bạn có thể sử dụng một 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ợ 2 thẻ định dạng HTML: và
. Các lựa chọn này được dùng để chỉ định các lựa chọn có cả tiêu đề và nội dung mô tả chi tiết, ví dụ: "Ghế cao cấp
Lựa chọn này cung cấp ghế ngồi tại các hộp riêng, bao gồm cả ghế có đệm đầy đủ, TV riêng, dịch vụ Thực phẩm và đồ uống tại chỗ. Những chỗ ngồi này có tầm nhìn đẹp như tranh vẽ ra sân."
inventoryType

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é duy nhất thuộc loại này.

PerTicketFee

Các khoản phí mà người dùng phải trả cho mỗi vé họ 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)

Một khoản phí được trả cho địa điểm/cơ sở.
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 có đườ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ư 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 nhầm lẫn.

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Bạn chưa chỉ định loại giá hiển thị. 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é duy nhất thuộc loại này.

Enum
INVENTORY_TYPE_UNSPECIFIED Bạn 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 hàng của đơn vị tổng hợp. Trang web tổng hợp (ví dụ: www.bandsintown.com) nghĩa là đối tác cung cấp thông tin về sự kiện và vé. Tuy nhiên, vé không phải do đối tác bán trực tiếp. Người bán vé thực tế có thể là người bán vé chính, người bán lại đã xác minh hoặc người bán lại. Giờ đây, chúng tôi chỉ phân biệt loại khoảng không quảng cáo của đối tác cấp cao nhất và bỏ qua loại khoảng không quảng cáo thực tế của người bán vé trong một đơn vị tổng hợp.

RelatedMedia

Ảnh liên quan đến dịch vụ này. Google sẽ thu thập dữ liệu về những nội dung nghe nhìn này để đảm bảo rằng nội dung được 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 nghe nhìn này.
localizedCaption

object (Text)

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

object (Attribution)

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

string

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

MediaType

Liệt kê để 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ỗ bằng Google nếu bạn cần hỗ trợ các loại nội dung nghe nhìn khác ngoài ảnh.

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

string

Không dùng nữa, nê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ã nhận dạng của một thuộc tính như được xác định trong Merchant.service_attribute, ví dụ: "service-type".
valueId

string

Mã nhận dạng của giá trị cho thuộc tính này, ví dụ: "haircut". Phải khớp với một 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 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ì bạn không được điền thông tin này.
supportsAdditionalRequest

boolean

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

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

Các lựa chọn cho những 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 nhóm 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 trạng thái sau:
callMerchant

object (CallMerchant)

Những nhóm có số lượng người ngoài phạm vi có thể gọi điện cho doanh nghiệp. Một thông báo được xác định trước sẽ xuất hiện cho người dùng. Văn bản mẫu sẽ xuất hiện: "Đối với những buổi 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 sẽ để trống.

CallMerchant

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

Thông báo trống sẽ được 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 chỗ.

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),
  "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 hình 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.
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 nhóm nhỏ các danh mục sự kiện mà chúng tôi tuỳ chỉnh trải nghiệm về sản phẩm. Lưu ý: không nhằm mục đích trở thành một bản thể học phổ quát về các sự kiện.

Enum
EVENT_CATEGORY_UNSPECIFIED Chưa chỉ định. Không được dùng.
EVENT_CATEGORY_CONCERT Sự kiện âm nhạc.
EVENT_CATEGORY_SPORTS Sự kiện thể thao.
EVENT_CATEGORY_THEATRE Sự kiện tại 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 riêng biệt của thực thể trong cơ sở dữ liệu của đối tác. (không bắt buộc)
name

string

Tên của 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)

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

EntityType

Loại thực thể. Lưu ý: không nhằm mục đích trở thành một bản thể học phổ quát.

Enum
ENTITY_TYPE_UNSPECIFIED Chưa chỉ định. Không được dùng.
ENTITY_TYPE_PERFORMER Thực thể này đại diện cho nghệ sĩ hoặc nhóm nhạc biểu diễn tại một buổi hoà nhạc hoặc chương trình. Chỉ áp dụng khi danh mục sự kiện là CONCERT hoặc THEATRE.
ENTITY_TYPE_PLAYER Thực thể này đại diện cho đội thể thao hoặc cầu thủ 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 mà sự kiện này thuộc về. 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 mà sự kiện này thuộc về. Chỉ áp dụng khi danh mục sự kiện là 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 biểu diễn tại sự kiện. Chỉ áp dụng khi danh mục sự kiện là THEATRE.

EntityRole

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

Enum
ENTITY_ROLE_UNSPECIFIED Chưa chỉ định.
ENTITY_ROLE_HEADLINER Thực thể này đại diện cho một nghệ sĩ chính 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 một người biểu diễn phụ tại sự kiện.
ENTITY_ROLE_HOME_TEAM Thực thể này đại diện cho đội 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 đề cập đến một thực thể.

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

string

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

string

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

AttendanceMode

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

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

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ỉ liên quan đến 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

Mức độ 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 Hoàn tất quá trình tích hợp để cho phép đặt lịch hẹn từ đầu đến cuối thông qua Google.
INTEGRATION_TYPE_INVENTORY_ONLY Máy chủ đặt chỗ 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à (không bắt buộc) tình trạng còn hàng.

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

object (Price)

Một khoản phí có thể thay đổi tuỳ theo cách 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 kết xuất riêng (ví dụ: dưới dạng dấu đầu dòng).

Bạn nên điền sẵ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 túy và văn bản tương tự như HTML để định dạng cơ bản. Các thẻ định dạng tương tự như 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 // để làm nổi bật một văn bản quan trọng. Mọi thẻ cụm từ khác đều sẽ bị bỏ qua.

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

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 nội dung mô tả dịch vụ. * Tránh 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 người dùng không mong muốn.

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 nội dung được đưa vào mà người dùng có thể thấy.
exclusions[]

object (Text)

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

object (Text)

Danh sách các ghi chú quan trọng mà người dùng nhìn thấy, dùng để biết các 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.

Thông tin vị trí

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

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

string

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

string

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

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

string

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

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

LocationType

Loại vị trí này.

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

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ị phải nằm trong phạm vi [1, 5] và chỉ có thể bị bỏ qua nếu numberOfRatings bằng 0.
numberOfRatings

string

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

HomeServiceData

Bạn phải cung cấp thêm thông tin cho ngành dọc dịch vụ tại 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ụ tại 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ụ tại nhà đã cho thuộc về. Ví dụ: unclog_drain, install_faucet là các loại công việc thuộc danh mục thợ sửa ống nước.

VirtualSession

Thông tin về phiên ảo/trực tuyến. 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 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 cùng với thông tin đặt chỗ, thì văn bản này phải cho biết thời điểm URL của video sẽ đượ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 ảo đã cho. Ví dụ: thảm tập yoga, đồ dùng nấu ăn, v. v. (Nên dùng)
virtualPlatformInfo

object (VirtualPlatformInfo)

Thông tin về nền tảng ảo được 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 diễn ra trực tiếp và được ghi hình trước.

VirtualPlatformInfo

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

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

enum (Platform)

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

object (Text)

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

Nền tảng

Liệt kê để cho biết người bán sẽ sử dụng nền tảng ảo nào.

Enum
PLATFORM_UNSPECIFIED Không dùng đến.
FLEXIBLE Người bán có thể linh hoạt trong việc sử dụng nền tảng video.
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 thông số này nếu nền tảng video bạn 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ì trả trước cho dịch vụ thông qua RwG.

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

object (Text)

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

UriTemplate

Một mẫu chỉ định cách Google nên tạo URL cho 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 các giá trị được chỉ định trong các thực thể tương ứng.

Các 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 sẵn từ trường startSec trong nguồn cấp dữ liệu về tình trạng còn chỗ 2) (bắt buộc) {resources_party_size} :: được điền sẵn từ trường partySize trong nguồn cấp dữ liệu về tình trạng còn chỗ 3) (không bắt buộc) {availability_slot_duration_seconds} :: được điền sẵn từ trường durationSec trong nguồn cấp dữ liệu về tình trạng còn chỗ 4) (không bắt buộc) {availability_slot_availability_tag} :: được điền sẵn từ trường availabilityTag trong nguồn cấp dữ liệu về tình trạng còn chỗ

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

Với: * 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 đơn vị tập 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 đơn vị tổng hợp được chỉ định quản lý.

patch

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