Method: inventory.partners.merchants.services.availability.replace

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesinin 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 metni aşağıdaki yapıyla birlikte 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,
      "roomDescription": {
        object (Text)
      }
    },
    "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)
        },
        "prepayment": {
          object (Prepayment)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode),
        "linkoutRequiredReason": enum (LinkoutRequiredReason)
      }
    ]
  }
}
Alanlar
serviceAvailability.startTimeRestrict

string (Timestamp format)

Sağlanırsa sağlanan müsaitlik durumu öğelerini [startTimeRestrict, endTimeRestrict) arasındaki tam bir anlık görüntü olarak kabul ederiz. Yani aşağıdaki koşul geçerliyse mevcut tüm müsaitlik durumu 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 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.

startTimeRestrict ayarlanırken endTimeRestrict ayarlanmadan bırakılırsa bu, startTimeRestrict'ten itibaren tüm zamanın kastedildiği anlamına gelir.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

serviceAvailability.endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırken endTimeRestrict ayarlanırsa bu, endTimeRestrict'e kadar olan tüm süreyi ifade eder.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

serviceAvailability.durationRestrict

string (Duration format)

Süre ayarlamak, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlikle kısıtlar.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

serviceAvailability.resourcesRestrict

object (Resources)

Kaynakları kısıtlama ayarı, 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 müsaitlik durumu listesi.

Yanıt gövdesi

Kullanılabilirlik durumunun ve bu durumun kimlere/ne zaman uygulanacağının listesi.

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

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ğlanırsa sağlanan müsaitlik durumu öğelerini [startTimeRestrict, endTimeRestrict) arasındaki tam bir anlık görüntü olarak kabul ederiz. Yani aşağıdaki koşul geçerliyse mevcut tüm müsaitlik durumu 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 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.

startTimeRestrict ayarlanırken endTimeRestrict ayarlanmadan bırakılırsa bu, startTimeRestrict'ten itibaren tüm zamanın kastedildiği anlamına gelir.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren 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ırken endTimeRestrict ayarlanırsa bu, endTimeRestrict'e kadar olan tüm süreyi ifade eder.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren 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üre ayarlamak, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlikle 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ı kısıtlama ayarı, 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.

Yetkilendirme kapsamları

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

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