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
    },
    "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)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode)
      }
    ]
  }
}
Alanlar
serviceAvailability.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".

serviceAvailability.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".

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

serviceAvailability.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.

serviceAvailability.availability[]

object (Availability)

Yeni kullanılabilirlik listesi.

Yanıt gövdesi

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

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

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 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.

Yetkilendirme Kapsamları

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

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