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

Bunun uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde

İstek metni

İstek içeriği 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, [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".
serviceAvailability.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".
serviceAvailability.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".
serviceAvailability.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.
serviceAvailability.availability[]

object (Availability)

Yeni müsaitlik listesi.

Yanıt metni

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

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

Bunun uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde
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.

Yetkilendirme kapsamları

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

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