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

string (Timestamp format)

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

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

string (Duration format)

Randevu aralığının süresi

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

string (int64 format)

Bu müsaitlik durumunun toplam yer sayısı ve açık yer sayısı. Örnekler:

• 3 rezervasyon yapılmış 10 kişilik yoga dersi: availability {spotsTotal: 10, spotsOpen: 7 ...}
• Dolu olan koltuk masajı seansı: availability {spotsTotal: 1, spotsOpen: 0 ...}

Not: Aşağıda tanımlanan müsaitlik durumu sıkıştırma biçimini kullanarak istek gönderirseniz bu iki alan çıkarılır.

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

string (int64 format)

Açık park yeri sayısı.

string

Bu müsaitlik durumu aralığını tanımlayan isteğe bağlı opak bir dize. Ayarlanırsa randevu alma/güncelleme/iptal etme isteklerine dahil edilir.

object (Resources)

Farklı personel veya odalar hizmetin bir parçası olduğunda bu müsaitlik durumu aralığının diğerlerinden ayırt edilmesi için kullanılan isteğe bağlı kaynaklar.

Örneğin, iki eğitmenle aynı yoga sınıfı:

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çeneklerine atıfta bulunan kimliklerin listesi. Gerçek ödeme seçenekleri satıcı düzeyinde tanımlanır ve birden fazla satıcı arasında paylaşılabilir.

Bu alan, hizmet mesajında belirtilen tüm payment_option_ids değerlerini geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_ids parametresinin hizmet mesajında bulunması gerekmez ancak Satıcı düzeyinde tanımlanması gerekir.

object (Recurrence)

Birden fazla başlangıç saatini temsil eden müsaitlik durumu için yineleme bilgileri. Tekrarlanan bir toplantı, bir iş günü için randevular içermelidir.

object (ScheduleException)

Bu hizmetin planlanamaması scheduleException mesajlarının sayısını sınırlamak için bitişik istisnaları birleştirebilirsiniz.

object (Deposit)

Bu müsaitlik durumu için isteğe bağlı teminat. Belirtilmişse hizmet depozitosunu geçersiz kılar.

object (NoShowFee)

Bu müsaitlik durumu için isteğe bağlı olarak uygulanan, rezervasyonun kullanılmaması durumunda ödenmesi gereken ücret. Belirtilmişse hizmetin randevuya gelmemesi ücretini geçersiz kılar.

object (Prepayment)

İsteğe bağlı. Bu müsaitlik durumu için isteğe bağlı ön ödeme bilgileri.

enum (RequireCreditCard)

Kullanıcının bu müsaitlik durumu aralığını rezerve etmek için kredi kartı sağlaması gerekip gerekmediğini belirtir. Değer ayarlanmazsa hizmet düzeyinde ayarlanmışsa 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. Ayarlanmamışsa bu slot 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üne sahip hizmet: TicketType {ticketTypeId: "adult_1" shortDescription: "Yetişkin hafta içi"} TicketType {ticketTypeId: "adult_2" shortDescription: "Yetişkin hafta sonu"} TicketType {ticketTypeId: "youth_1" shortDescription: "Çocuk hafta içi"} TicketType {ticketTypeId: "youth_2" shortDescription: "Çocuk hafta sonu"}

Hafta içi envanteri temsil etmek için: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. Tatil sezonunda envanteri temsil etmek için: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}.

• Üç bilet türüne sahip hizmet: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

Bu zaman aralığı için üç bilet türünün de mevcut olduğunu belirtmek üzere availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} veya "availability {...}" değerini kullanın (bu aralıkta ticketTypeId değerini ayarlamayın).

(isteğe bağlı)

enum (DurationRequirement)

Açılış ve/veya bitiş zamanını gösterme şartı. Alan kullanılamıyorsa bu alan yoksayılır. Yapılacaklar alanında kullanılmaz. (isteğe bağlı)

object (SchedulingRuleOverrides)

Kullanılabilirlik planlama kuralları. Alanlar doldurulursa hizmet düzeyindeki SchedulingRules'da ilgili tüm planlama kuralları geçersiz kılınır.

enum (ConfirmationMode)

Bu müsaitlik durumu için rezervasyon yapılırken kullanılacak onay modu. ONAY_MODU_SYNCHRONOUS onay modu olan müsaitlik durumu rezervasyonu oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. ONAY_MODU_ASYNCHRONOUS onay modu olan müsaitlik durumları için rezervasyon oluşturma girişimleri hemen reddedilmelidir veya BEKLEMEDE durumuyla oluşturulmalıdır.

enum (LinkoutRequiredReason)

İsteğe bağlı. Bu slot için bağlantı çıkışının gerekli olmasının nedeni. Ayarlandıysa bu yuvanın Satıcı kaynağında geçerli bir LinkoutTemplate olmalıdır. (isteğe bağlı)

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

string

Hizmeti veren personel için isteğe bağlı kimlik. Bu alan, tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında personel üyesini tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirilebilmesi için zaman içinde sabit kalmalıdır. staffName alanı varsa bu alan da mevcut olmalıdır.

string

Hizmeti sunan personel üyesinin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve şeffaf olmayan bir tanımlayıcı yerine kullanıcı tarafından okunabilir olmalıdır. staffId mevcutsa bu alan da mevcut olmalıdır.

string

Hizmetin bulunduğu oda için isteğe bağlı bir kimlik. Bu alan, tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında odayı tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirilebilmesi için zaman içinde sabit kalmalıdır. roomName alanı varsa bu alan da bulunmalıdır.

string

Hizmetin bulunduğu oda için isteğe bağlı bir ad. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve şeffaf olmayan bir tanımlayıcı yerine kullanıcı tarafından okunabilir olmalıdır. (isteğe bağlı ancak roomId varsa zorunludur) Yemek alanında oda adı yalnızca bar veya veranda gibi oturma alanları için kullanılmalıdır ve sabit fiyatlı menüler, özel etkinlikler veya oda dışındaki diğer değerler (ör. rezervasyon veya akşam yemeği) için kullanılmamalıdır. Varsayılan oturma alanının ilişkili bir odası olmaması önemle tavsiye edilir.

integer

Yalnızca Yemek için geçerli: Bu zaman aralığında kabul edilebilecek grup boyutu. Bir restoran, aynı zaman için birden fazla Bölüm ile ilişkilendirilebilir. Örneğin, rezervasyonla 2, 3 veya 4 kişi oturabiliyorsa her biri farklı bir grup boyutu belirtir.

object (Text)

İsteğe bağlı. Yerelleştirilmiş oda açıklaması. Ayarlanırsa varsayılan bir değer sağlanmalıdır. Satıcının yerel ayarı için yaygın dillerin de sağlanması tercih edilir. (isteğe bağlı)

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

string (Timestamp format)

Kullanılabilirliğin tekrarlandığı en son UTC zaman damgası.

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

string (Duration format)

Art arda gelen müsaitlik durumu aralıkları arasındaki süreyi tanımlar.

Örnek: 20 dakikalık bir süre, 30 dakikalık bir tekrar aralığı, 9:00'da başlayan bir başlangıç zamanı ve 11:00'de biten bir tekrar süresi olan bir bilgi dokümanı, 9:00-9:20, 9:30-9:50, 10:00-10:20, 10:30-10:50, 11:00-11:20 saatlerinde aralık oluşturur. (gerekli)

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

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

object (TimeRange)

İstisnanın zaman aralığı. Yineleme tarafından açıklanan ve bu kapalı-açık zaman aralığıyla çakşan tüm aralıklar kullanılamaz olarak kabul edilir.

Örnek: Yineleme için 20 dakikalık bir süre, 30 dakikalık bir tekrar aralığı, 9:00'da bir başlangıç zamanı ve 11:00'de bir tekrar bitiş zamanı belirtilmişse 9:45-11:00 zaman aralığına sahip bir ScheduleException, 9:30-9:50, 10:00-10:20 ve 10:30-10:50 arasındaki zaman aralıklarını kullanılamaz hale getirir.

Zaman aralığı kapalı-açık olduğu için 11:00'de başlayan yuvanın etkilenmeyeceğini unutmayın.

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

Fiyat ayrıntıları kapsayıcısı.

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

Fiyatın veya fiyat aralığının nasıl uygulanacağını (kişi başına veya sabit) tanımlar

object (Price)

Bir hizmetin fiyatı veya ücreti.

object (PriceRange)

Bir hizmetin veya ücretin üst ve/veya alt sınırı.

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

Minimum tutar.

object (Price)

Maksimum tutar. Her zaman minPrice değerinden büyük olmalıdır.

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

string (int64 format)

Bu zaman aralığının rezerve edilebildiği son zaman (saniye cinsinden). Bu zaman damgasının, dikkate alınması için zaman aralığının startSec değerinden önce olması gerekir (Kullanıcıların başlangıç zamanından sonra rezervasyon yapabilmesi gerekiyorsa hizmet düzeyinde SchedulingRules.min_booking_before_end_time değerini kullanın). Varsa ilgili Hizmet'in SchedulingRules özelliğinin min_booking_buffer alanında belirtilen her şeyi geçersiz kılar.

string (int64 format)

Bu zaman aralığının rezerve edilebildiği ilk zaman (saniye cinsinden). Bu zaman damgası, alanın startSec değerinden veya belirtilmişse lastBookableSec değerinden önce olmalıdır.

string (int64 format)

Ayarlanırsa bu randevu aralığının Google ile Rezervasyon üzerinden iptal edilebileceği son zaman (Unix başlangıç zamanından itibaren saniye cinsinden). Bu alan, hizmet düzeyinde iptal kurallarını geçersiz kılar. (isteğe bağlı)