Method: inventory.partners.availability.replace

Mevcut Services öğesinin Availability değerini değiştirir. Bu toplu çağrı, atomikliği garanti etmez. Yalnızca başarıyla güncellenen kullanılabilirlik alanları döndürülür.

HTTP isteği

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

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

Yol parametreleri

Parametreler
parent

string

partners/{partner_id} biçimi.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Alanlar
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Mevcut müsaitlik aralıklarını değiştirmek için kullanılan genişletilmiş hizmet müsaitliği.

Yanıt gövdesi

Birden fazla Service müsaitlik durumu aralığını değiştirmek için toplu yanıt. Yalnızca başarıyla güncellenen alanlar bu mesaja dahil edilecek

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

JSON gösterimi 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Alanlar
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Mevcut kullanılabilirlik alanlarının yerine kullanılan genişletilmiş hizmet kullanılabilirliği mesajları başarıyla güncellendi.

Yetkilendirme kapsamları

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

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

ExtendedServiceAvailability

Kullanılabilirlik ve kime/ne zaman uygulanması gerektiğiyle ilgili liste.

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

string

Bu, aşağıdaki müsaitlik durumu mesajlarının hangi satıcıya ait olduğunu belirtmek için zorunlu bir alandır.
serviceId

string

Bu, aşağıdaki müsaitlik durumu iletilerinin ait olduğu hizmeti belirtmek için zorunlu bir alandır.
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

Bir 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 kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
resourcesRestrict

object (Resources)

Kaynaklar kısıtlamasının ayarlanması, 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 müsaitlik durumu listesi.