Method: inventory.partners.availability.replace

Mevcut Services öğesinin Availability değerini değiştirir. Bu toplu çağrı, eksiklik garantisi vermez. 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 gövdesi, aşağıdaki yapıya sahip verileri içerir:

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

object (ExtendedServiceAvailability)

Mevcut kullanılabilirlik slotlarının yerine kullanılan genişletilmiş hizmet kullanılabilirliği.

Yanıt gövdesi

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

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

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 stok 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 Stok Durumu varlıklarını, [startTimeRestrict, endTimeRestrict) öğesinin eksiksiz bir anlık görüntüsü olarak değerlendiririz. 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

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

  availability.duration == durationRestrict

Bir resourcesRestrict mesajı ayarlanırsa koşul 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 özelliği ayarlanmadan bırakılırsa endTimeRestrict'in ayarlanması, endTimeRestrict'a kadar olan tüm zamanlar anlamına gelecek şekilde 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".

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 kullanılabilirlik listesi.