Method: inventory.partners.availability.replace

Mevcut Services öğesinin Availability öğesini değiştirir. Bu toplu çağrı, atom değeri 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ıyla birlikte veriler içerir:

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

object (ExtendedServiceAvailability)

Mevcut kullanılabilirlik yuvalarının yerini almak için 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 çok Service kullanılabilirlik slotunu değiştirmeye yönelik toplu yanıt. Bu mesaja yalnızca başarıyla güncellenen zaman aralıkları dahil edilecek

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

object (ExtendedServiceAvailability)

Mevcut kullanılabilirlik yuvalarının yerini almak için kullanılan ve başarıyla güncellenen genişletilmiş hizmet kullanılabilirliği mesajları.

Yetkilendirme Kapsamları

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

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

ExtendedServiceAvailability

Kullanılabilirlik listesi ve kime/ne zaman uygulanacağını gösteren 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 mesajlarının hangi hizmete ait olduğunu belirtmek için zorunlu bir alandır.

startTimeRestrict

string (Timestamp format)

Sağlanması durumunda, sağlanan Müsaitlik Durumu varlıklarını [startTimeRestrict, endTimeRestrict öğesinde eksiksiz bir anlık görüntü olarak kabul ederiz. Yani aşağıdaki koşul doğruysa mevcut tüm kullanılabilirlikler 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

Kaynakları kısıtla 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 kullanılabilirliğin tam bir güncellemesini sağlamak için kullanılır.

endTimeRestrict ayarlanmadan bırakılırsa startTimeRestrict ayarı, startTimeRestrict ile başlayan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırsa endTimeRestrict ayarı, endTimeRestrict değerine kadar olan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 müsaitlik durumuyla daha da kısıtlar.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

resourcesRestrict

object (Resources)

"Kaynakları kısıtla"yı ayarlamak, 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 kullanılabilirlik listesi.