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

Mengganti Availability dari Service yang ada pada penjual yang dikelola agregator yang ditentukan, dan menampilkannya.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
serviceAvailability.name

string

Nama resource layanan yang akan menerapkannya. Dalam format partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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)
      }
    ]
  }
}
Kolom
serviceAvailability.startTimeRestrict

string (Timestamp format)

Jika disediakan, kami akan menganggap entity Availability yang disediakan sebagai snapshot lengkap dari [startTimeRestrict, endTimeRestrict). Artinya, semua ketersediaan yang ada akan dihapus jika ketentuan berikut berlaku:

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

Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:

  availability.duration == durationRestrict

Jika pesan resourceRestrict ditetapkan, ketentuan akan dibatasi lebih lanjut:

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

Kolom ini biasanya digunakan untuk memberikan pembaruan lengkap tentang ketersediaan dalam rentang waktu tertentu.

Menetapkan startTimeRestrict sementara membiarkan endTimeRestrict tidak ditetapkan akan berarti setiap waktu dimulai pada startTimeRestrict.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
serviceAvailability.endTimeRestrict

string (Timestamp format)

Menetapkan endTimeRestrict dan membiarkan startTimeRestrict tidak ditetapkan akan berarti semua waktu berakhir pada endTimeRestrict.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
serviceAvailability.durationRestrict

string (Duration format)

Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
serviceAvailability.resourcesRestrict

object (Resources)

Menetapkan resourcesRestrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk kumpulan resource ini. Semua kolom id untuk resource harus sama persis.
serviceAvailability.availability[]

object (Availability)

Daftar ketersediaan baru.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Daftar ketersediaan dan siapa/kapan harus menerapkannya.

Representasi JSON 
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Kolom
name

string

Nama resource layanan yang akan menerapkannya. Dalam format partners/{partner_id}/merchants/{merchantId}/services/{serviceId}
startTimeRestrict

string (Timestamp format)

Jika disediakan, kami akan menganggap entity Availability yang disediakan sebagai snapshot lengkap dari [startTimeRestrict, endTimeRestrict). Artinya, semua ketersediaan yang ada akan dihapus jika ketentuan berikut berlaku:

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

Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:

  availability.duration == durationRestrict

Jika pesan resourceRestrict ditetapkan, ketentuan akan dibatasi lebih lanjut:

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

Kolom ini biasanya digunakan untuk memberikan pembaruan lengkap tentang ketersediaan dalam rentang waktu tertentu.

Menetapkan startTimeRestrict sementara membiarkan endTimeRestrict tidak ditetapkan akan berarti setiap waktu dimulai pada startTimeRestrict.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

Menetapkan endTimeRestrict dan membiarkan startTimeRestrict tidak ditetapkan akan berarti semua waktu berakhir pada endTimeRestrict.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
durationRestrict

string (Duration format)

Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
resourcesRestrict

object (Resources)

Menetapkan resourcesRestrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk kumpulan resource ini. Semua kolom id untuk resource harus sama persis.
availability[]

object (Availability)

Daftar ketersediaan baru.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

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