REST Resource: inventory.partners.merchants.services.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)
}

string (Timestamp format)

Toplantı aralığının başlangıç zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Toplantı aralığının süresi

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

string (int64 format)

Bu müsaitlik durumundaki toplam yer sayısı ve boş yer sayısı. Örnekler:

• 10 kişilik yoga dersi ve 3 rezervasyonu: availability {spotsTotal: 10, spotsOpen: 7 ...}
• Rezervasyonu tamamlanmış koltuk masajı oturumu: availability {spotsTotal: 1, spotsOpen: 0 ...}

Not: İstekler aşağıda tanımlanan müsaitlik durumu sıkıştırma biçimini kullanarak gönderiliyorsa bu iki alana çıkarım yapılır.

• Yinelenme, spotsTotal=1 ve spotsOpen=1 anlamına gelir.
• ScheduleException, spotsTotal=1 ve spotsOpen=0 anlamına gelir.

string (int64 format)

Boş yer sayısı.

string

Bu kullanılabilirlik alanını tanımlamak için kullanılan isteğe bağlı opak bir dize. Ayarlanırsa randevu alma/güncelleme/iptal etme isteklerine dahil edilir.

object (Resources)

Hizmetin bir parçası olan farklı personel veya odalar olduğunda, bu müsaitlik durumu alanını diğerlerinden netleştirmek için kullanılan isteğe bağlı kaynaklar.

Ör. iki 2 eğitmenden oluşan aynı Yoga dersinde:

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

Bu slot için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerini referans alan kimliklerin listesi. Gerçek ödeme seçenekleri Satıcı düzeyinde tanımlanır ve birden fazla Satıcı arasında da paylaşılabilir.

Bu alan, hizmet mesajında belirtilen tüm payment_option_ids'yi geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_id'lerin hizmet mesajında bulunması GEREKMEZ, ancak Satıcı düzeyinde tanımlanmalıdır.

object (Recurrence)

Müsaitlik durumu için, birden fazla başlangıç zamanını temsil eden yineleme bilgileri. Yinelenme, bir iş gününe ait randevuları içermelidir.

object (ScheduleException)

Bu hizmetin programlanamayacağı zamanlar. ScheduleException mesajlarının sayısını sınırlandırmak için bitişik istisnalara katılmayı deneyin.

object (Deposit)

Bu müsaitlik durumu için isteğe bağlı ödeme. Hizmet ödemesi belirtilmişse geçersiz kılınır.

object (NoShowFee)

Bu müsaitlik durumu için isteğe bağlı, rezervasyonu kullanmama ücreti alınır. Hizmetin gösterilmeme ücreti belirtilmişse geçersiz kılınır.

enum (RequireCreditCard)

Kullanıcının bu müsaitlik durumu aralığını rezerve edebilmesi için bir kredi kartı sağlamasının gerekip gerekmediğini belirtir. Değer ayarlanmazsa ayarlanmaları hizmet düzeyinden devralınır. (isteğe bağlı)

string

Bu müsaitlik durumu aralığı için desteklenen bilet türlerinin listesini gösterir. Politika ayarlanmazsa bu alan için üst hizmetteki tüm bilet türleri kullanılabilir. Bu alanın değerlerinin üst hizmette tanımlanması gerektiğini unutmayın. Örnekler:

• Dört bilet türünde hizmet: TicketType {ticketTypeId: "adult_1" shortDescription: "Yetişkin hafta içi"} TicketType {ticketTypeId: "adult_2" shortDescription: "Yetişkin hafta sonları"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Gençlerin hafta sonları"}

Hafta içi günlerde envanteri temsil etmek için: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. Tatil dönemlerinde envanteri temsil etmek için: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}.

• Üç bilet türünde hizmet: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "genç" ShortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Kıdemli"}

Bu zaman aralığında üç bilet türünün de uygun olduğunu belirtmek için availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} veya "availability {...}" öğesini kullanın. (bu alanda TicketTypeId değerini ayarlamayın).

(isteğe bağlı)

enum (DurationRequirement)

Zaman aralığı süresini ve/veya bitiş zamanını gösterme koşulu. Alan kullanılamıyorsa bu alan yoksayılır. Yapılacaklar sektöründe kullanılmaz. (isteğe bağlı)

object (SchedulingRuleOverrides)

Müsaitlik durumu planlama kuralları. Alanlar doldurulursa hizmet düzeyindeki SchedulingRules ile ilgili tüm planlama kurallarını geçersiz kılar.

enum (ConfirmationMode)

Bu müsaitlik durumu için rezervasyon yapılırken kullanılacak onay modu. CONFIRMATION_MODE_SYNCHRONOUS onay moduyla müsaitlik durumu için rezervasyon oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. CONFIRMATION_MODE_ASYNCHRONOUS onay moduyla müsaitlik durumu için rezervasyon oluşturma girişimleri hemen reddedilmeli ya da BEKLEMEDE durumuyla oluşturulmalıdır.

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer
}

string

Hizmeti sağlayan personel için isteğe bağlı kimlik. Bu alan tüm satıcılar, hizmetler ve stok durumu kayıtlarında personeli tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurulmasını sağlamak için zaman içinde istikrarlı olmalıdır. PersonelAdı varsa bu alan da mevcut olmalıdır.

string

Hizmeti sağlayan personelin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine insan tarafından okunabilir olmalıdır. Personel kimliği varsa bu alan da mevcut olmalıdır.

string

Hizmetin bulunduğu odanın isteğe bağlı kimliği. Bu alan tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında odayı tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurulmasını sağlamak için zaman içinde istikrarlı olmalıdır. RoomName varsa bu alan da bulunmalıdır.

string

Hizmetin bulunduğu odanın isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine insan tarafından okunabilir olmalıdır. (isteğe bağlıdır ancak oda kimliği mevcutsa zorunludur) Yemekte oda adı yalnızca bar ya da veranda gibi oturma alanları için kullanılmalıdır. Sabit fiyatlı menüler, özel etkinlikler veya oda harici başka değerler (rezervasyon veya akşam yemeği gibi) için kullanılmamalıdır. Varsayılan oturma alanıyla ilişkilendirilmiş bir oda olmaması önemle tavsiye edilir.

integer

Yalnızca Yemek için geçerlidir: Bu zaman aralığı boyunca konaklayabilecek kişi sayısı. Bir restoran, aynı anda birden fazla Slot ile ilişkilendirilebilir. Bu Slotların her biri farklı bir parti Boyutu belirtir (örneğin, rezervasyonda 2, 3 veya 4 kişi oturabiliyorsa).

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

Müsaitlik durumunun ne kadar tekrarlanacağını içeren maksimum UTC zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Art arda gelen kullanılabilirlik aralıkları arasındaki süreyi tanımlar.

Örnek: 20 dakika süreli kullanılabilirlik, 30 dakikada bir tekrarlama 30 dakika, startTime 09:00'a kadar ve 11:00'a kadar uzatma durumu; 09:00 - 9:20, 09:30-09:50, 10:00-10:20, 10:30-10:50 arası zaman aralıkları oluşturur. (gerekli)

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

Özel durumun zaman aralığı. Yinelenme tarafından tanımlanan, bu kapalı zaman aralığıyla çakışan tüm alanlar kullanılamaz olarak kabul edilir.

Örnek: Yineleme 20 dakika, 30 dakika tekrarlama 30 dakika, startTime 09:00 ve tekrarKalma sıklığı 11:00 olarak belirtiliyorsa zaman aralığı 09:45 - 11:00 (zaman aralığı) olan bir ScheduleException, 09:30-09:50, 01:30-09:50 saatleri arasında alanları kullanılamaz hale getirir.

Zaman aralığı kapalı ve açık olduğundan 11:00'de başlayan zaman aralığı bu durumdan etkilenmez.

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

Bu zaman aralığının en son rezerve edilebileceği son zaman (saniye cinsinden). Bu zaman damgası, dikkate alınması gereken alanın startSec'inden önce olmalıdır (kullanıcıların başlangıç zamanından sonra rezervasyon yapabilmesi gerekiyorsa hizmet düzeyinde SchedulingRules.min_booking_before_end_time'ı). Mevcut olduğunda ilgili Hizmetin SchedulingRules'un min_booking_buffer bölümünde belirtilen her şeyi geçersiz kılar.

string (int64 format)

Bu zaman aralığı ilk kez (saniye cinsinden) rezerve edilebilir. Bu zaman damgası, alanın startSec'inden veya belirtilmişse lastBookableSec'ten önce olmalıdır.

string (int64 format)

Ayarlanırsa bu randevu aralığının Google ile Rezervasyon üzerinden iptal edilebileceği son zaman (Unex epoch'tan bu yana saniye cinsinden). Bu alan, hizmet düzeyindeki tüm iptal kurallarını geçersiz kılar. (isteğe bağlı)