Method: inventory.partners.availability.replace

Mevcut Services öğelerinin Availability yerini alır. Bu toplu çağrı, atomikliği garanti etmez. Yalnızca başarıyla güncellenen uygunluk aralıkları 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 metni

İstek içeriği 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ın yerine kullanılan genişletilmiş hizmet müsaitliği.

Yanıt metni

Birden fazla Service müsaitlik durumu aralığını değiştirmek için toplu yanıt. Bu iletiye yalnızca başarıyla güncellenen zaman aralıkları dahil edilir.

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 uygunluk aralıklarının yerine kullanılan, başarıyla güncellenmiş genişletilmiş hizmet uygunluğu mesajları.

Yetkilendirme kapsamları

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

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

ExtendedServiceAvailability

Kullanılabilirlik listesi ve kimlere/ne zaman uygulanması gerektiği.

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

string

Bu alan, aşağıdaki stok durumu mesajlarının hangi satıcıya ait olduğunu belirtmek için zorunludur.

serviceId

string

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

startTimeRestrict

string (Timestamp format)

Sağlanırsa, [startTimeRestrict, endTimeRestrict) aralığında sağlanan Availability öğelerinin eksiksiz bir anlık görüntü olduğunu kabul ederiz. Yani aşağıdaki koşul geçerliyse mevcut tüm uygunluk 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 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ığında stok durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

startTimeRestrict ayarlanırken endTimeRestrict ayarlanmadan bırakılırsa bu, startTimeRestrict ile başlayan tüm zaman olarak yorumlanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmamışken endTimeRestrict ayarlanması, endTimeRestrict'e kadar olan tüm zamanı ifade eder.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

durationRestrict

string (Duration format)

Süre ayarlama, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik bloklarıyla 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ı ayarlama, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.

availability[]

object (Availability)

Yeni müsaitlik listesi.