REST Resource: inventory.partners.merchants.services.availability

string (Timestamp format)

Thời gian bắt đầu của khung giờ nhận đặt hẹn.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Thời lượng của khung giờ nhận đặt hẹn

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

string (int64 format)

Tổng số chỗ và số chỗ còn trống của lịch phát sóng này. Ví dụ:

• Lớp Yoga gồm 10 chỗ, có 3 chỗ được đặt trước: availability {spotsTotal: 10, spotsOpen: 7 ...}
• Phiên mát xa trên ghế đã kín chỗ: availability {spotsTotal: 1, spotsOpen: 0 ...}

Lưu ý: Nếu gửi yêu cầu sử dụng định dạng nén tính khả dụng được xác định bên dưới, hai trường này sẽ được suy ra.

• Lặp lại ngụ ý spotsTotal=1 và spotsOpen=1.
• ScheduleException ngụ ý spotsTotal=1 và spotsOpen=0.

string (int64 format)

Số lượng chỗ trống.

string

Một chuỗi mờ tuỳ chọn để xác định vùng tình trạng rảnh/bận này. Nếu được đặt, lịch hẹn này sẽ được đưa vào yêu cầu đặt lịch/cập nhật/huỷ cuộc hẹn.

object (Resources)

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

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

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

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 vùng này. Các phương thức thanh toán thực tế được xác định ở cấp Người bán và cũng có thể được chia sẻ giữa nhiều Người bán.

Trường này sẽ ghi đè mọi payment_option_ids được chỉ định trong thông báo dịch vụ. Tương tự, payment_option_ids được chỉ định ở đây KHÔNG bắt buộc phải có trong thông báo dịch vụ, mặc dù phải được xác định ở cấp Người bán.

object (Recurrence)

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

object (ScheduleException)

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

object (Deposit)

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

object (NoShowFee)

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

object (Prepayment)

Không bắt buộc. Thông tin thanh toán trước không bắt buộc cho tình trạng sẵn có này.

enum (RequireCreditCard)

Cho biết liệu người dùng có phải cung cấp thẻ tín dụng để đặt khung giờ trống này hay không. Nếu bạn không đặt giá trị này, giá trị này sẽ được kế thừa từ cấp dịch vụ nếu được đặt ở đó. (không bắt buộc)

string

Cho biết danh sách các loại vé được hỗ trợ cho khung giờ trống này. Nếu không đặt, tất cả các loại vé trong dịch vụ mẹ đều dùng được cho vùng này. Lưu ý rằng bạn phải xác định các giá trị của trường này trong dịch vụ mẹ. Ví dụ:

• Dịch vụ có 4 loại vé: TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Youth weekends"}

Để thể hiện khoảng không quảng cáo trong các ngày trong tuần: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. Để thể hiện khoảng không quảng cáo trong mùa lễ: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}.

• Dịch vụ có 3 loại vé: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

Để cho biết cả ba loại vé đều có sẵn cho khung giờ này, hãy sử dụng availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} hoặc "availability {...}" (không đặt ticketTypeId trong khung giờ này).

(không bắt buộc)

enum (DurationRequirement)

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

object (SchedulingRuleOverrides)

Quy tắc lên lịch về tình trạng rảnh/bận. Nếu các trường được điền sẵn, chúng sẽ ghi đè mọi quy tắc lập lịch tương ứng trên SchedulingRules cấp dịch vụ.

enum (ConfirmationMode)

Chế độ xác nhận sẽ được dùng khi đặt lịch trống trong tình trạng còn hàng này. Những nỗ lực tạo yêu cầu đặt trước cho tình trạng còn hàng bằng phương thức xác nhận là CONFIRMATION_MODE_SYNCHRONOUS phải được xác nhận hoặc bị từ chối ngay lập tức. Đối với những yêu cầu đặt lịch phát sóng cho lịch phát sóng có phương thức xác nhận là CONFIRMATION_MODE_ASYNCHRONOUS, hệ thống phải từ chối ngay lập tức hoặc được tạo với trạng thái PENDING.

enum (LinkoutRequiredReason)

Không bắt buộc. Lý do yêu cầu đường liên kết cho vị trí này. Nếu được đặt, tài nguyên Người bán cho vị trí này phải có LinkoutTemplate hợp lệ. (không bắt buộc)

string

Giấy tờ tuỳ thân không bắt buộc của nhân viên cung cấp dịch vụ. Trường này xác định nhân viên của tất cả người bán, dịch vụ và hồ sơ về tình trạng còn hàng. Giá phòng cũng cần phải ổn định theo thời gian để có thể tương quan với các lượt đặt phòng trước đây. Trường này phải có nếu có staffName.

string

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

string

Mã nhận dạng không bắt buộc cho phòng chứa dịch vụ. Trường này xác định phòng trên tất cả người bán, dịch vụ và hồ sơ về tình trạng phòng. Số liệu này cũng cần phải ổn định theo thời gian để cho phép mối tương quan với các lượt đặt phòng trước đây. Bạn phải có trường này nếu có RoomName.

string

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

integer

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

object (Text)

Không bắt buộc. Nội dung mô tả phòng đã bản địa hoá. Nếu được đặt, bạn phải cung cấp giá trị mặc định. Bạn cũng nên cung cấp các ngôn ngữ phổ biến cho ngôn ngữ của người bán. (không bắt buộc)

string (Timestamp format)

Dấu thời gian tối đa (theo giờ UTC) mà thời gian phát hành sẽ lặp lại cho đến.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Duration format)

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

Ví dụ: Lịch phát sóng có thời lượng 20 phút, repeatEvery là 30 phút, startTime là 9:00 và repeatUntil là 11:00 sẽ tạo ra các khung giờ phát sóng từ 9:00 đến 9:20, 9:30 đến 9:50, 10:00 đến 10:20, 10:30 đến 10:50, 11:00 đến 11:20. (bắt buộc)

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

object (TimeRange)

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

Ví dụ: Nếu lịch biểu định kỳ chỉ định thời lượng là 20 phút, repeatEvery là 30 phút, startTime là 9:00 và repeatUntil là 11:00, thì ScheduleException có timeRange là 9:45-11:00 sẽ không cung cấp các khung giờ từ 9:30 đến 9:50, 10 đến 10:20 và 10:30 đến 10:50.

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

object (PriceInfo)

Vùng chứa thông tin về giá.

enum (PriceType)

Xác định cách áp dụng giá hoặc khoảng giá (mỗi người hoặc cố định)

object (Price)

Giá của một dịch vụ hoặc khoản phí.

object (PriceRange)

Giới hạn trên và/hoặc giới hạn dưới của một dịch vụ hoặc một khoản phí.

object (Price)

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

object (Price)

Số tiền tối đa. Phải luôn là > minPrice.

string (int64 format)

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

string (int64 format)

Lần đầu tiên (tính bằng giây) mà khung giờ này có thể được đặt trước. Dấu thời gian này phải trước startSec của vị trí hoặc lastBookableSec nếu được chỉ định.

string (int64 format)

Nếu được đặt, thời gian cuối cùng (tính bằng giây kể từ thời gian Unix) mà thời gian rảnh cụ thể này có thể bị hủy thông qua Đặt chỗ với Google. Trường này sẽ ghi đè mọi quy tắc huỷ ở cấp dịch vụ. (không bắt buộc)