REST Resource: inventory.partners.merchants.services

Kaynak: Hizmet

Satıcı tarafından sağlanan bir hizmetle ilgili bilgiler (ör. saç kesimi).

JSON gösterimi 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Alanlar
name

string

partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde olan hizmet kaynağı adı.
serviceName

string

Hizmetin adı (ör. "Erkek saç kesimi"). Desteği sonlandırıldı. Bunun yerine localizedServiceName kullanın.
localizedServiceName

object (Text)

Hizmetin adı (ör. "Erkek saç kesimi"). Muhtemelen birkaç yerel ayarda.
description

string

Hizmetin kullanıcı tarafından görülebilen açıklaması. Desteği sonlandırıldı. Bunun yerine localizedDescription kullanın.
localizedDescription

object (Text)

Hizmetin kullanıcı tarafından görülebilen açıklaması.

Bu alan hem düz metin hem de HTML benzeri biçimlendirmeyi destekler. Düz metin bölümlerinin aksine, burada başlıklar, paragraflar, listeler ve bazı ifade etiketleri kullanılarak özelleştirilmiş düzenler oluşturulabilir. En iyi kullanıcı deneyimini oluşturmak için lütfen aşağıdaki talimatları ve notları dikkatlice okuyun.

Desteklenen HTML benzeri biçimlendirme etiketleri:

Başlık etiketleri: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Başlık etiketleri, başlıkları ve alt başlıkları göstermek için kullanılabilir. Örneğin, <h1>Seyahat Planı</h1> satır içi metni bölümün en önemli başlığı olarak gösterir. Tüm iç HTML etiketlerinin, stillerin veya özelliklerin yoksayılacağını unutmayın. Örneğin, <h1 style=".."> ile <h1> aynı şekilde değerlendirilir. Yalnızca düz metin korunur.

Paragraf etiketi: <p>
Paragraf etiketi, ayrıntılı bir giriş veya içeriği vurgulamak için kullanılabilir. <br>, <strong> ve <em> etiketleri hariç olmak üzere tüm iç etiketler, stiller veya özellikler yoksayılır. Daha fazla bilgi için lütfen aşağıdaki ifade etiketi bölümüne bakın.

Liste etiketleri: <ul>, <ol>, <li>
<ul> etiketi, sırasız listeleri göstermek için <li> etiketiyle, <ol> etiketi ise sıralı listeleri göstermek için <li> etiketiyle kullanılabilir. Bu, yapılacaklar listelerini, programları veya kullanım alanlarınıza uygun diğer listeleri görüntülemek için iyi bir yöntemdir.
Örnek: Bir gemi gezisinin özelliklerinin listesini göstermek için:
<ol>
<li>Muhteşem okyanus manzarası ve vahşi yaşamla etkileşim kurma fırsatı.</li>
<li>Özenle tasarlanmış seyahat düzenlemeleri ve hizmetleri.</li>
<li>En düşük fiyat garantisi.</li>
</ol>
Yalnızca <li> öğelerinin <ul> veya <ol> etiketleri dönüştürülecektir. Diğer tüm alt öğeler bırakılır. Ayrıca, tüm iç etiketler, özellikler ve stiller yoksayılır. Yalnızca düz metin içerikleri korunur.

Bölüm etiketi: <div>
<div> etiketinin desteklenen tüm iç etiketleri yukarıda belirtilen kurallarla ayrıştırılır. Bu, <div> etiketinin kendisinin burada herhangi bir gruplandırma veya girintileme anlamına gelmediği anlamına gelir. Ayrıca, tüm iç özellikler ve stiller yoksayılır.

İfade etiketleri: <br>, <strong>, <em>:
Yalnızca yukarıda belirtilen üç etiket desteklenir. <br> paragraflarda satırları bölmek için, <strong>/<em> ise önemli metinleri vurgulamak için kullanılabilir. Diğer tüm ifade etiketleri yoksayılır.

Desteklenmeyen etiketler:

  • <html>, <header> ve <body> etiketlerine izin verilmez.
  • Yukarıda belirtilmeyen diğer etiketler desteklenmez (ör. <table>, <td> ...).
    Tüm URL'ler, bağlantılar ve bağlantılar kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez. Fotoğrafları kullanarak zengin bir kullanıcı deneyimi oluşturmak istiyorsanız lütfen fotoğraf URL'lerinizi göndermek için aşağıdaki "relatedMedia" alanını kullanın.

Önemli notlar:

  • Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve bu durum istenmeyen bir kullanıcı deneyimine yol açabileceğinden, yukarıda belirtilen desteklenen etiketler dışında başka etiket kullanmamaya çalışın.
  • 3'ten fazla farklı başlık düzeyi veya iç içe geçmiş listeler gibi derin iç içe geçmiş yapılardan kaçınmaya çalışın. Yapıyı düz, basit ve anlaşılır tutmak daha iyi bir kullanıcı deneyimi oluşturmaya yardımcı olur.
  • Şu anda desteklenen düzenler kullanım alanlarınız için yeterli değilse lütfen Google ile Rezervasyon ekibiyle iletişime geçin.
  • Önerilen maksimum boyut 32.000 karakterdir.
price

object (Price)

Hizmetin fiyatı.
priceInterpretation

enum (PriceInterpretation)

Fiyatın nasıl yorumlandığını ve kullanıcıya nasıl gösterildiğini açıklar. Yemek ve Aktivite Önerileri hariç tüm sektörler tarafından hizmet fiyatının gösterimini yapılandırmak için kullanılabilir.
rules

object (SchedulingRules)

Randevu alma/iptal etme kuralları
prepaymentType

enum (PrepaymentType)

Ön ödemenin gerekli, isteğe bağlı veya desteklenmiyor olup olmadığı
prepaymentTerms

object (PrepaymentTerms)

Ön ödemenin ne zaman tamamlanacağıyla ilgili şartlar.
form[]
(deprecated)

object (ServiceIntakeForm)

Kullanımdan kaldırıldı. Lütfen intakeForm ve perTicketIntakeForm'u kullanın.
intakeForm

object (ServiceIntakeForm)

Kullanıcı bu hizmeti rezerve ettiğinde ek bilgi isteyen bir form. (isteğe bağlı)
perTicketIntakeForm

object (ServiceIntakeForm)

Kullanıcı bu hizmeti rezerve ettiğinde ek bilgi isteyen bir form. Bu form, kullanıcının rezervasyon yaptığı her bilet için bir kez doldurulmalıdır. (isteğe bağlı)
taxRate

object (TaxRate)

Hizmetin vergi oranı. Bu alan varsa satıcı düzeyinde ayarlanan tüm taxRate değerlerini geçersiz kılar. Boş bir mesaj (ör. taxRate { }) uygulanan vergi oranını sıfırlar.
paymentOptionId[]

string

Bu hizmet için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine referans veren kimliklerin listesi. Gerçek ödeme seçenekleri satıcı düzeyinde tanımlanır ve birden fazla satıcı arasında da paylaşılabilir.
deposit

object (Deposit)

Depozitonun kullanıcıdan nasıl alınabileceğini tanımlar. Belirtilmişse hizmet depozitosunu geçersiz kılar. Bu ayarı boş bir depozito mesajı olarak ayarlamak, hizmet düzeyindeki tüm depozitoları kaldırır. (isteğe bağlı)
noShowFee

object (NoShowFee)

Kullanıcıdan alınabilecek bir "gösterilmeme" ücreti tanımlar. Belirtilmişse hizmete gelinmeme ücretini geçersiz kılar. Bu ayarı boş bir NoShowFee mesajına ayarlamak, hizmet düzeyindeki tüm "gösterilmeme" ücretlerini kaldırır. (isteğe bağlı)
requireCreditCard

enum (RequireCreditCard)

Kullanıcının bu hizmeti rezerve etmek için kredi kartı sağlaması gerekip gerekmediğini gösterir. Bu alan, stok durumu düzeyinde geçersiz kılınabilir. (isteğe bağlı)
type

enum (ServiceType)

Bu hizmetin önceden tanımlanmış türü. (isteğe bağlı)
ticketType[]

object (TicketType)

Biletler destekleniyorsa bu hizmet için rezerve edilebilen/satın alınabilen bilet türleri. (isteğe bağlı)
relatedMedia[]

object (RelatedMedia)

Bu hizmetle ilgili fotoğraflar. Google, medyaların son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bunları tarar ve depolar. (isteğe bağlı)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

Bu hizmet için geçerli olan hizmet özelliği değerleri (isteğe bağlı). Her Hizmet, ilgili satıcıda tanımlanan her hizmet özelliği için sıfır veya daha fazla değere sahip olabilir. (isteğe bağlı)
waitlistRules

object (WaitlistRules)

Bekleme listesine katılma kuralları
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

Etkinlik bilet işlemleri dikeyine özgü ek bilgiler. (isteğe bağlı)
integrationType

enum (IntegrationType)

Bu hizmet için desteklediğimiz entegrasyon derinliği. (isteğe bağlı) Başlangıç entegrasyonuna sahip iş ortakları için geçerli değildir. Uçtan uca şifreleme, bu iş ortakları için her zaman devre dışı bırakılır.
perOrderFee

object (PerOrderFee)

Bu hizmetin satın alınmasıyla ilgili sipariş düzeyinde ücretler. (isteğe bağlı)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

Turlar ve Aktiviteler'e özgü içerik alanları.
location[]

object (Location)

Bu hizmetle ilgili konumlar. ÖNEMLİ NOTLAR: Bu hizmetle ilgili birden fazla ziyaret edilen konum varsa veya START_LOCATION, VISITED_LOCATION'dan farklıysa START_LOCATION belirtilmelidir. Örnek: Üç mekanı ziyaret eden rehberli bir bisiklet turu. Başlangıç mekanı belirtilmelidir. Bir otel lobisinde buluşup ziyaret edilen yere giden bir otobüs turu. Toplantı yeri belirtilmelidir.
rating

object (Rating)

Bu hizmetin tüm yorumlardaki toplu metriği olarak kullanıcı puanı.
homeServiceData

object (HomeServiceData)

Ev hizmetleri sektörüne özgü ek bilgiler. (isteğe bağlı)
virtualSession

object (VirtualSession)

İsteğe bağlı. Sanal oturum hakkında bilgiler. Sanal hizmetlerin etkinleştirilmesi için gereklidir.
directMerchantPayment

object (DirectMerchantPayment)

İsteğe bağlı. Hizmetin, kullanıcının doğrudan satıcıya ödeme yapmasını gerektirmesi durumunda eklenmesi gereken ek bilgiler. ÖNEMLİ NOT: RwG bu işleme dahil değildir. virtualSession tanımlanmışsa ve hizmet ücretsiz değilse veya prepaymentType REQUIRED olarak ayarlanmamışsa zorunludur.
uriTemplate

object (UriTemplate)

İsteğe bağlı. Google'ın harici site URL'lerini nasıl oluşturacağını belirten isteğe bağlı bir şablon.

PriceInterpretation

Bir fiyatın nasıl yorumlanması ve kullanıcıya nasıl gösterilmesi gerektiğini açıklar.

Sıralamalar
PRICE_INTERPRETATION_UNSPECIFIED Fiyat yorumu belirtilmedi, varsayılan olarak EXACT_AMOUNT kullanılır.
EXACT_AMOUNT

Fiyatın belirli bir değer olarak yorumlanması gerektiğinde kullanılır.

Örnekler: yoga dersi için 20 ABD doları, çocuk saç kesimi için 15 ABD doları
STARTS_AT

Bir hizmetin fiyatı değişken olduğunda ancak minimum fiyat bilindiğinde ve tüketicilere gösterildiğinde. Tüketiciler, fiyatı artıran seçimler yapabilir.

Bu PriceInterpretation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED'ı kullanması gerektiğini unutmayın.

Örnekler: Köpek bakımı için 30 ABD doları, ancak ek tüketici tercihleri fiyatı artırabilir.
NOT_DISPLAYED

Bir hizmetin fiyatı değişken olduğunda ve tüketicilere önceden fiyat bilgisi gösterilmediğinde.

Bu PriceInterpretation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED'ı kullanması ve Price'ın boş olması gerektiğini unutmayın.

Örnekler: Ev hizmeti için danışmanlık

SchedulingRules

Bir hizmetin planlama kuralları.

JSON gösterimi 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Alanlar
minAdvanceOnlineCanceling

string (int64 format)

Online olarak alınan bir randevunun iptal edilmesi için gereken minimum ön bildirim süresi (saniye cinsinden). (isteğe bağlı)
lateCancellationFee
(deprecated)

object (Price)

Minimum ön bildirim süresi içinde yapılan iptaller için alınan ücret.
noshowFee
(deprecated)

object (Price)

İptal etmeden rezervasyonu kullanmama ücreti.
admissionPolicy

enum (AdmissionPolicy)

Bu hizmet için geçerli olan kabul politikası. Ayarlanmamışsa varsayılan olarak TIME_STRICT olur. (isteğe bağlı)
cancellationPolicy

object (CancellationPolicy)

Planlama kuralları iptal politikası. (Yapılacaklar için zorunlu)

min_booking_buffer birleşik alanı. Son rezervasyonun yapılabileceği zamandan uygunluk aralığının başlayabileceği veya bitebileceği zamana kadar geçen süre (saniye cinsinden).

"min_advance_booking" ayarlanmışsa son rezervasyon yapılabilir zaman (<slot start time> - "min_advance_booking") olarak hesaplanır. "min_booking_buffer_before_end_time" ayarlanmışsa son rezerve edilebilir zaman (<slot end time> - "min_booking_buffer_before_end_time") olarak hesaplanır. "min_booking_buffer_before_end_time" değerinin ayarlanması durumunda pozitif olması gerektiğini unutmayın. Her ikisi de ayarlanmamışsa yuva, yuvanın başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanırsa yalnızca bir değer seçilir ve diğer değer yoksayılır. Hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz.

Örnekler:

  • Başlangıç saatinden en az 1 saat önce randevu alınması gereken bir saç kesimi. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Kapanmadan 30 dakika önce son biletin satın alınabileceği bir müze: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • Başlangıç saatinden önce satın alınması gereken bir sinema bileti. "scheduling_rules{ ...}" (bu alanı boş bırakın) (isteğe bağlı) min_booking_buffer aşağıdakilerden yalnızca biri olabilir:
minAdvanceBooking

string (int64 format)

Son rezervasyonun yapılabileceği zamandan uygunluk aralığının başlayacağı zamana kadar geçen süre (saniye cinsinden).
minBookingBufferBeforeEndTime

string (int64 format)

Son rezervasyonun yapılabileceği zamandan uygunluk aralığının sona ereceği zamana kadar geçen süre (saniye cinsinden). Bu alan ayarlanırsa kullanıcıların satın alınan biletleri zaman aralıkları başladıktan sonra kullanabileceğini belirtmek için "admissionPolicy" alanı TIME_FLEXIBLE olarak ayarlanmalıdır.

AdmissionPolicy

Bu hizmetin kabul politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmamış.
TIME_STRICT Müşterilerin, uygunluk aralığının başlangıç zamanında orada bulunması gerekir ve hizmetin, aralığın bitiş zamanında tamamlanması beklenir. TIME_STRICT kullanım alanlarına örnekler: * Saat 09:00'da başlayan, tüm katılımcıların başlangıç saatinde gelmesini gerektiren ve yaklaşık 12:00'de dönen bir tur. Cumartesi günü saat 15:00'te yaklaşık 30 dakika sürecek bir saç kesimi randevusu. * 18:00-20:00 arası fitness dersi
TIME_FLEXIBLE

Müşteriler, bu rezervasyonu kullanmak için uygunluk aralığının başlangıç ve bitiş zamanı arasında herhangi bir zamanda gelebilir.

TIME_FLEXIBLE kullanım alanlarına örnekler: * Satın alma tarihinde herhangi bir zamanda kullanılabilen müze bileti. * Öğleden sonra 12:00-21:00 saatleri arasında kullanılabilecek bir eğlence parkı girişi
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Müşterilerin, uygunluk aralığının başlangıç saatinde satıcıya ulaşması gerekir ancak istedikleri zaman ayrılabilirler.

Örneğin, müze giriş senaryosunda, saat 10:00 için zamanlı giriş bileti olan kullanıcının saat 10:00'da müzede olması gerekir. Bu hizmet için uygunluk aralıklarının başlangıç zamanı, belirlenen giriş zamanını gösterir. Ancak bitiş saati yalnızca rezervasyon için uygunluk aralığını tanımlamak üzere anahtar olarak kullanılır.

CancellationPolicy

Bir hizmetin iptal politikası.

JSON gösterimi 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
Alanlar
refundCondition[]

object (RefundCondition)

Politika için geçerli olan sıfır veya daha fazla geri ödeme koşulu.

RefundCondition

Tek bir geri ödeme koşulu tanımlar. "Geri ödeme adımlarını" hizmetin başlangıç zamanından önceki çeşitli süreler olarak tanımlamak için birden fazla geri ödeme koşulu birlikte kullanılabilir.

JSON gösterimi 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Alanlar
minDurationBeforeStartTime

string (Duration format)

Başlangıç zamanından önceki süre. Müşteri, refundPercent içinde belirtilen hizmet maliyetinin bir kısmı için bu süre içinde geri ödeme alabilir. 0 (varsayılan) olarak ayarlandığında hizmet istediğiniz zaman iptal edilebilir.

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

integer (uint32 format)

Hizmet rezervasyonu, hizmetin başlangıç saatinden en az minDurationBeforeStartTime önce iptal edildiği sürece geri ödenebilecek yüzde. [0, 100] aralığında olmalıdır. 0 (varsayılan) olarak ayarlandığında hizmet için geri ödeme yapılmaz. %100 olarak ayarlandığında bu hizmetin ücreti tamamen iade edilir.

PrepaymentType

Ön ödeme türünü belirten enum.

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak, ön ödemenin NOT_SUPPORTED (desteklenmiyor) olduğu varsayılır.
REQUIRED Kullanıcı, bu hizmetin ödemesini rezervasyon sırasında yapmalıdır.
OPTIONAL Kullanıcı, bu hizmet için rezervasyon sırasında veya daha sonra ön ödeme yapmayı seçebilir ancak rezervasyon yapmak için ön ödeme yapması gerekmez.
NOT_SUPPORTED Bu hizmet için ön ödeme desteklenmiyor.

PrepaymentTerms

Ön ödemenin ne zaman tamamlandığıyla ilgili ayrıntılı bilgi.

JSON gösterimi 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Alanlar
chargeTiming

enum (ChargeTiming)

Ücretin, satın alma zamanına göre ne zaman alınacağı.
chargeTimeBeforeStartTimeSec

string (int64 format)

Kullanıcının ödeme için ücretlendirildiği, hizmetin başlangıç zamanından önceki süre (saniye cinsinden). Bu alan yalnızca ChargeTiming CHARGE_LATER olduğunda ayarlanmalıdır.

ChargeTiming

Ücretin, satın alma zamanına göre ne zaman alınacağını belirten enum.

Sıralamalar
CHARGE_TIMING_UNSPECIFIED Kullanılmamış.
CHARGE_NOW Müşteriden hemen ödeme alınır.
CHARGE_LATER Müşteriden daha sonra ödeme alınacak.

ServiceIntakeForm

Satıcı tarafından sağlanan hizmeti özelleştiren bir giriş formu tanımlar.

JSON gösterimi 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Alanlar
field[]

object (ServiceIntakeFormField)

Kullanıcıya gösterilecek alanlar.
firstTimeCustomers
(deprecated)

boolean

Doğruysa bu form, ilk kez alışveriş yapan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.
returningCustomers
(deprecated)

boolean

True (doğru) ise bu form, tekrar eden müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

ServiceIntakeFormField

ServiceIntakeForm'da bulunan bir alanı tanımlar.

JSON gösterimi 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Alanlar
id

string

Bir form alanını benzersiz şekilde tanımlayan, toplayıcı iş ortağından alınan bir dize. Bu kimlik, ilgili form alanı yanıtındaki kimlikle aynı olmalı ve hem hizmet düzeyinde hem de her bilet alımı formunda benzersiz olmalıdır. (gerekli)
type

enum (FieldType)

Bu alanın türü.
label

string

Bu alan için kullanıcıya gösterilen metin. Kullanımdan kaldırıldı. Lütfen bunun yerine localizedLabel kullanın.
localizedLabel

object (Text)

Bu alan için kullanıcıya gösterilen metin. Alan, birden fazla yerel ayarda sağlanabilir. (gerekli)
value[]

string

Yalnızca alan türü LOCATION_SEARCH ise ayarlayın. Konum değerini belirtmek için lütfen "konum" alanındaki "locationId"yi kullanın.
choiceText[]

object (Text)

Yalnızca alan türü MULTIPLE_CHOICE, CHECKBOXES veya DROPDOWN ise ayarlayın. Olası seçenekleri listelemek için kullanılır.
isRequired

boolean

Bu alana yanıt verilmesinin kullanıcı tarafından zorunlu olup olmadığını gösterir.
allowCustomAnswer

boolean

Önceden tanımlanmış yanıtlara ek olarak özel bir değere izin verilip verilmediğini gösterir. Bu yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. (isteğe bağlı)
additionalOption[]

object (Text)

Belirtilen değerlere ek olarak sunulan ek seçenekler. Yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. Örneğin, sağlanan konum listesine ek olarak "Tedarikçiyle daha sonra iletişime geçeceğim" seçeneği de kullanılabilir. (isteğe bağlı)
ticketTypeRestrict[]

string

Bu soru yalnızca kullanıcı belirli bilet türlerini rezerve ettiğinde gösterilecekse bu alan, geçerli bilet türü kimlikleri kümesi olarak ayarlanmalıdır. Soru her zaman geçerliyse alanı boş bırakın.
hint

object (Text)

Giriş için ipucu metni, metin yer tutucusu olarak gösterilir. Bu yalnızca alan türü SHORT_ANSWER veya PARAGRAPH olduğunda geçerlidir. (isteğe bağlı)

FieldType

Alan türünü belirten enum.

Sıralamalar
FIELD_TYPE_UNSPECIFIED Belirtilmemiş veya bilinmeyen türdeki alanlar yoksayılır.
SHORT_ANSWER Metin için tek satırlık giriş alanı.
PARAGRAPH Metin için çok satırlı bir giriş alanı.
MULTIPLE_CHOICE Birçok seçenek arasından bir seçim yapılması gereken bir grup radyo düğmesi.
CHECKBOXES Onay kutularıyla birlikte bir veya daha fazla numaralandırılmış öğe.
DROPDOWN Açılır listeden yapılan seçim.
BOOLEAN Evet/hayır düğmesi.

ServiceType

Önceden tanımlanmış hizmet türleri.

Sıralamalar
SERVICE_TYPE_UNSPECIFIED Kullanılmamış.
SERVICE_TYPE_DINING_RESERVATION Yemek rezervasyonu
SERVICE_TYPE_FOOD_ORDERING Yemek siparişi (adrese teslimat, paket servis veya her ikisi de olabilir)
SERVICE_TYPE_FOOD_DELIVERY Yemek teslimatı
SERVICE_TYPE_FOOD_TAKEOUT Paket yemek servisi
SERVICE_TYPE_EVENT_TICKET Etkinlik bileti.
SERVICE_TYPE_TRIP_TOUR Gezi turu.
SERVICE_TYPE_APPOINTMENT Randevu veya ders hizmeti sunan işletmeler. (1) Sağlık ve fitness, (2) spa ve güzellik, (3) finansal danışmanlık ve değerlendirme hizmetleri için önerilir. Lütfen desteklenen hizmet türlerine bakın: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Tamamen sanal olarak gerçekleştirilecek bir sınıf veya oturum için online randevu hizmeti sunulmalıdır. Sanal hizmet rezervasyonları etkinleştiriliyorsa ayarlanmalıdır.
SERVICE_TYPE_SHOPPING Kullanıcıların belirtilen satıcıdan alışveriş yapmasına olanak tanıyan hizmet. Teslimat veya teslim alma olabilir.

TicketType

TicketType, farklı kullanıcı türleri, farklı hizmet özellikleri veya farklı seçenekler/eklentiler nedeniyle farklı fiyatlara ve/veya stok durumlarına sahip biletler arasında ayrım yapmak için kullanılır.

Bilet, bir hizmet için rezerve edilebilen en küçük birimdir. Örneğin, rafting gezisinde bir yer, müzeye giriş, tam gün çift kişilik kano kiralama.

JSON gösterimi 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Alanlar
ticketTypeId

string

Bilet kimliği, aynı hizmetin farklı bilet türlerini ayırt etmek için kullanılır ve yalnızca hizmet içinde benzersiz olması beklenir.
shortDescription

string

Bu TicketType için kısa bir açıklama.

Bu, kullanıcı tarafından görülebilir (ör. "yetişkin", "çocuk", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Desteği sonlandırıldı. Bunun yerine localizedShortDescription özelliğini kullanın.
localizedShortDescription

object (Text)

Bu TicketType'ın kısa bir açıklaması (uluslararasılaştırma desteğiyle).

Bu, kullanıcı tarafından görülebilir (ör. "yetişkin", "çocuk", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Her yerel ayar için ayrı değerler sağlanabilir.
price

object (Price)

Bu türdeki tek bir biletin, vergiler hariç fiyatı. Hizmetin vergi oranı, biletlerine uygulanır.
perTicketFee

object (PerTicketFee)

Bu bileti satın almak için ek ücretler. (isteğe bağlı)
priceDisplayType

enum (PriceDisplayType)

İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş fiyat gösterimi türü.
optionDescription

string

Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Desteği sonlandırıldı. Bunun yerine localizedOptionDescription kullanın.
localizedOptionDescription

object (Text)

Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Her yerel ayar için ayrı değerler sağlanabilir.

Bilet türü birden fazla boyutu temsil ettiğinde ek seçenekler kullanışlıdır.

1. örnek: Farklı türlere ("yetişkin", "çocuk") sahip bir giriş bileti ve ek seçenek olarak dil. Beklenen TicketType listesi şu şekilde olur: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

2. örnek: İsteğe bağlı kuru çanta eklentisiyle çok saatlik kano kiralama. shortDescription "3 saat" olabilir ve optionDescription "kuru çanta ile" veya "kuru çanta olmadan" olabilir: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } }

İsteğe bağlıdır ancak hizmetteki herhangi bir bilet türünde bu alan ayarlanmışsa diğer tüm bilet türlerinde de bu alanın ayarlanmasını bekleriz (varsayılan bir optionDescription kullanılabilir). Örneğin, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] geçerli bir liste değildir.

Yalnızca iki HTML biçimlendirme etiketi desteklenir: ve
. Bu seçenekler, hem başlık hem de ayrıntılı açıklama içeren seçenekleri belirtmek için kullanılır. Örneğin: "Premium Koltuk
Bu seçenek, tamamen yastıklı koltuklar, özel TV'ler, koltukta yiyecek ve içecek servisi gibi özelliklerin bulunduğu özel localarda koltuk sunar. Bu koltuklardan saha manzarası çok güzel."
inventoryType

enum (InventoryType)

İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş envanter türü.

PerTicketFee

Kullanıcının satın aldığı her bilet için ödenmesi gereken ücretler.

JSON gösterimi 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Alanlar
serviceCharge

object (Price)

Bir hizmet için alınan ek ücret.
facilityFee

object (Price)

Mekana/tesise ödenen bir ücrettir.
taxes

object (Price)

Bilet başına vergiler.

PriceDisplayType

Açılış sayfasında gösterilen fiyat biçimini belirtir.

Bu alan, bağlantı içermeyen envanter için yoksayılır.

Bu alan, Google platformlarının açılış sayfası tarafından kullanılan fiyat biçimini göstermesine olanak tanır. Tutarlı fiyat biçimleri, dönüşüm oranını artırır ve kafa karışıklığını azaltır.

Sıralamalar
PRICE_DISPLAY_TYPE_UNSPECIFIED Fiyat görüntüleme türü belirtilmemiş. Google, hangi biçimin gösterileceğine karar verir.
PRICE_DISPLAY_TYPE_BASE Açılış sayfasında gösterilen fiyat, taban fiyattır.
PRICE_DISPLAY_TYPE_ALL_IN Açılış sayfasında gösterilen fiyata tüm ücretler ve vergiler dahildir.

InventoryType

Bu türdeki tek bir biletin önceden belirlenmiş envanter türü.

Sıralamalar
INVENTORY_TYPE_UNSPECIFIED Envanter türü belirtilmedi.
INVENTORY_TYPE_PRIMARY Birincil envanter.
INVENTORY_TYPE_VERIFIED_RESALE Doğrulanmış yeniden satış envanteri.
INVENTORY_TYPE_RESALE Yeniden satış envanteri.
INVENTORY_TYPE_AGGREGATOR Toplayıcı envanteri. Toplayıcı (ör. www.bandsintown.com), iş ortağının etkinlik ve bilet bilgileri sağladığı anlamına gelir. Ancak biletler doğrudan iş ortağı tarafından satılmaz. Gerçek bilet satıcısı birincil, doğrulanmış yeniden satış veya yeniden satış olabilir. Artık yalnızca üst düzey iş ortağı envanter türü ayırt ediliyor ve bir toplayıcıdaki gerçek bilet satıcısı envanter türü göz ardı ediliyor.

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, bu medyaları son kullanıcılara doğru şekilde gösterildiğinden emin olmak için tarar. (isteğe bağlı)

JSON gösterimi 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Alanlar
url

string

Bu medya kaynağının URL'si. Google, bu URL'de barındırılan medyayı tarar.
type

enum (MediaType)

Bu medya kaynağının türü.
localizedCaption

object (Text)

Uluslararasılaştırmayı destekleyen medyanın altyazısı. Yalnızca düz metin desteklenir. HTML bileşenleri kaldırılır. (isteğe bağlı)
attribution

object (Attribution)

Medyanın kaynağıyla ilgili ilişkilendirme bilgileri. Fotoğrafçıya veya ajansa atıfta bulunmak için ilişkilendirmenin medyayla birlikte gösterilmesi gerekiyorsa bu alanın ayarlanması gerektiğini unutmayın. (isteğe bağlı)
caption
(deprecated)

string

Desteği sonlandırıldı. Yerelleştirilmiş altyazı kullanılması tercih edilir.

MediaType

Bu medya kaynağının türünü belirten enum. Yalnızca fotoğraflar desteklenir. Fotoğrafların dışında başka medya türlerinin de desteklenmesi gerekiyorsa lütfen Google ile Rezervasyon ekibiyle iletişime geçin.

Sıralamalar
TYPE_UNSPECIFIED Kullanılmamış.
PHOTO URL tarafından sağlanan medyanın fotoğraf olduğunu gösterir.

İlişkilendirme

Bu medya için atıf bilgileri.

JSON gösterimi 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
Alanlar
localizedText

object (Text)

Uluslararasılaştırmayı destekleyen fotoğrafçıya veya ajansa atıfta bulunmak için kullanılan metin. Bu metin, kaynak medyayla birlikte gösterilir. Bu alan için yalnızca düz metnin desteklendiğini, HTML bileşenlerinin kaldırılacağını (köprü tabanlı ilişkilendirme desteklenmez) unutmayın.
text
(deprecated)

string

Desteği sonlandırıldı. Bunun yerine localizedText kullanılması tercih edilir.

ServiceAttributeValueId

Bir hizmet özelliğinin, bir hizmete uygulanacak belirli bir değerini tanımlar.

JSON gösterimi 
{
  "attributeId": string,
  "valueId": string
}
Alanlar
attributeId

string

Merchant.service_attribute içinde tanımlanan bir özelliğin kimliği (ör. "service-type").
valueId

string

Bu özelliğin değerinin kimliği (ör. "saç kesimi"). Hizmet özelliği tanımındaki bir valueId ile eşleşmelidir.

WaitlistRules

Bekleme listesine katılmayla ilgili kurallar.

JSON gösterimi 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Alanlar
minPartySize

integer

Zorunlu. Bekleme listesi işlevi sunan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevi sunmuyorsa bu alan doldurulmamalıdır.
maxPartySize

integer

Zorunlu. Bekleme listesi işlevi sunan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevi sunmuyorsa bu alan doldurulmamalıdır.
supportsAdditionalRequest

boolean

Doğruysa kullanıcı, bu hizmetin bekleme listesine katılırken serbest biçimli ek bir metin isteği gönderebilir.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Set maxPartySize değerinden daha büyük partiler için seçenekleri ayarlayın. Daha büyük gruplara bekleme listesine katılmak için alternatif seçenekler sunulmaması gerekiyorsa boş bırakın.

UnsupportedPartySizeOption

Kapsama alanı dışında kalan partiler için seçenekler.

JSON gösterimi 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Alanlar
kind birleşik alanı. Kapsama alanı dışında kalan partiler için kullanılabilir seçenekler. kind aşağıdakilerden yalnızca biri olabilir:
callMerchant

object (CallMerchant)

Aralık dışında kalan parti büyüklükleri için işletme aranabilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Gösterilecek örnek metin: {waitlistRules.max_party_size} kişiden büyük gruplar için lütfen {phone} numaralı telefondan restoranı arayın. CallMerchant ayarlanmalı ancak boş olacaktır.

CallMerchant

Bu türde alan yok.

UnsupportedPartySizeOption'da kullanılacak boş mesaj. Bu ayar, kullanıcılara rezervasyon için işletmeyi arama seçeneğini gösterir.

TicketingVerticalSpecificData

Etkinlik bilet işlemleri dikeyine özgü ek bilgiler.

JSON gösterimi 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Alanlar
eventCategory

enum (EventCategory)

Etkinliğin kategorisi. Yalnızca etkinlik önceden tanımlanmış kategorilerden birine girdiğinde ayarlanır. (isteğe bağlı)
eventUrl

string

İş ortağının web sitesindeki etkinliğin URL'si. (isteğe bağlı)
entity[]

object (Entity)

Etkinlikle ilgili öğelerin listesi. (isteğe bağlı)
eventAttendanceMode

enum (AttendanceMode)

Zorunlu. Etkinliğe katılım türü.
eventVirtualLocationUrl[]

string

İsteğe bağlı. Etkinliğin izlenebileceği URL.
eventOrganizer

object (Text)

İsteğe bağlı. Etkinliği düzenleyen kullanıcı.
eventOrganizerUrl

string

İsteğe bağlı. Etkinliği düzenleyen kişinin URL'si.
eventOrganizerType

enum (OrganizerType)

İsteğe bağlı. Düzenleyenin türü.
eventSourceUrl[]

string

Zorunlu. Etkinlik bilgilerinin veya açıklamalarının bulunabileceği sayfaların URL'si.
eventState

enum (EventState)

İsteğe bağlı. Etkinliğin durumu.
brandName

object (Text)

İsteğe bağlı. Yerelleştirilmiş marka adı.
eventCreator

object (EventCreator)

İsteğe bağlı. Etkinliği oluşturan kişi hakkında bilgiler.

EventCategory

Ürün deneyimini özelleştirdiğimiz etkinlik kategorilerinin bir alt kümesi. Not: Etkinliklerin evrensel bir ontolojisi olması amaçlanmamıştır.

Sıralamalar
EVENT_CATEGORY_UNSPECIFIED Belirtilmedi. Kullanmayın.
EVENT_CATEGORY_CONCERT Konserler
EVENT_CATEGORY_SPORTS Spor etkinlikleri
EVENT_CATEGORY_THEATRE Tiyatro etkinlikleri
EVENT_CATEGORY_EXHIBITS Sergiler.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Atölyeler ve sınıflar

Varlık

Etkinlikle ilgili bir varlığı temsil eder.

JSON gösterimi 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Alanlar
id

string

İş ortağının veritabanındaki öğenin benzersiz tanımlayıcısı. (isteğe bağlı)
name

string

Varlığın adı. (gerekli)
url

string

Özneyi açık bir şekilde tanımlayan web sayfasının URL'si. Bu, varsa iş ortağının web sitesindeki öğeye ait web sayfasıdır. Öğenin diğer herkese açık URL'leri için publicIdentificationData içinde relevantUrl'yi kullanın. (isteğe bağlı)
entityType

enum (EntityType)

Varlığın türü. (isteğe bağlı)
entityRole

enum (EntityRole)

Varlığın etkinlikteki rolü. (isteğe bağlı)
publicIdentificationData

object (PublicIdentificationData)

Varlığın herkese açık referansları. (isteğe bağlı)

EntityType

Varlığın türü. Not: Evrensel bir ontoloji olması amaçlanmamıştır.

Sıralamalar
ENTITY_TYPE_UNSPECIFIED Belirtilmedi. Kullanmayın.
ENTITY_TYPE_PERFORMER Bu varlık, konserde veya gösteride sahne alan sanatçıyı ya da grubu temsil eder. Yalnızca etkinlik kategorisi CONCERT veya THEATRE olduğunda geçerlidir.
ENTITY_TYPE_PLAYER Varlık, etkinlikteki spor takımını veya oyuncuyu temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir.
ENTITY_TYPE_CONCERT_TOUR Varlık, bu etkinliğin ait olduğu turu temsil eder. Yalnızca etkinlik kategorisi CONCERT olduğunda geçerlidir.
ENTITY_TYPE_SPORTS_SERIES Varlık, bu etkinliğin ait olduğu bir spor turnuvasını temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir.
ENTITY_TYPE_PLAY Varlık, etkinlikte sahnelenen oyun türünü (ör. müzikal, komedi, bale vb.) temsil eder. Yalnızca etkinlik kategorisi THEATRE olduğunda geçerlidir.

EntityRole

Varlığın etkinlikteki rolü.

Sıralamalar
ENTITY_ROLE_UNSPECIFIED Belirtilmedi.
ENTITY_ROLE_HEADLINER Tüzel kişi, etkinlikte sahne alan önemli bir sanatçıyı veya başrol oyuncusunu temsil ediyor.
ENTITY_ROLE_SUPPORTER Varlık, etkinlikte destekleyici bir sanatçıyı temsil ediyor.
ENTITY_ROLE_HOME_TEAM Bu öğe, (spor) etkinliğindeki ev sahibi takımı temsil eder.
ENTITY_ROLE_AWAY_TEAM Varlık, (spor) etkinliğindeki deplasman takımını temsil eder.

PublicIdentificationData

Bir tüzel kişiye referans veren tanımlayıcılar, web sayfaları veya diğer kamuya açık kaynaklar.

JSON gösterimi 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
Alanlar
relevantUrl[]

string

Yalnızca konuya ayrılmış herhangi bir web sayfasının herkese açık URL'si. Resmi web siteleri, Discogs, sosyal medya platformları, Wikipedia veya IMDb sayfaları buna örnek olarak verilebilir. Örneğin: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (isteğe bağlı)
musicbrainzId

string

Sanatçının veya diğer müzik varlıklarının 36 karakterlik MusicBrainz tanımlayıcısı (varsa). https://musicbrainz.org/doc/MusicBrainz_Identifier adresini ziyaret edin. (isteğe bağlı)

AttendanceMode

Etkinliğe katılım türü.

Sıralamalar
ATTENDANCE_MODE_UNSPECIFIED Belirtilmedi.
ONLINE Sanal etkinlikler için.
PHYSICAL Fiziksel etkinlikler için.
PHYSICAL_ONLINE_MIXED Hem fiziksel hem de sanal etkinlikler için.

OrganizerType

Düzenleyenin türü.

Sıralamalar
ORGANIZER_TYPE_UNSPECIFIED Belirtilmedi.
PERSON Etkinliği düzenleyen kişi için.
ORGANIZATION Etkinliği düzenleyen kişi bir kuruluşsa

EventState

Etkinliğin durumu.

Sıralamalar
EVENT_STATE_UNSPECIFIED Belirtilmedi.
SCHEDULED Etkinlik planlandı.
RESCHEDULED Etkinlik yeniden planlandı.
CANCELLED Etkinlik iptal edildi.
POSTPONED Etkinlik ertelendi.

EventCreator

Etkinliği oluşturan kişi hakkında bilgiler. Yalnızca kullanıcı tarafından oluşturulan içerik etkinliklerini içeren platformlar için geçerlidir.

JSON gösterimi 
{
  "name": string
}
Alanlar
name

string

İsteğe bağlı. Etkinliği oluşturanın adı. Karakter kısıtlaması yoktur.

IntegrationType

Desteklenen entegrasyon derinliği.

Sıralamalar
INTEGRATION_TYPE_UNSPECIFIED Varsayılan olarak END_TO_END değerine ayarlanır.
INTEGRATION_TYPE_END_TO_END Google üzerinden uçtan uca rezervasyon yapılmasına olanak tanıyan tam entegrasyon.
INTEGRATION_TYPE_INVENTORY_ONLY Rezervasyon sunucusunun bu hizmeti desteklemesi gerekmez. Yalnızca satıcı, hizmet ve (isteğe bağlı olarak) stok durumu verilerinin gönderilmesi gerekir.

PerOrderFee

Bilet sayısından bağımsız olarak sipariş başına bir kez ödenmesi gereken ücretler.

JSON gösterimi 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Alanlar
deliveryFee

object (Price)

Yayınlanma yöntemine göre değişebilen bir ücret.
processingFee

object (Price)

Kullanıcının ödeme yönteminin işlenmesi için alınan ücret.

ToursAndActivitiesContent

Turlar ve Aktiviteler'e özgü içerik alanları. Tekrarlanan alandaki her öğe, ayrı oluşturmaya (ör. madde işareti olarak) izin verecek şekilde bağımsız olmalıdır.

Turlar ve aktiviteler için ToursAndActivitiesContent'in doldurulması kesinlikle önerilir ancak zorunlu değildir. Tüm alanlar, temel biçimlendirme için hem düz metni hem de HTML benzeri metni destekler. Desteklenen HTML benzeri biçimlendirme etiketleri:

İfade etiketleri:
, , , : Yalnızca yukarıda belirtilen üç etiket desteklenir.
, paragraflardaki satırları bölmek için, // ise önemli bir metni vurgulamak için kullanılabilir. Diğer tüm ifade etiketleri yoksayılır.

Diğer tüm etiketlere ve özel stillere izin verilmez ve bunlar kaldırılır. Tüm URL'ler, bağlantılar ve köprüler kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez.

Önemli notlar: * highlights, exclusion ve hizmet açıklamasındaki diğer daha ayrıntılı alanlarda zaten sağlanan verileri kopyalamayın. * Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve bu durum istenmeyen bir kullanıcı deneyimine yol açabileceğinden, yukarıda belirtilen desteklenen etiketler dışında etiket kullanmaktan kaçının.

JSON gösterimi 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Alanlar
highlights[]

object (Text)

Kullanıcıların görebileceği öne çıkanlar listesi.
inclusions[]

object (Text)

Kullanıcıların görebileceği dahil etme listesi.
exclusions[]

object (Text)

Kullanıcıların görebileceği hariç tutma listesi.
mustKnow[]

object (Text)

Önemli notların kullanıcı tarafından görülebilen listesi. Yaş kısıtlamaları veya bu hizmeti uygunsuz kılan diğer koşullar gibi ayrıntılar için kullanılır.

Konum

Bir konumla ilgili coğrafi bilgiler.

JSON gösterimi 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Alanlar
placeId

string

Google Places veritabanında ve Google Haritalar'da bir yerin yer kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresini ziyaret edin. Bu bilgi sağlanırsa Google, konumu bu yerle eşleştirir.
name

string

Konumun adı, telefonu, URL'si ve coğrafi bilgisi, konumun Google Haritalar'da mevcut yerlerle eşleştirilmesini desteklemek için kullanılır.

Bu alan isteğe bağlıdır ancak bazı durumlarda zorunlu olabilir. Örneğin, aynı adreste bulunsa bile adı olmayan bir Service.location, bir ticari işletmeyle eşleştirilmez. (isteğe bağlı)
telephone

string

Ülke ve alan kodları dahil olmak üzere konumun herkese açık telefon numarası (ör. +14567891234). (isteğe bağlı)
url

string

Konumun herkese açık web sitesinin URL'si. (isteğe bağlı)
geo

object (GeoCoordinates)

Enlem, boylam ve adres dahil olmak üzere konumun coğrafi bilgileri. (isteğe bağlı)
locationType

enum (LocationType)

Bu konum bir hizmet için sağlanıyorsa konum türü belirtilmelidir.
locationId

string

Konumun hizmet içindeki benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konuma başvurmak için kullanılabilir. Örneğin, özel alım formunda, teslim alma konumu seçeneklerini belirtmek için bir dizi konum kimliği kullanılabilir. Ayarlanırsa bu kimlik aynı hizmet içinde benzersiz olmalıdır. (isteğe bağlı)

LocationType

Bu konumun türü.

Sıralamalar
LOCATION_TYPE_UNSPECIFIED Konum türü belirtilmedi.
VISITED_LOCATION Bu hizmetin ziyaret ettiği konum.
START_LOCATION Bu hizmetin başladığı konum, MEETING_LOCATION olarak da kullanılır.
END_LOCATION Bu hizmetin sona erdiği konum.

Derecelendirme

Bir varlık için puanı tanımlar.

JSON gösterimi 
{
  "value": number,
  "numberOfRatings": string
}
Alanlar
value

number

Ortalama puan değeri (numberOfRatings > 0 olduğunda zorunludur). Değer [1, 5] aralığında olmalıdır ve yalnızca numberOfRatings sıfırsa atlanabilir.
numberOfRatings

string

Değeri hesaplarken kullanılan puan sayısı (zorunlu).

HomeServiceData

Ev hizmetleri sektörü için sağlanması gereken ek bilgiler.

JSON gösterimi 
{
  "categoryType": string,
  "jobType": string
}
Alanlar
categoryType

string

Bu ev hizmetinin ait olduğu üst düzey kategori. Ör. tesisatçı, elektrikçi vb.
jobType

string

Belirli bir ev hizmetinin ait olduğu kategori altındaki iş türü. Örneğin, unclog_drain ve install_faucet, tesisatçı kategorisindeki iş türleridir.

VirtualSession

Sanal/online oturum hakkında bilgiler. Ör. online yoga dersi, sanal yemek pişirme dersi vb.

JSON gösterimi 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Alanlar
sessionInstructions

object (Text)

Bu sanal sınıfın nasıl ayarlandığına ilişkin talimatlar. İş ortağı, rezervasyona video URL'sini dahil etmezse bu metinde video URL'sinin kullanıcıyla ne zaman paylaşılacağı belirtilmelidir. Ör. "Zoom URL'si, dersten 30 dakika önce e-postayla gönderilecektir." (Önerilir)
sessionRequirements

object (Text)

Belirli bir sanal oturumun şartları. Ör. yoga matı, mutfak gereçleri vb. (Önerilir)
virtualPlatformInfo

object (VirtualPlatformInfo)

Bu oturumda kullanılan sanal platform hakkında bilgiler. (Sanal hizmetleri etkinleştirmek için gereklidir)
isSessionPrerecorded

boolean

Zorunlu. Sanal oturum canlı değilse ve önceden kaydedilmişse bu değeri doğru olarak ayarlayın.

VirtualPlatformInfo

Bu sanal oturumda kullanılacak platform hakkında bilgiler.

JSON gösterimi 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Alanlar
platform

enum (Platform)

Sanal oturum için kullanılan platform.
otherPlatformName

object (Text)

Platform OTHER olarak ayarlanmışsa platformun adı. (Platform OTHER olarak ayarlandıysa zorunludur)

Platform

Hangi sanal platformun satıcı tarafından kullanılacağını belirten enum.

Sıralamalar
PLATFORM_UNSPECIFIED Kullanılmamış.
FLEXIBLE Satıcı, hangi video platformunu kullanacağı konusunda esnektir.
GOOGLE_HANGOUTS Google Hangouts ürünü.
GOOGLE_MEET Google Meet ürünü.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE YouTube'da canlı yayın yapma
OTHER Kullanılan video platformu burada belirtilenlerden farklıysa ayarlanmalıdır.

DirectMerchantPayment

Kullanıcının, hizmet için RwG üzerinden ön ödeme yapmak yerine doğrudan satıcıya nasıl ödeme yapabileceği hakkında bilgi.

JSON gösterimi 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Alanlar
paymentMethods[]

object (Text)

Kullanıcıların yalnızca aşağıda belirtilen ödeme yöntemleriyle ödeme yapmaları önerilir.

UriTemplate

Google'ın harici site URL'lerini nasıl oluşturacağını belirten bir şablon.

JSON gösterimi 
{
  "uriTemplate": string
}
Alanlar
uriTemplate

string

İsteğe bağlı. URI şablonu RFC6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 2. düzey şablonları destekler. Bu parametreler, ilgili öğelerinde belirtilen değerlere dönüştürülür.

Yemek rezervasyonu için yönlendirme bağlantısı parametreleri: 1) (zorunlu) {availability_slot_start_seconds}: Stok durumu feed'indeki startSec alanından doldurulur. 2) (zorunlu) {resources_party_size}: Stok durumu feed'indeki partySize alanından doldurulur. 3) (isteğe bağlı) {availability_slot_duration_seconds}: Stok durumu feed'indeki durationSec alanından doldurulur. 4) (isteğe bağlı) {availability_slot_availability_tag}: Stok durumu feed'indeki availabilityTag alanından doldurulur.

Kullanım örneği: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

Şu değerlerle: * startSec = 123456 * partySize = 2

https://example.com/book/restaurant?start=123456&num_guests=2

Yöntemler

create

 Belirtilen toplayıcı tarafından yönetilen bir satıcının yeni bir Service öğesini oluşturur ve döndürür.

delete

 Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesini siler.

patch

 Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesini günceller ve döndürür.