Method: inventory.partners.merchants.services.availability.replace

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

Yêu cầu HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
serviceAvailability.name

string

Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo định dạng partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer
    },
    "availability": [
      {
        "startTime": string,
        "duration": string,
        "spotsTotal": string,
        "spotsOpen": string,
        "availabilityTag": string,
        "resources": {
          object (Resources)
        },
        "paymentOptionId": [
          string
        ],
        "recurrence": {
          object (Recurrence)
        },
        "scheduleException": [
          {
            object (ScheduleException)
          }
        ],
        "deposit": {
          object (Deposit)
        },
        "noShowFee": {
          object (NoShowFee)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode)
      }
    ]
  }
}
Các trường
serviceAvailability.startTimeRestrict

string (Timestamp format)

Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Khả năng đáp ứng được cung cấp là bản tổng quan nhanh hoàn chỉnh từ [startTimeRestrict, endTimeRestrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo Hạn chế tài nguyên, điều kiện sẽ bị hạn chế hơn nữa:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Các trường này thường dùng để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định.

Việc đặt startTimeRestrict trong khi không đặt endTimeRestrict có nghĩa là mọi lúc bắt đầu từ startTimeRestrict.

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

string (Timestamp format)

Việc đặt endTimeRestrict trong khi không đặt startTimeRestrict được hiểu là luôn có nghĩa là thời gian giới hạn thời gian kết thúc.

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

string (Duration format)

Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp.

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

object (Resources)

Việc đặt tài nguyên Hạn chế sẽ hạn chế hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.
serviceAvailability.availability[]

object (Availability)

Danh sách tình trạng rảnh/bận mới.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Danh sách tình trạng rảnh/bận và người/thời điểm áp dụng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Các trường
name

string

Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo định dạng partners/{partner_id}/merchants/{merchantId}/services/{serviceId}
startTimeRestrict

string (Timestamp format)

Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Khả năng đáp ứng được cung cấp là bản tổng quan nhanh hoàn chỉnh từ [startTimeRestrict, endTimeRestrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đáp ứng điều kiện sau:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế hơn nữa:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo Hạn chế tài nguyên, điều kiện sẽ bị hạn chế hơn nữa:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Các trường này thường dùng để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định.

Việc đặt startTimeRestrict trong khi không đặt endTimeRestrict có nghĩa là mọi lúc bắt đầu từ startTimeRestrict.

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

string (Timestamp format)

Việc đặt endTimeRestrict trong khi không đặt startTimeRestrict được hiểu là luôn có nghĩa là thời gian giới hạn thời gian kết thúc.

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

string (Duration format)

Việc đặt thời lượng sẽ hạn chế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp.

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

object (Resources)

Việc đặt tài nguyên Hạn chế sẽ hạn chế hơn nữa phạm vi cập nhật chỉ cho nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.
availability[]

object (Availability)

Danh sách tình trạng rảnh/bận mới.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking