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

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service Availability değerini değiştirir ve döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
serviceAvailability.name

string

Bu özelliğin uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer,
      "roomDescription": {
        object (Text)
      }
    },
    "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)
        },
        "prepayment": {
          object (Prepayment)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode),
        "linkoutRequiredReason": enum (LinkoutRequiredReason)
      }
    ]
  }
}
Alanlar
serviceAvailability.startTimeRestrict

string (Timestamp format)

Sağlanırsa sağlanan müsaitlik durumu öğelerini [startTimeRestrict, endTimeRestrict) arasındaki tam bir anlık görüntü olarak kabul ederiz. Diğer bir deyişle, aşağıdaki koşulun geçerli olması durumunda tüm mevcut kullanılabilirlikler silinecektir:

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

Süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == durationRestrict

resourcesRestrict mesajı ayarlanırsa durum daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki müsaitlik durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

endTimeRestrict özelliği ayarlanmadan bırakılırsa startTimeRestrict'ın ayarlanması, startTimeRestrict'tan başlayan tüm zamanlar olarak yorumlanır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
serviceAvailability.endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırken endTimeRestrict ayarlanırsa bu, endTimeRestrict'e kadar olan tüm sürenin kastedildiği anlamına gelir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
serviceAvailability.durationRestrict

string (Duration format)

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip stok durumuyla daha da kısıtlar.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
serviceAvailability.resourcesRestrict

object (Resources)

Kaynakları kısıtla ayarı, güncellemenin kapsamını yalnızca bu kaynak kümesiyle daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.
serviceAvailability.availability[]

object (Availability)

Yeni müsaitlik durumu listesi.

Yanıt gövdesi

Kullanılabilirlik durumunun ve bu durumun kimlere/ne zaman uygulanacağının listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Alanlar
name

string

Bu özelliğin uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde
startTimeRestrict

string (Timestamp format)

Sağlanmışsa sağlanan Availability varlıklarını, [startTimeRestrict, endTimeRestrict) öğesinin eksiksiz bir anlık görüntüsü olarak değerlendiririz. Yani aşağıdaki koşul geçerliyse mevcut tüm müsaitlik durumu silinir:

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

Süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == durationRestrict

resourcesRestrict mesajı ayarlanırsa durum daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki müsaitlik durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

endTimeRestrict özelliği ayarlanmadan bırakılırsa startTimeRestrict'ın ayarlanması, startTimeRestrict'tan başlayan tüm zamanlar olarak yorumlanır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırken endTimeRestrict ayarlanırsa bu, endTimeRestrict'e kadar olan tüm sürenin kastedildiği anlamına gelir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
durationRestrict

string (Duration format)

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip stok durumuyla daha da kısıtlar.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
resourcesRestrict

object (Resources)

Kaynakları kısıtla ayarı, güncellemenin kapsamını yalnızca bu kaynak kümesiyle daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.
availability[]

object (Availability)

Yeni kullanılabilirlik listesi.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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